@cochon123/cli2api 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cli2api contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,252 @@
+# cli2api
+
+Local OpenAI- and OpenRouter-compatible gateway for coding CLIs.
+
+Point any OpenAI SDK / benchmark at localhost and run against **Codex, OpenCode, Cursor Agent, or Claude Code** (plus the built-in mock) using the credentials/login already configured in each CLI.
+
+> **Local only.** Binds to `127.0.0.1` by default. Not a multi-tenant product. Do not expose your CLI auth to the network.
+
+## 30-second start
+
+Install the published package globally:
+
+```bash
+npm install --global @cochon123/cli2api
+cli2api serve --adapter mock --port 3927
+```
+
+The npm package is scoped because the unscoped `cli2api` name is already owned by another publisher. The installed executable is still named `cli2api`.
+
+Before the first npm release, or to install the current GitHub version directly:
+
+```bash
+npm install --global github:cochon123/cli2api
+cli2api --version
+```
+
+For development from a checkout:
+
+```bash
+# from the project root
+npm install
+npm run serve -- --adapter mock --port 3927
+```
+
+The server prints a generated bearer token on stderr if you did not set one. Copy it into your client env:
+
+```bash
+OPENAI_BASE_URL=http://127.0.0.1:3927/v1
+OPENAI_API_KEY=<token printed by serve>
+OPENAI_MODEL=mock/echo
+```
+
+Or pin the token yourself:
+
+```bash
+CLI2API_TOKEN=dev-secret npm run serve -- --adapter mock
+# OPENAI_API_KEY=dev-secret
+```
+
+Smoke:
+
+```bash
+npm run test:smoke
+npm run doctor
+npm run dev -- completion -m mock/echo -p "hello"
+```
+
+## Use a real CLI
+
+Requires [`codex`](https://github.com/openai/codex) on your `PATH` and logged in.
+
+```bash
+npm run doctor -- --adapter codex
+npm run serve -- --adapter codex --port 3927
+```
+
+```bash
+OPENAI_BASE_URL=http://127.0.0.1:3927/v1
+OPENAI_API_KEY=<token printed by serve>
+OPENAI_MODEL=codex/default
+```
+
+One-shot without the server:
+
+```bash
+npm run dev -- completion -m codex/default -p "Reply with exactly: pong"
+```
+
+The other adapters use the same commands and model-prefix routing:
+
+```bash
+# OpenCode: completed JSON reasoning/text blocks, safe `plan` agent, plugins disabled
+npm run completion -- -m opencode/deepseek-v4-flash-free -p "Reply with: pong"
+
+# Cursor: native partial reasoning/content deltas, read-only ask mode + sandbox
+npm run completion -- -m cursor/composer-2.5-fast -p "Reply with: pong"
+
+# Claude Code: native partial stream-json, plan mode, all built-in/MCP tools disabled
+npm run completion -- -m claude/default -p "Reply with: pong"
+```
+
+Claude Code is implemented from its official headless CLI contract but was not live-tested on the development machine because `claude` was not installed.
+
+## CLI
+
+| Command | Purpose |
+|---------|---------|
+| `cli2api serve` | Start HTTP gateway |
+| `cli2api doctor` | Check adapters / binaries (`--json`) |
+| `cli2api models` | List model ids |
+| `cli2api completion` | Smoke a prompt |
+| `cli2api adapters` | List adapters |
+
+```bash
+npx tsx src/index.ts serve --help
+```
+
+After `npm run build`, the bin is `cli2api`.
+
+## Env vars
+
+| Var | Meaning |
+|-----|---------|
+| `CLI2API_ADAPTER` | Default adapter (`mock` \| `codex` \| `opencode` \| `cursor` \| `claude`) |
+| `CLI2API_TOKEN` | Bearer token (auto-generated for the session if unset) |
+| `CLI2API_CODEX_BIN` | Path/name of Codex binary |
+| `CLI2API_OPENCODE_BIN` | Path/name of OpenCode binary |
+| `CLI2API_CURSOR_BIN` | Path/name of Cursor Agent binary |
+| `CLI2API_CLAUDE_BIN` | Path/name of Claude Code binary |
+| `CLI2API_CWD` | Working directory for CLI adapters |
+| `CLI2API_CHILD_ENV_ALLOWLIST` | Comma-separated extra parent env names to explicitly pass to child CLIs |
+| `CLI2API_CONFIG` | Explicit JSON config path |
+| `CLI2API_OPENROUTER_CATALOG` | OpenRouter catalog mode (`runnable` or `mirror`) |
+| `OPENROUTER_API_KEY` | Optional key used only to refresh OpenRouter model metadata |
+
+## Config and model aliases
+
+JSON config is merged in this order: `$XDG_CONFIG_HOME/cli2api/config.json`, project `.cli2api.json`, then `--config <path>` / `CLI2API_CONFIG`. Later values win; `modelAliases` and `binaries` merge by key.
+
+```json
+{
+  "defaultAdapter": "opencode",
+  "port": 3927,
+  "token": "local-secret",
+  "cwd": "/path/to/project",
+  "modelAliases": {
+    "fast": "opencode/deepseek-v4-flash-free",
+    "composer": "cursor/composer-2.5-fast"
+  },
+  "openRouter": {
+    "defaultModel": "anthropic/claude-sonnet-4",
+    "catalogMode": "runnable",
+    "annotateAvailability": true,
+    "modelRoutes": {
+      "anthropic/claude-sonnet-4": {
+        "adapter": "claude",
+        "model": "sonnet"
+      },
+      "openai/gpt-local": {
+        "adapter": "codex",
+        "model": "default"
+      }
+    }
+  },
+  "binaries": {
+    "codex": "codex",
+    "opencode": "opencode",
+    "cursor": "cursor-agent",
+    "claude": "claude"
+  }
+}
+```
+
+Aliases appear in `/v1/models` and work anywhere a model id is accepted.
+
+## API (subset)
+
+- `GET /health`
+- `GET /v1/models`
+- `POST /v1/chat/completions` — non-stream + `stream: true` (SSE)
+- `POST /v1/responses` — text/function input, non-stream + semantic SSE events
+- `GET /api/v1/models` — OpenRouter-compatible model catalog
+- `POST /api/v1/chat/completions` — OpenRouter-compatible chat, tools, reasoning, and SSE
+- `POST /api/v1/responses` — OpenRouter path alias for the Responses subset
+
+All endpoints require `Authorization: Bearer <token>`.
+
+Model ids: `adapter/model` — e.g. `mock/echo`, `codex/default`, `opencode/deepseek-v4-flash-free`, `cursor/composer-2.5-fast`, `claude/sonnet`. OpenCode provider-qualified models keep the second slash, for example `opencode/openrouter/deepseek/deepseek-v4-flash`.
+
+## OpenRouter compatibility
+
+Point an OpenRouter-oriented client at `http://127.0.0.1:3927/api/v1` and use the same cli2api bearer token. Public OpenRouter model ids are mapped to local CLI models with `openRouter.modelRoutes`; the public id is preserved in responses while routing stays internal.
+
+If an application relies on OpenRouter's account-level default and omits `model`, set `openRouter.defaultModel` locally.
+
+The OpenRouter catalog has two modes:
+
+- `runnable` (default) lists only models cli2api can execute. Configured OpenRouter ids are enriched with metadata from OpenRouter's models API.
+- `mirror` returns the cached OpenRouter catalog so model discovery resembles production. Models without a local route remain visible but return a `model_not_available` error when called.
+
+Select the mode in config or with `cli2api serve --openrouter-catalog runnable|mirror`.
+
+Metadata is cached for 24 hours at `$XDG_CACHE_HOME/cli2api/openrouter-models.json` (or `~/.cache/cli2api/openrouter-models.json`). Stale data is used if refresh fails. Configure `metadataTtlSeconds`, `metadataCachePath`, or `metadataUrl` under `openRouter` when needed. Pricing fields describe OpenRouter's hosted service, not local CLI execution.
+
+For safety, `OPENROUTER_API_KEY` is sent only to the canonical `https://openrouter.ai` origin. Custom `metadataUrl` sources never receive it. Cache entries are tied to their source URL so catalogs cannot be mixed across sources.
+
+Set `annotateAvailability` to `true` to add a `cli2api` object to model records with local availability and routing details. Set it to `false` in `mirror` mode for the closest upstream catalog shape.
+
+OpenRouter cloud-only routing features such as provider fallback, billing, and plugins are accepted as request metadata but are not performed locally. Adapter capabilities still determine the actual result.
+
+Function tools are accepted in both OpenAI API shapes. Because these coding CLIs do not expose a uniform native tool protocol, cli2api supplies the function schemas in the prompt and validates a strict JSON call envelope; it returns standard `tool_calls` / `function_call` output. Tool names and JSON argument objects are always validated, and `strict: true` arguments are validated against the supplied JSON Schema. The mock adapter has native deterministic tool events for tests.
+
+For Chat Completions, reuse a client-chosen `session_id` to resume the CLI's native conversation. For Responses, pass the prior returned `id` as `previous_response_id`; unknown, expired, restarted, or adapter-mismatched ids return HTTP 400 instead of silently losing context. Mappings are adapter-bound, in memory, limited to 1,000 entries, and expire after 24 hours; restarting cli2api clears them. On native resume, only messages after the last assistant turn are sent, avoiding duplicate history. Responses `instructions` are forwarded as a developer message.
+
+## Phase 0 scope
+
+- [x] OpenAI chat completions + models
+- [x] OpenRouter-compatible paths, model routing, catalog modes, reasoning, and streaming usage
+- [x] Mock adapter (instant env-swap proof)
+- [x] Codex adapter via `codex exec --json`
+- [x] Loopback-only bind + `doctor` / `completion`
+- [x] Required bearer token (auto-generated if unset)
+- [x] No open CORS (SDK/script clients only)
+- [x] OpenCode adapter (`run --format json --thinking`, safe `plan` agent)
+- [x] Cursor Agent adapter (native partial `stream-json`, read-only `ask` mode)
+- [x] Claude Code adapter (headless partial `stream-json`, restrictive flags; not live-tested locally)
+- [x] Real JSONL streaming from Codex (`codex exec --json` line-by-line)
+  - Enable reasoning summaries via `-c model_reasoning_summary=detailed` (+ supports / unhide)
+  - Reasoning summary items → word-by-word `delta.reasoning` / `reasoning_content`
+  - Final `agent_message` → word-by-word `delta.content`
+  - Short lifecycle crumbs still go to reasoning without fake-stream delay
+- [x] Config files + model aliases
+- [x] Function tool calling (validated prompt-envelope fallback)
+- [x] Responses API subset + semantic streaming events
+- [x] Native CLI session resume (`session_id` / `previous_response_id`)
+- [x] Env scrubbing for spawned CLI processes with a small runtime allowlist, per-adapter auth vars, and explicit opt-in passthrough
+
+## Project layout
+
+```
+src/
+  index.ts              # CLI
+  adapters/             # mock, codex, registry
+  protocol/openai.ts    # request/response shaping
+  openrouter/catalog.ts # cached metadata and runnable/mirror model views
+  server/               # Hono app + listen
+  types.ts
+scripts/smoke.ts
+```
+
+## Safety
+
+- Default bind: `127.0.0.1` only (refuse non-loopback hosts).
+- Bearer token required on every request; generated on startup if unset.
+- No CORS middleware — browser tabs on the same machine cannot read responses via `fetch` from arbitrary origins.
+- Codex adapter defaults to `--sandbox read-only` (blocks writes; does **not** block reading files the agent is asked about).
+- Spawn uses argv arrays only (`shell: false`); no prompt concatenation into a shell string.
+- Child processes receive a scrubbed environment. Normal runtime paths/local config homes and narrowly scoped adapter auth variables are retained; unrelated parent secrets are removed. Add exceptional keys explicitly with `CLI2API_CHILD_ENV_ALLOWLIST`.
+- OpenCode runs with its `plan` agent and external plugins disabled.
+- Cursor runs in read-only `ask` mode with its sandbox enabled; `--trust` only acknowledges the configured working directory for headless startup.
+- Claude runs in `plan` mode with built-in tools disabled and configured MCP tools excluded.
+- You are responsible for complying with each CLI vendor’s terms for local use.

package/dist/adapters/claude.d.ts

@@ -0,0 +1,27 @@
+import type { Adapter } from "./types.js";
+import type { ChatCompletionResponse } from "../types.js";
+export interface ClaudeAdapterOptions {
+    binary?: string;
+    cwd?: string;
+    timeoutMs?: number;
+    extraArgs?: string[];
+}
+export type ClaudeParsedLine = {
+    kind: "content" | "reasoning";
+    text: string;
+    partial: boolean;
+} | {
+    kind: "session";
+    id: string;
+} | {
+    kind: "result";
+    text?: string;
+    usage?: ChatCompletionResponse["usage"];
+} | {
+    kind: "error";
+    message: string;
+} | {
+    kind: "ignore";
+};
+export declare function parseClaudeLine(line: string): ClaudeParsedLine[];
+export declare function createClaudeAdapter(opts?: ClaudeAdapterOptions): Adapter;

package/dist/adapters/claude.js

@@ -0,0 +1,253 @@
+import { requestToPrompt } from "../protocol/openai.js";
+import { runCommand, runCommandLines, which } from "../util/process.js";
+const DEFAULT_MODELS = ["default", "sonnet", "opus", "haiku"];
+function record(value) {
+    return value && typeof value === "object" ? value : null;
+}
+function assistantBlocks(value) {
+    if (!Array.isArray(value))
+        return [];
+    const result = [];
+    for (const raw of value) {
+        const block = record(raw);
+        if (!block)
+            continue;
+        if (block.type === "text" && typeof block.text === "string" && block.text) {
+            result.push({ kind: "content", text: block.text });
+        }
+        else if (block.type === "thinking" && typeof block.thinking === "string" && block.thinking) {
+            result.push({ kind: "reasoning", text: block.thinking });
+        }
+    }
+    return result;
+}
+export function parseClaudeLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return [{ kind: "ignore" }];
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return trimmed.startsWith("{") ? [{ kind: "ignore" }] : [{ kind: "content", text: trimmed, partial: false }];
+    }
+    const message = record(parsed);
+    if (!message)
+        return [{ kind: "ignore" }];
+    const type = typeof message.type === "string" ? message.type : "";
+    if (type === "system" && message.subtype === "init" && typeof message.session_id === "string") {
+        return [{ kind: "session", id: message.session_id }];
+    }
+    if (type === "stream_event") {
+        const event = record(message.event);
+        const delta = record(event?.delta);
+        if (event?.type === "content_block_delta" && delta) {
+            if (delta.type === "text_delta" && typeof delta.text === "string") {
+                return [{ kind: "content", text: delta.text, partial: true }];
+            }
+            if (delta.type === "thinking_delta" && typeof delta.thinking === "string") {
+                return [{ kind: "reasoning", text: delta.thinking, partial: true }];
+            }
+        }
+        return [{ kind: "ignore" }];
+    }
+    if (type === "assistant") {
+        const nested = record(message.message);
+        const blocks = assistantBlocks(nested?.content);
+        return blocks.length
+            ? blocks.map((block) => ({ ...block, partial: false }))
+            : [{ kind: "ignore" }];
+    }
+    if (type === "result") {
+        if (message.is_error === true || message.subtype === "error") {
+            return [{ kind: "error", message: typeof message.result === "string" ? message.result : "Claude Code failed" }];
+        }
+        const rawUsage = record(message.usage);
+        let usage;
+        if (rawUsage) {
+            const prompt = typeof rawUsage.input_tokens === "number" ? rawUsage.input_tokens : 0;
+            const completion = typeof rawUsage.output_tokens === "number" ? rawUsage.output_tokens : 0;
+            usage = { prompt_tokens: prompt, completion_tokens: completion, total_tokens: prompt + completion };
+        }
+        return [{
+                kind: "result",
+                text: typeof message.result === "string" ? message.result : undefined,
+                usage,
+            }];
+    }
+    if (type === "error") {
+        return [{ kind: "error", message: typeof message.message === "string" ? message.message : "Claude Code stream error" }];
+    }
+    return [{ kind: "ignore" }];
+}
+export function createClaudeAdapter(opts = {}) {
+    const binary = opts.binary ?? "claude";
+    const timeoutMs = opts.timeoutMs ?? 180_000;
+    return {
+        id: "claude",
+        description: "Claude Code via headless stream-json (plan mode, tools disabled)",
+        async listModels() {
+            return DEFAULT_MODELS.map((model) => ({
+                id: `claude/${model}`,
+                object: "model",
+                created: 0,
+                owned_by: "anthropic",
+                description: model === "default" ? "Uses the Claude Code default model" : undefined,
+            }));
+        },
+        async *chat(req, signal) {
+            const path = await which(binary);
+            if (!path) {
+                yield {
+                    type: "error",
+                    message: `claude binary not found on PATH (looked for "${binary}"). Install Claude Code or set CLI2API_CLAUDE_BIN.`,
+                    code: "binary_missing",
+                };
+                return;
+            }
+            // Official headless flags. Empty --tools disables built-ins; strict MCP plus
+            // the deny rule prevents configured MCP tools from bypassing that restriction.
+            const args = [
+                "-p",
+                "--output-format",
+                "stream-json",
+                "--verbose",
+                "--include-partial-messages",
+                "--permission-mode",
+                "plan",
+                "--tools",
+                "",
+                "--disallowedTools",
+                "mcp__*",
+                "--strict-mcp-config",
+            ];
+            if (req.nativeSessionId)
+                args.push("--resume", req.nativeSessionId);
+            if (req.modelLocal && req.modelLocal !== "default")
+                args.push("--model", req.modelLocal);
+            if (opts.extraArgs?.length)
+                args.push(...opts.extraArgs);
+            args.push(requestToPrompt(req));
+            let sawContent = false;
+            let sawPartialContent = false;
+            let sawPartialReasoning = false;
+            let fallbackResult = "";
+            let usage;
+            let exitCode = null;
+            let timedOut = false;
+            let stderr = "";
+            try {
+                for await (const event of runCommandLines(path, args, {
+                    cwd: opts.cwd,
+                    timeoutMs,
+                    signal,
+                    inheritEnv: [
+                        "CLAUDE_CONFIG_DIR",
+                        "CLAUDE_CODE_OAUTH_TOKEN",
+                        "ANTHROPIC_API_KEY",
+                        "ANTHROPIC_AUTH_TOKEN",
+                        "ANTHROPIC_BASE_URL",
+                    ],
+                })) {
+                    if (event.type === "stdout_line") {
+                        for (const parsed of parseClaudeLine(event.line)) {
+                            if (parsed.kind === "content") {
+                                if (parsed.partial) {
+                                    sawPartialContent = true;
+                                    sawContent = true;
+                                    yield { type: "delta", text: parsed.text, channel: "content" };
+                                }
+                                else if (!sawPartialContent) {
+                                    sawContent = true;
+                                    yield { type: "delta", text: parsed.text, channel: "content" };
+                                }
+                            }
+                            else if (parsed.kind === "reasoning") {
+                                if (parsed.partial) {
+                                    sawPartialReasoning = true;
+                                    yield { type: "delta", text: parsed.text, channel: "reasoning" };
+                                }
+                                else if (!sawPartialReasoning) {
+                                    yield { type: "delta", text: parsed.text, channel: "reasoning" };
+                                }
+                            }
+                            else if (parsed.kind === "session") {
+                                yield { type: "session", id: parsed.id };
+                            }
+                            else if (parsed.kind === "result") {
+                                fallbackResult = parsed.text ?? fallbackResult;
+                                usage = parsed.usage ?? usage;
+                            }
+                            else if (parsed.kind === "error") {
+                                yield { type: "error", message: parsed.message, code: "cli_error" };
+                                return;
+                            }
+                        }
+                    }
+                    else if (event.type === "exit") {
+                        exitCode = event.code;
+                        timedOut = event.timedOut;
+                        stderr = event.stderr;
+                    }
+                }
+            }
+            catch (error) {
+                yield {
+                    type: "error",
+                    message: `Failed to spawn claude: ${error instanceof Error ? error.message : String(error)}`,
+                    code: "spawn_error",
+                };
+                return;
+            }
+            if (!sawContent && fallbackResult) {
+                sawContent = true;
+                yield { type: "delta", text: fallbackResult, channel: "content" };
+            }
+            if (timedOut) {
+                yield { type: "error", message: `claude timed out after ${timeoutMs}ms`, code: "timeout" };
+            }
+            else if (signal.aborted) {
+                yield { type: "error", message: "Aborted", code: "abort" };
+            }
+            else if (exitCode !== 0) {
+                yield {
+                    type: "error",
+                    message: `claude exited with code ${exitCode}${stderr.trim() ? `: ${stderr.trim().slice(0, 2000)}` : ""}`,
+                    code: "cli_error",
+                };
+            }
+            else if (!sawContent) {
+                yield { type: "error", message: "claude returned empty output", code: "empty_output" };
+            }
+            else {
+                yield { type: "done", finishReason: "stop", usage };
+            }
+        },
+        async health() {
+            const path = await which(binary);
+            if (!path)
+                return { ok: false, adapter: "claude", details: { binary }, message: "claude binary not found on PATH" };
+            const version = await runCommand(path, ["--version"], { timeoutMs: 8_000 });
+            return {
+                ok: version.code === 0,
+                adapter: "claude",
+                details: { binary: path, version: (version.stdout || version.stderr).trim(), permissionMode: "plan", tools: "disabled" },
+                message: version.code === 0 ? "claude available" : "claude --version failed",
+            };
+        },
+        async doctor() {
+            const path = await which(binary);
+            const checks = [{ name: "binary-on-path", ok: Boolean(path), detail: path ?? `missing: ${binary}` }];
+            let version;
+            if (path) {
+                const result = await runCommand(path, ["--version"], { timeoutMs: 8_000 });
+                version = (result.stdout || result.stderr).trim();
+                checks.push({ name: "version", ok: result.code === 0, detail: version || `exit ${result.code}` });
+            }
+            checks.push({ name: "restrictive-default", ok: true, detail: "permission-mode=plan; built-in and MCP tools disabled" });
+            return { adapter: "claude", ok: Boolean(path) && checks.every((check) => check.ok), binary: path ?? binary, version, checks };
+        },
+    };
+}
+//# sourceMappingURL=claude.js.map

package/dist/adapters/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"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"}

package/dist/adapters/codex.d.ts

@@ -0,0 +1,51 @@
+import type { Adapter } from "./types.js";
+import type { ChatEvent } from "../types.js";
+export interface CodexAdapterOptions {
+    /** Binary name or path (default: codex) */
+    binary?: string;
+    /** Working directory for codex exec (default: cwd) */
+    cwd?: string;
+    /** Extra args appended to `codex exec` */
+    extraArgs?: string[];
+    /** Request timeout in ms */
+    timeoutMs?: number;
+    /**
+     * Sandbox mode for exec.
+     * Default: read-only (safer for API/benchmark prompts that should not mutate disk).
+     */
+    sandbox?: "read-only" | "workspace-write" | "danger-full-access";
+    /** Skip git repo check (needed outside of git repos) */
+    skipGitRepoCheck?: boolean;
+    /** Word-by-word delay for content fake-stream (ms). 0 = instant chunks. */
+    contentWordDelayMs?: number;
+}
+/** Yield text word-by-word so SSE clients see a typing effect. */
+export declare function fakeStreamWords(text: string, delayMs: number, signal?: AbortSignal, channel?: "content" | "reasoning"): AsyncGenerator<ChatEvent>;
+export type CodexLineKind = "content" | "reasoning" | "session" | "done" | "error" | "ignore";
+export interface CodexParsedLine {
+    kind: CodexLineKind;
+    text?: string;
+    /** True for model reasoning summaries (fake-stream); false for short status crumbs. */
+    fakeStream?: boolean;
+    sessionId?: string;
+    error?: ChatEvent & {
+        type: "error";
+    };
+    done?: ChatEvent & {
+        type: "done";
+    };
+}
+/**
+ * Parse one Codex JSONL line into a typed payload.
+ * Content (agent_message) is returned whole — caller fake-streams words.
+ * Everything else useful goes to reasoning.
+ */
+export declare function parseCodexLine(line: string): CodexParsedLine;
+/**
+ * Map one Codex JSONL event to ChatEvents (content returned as a single delta;
+ * prefer parseCodexLine + fakeStreamWords in the live adapter path).
+ */
+export declare function chatEventsFromCodexLine(line: string): ChatEvent[];
+/** Batch helper kept for tests / non-streaming inspection. */
+export declare function parseCodexJsonl(stdout: string): string;
+export declare function createCodexAdapter(opts?: CodexAdapterOptions): Adapter;