@anagnole/claude-cli 0.1.0

package/dist/cli/parser.d.ts

@@ -0,0 +1,6 @@
+/** Buffers partial lines from a stream and yields complete parsed JSON objects. */
+export declare class NdjsonParser {
+    private buffer;
+    feed(chunk: string): unknown[];
+    flush(): unknown[];
+}

package/dist/cli/parser.js

@@ -0,0 +1,35 @@
+/** Buffers partial lines from a stream and yields complete parsed JSON objects. */
+export class NdjsonParser {
+    buffer = "";
+    feed(chunk) {
+        this.buffer += chunk;
+        const lines = this.buffer.split("\n");
+        this.buffer = lines.pop() ?? "";
+        const results = [];
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                results.push(JSON.parse(trimmed));
+            }
+            catch {
+                // Non-JSON line, skip
+            }
+        }
+        return results;
+    }
+    flush() {
+        const remaining = this.buffer.trim();
+        this.buffer = "";
+        if (!remaining)
+            return [];
+        try {
+            return [JSON.parse(remaining)];
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/cli/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/cli/parser.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,OAAO,YAAY;IACf,MAAM,GAAG,EAAE,CAAC;IAEpB,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QAEhC,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,IAAI,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,sBAAsB;YACxB,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,SAAS;YAAE,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/cli/spawn.d.ts

@@ -0,0 +1,29 @@
+import { type ChildProcess } from "node:child_process";
+export interface SpawnOptions {
+    prompt: string;
+    model?: string;
+    systemPrompt?: string;
+    appendSystemPrompt?: boolean;
+    resumeSessionId?: string;
+    continueConversation?: boolean;
+    forkSession?: boolean;
+    streaming: boolean;
+    effort?: string;
+    jsonSchema?: unknown;
+    permissionMode?: string;
+    allowedTools?: string[];
+    disallowedTools?: string[];
+    cliTools?: string;
+    mcpConfig?: string;
+    strictMcpConfig?: boolean;
+    worktree?: string;
+    workingDirectory?: string;
+    maxTurns?: number;
+    maxBudgetUsd?: number;
+    fallbackModel?: string;
+    dangerouslySkipPermissions?: boolean;
+    addDirs?: string[];
+    /** Path to the claude CLI binary. Defaults to "claude". */
+    claudePath?: string;
+}
+export declare function spawnClaude(options: SpawnOptions): ChildProcess;

package/dist/cli/spawn.js

@@ -0,0 +1,77 @@
+import { spawn } from "node:child_process";
+export function spawnClaude(options) {
+    const args = ["--print"];
+    // Output format
+    if (options.streaming) {
+        args.push("--output-format", "stream-json", "--verbose", "--include-partial-messages");
+    }
+    else {
+        args.push("--output-format", "json");
+    }
+    // Model
+    if (options.model)
+        args.push("--model", options.model);
+    if (options.fallbackModel)
+        args.push("--fallback-model", options.fallbackModel);
+    // System prompt
+    if (options.systemPrompt) {
+        if (options.appendSystemPrompt) {
+            args.push("--append-system-prompt", options.systemPrompt);
+        }
+        else {
+            args.push("--system-prompt", options.systemPrompt);
+        }
+    }
+    // Session management
+    if (options.resumeSessionId)
+        args.push("--resume", options.resumeSessionId);
+    if (options.continueConversation)
+        args.push("--continue");
+    if (options.forkSession)
+        args.push("--fork-session");
+    // Effort & structured output
+    if (options.effort)
+        args.push("--effort", options.effort);
+    if (options.jsonSchema)
+        args.push("--json-schema", JSON.stringify(options.jsonSchema));
+    // Permission & tools
+    if (options.permissionMode)
+        args.push("--permission-mode", options.permissionMode);
+    if (options.dangerouslySkipPermissions)
+        args.push("--dangerously-skip-permissions");
+    if (options.allowedTools?.length)
+        args.push("--allowedTools", ...options.allowedTools);
+    if (options.disallowedTools?.length)
+        args.push("--disallowedTools", ...options.disallowedTools);
+    if (options.cliTools != null)
+        args.push("--tools", options.cliTools);
+    // MCP
+    if (options.mcpConfig)
+        args.push(`--mcp-config=${options.mcpConfig}`);
+    if (options.strictMcpConfig)
+        args.push("--strict-mcp-config");
+    // Worktree & directories
+    if (options.worktree)
+        args.push("--worktree", options.worktree);
+    if (options.addDirs?.length)
+        args.push("--add-dir", ...options.addDirs);
+    // Safety limits
+    if (options.maxTurns != null)
+        args.push("--max-turns", String(options.maxTurns));
+    if (options.maxBudgetUsd != null)
+        args.push("--max-budget-usd", String(options.maxBudgetUsd));
+    // Prompt is always last
+    if (options.prompt) {
+        args.push("--", options.prompt);
+    }
+    // Prevent recursion / interference if running inside a Claude Code session
+    const env = { ...process.env };
+    delete env.CLAUDECODE;
+    delete env.CLAUDE_CODE_ENTRYPOINT;
+    return spawn(options.claudePath ?? "claude", args, {
+        cwd: options.workingDirectory,
+        stdio: ["ignore", "pipe", "pipe"],
+        env,
+    });
+}
+//# sourceMappingURL=spawn.js.map

package/dist/cli/spawn.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { spawnClaude } from "./cli/spawn.js";
+export type { SpawnOptions } from "./cli/spawn.js";
+export { NdjsonParser } from "./cli/parser.js";
+export { SessionMap } from "./session/session-map.js";
+export { extractPrompt, extractSystem, warnUnsupported } from "./transform/request.js";
+export { buildResponse, generateMsgId } from "./transform/response.js";
+export { createStreamState, transformEvent } from "./transform/stream.js";
+export type { StreamState } from "./transform/stream.js";
+export type { ContentBlock, SystemBlock, MessageParam, MessagesRequest, MessagesResponse, Usage, ApiError, } from "./types.js";
+export { apiError } from "./types.js";

package/dist/index.js

@@ -0,0 +1,11 @@
+// CLI
+export { spawnClaude } from "./cli/spawn.js";
+export { NdjsonParser } from "./cli/parser.js";
+// Session
+export { SessionMap } from "./session/session-map.js";
+// Transform
+export { extractPrompt, extractSystem, warnUnsupported } from "./transform/request.js";
+export { buildResponse, generateMsgId } from "./transform/response.js";
+export { createStreamState, transformEvent } from "./transform/stream.js";
+export { apiError } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM;AACN,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,UAAU;AACV,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAa1E,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/session/session-map.d.ts

@@ -0,0 +1,16 @@
+import type { MessageParam } from "../types.js";
+export declare class SessionMap {
+    private map;
+    private maxEntries;
+    /** Hash all messages except the last one to fingerprint the conversation context. */
+    static hashContext(messages: MessageParam[]): string;
+    /** Look up a CLI session ID for a given context hash + model. */
+    lookup(hash: string, model: string): string | null;
+    /**
+     * Store a session after a successful CLI invocation.
+     * `fullMessages` should include the original messages + the assistant response,
+     * so the *next* request with that history will find this session.
+     */
+    store(fullMessages: MessageParam[], cliSessionId: string, model: string): void;
+    private evictIfNeeded;
+}

package/dist/session/session-map.js

@@ -0,0 +1,55 @@
+import { createHash } from "node:crypto";
+export class SessionMap {
+    map = new Map();
+    maxEntries = 1000;
+    /** Hash all messages except the last one to fingerprint the conversation context. */
+    static hashContext(messages) {
+        const context = messages.slice(0, -1);
+        if (context.length === 0)
+            return "empty";
+        const payload = JSON.stringify(context);
+        return createHash("sha256").update(payload).digest("hex").slice(0, 16);
+    }
+    /** Look up a CLI session ID for a given context hash + model. */
+    lookup(hash, model) {
+        const entry = this.map.get(hash);
+        if (!entry || entry.model !== model)
+            return null;
+        entry.lastUsedAt = Date.now();
+        return entry.cliSessionId;
+    }
+    /**
+     * Store a session after a successful CLI invocation.
+     * `fullMessages` should include the original messages + the assistant response,
+     * so the *next* request with that history will find this session.
+     */
+    store(fullMessages, cliSessionId, model) {
+        // The next request will hash messages[0..n-1] (all except its new user msg),
+        // which equals the full messages from this turn.
+        const nextHash = createHash("sha256")
+            .update(JSON.stringify(fullMessages))
+            .digest("hex")
+            .slice(0, 16);
+        this.map.set(nextHash, {
+            cliSessionId,
+            lastUsedAt: Date.now(),
+            model,
+        });
+        this.evictIfNeeded();
+    }
+    evictIfNeeded() {
+        if (this.map.size <= this.maxEntries)
+            return;
+        let oldestKey = null;
+        let oldestTime = Infinity;
+        for (const [key, entry] of this.map) {
+            if (entry.lastUsedAt < oldestTime) {
+                oldestTime = entry.lastUsedAt;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey)
+            this.map.delete(oldestKey);
+    }
+}
+//# sourceMappingURL=session-map.js.map

package/dist/session/session-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-map.js","sourceRoot":"","sources":["../../src/session/session-map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AASzC,MAAM,OAAO,UAAU;IACb,GAAG,GAAG,IAAI,GAAG,EAAwB,CAAC;IACtC,UAAU,GAAG,IAAI,CAAC;IAE1B,qFAAqF;IACrF,MAAM,CAAC,WAAW,CAAC,QAAwB;QACzC,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,iEAAiE;IACjE,MAAM,CAAC,IAAY,EAAE,KAAa;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC;QACjD,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,YAAY,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,YAA4B,EAAE,YAAoB,EAAE,KAAa;QACrE,6EAA6E;QAC7E,iDAAiD;QACjD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;aAClC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;aACpC,MAAM,CAAC,KAAK,CAAC;aACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEhB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE;YACrB,YAAY;YACZ,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;YACtB,KAAK;SACN,CAAC,CAAC;QAEH,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAEO,aAAa;QACnB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO;QAC7C,IAAI,SAAS,GAAkB,IAAI,CAAC;QACpC,IAAI,UAAU,GAAG,QAAQ,CAAC;QAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACpC,IAAI,KAAK,CAAC,UAAU,GAAG,UAAU,EAAE,CAAC;gBAClC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;gBAC9B,SAAS,GAAG,GAAG,CAAC;YAClB,CAAC;QACH,CAAC;QACD,IAAI,SAAS;YAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/transform/request.d.ts

@@ -0,0 +1,11 @@
+import type { MessageParam, MessagesRequest, SystemBlock } from "../types.js";
+interface Logger {
+    warn(msg: string): void;
+}
+/** Extract the text content from the last user message. */
+export declare function extractPrompt(messages: MessageParam[]): string;
+/** Flatten system prompt to a single string. */
+export declare function extractSystem(system: string | SystemBlock[] | undefined): string | undefined;
+/** Log warnings for API params the CLI truly can't handle. */
+export declare function warnUnsupported(req: MessagesRequest, log: Logger): void;
+export {};

package/dist/transform/request.js

@@ -0,0 +1,40 @@
+/** Extract the text content from the last user message. */
+export function extractPrompt(messages) {
+    const last = messages[messages.length - 1];
+    if (!last || last.role !== "user") {
+        throw new Error("Last message must have role 'user'");
+    }
+    if (typeof last.content === "string")
+        return last.content;
+    return last.content
+        .filter((b) => b.type === "text")
+        .map((b) => b.text)
+        .join("\n");
+}
+/** Flatten system prompt to a single string. */
+export function extractSystem(system) {
+    if (!system)
+        return undefined;
+    if (typeof system === "string")
+        return system;
+    return system
+        .filter((b) => b.type === "text")
+        .map((b) => b.text)
+        .join("\n");
+}
+/** Log warnings for API params the CLI truly can't handle. */
+export function warnUnsupported(req, log) {
+    if (req.temperature != null)
+        log.warn("temperature param ignored (CLI does not support it)");
+    if (req.top_p != null)
+        log.warn("top_p param ignored");
+    if (req.top_k != null)
+        log.warn("top_k param ignored");
+    if (req.stop_sequences?.length)
+        log.warn("stop_sequences param ignored");
+    if (req.tools?.length)
+        log.warn("tools param ignored (CLI uses its own built-in tools, use allowed_tools/disallowed_tools instead)");
+    if (req.tool_choice != null)
+        log.warn("tool_choice param ignored");
+}
+//# sourceMappingURL=request.js.map

package/dist/transform/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../src/transform/request.ts"],"names":[],"mappings":"AAMA,2DAA2D;AAC3D,MAAM,UAAU,aAAa,CAAC,QAAwB;IACpD,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC;IAC1D,OAAO,IAAI,CAAC,OAAO;SAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;SAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,aAAa,CAC3B,MAA0C;IAE1C,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC9C,OAAO,MAAM;SACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;SAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,eAAe,CAAC,GAAoB,EAAE,GAAW;IAC/D,IAAI,GAAG,CAAC,WAAW,IAAI,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;IAC7F,IAAI,GAAG,CAAC,KAAK,IAAI,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACvD,IAAI,GAAG,CAAC,KAAK,IAAI,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACvD,IAAI,GAAG,CAAC,cAAc,EAAE,MAAM;QAAE,GAAG,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IACzE,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM;QAAE,GAAG,CAAC,IAAI,CAAC,mGAAmG,CAAC,CAAC;IACrI,IAAI,GAAG,CAAC,WAAW,IAAI,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;AACrE,CAAC"}

package/dist/transform/response.d.ts

@@ -0,0 +1,18 @@
+import type { MessagesResponse } from "../types.js";
+export declare function generateMsgId(): string;
+interface CliResult {
+    result: string;
+    stop_reason?: string;
+    session_id: string;
+    total_cost_usd?: number;
+    duration_ms?: number;
+    num_turns?: number;
+    usage?: {
+        input_tokens?: number;
+        output_tokens?: number;
+        cache_creation_input_tokens?: number;
+        cache_read_input_tokens?: number;
+    };
+}
+export declare function buildResponse(cli: CliResult, model: string): MessagesResponse;
+export {};

package/dist/transform/response.js

@@ -0,0 +1,41 @@
+import crypto from "node:crypto";
+export function generateMsgId() {
+    return "msg_" + crypto.randomBytes(18).toString("base64url");
+}
+export function buildResponse(cli, model) {
+    const usage = {
+        input_tokens: cli.usage?.input_tokens ?? 0,
+        output_tokens: cli.usage?.output_tokens ?? 0,
+    };
+    if (cli.usage?.cache_creation_input_tokens) {
+        usage.cache_creation_input_tokens = cli.usage.cache_creation_input_tokens;
+    }
+    if (cli.usage?.cache_read_input_tokens) {
+        usage.cache_read_input_tokens = cli.usage.cache_read_input_tokens;
+    }
+    // Build content blocks — for now just text, but could include tool_use in the future
+    const content = [{ type: "text", text: cli.result }];
+    return {
+        id: generateMsgId(),
+        type: "message",
+        role: "assistant",
+        content,
+        model,
+        stop_reason: mapStopReason(cli.stop_reason),
+        stop_sequence: null,
+        usage,
+        // CLI extras
+        session_id: cli.session_id,
+        cost_usd: cli.total_cost_usd,
+        duration_ms: cli.duration_ms,
+        num_turns: cli.num_turns,
+    };
+}
+function mapStopReason(reason) {
+    if (reason === "max_tokens")
+        return "max_tokens";
+    if (reason === "stop_sequence")
+        return "stop_sequence";
+    return "end_turn";
+}
+//# sourceMappingURL=response.js.map

package/dist/transform/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../src/transform/response.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AAGjC,MAAM,UAAU,aAAa;IAC3B,OAAO,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC/D,CAAC;AAiBD,MAAM,UAAU,aAAa,CAAC,GAAc,EAAE,KAAa;IACzD,MAAM,KAAK,GAAU;QACnB,YAAY,EAAE,GAAG,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC;QAC1C,aAAa,EAAE,GAAG,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC;KAC7C,CAAC;IACF,IAAI,GAAG,CAAC,KAAK,EAAE,2BAA2B,EAAE,CAAC;QAC3C,KAAK,CAAC,2BAA2B,GAAG,GAAG,CAAC,KAAK,CAAC,2BAA2B,CAAC;IAC5E,CAAC;IACD,IAAI,GAAG,CAAC,KAAK,EAAE,uBAAuB,EAAE,CAAC;QACvC,KAAK,CAAC,uBAAuB,GAAG,GAAG,CAAC,KAAK,CAAC,uBAAuB,CAAC;IACpE,CAAC;IAED,qFAAqF;IACrF,MAAM,OAAO,GAAmB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAErE,OAAO;QACL,EAAE,EAAE,aAAa,EAAE;QACnB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,WAAW;QACjB,OAAO;QACP,KAAK;QACL,WAAW,EAAE,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC;QAC3C,aAAa,EAAE,IAAI;QACnB,KAAK;QACL,aAAa;QACb,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,QAAQ,EAAE,GAAG,CAAC,cAAc;QAC5B,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,MAAe;IAEf,IAAI,MAAM,KAAK,YAAY;QAAE,OAAO,YAAY,CAAC;IACjD,IAAI,MAAM,KAAK,eAAe;QAAE,OAAO,eAAe,CAAC;IACvD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/transform/stream.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Transforms CLI stream-json NDJSON events into Anthropic SSE format.
+ *
+ * The CLI's `--output-format stream-json --verbose` emits events like:
+ *   {"type": "stream_event", "event": { ...anthropic_event... }, "session_id": "..."}
+ *
+ * The inner `event` payload is almost identical to the Anthropic SSE data.
+ * We unwrap it, inject our msg_id where needed, and format as SSE lines.
+ */
+export interface StreamState {
+    msgId: string;
+    model: string;
+    sessionId: string | null;
+    inputTokens: number;
+    outputTokens: number;
+    started: boolean;
+    finished: boolean;
+}
+export declare function createStreamState(model: string): StreamState;
+/**
+ * Transform a parsed CLI NDJSON object into zero or more SSE strings.
+ * Returns an array of SSE-formatted strings to write to the response.
+ */
+export declare function transformEvent(obj: Record<string, unknown>, state: StreamState): string[];

package/dist/transform/stream.js

@@ -0,0 +1,106 @@
+/**
+ * Transforms CLI stream-json NDJSON events into Anthropic SSE format.
+ *
+ * The CLI's `--output-format stream-json --verbose` emits events like:
+ *   {"type": "stream_event", "event": { ...anthropic_event... }, "session_id": "..."}
+ *
+ * The inner `event` payload is almost identical to the Anthropic SSE data.
+ * We unwrap it, inject our msg_id where needed, and format as SSE lines.
+ */
+import { generateMsgId } from "./response.js";
+/** Format a single SSE event. */
+function sse(event, data) {
+    return `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
+}
+export function createStreamState(model) {
+    return {
+        msgId: generateMsgId(),
+        model,
+        sessionId: null,
+        inputTokens: 0,
+        outputTokens: 0,
+        started: false,
+        finished: false,
+    };
+}
+/**
+ * Transform a parsed CLI NDJSON object into zero or more SSE strings.
+ * Returns an array of SSE-formatted strings to write to the response.
+ */
+export function transformEvent(obj, state) {
+    const results = [];
+    // Capture session_id from any event
+    if (typeof obj.session_id === "string") {
+        state.sessionId = obj.session_id;
+    }
+    // stream_event wraps Anthropic-format events
+    if (obj.type === "stream_event" && obj.event && typeof obj.event === "object") {
+        const event = obj.event;
+        const eventType = event.type;
+        switch (eventType) {
+            case "message_start": {
+                state.started = true;
+                // Rebuild message_start with our msg_id
+                const msg = (event.message ?? {});
+                const usage = (msg.usage ?? {});
+                if (typeof usage.input_tokens === "number")
+                    state.inputTokens = usage.input_tokens;
+                results.push(sse("message_start", {
+                    type: "message_start",
+                    message: {
+                        id: state.msgId,
+                        type: "message",
+                        role: "assistant",
+                        content: [],
+                        model: state.model,
+                        stop_reason: null,
+                        stop_sequence: null,
+                        usage: { input_tokens: state.inputTokens, output_tokens: 1 },
+                    },
+                }));
+                break;
+            }
+            case "content_block_start":
+                results.push(sse("content_block_start", event));
+                break;
+            case "content_block_delta":
+                results.push(sse("content_block_delta", event));
+                break;
+            case "content_block_stop":
+                results.push(sse("content_block_stop", event));
+                break;
+            case "message_delta": {
+                const usage = (event.usage ?? {});
+                if (typeof usage.output_tokens === "number")
+                    state.outputTokens = usage.output_tokens;
+                results.push(sse("message_delta", event));
+                break;
+            }
+            case "message_stop":
+                state.finished = true;
+                results.push(sse("message_stop", { type: "message_stop" }));
+                break;
+            default:
+                // Pass through unknown event types (ping, etc.)
+                if (eventType === "ping") {
+                    results.push(sse("ping", { type: "ping" }));
+                }
+                break;
+        }
+    }
+    // result event — capture session_id and usage for session map
+    if (obj.type === "result") {
+        if (typeof obj.session_id === "string")
+            state.sessionId = obj.session_id;
+        const usage = obj.usage;
+        if (usage) {
+            if (typeof usage.input_tokens === "number")
+                state.inputTokens = usage.input_tokens;
+            if (typeof usage.output_tokens === "number")
+                state.outputTokens = usage.output_tokens;
+        }
+        // Don't emit SSE — message_stop was already sent by the stream events
+    }
+    return results;
+}
+//# sourceMappingURL=stream.js.map

package/dist/transform/stream.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,103 @@
+export interface ContentBlock {
+    type: string;
+    text?: string;
+    id?: string;
+    name?: string;
+    input?: unknown;
+    tool_use_id?: string;
+    content?: string | ContentBlock[];
+    is_error?: boolean;
+}
+export interface SystemBlock {
+    type: "text";
+    text: string;
+    cache_control?: {
+        type: "ephemeral";
+        ttl?: string;
+    };
+}
+export interface MessageParam {
+    role: "user" | "assistant";
+    content: string | ContentBlock[];
+}
+export interface MessagesRequest {
+    model: string;
+    messages: MessageParam[];
+    max_tokens?: number;
+    system?: string | SystemBlock[];
+    stream?: boolean;
+    temperature?: number;
+    top_p?: number;
+    top_k?: number;
+    stop_sequences?: string[];
+    tools?: unknown[];
+    tool_choice?: unknown;
+    thinking?: unknown;
+    metadata?: {
+        user_id?: string;
+    };
+    effort?: string;
+    json_schema?: unknown;
+    /** Permission mode: "plan" | "bypassPermissions" | etc. Maps to --permission-mode */
+    permission_mode?: string;
+    /** Tools to auto-approve without prompting. Maps to --allowedTools */
+    allowed_tools?: string[];
+    /** Tools to remove from context entirely. Maps to --disallowedTools */
+    disallowed_tools?: string[];
+    /** Restrict built-in tools. "" disables all, "default" for all. Maps to --tools */
+    cli_tools?: string;
+    /** Path to MCP server config JSON file. Maps to --mcp-config */
+    mcp_config?: string;
+    /** Use only MCP servers from mcp_config, ignore all others. Maps to --strict-mcp-config */
+    strict_mcp_config?: boolean;
+    /** Run in isolated git worktree. Maps to --worktree */
+    worktree?: string;
+    /** Working directory for the CLI process. Maps to cwd */
+    working_directory?: string;
+    /** Max agentic turns before stopping. Maps to --max-turns */
+    max_turns?: number;
+    /** Max dollar spend before stopping. Maps to --max-budget-usd */
+    max_budget_usd?: number;
+    /** Append to default system prompt instead of replacing. Maps to --append-system-prompt */
+    append_system_prompt?: boolean;
+    /** Continue most recent conversation. Maps to --continue */
+    continue_conversation?: boolean;
+    /** Resume a specific CLI session by ID. Maps to --resume */
+    resume_session_id?: string;
+    /** Fork the session (new ID) when resuming. Maps to --fork-session */
+    fork_session?: boolean;
+    /** Fallback model if primary is overloaded. Maps to --fallback-model */
+    fallback_model?: string;
+    /** Skip all permission prompts. Maps to --dangerously-skip-permissions */
+    dangerously_skip_permissions?: boolean;
+    /** Additional working directories. Maps to --add-dir */
+    add_dirs?: string[];
+}
+export interface Usage {
+    input_tokens: number;
+    output_tokens: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+}
+export interface MessagesResponse {
+    id: string;
+    type: "message";
+    role: "assistant";
+    content: ContentBlock[];
+    model: string;
+    stop_reason: "end_turn" | "max_tokens" | "stop_sequence" | null;
+    stop_sequence: string | null;
+    usage: Usage;
+    session_id?: string;
+    cost_usd?: number;
+    duration_ms?: number;
+    num_turns?: number;
+}
+export interface ApiError {
+    type: "error";
+    error: {
+        type: string;
+        message: string;
+    };
+}
+export declare function apiError(type: string, message: string): ApiError;

package/dist/types.js

@@ -0,0 +1,5 @@
+// --- Anthropic Messages API types ---
+export function apiError(type, message) {
+    return { type: "error", error: { type, message } };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,uCAAuC;AAoHvC,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,OAAe;IACpD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;AACrD,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@anagnole/claude-cli",
+  "version": "0.1.0",
+  "description": "Shared library for spawning, parsing, and managing Claude Code CLI sessions",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./cli": {
+      "types": "./dist/cli/spawn.d.ts",
+      "default": "./dist/cli/spawn.js"
+    },
+    "./parser": {
+      "types": "./dist/cli/parser.d.ts",
+      "default": "./dist/cli/parser.js"
+    },
+    "./session": {
+      "types": "./dist/session/session-map.d.ts",
+      "default": "./dist/session/session-map.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "default": "./dist/types.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "tsc"
+  },
+  "keywords": ["claude", "cli", "anthropic", "proxy", "agent"],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/cli/parser.ts

@@ -0,0 +1,33 @@
+/** Buffers partial lines from a stream and yields complete parsed JSON objects. */
+export class NdjsonParser {
+  private buffer = "";
+
+  feed(chunk: string): unknown[] {
+    this.buffer += chunk;
+    const lines = this.buffer.split("\n");
+    this.buffer = lines.pop() ?? "";
+
+    const results: unknown[] = [];
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      try {
+        results.push(JSON.parse(trimmed));
+      } catch {
+        // Non-JSON line, skip
+      }
+    }
+    return results;
+  }
+
+  flush(): unknown[] {
+    const remaining = this.buffer.trim();
+    this.buffer = "";
+    if (!remaining) return [];
+    try {
+      return [JSON.parse(remaining)];
+    } catch {
+      return [];
+    }
+  }
+}

package/src/cli/spawn.ts

@@ -0,0 +1,100 @@
+import { spawn, type ChildProcess } from "node:child_process";
+
+export interface SpawnOptions {
+  prompt: string;
+  model?: string;
+  systemPrompt?: string;
+  appendSystemPrompt?: boolean;
+  resumeSessionId?: string;
+  continueConversation?: boolean;
+  forkSession?: boolean;
+  streaming: boolean;
+  effort?: string;
+  jsonSchema?: unknown;
+
+  // CLI-specific options
+  permissionMode?: string;
+  allowedTools?: string[];
+  disallowedTools?: string[];
+  cliTools?: string;
+  mcpConfig?: string;
+  strictMcpConfig?: boolean;
+  worktree?: string;
+  workingDirectory?: string;
+  maxTurns?: number;
+  maxBudgetUsd?: number;
+  fallbackModel?: string;
+  dangerouslySkipPermissions?: boolean;
+  addDirs?: string[];
+
+  /** Path to the claude CLI binary. Defaults to "claude". */
+  claudePath?: string;
+}
+
+export function spawnClaude(options: SpawnOptions): ChildProcess {
+  const args = ["--print"];
+
+  // Output format
+  if (options.streaming) {
+    args.push("--output-format", "stream-json", "--verbose", "--include-partial-messages");
+  } else {
+    args.push("--output-format", "json");
+  }
+
+  // Model
+  if (options.model) args.push("--model", options.model);
+  if (options.fallbackModel) args.push("--fallback-model", options.fallbackModel);
+
+  // System prompt
+  if (options.systemPrompt) {
+    if (options.appendSystemPrompt) {
+      args.push("--append-system-prompt", options.systemPrompt);
+    } else {
+      args.push("--system-prompt", options.systemPrompt);
+    }
+  }
+
+  // Session management
+  if (options.resumeSessionId) args.push("--resume", options.resumeSessionId);
+  if (options.continueConversation) args.push("--continue");
+  if (options.forkSession) args.push("--fork-session");
+
+  // Effort & structured output
+  if (options.effort) args.push("--effort", options.effort);
+  if (options.jsonSchema) args.push("--json-schema", JSON.stringify(options.jsonSchema));
+
+  // Permission & tools
+  if (options.permissionMode) args.push("--permission-mode", options.permissionMode);
+  if (options.dangerouslySkipPermissions) args.push("--dangerously-skip-permissions");
+  if (options.allowedTools?.length) args.push("--allowedTools", ...options.allowedTools);
+  if (options.disallowedTools?.length) args.push("--disallowedTools", ...options.disallowedTools);
+  if (options.cliTools != null) args.push("--tools", options.cliTools);
+
+  // MCP
+  if (options.mcpConfig) args.push(`--mcp-config=${options.mcpConfig}`);
+  if (options.strictMcpConfig) args.push("--strict-mcp-config");
+
+  // Worktree & directories
+  if (options.worktree) args.push("--worktree", options.worktree);
+  if (options.addDirs?.length) args.push("--add-dir", ...options.addDirs);
+
+  // Safety limits
+  if (options.maxTurns != null) args.push("--max-turns", String(options.maxTurns));
+  if (options.maxBudgetUsd != null) args.push("--max-budget-usd", String(options.maxBudgetUsd));
+
+  // Prompt is always last
+  if (options.prompt) {
+    args.push("--", options.prompt);
+  }
+
+  // Prevent recursion / interference if running inside a Claude Code session
+  const env = { ...process.env };
+  delete env.CLAUDECODE;
+  delete env.CLAUDE_CODE_ENTRYPOINT;
+
+  return spawn(options.claudePath ?? "claude", args, {
+    cwd: options.workingDirectory,
+    stdio: ["ignore", "pipe", "pipe"],
+    env,
+  });
+}

package/src/index.ts

@@ -0,0 +1,25 @@
+// CLI
+export { spawnClaude } from "./cli/spawn.js";
+export type { SpawnOptions } from "./cli/spawn.js";
+export { NdjsonParser } from "./cli/parser.js";
+
+// Session
+export { SessionMap } from "./session/session-map.js";
+
+// Transform
+export { extractPrompt, extractSystem, warnUnsupported } from "./transform/request.js";
+export { buildResponse, generateMsgId } from "./transform/response.js";
+export { createStreamState, transformEvent } from "./transform/stream.js";
+export type { StreamState } from "./transform/stream.js";
+
+// Types
+export type {
+  ContentBlock,
+  SystemBlock,
+  MessageParam,
+  MessagesRequest,
+  MessagesResponse,
+  Usage,
+  ApiError,
+} from "./types.js";
+export { apiError } from "./types.js";

package/src/session/session-map.ts

@@ -0,0 +1,64 @@
+import { createHash } from "node:crypto";
+import type { MessageParam } from "../types.js";
+
+interface SessionEntry {
+  cliSessionId: string;
+  lastUsedAt: number;
+  model: string;
+}
+
+export class SessionMap {
+  private map = new Map<string, SessionEntry>();
+  private maxEntries = 1000;
+
+  /** Hash all messages except the last one to fingerprint the conversation context. */
+  static hashContext(messages: MessageParam[]): string {
+    const context = messages.slice(0, -1);
+    if (context.length === 0) return "empty";
+    const payload = JSON.stringify(context);
+    return createHash("sha256").update(payload).digest("hex").slice(0, 16);
+  }
+
+  /** Look up a CLI session ID for a given context hash + model. */
+  lookup(hash: string, model: string): string | null {
+    const entry = this.map.get(hash);
+    if (!entry || entry.model !== model) return null;
+    entry.lastUsedAt = Date.now();
+    return entry.cliSessionId;
+  }
+
+  /**
+   * Store a session after a successful CLI invocation.
+   * `fullMessages` should include the original messages + the assistant response,
+   * so the *next* request with that history will find this session.
+   */
+  store(fullMessages: MessageParam[], cliSessionId: string, model: string): void {
+    // The next request will hash messages[0..n-1] (all except its new user msg),
+    // which equals the full messages from this turn.
+    const nextHash = createHash("sha256")
+      .update(JSON.stringify(fullMessages))
+      .digest("hex")
+      .slice(0, 16);
+
+    this.map.set(nextHash, {
+      cliSessionId,
+      lastUsedAt: Date.now(),
+      model,
+    });
+
+    this.evictIfNeeded();
+  }
+
+  private evictIfNeeded(): void {
+    if (this.map.size <= this.maxEntries) return;
+    let oldestKey: string | null = null;
+    let oldestTime = Infinity;
+    for (const [key, entry] of this.map) {
+      if (entry.lastUsedAt < oldestTime) {
+        oldestTime = entry.lastUsedAt;
+        oldestKey = key;
+      }
+    }
+    if (oldestKey) this.map.delete(oldestKey);
+  }
+}

package/src/transform/request.ts

@@ -0,0 +1,40 @@
+import type { MessageParam, MessagesRequest, SystemBlock } from "../types.js";
+
+interface Logger {
+  warn(msg: string): void;
+}
+
+/** Extract the text content from the last user message. */
+export function extractPrompt(messages: MessageParam[]): string {
+  const last = messages[messages.length - 1];
+  if (!last || last.role !== "user") {
+    throw new Error("Last message must have role 'user'");
+  }
+  if (typeof last.content === "string") return last.content;
+  return last.content
+    .filter((b) => b.type === "text")
+    .map((b) => b.text)
+    .join("\n");
+}
+
+/** Flatten system prompt to a single string. */
+export function extractSystem(
+  system: string | SystemBlock[] | undefined,
+): string | undefined {
+  if (!system) return undefined;
+  if (typeof system === "string") return system;
+  return system
+    .filter((b) => b.type === "text")
+    .map((b) => b.text)
+    .join("\n");
+}
+
+/** Log warnings for API params the CLI truly can't handle. */
+export function warnUnsupported(req: MessagesRequest, log: Logger): void {
+  if (req.temperature != null) log.warn("temperature param ignored (CLI does not support it)");
+  if (req.top_p != null) log.warn("top_p param ignored");
+  if (req.top_k != null) log.warn("top_k param ignored");
+  if (req.stop_sequences?.length) log.warn("stop_sequences param ignored");
+  if (req.tools?.length) log.warn("tools param ignored (CLI uses its own built-in tools, use allowed_tools/disallowed_tools instead)");
+  if (req.tool_choice != null) log.warn("tool_choice param ignored");
+}

package/src/transform/response.ts

@@ -0,0 +1,61 @@
+import crypto from "node:crypto";
+import type { ContentBlock, MessagesResponse, Usage } from "../types.js";
+
+export function generateMsgId(): string {
+  return "msg_" + crypto.randomBytes(18).toString("base64url");
+}
+
+interface CliResult {
+  result: string;
+  stop_reason?: string;
+  session_id: string;
+  total_cost_usd?: number;
+  duration_ms?: number;
+  num_turns?: number;
+  usage?: {
+    input_tokens?: number;
+    output_tokens?: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+  };
+}
+
+export function buildResponse(cli: CliResult, model: string): MessagesResponse {
+  const usage: Usage = {
+    input_tokens: cli.usage?.input_tokens ?? 0,
+    output_tokens: cli.usage?.output_tokens ?? 0,
+  };
+  if (cli.usage?.cache_creation_input_tokens) {
+    usage.cache_creation_input_tokens = cli.usage.cache_creation_input_tokens;
+  }
+  if (cli.usage?.cache_read_input_tokens) {
+    usage.cache_read_input_tokens = cli.usage.cache_read_input_tokens;
+  }
+
+  // Build content blocks — for now just text, but could include tool_use in the future
+  const content: ContentBlock[] = [{ type: "text", text: cli.result }];
+
+  return {
+    id: generateMsgId(),
+    type: "message",
+    role: "assistant",
+    content,
+    model,
+    stop_reason: mapStopReason(cli.stop_reason),
+    stop_sequence: null,
+    usage,
+    // CLI extras
+    session_id: cli.session_id,
+    cost_usd: cli.total_cost_usd,
+    duration_ms: cli.duration_ms,
+    num_turns: cli.num_turns,
+  };
+}
+
+function mapStopReason(
+  reason?: string,
+): "end_turn" | "max_tokens" | "stop_sequence" {
+  if (reason === "max_tokens") return "max_tokens";
+  if (reason === "stop_sequence") return "stop_sequence";
+  return "end_turn";
+}

package/src/transform/stream.ts

@@ -0,0 +1,126 @@
+/**
+ * Transforms CLI stream-json NDJSON events into Anthropic SSE format.
+ *
+ * The CLI's `--output-format stream-json --verbose` emits events like:
+ *   {"type": "stream_event", "event": { ...anthropic_event... }, "session_id": "..."}
+ *
+ * The inner `event` payload is almost identical to the Anthropic SSE data.
+ * We unwrap it, inject our msg_id where needed, and format as SSE lines.
+ */
+
+import { generateMsgId } from "./response.js";
+
+/** Format a single SSE event. */
+function sse(event: string, data: unknown): string {
+  return `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
+}
+
+export interface StreamState {
+  msgId: string;
+  model: string;
+  sessionId: string | null;
+  inputTokens: number;
+  outputTokens: number;
+  started: boolean;
+  finished: boolean;
+}
+
+export function createStreamState(model: string): StreamState {
+  return {
+    msgId: generateMsgId(),
+    model,
+    sessionId: null,
+    inputTokens: 0,
+    outputTokens: 0,
+    started: false,
+    finished: false,
+  };
+}
+
+/**
+ * Transform a parsed CLI NDJSON object into zero or more SSE strings.
+ * Returns an array of SSE-formatted strings to write to the response.
+ */
+export function transformEvent(obj: Record<string, unknown>, state: StreamState): string[] {
+  const results: string[] = [];
+
+  // Capture session_id from any event
+  if (typeof obj.session_id === "string") {
+    state.sessionId = obj.session_id;
+  }
+
+  // stream_event wraps Anthropic-format events
+  if (obj.type === "stream_event" && obj.event && typeof obj.event === "object") {
+    const event = obj.event as Record<string, unknown>;
+    const eventType = event.type as string;
+
+    switch (eventType) {
+      case "message_start": {
+        state.started = true;
+        // Rebuild message_start with our msg_id
+        const msg = (event.message ?? {}) as Record<string, unknown>;
+        const usage = (msg.usage ?? {}) as Record<string, unknown>;
+        if (typeof usage.input_tokens === "number") state.inputTokens = usage.input_tokens;
+
+        results.push(sse("message_start", {
+          type: "message_start",
+          message: {
+            id: state.msgId,
+            type: "message",
+            role: "assistant",
+            content: [],
+            model: state.model,
+            stop_reason: null,
+            stop_sequence: null,
+            usage: { input_tokens: state.inputTokens, output_tokens: 1 },
+          },
+        }));
+        break;
+      }
+
+      case "content_block_start":
+        results.push(sse("content_block_start", event));
+        break;
+
+      case "content_block_delta":
+        results.push(sse("content_block_delta", event));
+        break;
+
+      case "content_block_stop":
+        results.push(sse("content_block_stop", event));
+        break;
+
+      case "message_delta": {
+        const usage = (event.usage ?? {}) as Record<string, unknown>;
+        if (typeof usage.output_tokens === "number") state.outputTokens = usage.output_tokens;
+        results.push(sse("message_delta", event));
+        break;
+      }
+
+      case "message_stop":
+        state.finished = true;
+        results.push(sse("message_stop", { type: "message_stop" }));
+        break;
+
+      default:
+        // Pass through unknown event types (ping, etc.)
+        if (eventType === "ping") {
+          results.push(sse("ping", { type: "ping" }));
+        }
+        break;
+    }
+  }
+
+  // result event — capture session_id and usage for session map
+  if (obj.type === "result") {
+    if (typeof obj.session_id === "string") state.sessionId = obj.session_id;
+    const usage = obj.usage as Record<string, unknown> | undefined;
+    if (usage) {
+      if (typeof usage.input_tokens === "number") state.inputTokens = usage.input_tokens;
+      if (typeof usage.output_tokens === "number") state.outputTokens = usage.output_tokens;
+    }
+    // Don't emit SSE — message_stop was already sent by the stream events
+  }
+
+  return results;
+}

package/src/types.ts

@@ -0,0 +1,119 @@
+// --- Anthropic Messages API types ---
+
+export interface ContentBlock {
+  type: string;
+  text?: string;
+  // tool_use fields
+  id?: string;
+  name?: string;
+  input?: unknown;
+  // tool_result fields
+  tool_use_id?: string;
+  content?: string | ContentBlock[];
+  is_error?: boolean;
+}
+
+export interface SystemBlock {
+  type: "text";
+  text: string;
+  cache_control?: { type: "ephemeral"; ttl?: string };
+}
+
+export interface MessageParam {
+  role: "user" | "assistant";
+  content: string | ContentBlock[];
+}
+
+export interface MessagesRequest {
+  model: string;
+  messages: MessageParam[];
+  max_tokens?: number;
+  system?: string | SystemBlock[];
+  stream?: boolean;
+  temperature?: number;
+  top_p?: number;
+  top_k?: number;
+  stop_sequences?: string[];
+  tools?: unknown[];
+  tool_choice?: unknown;
+  thinking?: unknown;
+  metadata?: { user_id?: string };
+
+  // --- Standard extensions ---
+  effort?: string;
+  json_schema?: unknown;
+
+  // --- CLI extensions (all optional) ---
+  // These map directly to Claude CLI flags.
+  // Pass them in the request body alongside standard Anthropic params.
+
+  /** Permission mode: "plan" | "bypassPermissions" | etc. Maps to --permission-mode */
+  permission_mode?: string;
+  /** Tools to auto-approve without prompting. Maps to --allowedTools */
+  allowed_tools?: string[];
+  /** Tools to remove from context entirely. Maps to --disallowedTools */
+  disallowed_tools?: string[];
+  /** Restrict built-in tools. "" disables all, "default" for all. Maps to --tools */
+  cli_tools?: string;
+  /** Path to MCP server config JSON file. Maps to --mcp-config */
+  mcp_config?: string;
+  /** Use only MCP servers from mcp_config, ignore all others. Maps to --strict-mcp-config */
+  strict_mcp_config?: boolean;
+  /** Run in isolated git worktree. Maps to --worktree */
+  worktree?: string;
+  /** Working directory for the CLI process. Maps to cwd */
+  working_directory?: string;
+  /** Max agentic turns before stopping. Maps to --max-turns */
+  max_turns?: number;
+  /** Max dollar spend before stopping. Maps to --max-budget-usd */
+  max_budget_usd?: number;
+  /** Append to default system prompt instead of replacing. Maps to --append-system-prompt */
+  append_system_prompt?: boolean;
+  /** Continue most recent conversation. Maps to --continue */
+  continue_conversation?: boolean;
+  /** Resume a specific CLI session by ID. Maps to --resume */
+  resume_session_id?: string;
+  /** Fork the session (new ID) when resuming. Maps to --fork-session */
+  fork_session?: boolean;
+  /** Fallback model if primary is overloaded. Maps to --fallback-model */
+  fallback_model?: string;
+  /** Skip all permission prompts. Maps to --dangerously-skip-permissions */
+  dangerously_skip_permissions?: boolean;
+  /** Additional working directories. Maps to --add-dir */
+  add_dirs?: string[];
+}
+
+export interface Usage {
+  input_tokens: number;
+  output_tokens: number;
+  cache_creation_input_tokens?: number;
+  cache_read_input_tokens?: number;
+}
+
+export interface MessagesResponse {
+  id: string;
+  type: "message";
+  role: "assistant";
+  content: ContentBlock[];
+  model: string;
+  stop_reason: "end_turn" | "max_tokens" | "stop_sequence" | null;
+  stop_sequence: string | null;
+  usage: Usage;
+  // CLI extras returned in response
+  session_id?: string;
+  cost_usd?: number;
+  duration_ms?: number;
+  num_turns?: number;
+}
+
+export interface ApiError {
+  type: "error";
+  error: {
+    type: string;
+    message: string;
+  };
+}
+
+export function apiError(type: string, message: string): ApiError {
+  return { type: "error", error: { type, message } };
+}