/**
 * @license
 * Copyright 2026 HopCode Team
 * SPDX-License-Identifier: Apache-2.0
 *
 * `hopcode serve` — starts HopCode as a headless HTTP API server.
 *
 * Endpoints:
 *   GET  /health              — liveness probe (returns 200 {"status":"ok"})
 *   POST /api/v1/run          — run a prompt, streaming SSE response
 *   GET  /api/v1/sessions     — list recent chat sessions (metadata)
 *
 * The /api/v1/run endpoint spawns a child `hopcode --json` process per request
 * and streams the JSON-ND events as Server-Sent Events (SSE) back to the caller.
 * This keeps each request fully isolated and reuses all existing HopCode logic.
 *
 * Usage:
 *   hopcode serve [--port 7900] [--host localhost]
 *
 * Client example (curl):
 *   curl -N -X POST http://localhost:7900/api/v1/run \
 *        -H 'Content-Type: application/json' \
 *        -d '{"prompt":"List files in the current directory"}'
 */
import type { CommandModule } from 'yargs';
interface ServeArgs {
    port: number;
    host: string;
    allowOrigin: string;
}
export declare const serveCommand: CommandModule<object, ServeArgs>;
export {};
