@seanpropapp/cli 0.1.0-beta.1

package/dist/mcp/manifest.js

@@ -0,0 +1,88 @@
+export const MODULES = [
+    {
+        id: "EXEC_SUMMARY",
+        displayName: "Executive Summary",
+        description: "Board-ready synthesis tying market, customer, competition, and economics into one decision narrative. Best run after the research modules.",
+    },
+    {
+        id: "SETUP",
+        displayName: "Initial Framing",
+        description: "START HERE. Establishes the company's context, sector, and business model so every later module reasons from the right baseline.",
+    },
+    {
+        id: "TAM_SIZING",
+        displayName: "Market Sizing & TAM",
+        description: "Sizes the opportunity (TAM / SAM / SOM + segment prioritization) to test whether the market is big enough to matter.",
+    },
+    {
+        id: "ICP",
+        displayName: "Ideal Customer Profile",
+        description: "Pinpoints the highest-fit customer segments and the personas who actually buy.",
+    },
+    {
+        id: "JTBD",
+        displayName: "Jobs To Be Done",
+        description: "Uncovers the real job customers hire this for: their pains, desired outcomes, and switch triggers.",
+    },
+    {
+        id: "COMPETITIVE",
+        displayName: "Competitive Landscape",
+        description: "Maps the competitive field and where you genuinely differentiate vs. where you don't.",
+    },
+    {
+        id: "POSITIONING",
+        displayName: "Positioning Statement",
+        description: "Turns the research into a sharp positioning statement: who it's for, what it is, why it wins.",
+    },
+    {
+        id: "PITCHES",
+        displayName: "Elevator Pitches",
+        description: "Audience-tuned elevator pitches (exec, customer, investor) you can use verbatim.",
+    },
+    {
+        id: "QUOTES",
+        displayName: "Customer Quotes",
+        description: "Illustrative customer/stakeholder quotes that make the value concrete and testable.",
+    },
+    {
+        id: "PRESS_RELEASE",
+        displayName: "Future Press Release",
+        description: "Amazon Working-Backwards future press release: forces clarity on the outcome you're building toward.",
+    },
+    {
+        id: "DISCOVERY",
+        displayName: "Discovery & Validation Plan",
+        description: "A concrete plan to validate the riskiest assumptions before you over-invest.",
+    },
+    {
+        id: "GAP",
+        displayName: "Gap Analysis",
+        description: "Surfaces gaps between today's reality and the proposition: what must be true to win.",
+    },
+    {
+        id: "VALUE_STACK",
+        displayName: "Value Stack",
+        description: "Builds the value stack and pressure-tests it against the 'do nothing / DIY' alternative.",
+    },
+    {
+        id: "MOAT",
+        displayName: "Moat Deep Dive",
+        description: "Assesses durable advantage: what stops a competitor from copying this within a year.",
+    },
+    {
+        id: "UNIT_ECON",
+        displayName: "Unit Economics",
+        description: "Unit economics, cost-to-serve, pricing mechanics, and revenue scenarios: does the model pay?",
+    },
+    {
+        id: "TOP_QUESTIONS",
+        displayName: "Top Questions & Action Plan",
+        description: "The critical unanswered questions plus an action plan to resolve them.",
+    },
+    {
+        id: "IDEAS",
+        displayName: "Five Additional Ideas",
+        description: "Five adjacent initiative or investment ideas worth exploring next.",
+    },
+];
+//# sourceMappingURL=manifest.js.map

package/dist/mcp/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/mcp/manifest.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,OAAO,GAA0B;IAC5C;QACE,EAAE,EAAE,cAAc;QAClB,WAAW,EAAE,mBAAmB;QAChC,WAAW,EACT,4IAA4I;KAC/I;IACD;QACE,EAAE,EAAE,OAAO;QACX,WAAW,EAAE,iBAAiB;QAC9B,WAAW,EACT,kIAAkI;KACrI;IACD;QACE,EAAE,EAAE,YAAY;QAChB,WAAW,EAAE,qBAAqB;QAClC,WAAW,EACT,sHAAsH;KACzH;IACD;QACE,EAAE,EAAE,KAAK;QACT,WAAW,EAAE,wBAAwB;QACrC,WAAW,EACT,gFAAgF;KACnF;IACD;QACE,EAAE,EAAE,MAAM;QACV,WAAW,EAAE,iBAAiB;QAC9B,WAAW,EACT,oGAAoG;KACvG;IACD;QACE,EAAE,EAAE,aAAa;QACjB,WAAW,EAAE,uBAAuB;QACpC,WAAW,EACT,uFAAuF;KAC1F;IACD;QACE,EAAE,EAAE,aAAa;QACjB,WAAW,EAAE,uBAAuB;QACpC,WAAW,EACT,+FAA+F;KAClG;IACD;QACE,EAAE,EAAE,SAAS;QACb,WAAW,EAAE,kBAAkB;QAC/B,WAAW,EACT,kFAAkF;KACrF;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,WAAW,EAAE,iBAAiB;QAC9B,WAAW,EACT,qFAAqF;KACxF;IACD;QACE,EAAE,EAAE,eAAe;QACnB,WAAW,EAAE,sBAAsB;QACnC,WAAW,EACT,sGAAsG;KACzG;IACD;QACE,EAAE,EAAE,WAAW;QACf,WAAW,EAAE,6BAA6B;QAC1C,WAAW,EACT,8EAA8E;KACjF;IACD;QACE,EAAE,EAAE,KAAK;QACT,WAAW,EAAE,cAAc;QAC3B,WAAW,EACT,sFAAsF;KACzF;IACD;QACE,EAAE,EAAE,aAAa;QACjB,WAAW,EAAE,aAAa;QAC1B,WAAW,EACT,0FAA0F;KAC7F;IACD;QACE,EAAE,EAAE,MAAM;QACV,WAAW,EAAE,gBAAgB;QAC7B,WAAW,EACT,sFAAsF;KACzF;IACD;QACE,EAAE,EAAE,WAAW;QACf,WAAW,EAAE,gBAAgB;QAC7B,WAAW,EACT,8FAA8F;KACjG;IACD;QACE,EAAE,EAAE,eAAe;QACnB,WAAW,EAAE,6BAA6B;QAC1C,WAAW,EACT,wEAAwE;KAC3E;IACD;QACE,EAAE,EAAE,OAAO;QACX,WAAW,EAAE,uBAAuB;QACpC,WAAW,EACT,oEAAoE;KACvE;CACF,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,25 @@
+export interface McpServerOptions {
+    /** Override config dir (used by tests). */
+    configDir?: string;
+    /** Override base URL (used by tests + dev). */
+    baseUrl?: string;
+    /** Override fetch (used by tests). */
+    fetchImpl?: typeof fetch;
+    /** Override stderr writer (used by tests). */
+    stderr?: (line: string) => void;
+}
+export interface ResolvedToken {
+    token: string;
+    source: "env" | "config";
+}
+/**
+ * Resolve the MCP bearer token from env > config. Throws a clear error if
+ * neither source has one.
+ */
+export declare function resolveMcpToken(opts?: McpServerOptions): Promise<ResolvedToken>;
+/**
+ * Run the stdio MCP server until the transport closes.
+ *
+ * Returns when the transport disconnects (which under stdio means stdin EOF).
+ */
+export declare function runMcpServer(opts?: McpServerOptions): Promise<void>;

package/dist/mcp/server.js

@@ -0,0 +1,166 @@
+/**
+ * Minimal MCP stdio server for `seanpropapp mcp`.
+ *
+ * v0.1.0-alpha scope:
+ *  - Reads bearer token from `~/.seanpropapp/config.json` (`mcp_token` field)
+ *    or `SEANPROPAPP_MCP_TOKEN` env override.
+ *  - Exposes one tool (`run_module`) plus one prompt per methodology module,
+ *    mirroring the existing `@seanpropapp/mcp` surface so Claude Desktop /
+ *    Cursor configs continue to work.
+ *  - Routes every assemble call to the production prompt-assembly endpoint
+ *    (`/api/mcp/assemble-prompt`). The server never sees the LLM response;
+ *    the host's LLM does inference using the user's own subscription.
+ *
+ * Out of scope (deferred to v1.4.0 full migration):
+ *  - Streaming, multi-region routing, local methodology caching.
+ *  - Telemetry beyond stderr session-ready line.
+ *
+ * Migration tracker: see proposition-app#341 + the README "MCP" section.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { randomUUID } from "node:crypto";
+import { z } from "zod";
+import { MODULES } from "./manifest.js";
+import { loadConfig } from "../config.js";
+import { CLI_VERSION } from "../version.js";
+/**
+ * Resolve the MCP bearer token from env > config. Throws a clear error if
+ * neither source has one.
+ */
+export async function resolveMcpToken(opts = {}) {
+    const env = process.env["SEANPROPAPP_MCP_TOKEN"];
+    if (env && env.trim())
+        return { token: env.trim(), source: "env" };
+    const cfg = await loadConfig(opts.configDir);
+    if (cfg.mcp_token && cfg.mcp_token.trim()) {
+        return { token: cfg.mcp_token.trim(), source: "config" };
+    }
+    throw new Error("No MCP token found. Generate one at https://prop.seanoneill.com/mcp-setup, " +
+        'then either set SEANPROPAPP_MCP_TOKEN or run `seanpropapp pair` and paste the token into ~/.seanpropapp/config.json under "mcp_token".');
+}
+/**
+ * Run the stdio MCP server until the transport closes.
+ *
+ * Returns when the transport disconnects (which under stdio means stdin EOF).
+ */
+export async function runMcpServer(opts = {}) {
+    const baseUrl = (opts.baseUrl ??
+        process.env["SEANPROPAPP_MCP_URL"] ??
+        "https://prop.seanoneill.com").replace(/\/$/, "");
+    const fetchImpl = opts.fetchImpl ?? fetch;
+    const stderr = opts.stderr ?? ((s) => process.stderr.write(s));
+    const { token, source } = await resolveMcpToken(opts);
+    // One id per process launch, forwarded on every call. Lets the server count
+    // distinct sessions without PII.
+    const sessionId = randomUUID();
+    const server = new McpServer({
+        name: "SeanPropApp",
+        version: CLI_VERSION,
+    });
+    function callerHost() {
+        return server.server.getClientVersion()?.name ?? "unknown";
+    }
+    async function assemble(args) {
+        const res = await fetchImpl(`${baseUrl}/api/mcp/assemble-prompt`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${token}`,
+                "X-MCP-Session": sessionId,
+                "X-MCP-Client": callerHost(),
+                "X-MCP-Transport": "seanpropapp-cli",
+            },
+            body: JSON.stringify({
+                moduleId: args.moduleId,
+                company: args.company,
+                persona: args.persona,
+                initiativeName: args.initiative,
+                investorQuestions: args.keyQuestion,
+                priorOutputs: args.priorOutputs,
+            }),
+        });
+        if (!res.ok) {
+            const err = (await res.json().catch(() => ({})));
+            const detail = err.message || err.error || `request failed (${res.status})`;
+            throw new Error(`SeanPropApp: ${detail}`);
+        }
+        return (await res.json());
+    }
+    const moduleIds = MODULES.map((m) => m.id);
+    server.registerTool("run_module", {
+        title: "Run a SeanPropApp methodology module",
+        description: "Assemble a SeanPropApp proposition-analysis module and return its instructions for you to execute. " +
+            "Run SETUP first for any new company. Pass `initiative` to focus on a specific What-If; pass `keyQuestion` to anchor the analysis. " +
+            "For continuity, pass earlier module outputs in `priorOutputs`. " +
+            `Available modules: ${moduleIds.join(", ")}.`,
+        inputSchema: {
+            moduleId: z
+                .enum(moduleIds)
+                .describe("Which methodology module to run (start with SETUP)"),
+            company: z.string().describe("The company or product being analyzed"),
+            persona: z
+                .enum(["internal_leader", "investor"])
+                .optional()
+                .describe("Analysis lens; defaults to internal_leader."),
+            initiative: z
+                .string()
+                .optional()
+                .describe("Optional What-If hypothesis to focus the analysis on."),
+            keyQuestion: z
+                .string()
+                .optional()
+                .describe("Optional key question the user wants answered."),
+            priorOutputs: z
+                .record(z.string(), z.string())
+                .optional()
+                .describe("Map of prior module id to its output text."),
+        },
+    }, async ({ moduleId, company, persona, initiative, keyQuestion, priorOutputs, }) => {
+        const a = await assemble({
+            moduleId,
+            company,
+            persona,
+            initiative,
+            keyQuestion,
+            priorOutputs,
+        });
+        const text = [a.systemPrompt, "", "---", "", a.userMessage].join("\n");
+        return { content: [{ type: "text", text }] };
+    });
+    // Prompt surface (Claude Desktop menu): one prompt per module.
+    for (const m of MODULES) {
+        server.registerPrompt(m.id, {
+            title: m.displayName,
+            description: m.description,
+            argsSchema: {
+                company: z.string().describe("The company or product being analyzed"),
+                persona: z.enum(["internal_leader", "investor"]).optional(),
+                initiative: z.string().optional(),
+                keyQuestion: z.string().optional(),
+            },
+        }, async ({ company, persona, initiative, keyQuestion }) => {
+            const a = await assemble({
+                moduleId: m.id,
+                company,
+                persona,
+                initiative,
+                keyQuestion,
+            });
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: `${a.systemPrompt}\n\n${a.userMessage}`,
+                        },
+                    },
+                ],
+            };
+        });
+    }
+    await server.connect(new StdioServerTransport());
+    stderr(`SeanPropApp MCP server ready (${baseUrl}, session ${sessionId}, token from ${source}).\n`);
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/providers/base.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Common provider interface. Each provider wraps a local subscription CLI
+ * (Claude CLI, Codex CLI, future Gemini CLI) and exposes a streaming API in
+ * Anthropic's Messages SSE shape.
+ *
+ * The bridge speaks both Anthropic and OpenAI wire formats; providers
+ * normalize to Anthropic internally and the OpenAI endpoint translates
+ * on the way out.
+ */
+export interface AnthropicMessage {
+    role: "user" | "assistant" | "system";
+    content: string | Array<{
+        type: string;
+        text?: string;
+    }>;
+}
+export interface AnthropicLikeRequest {
+    model: string;
+    max_tokens?: number;
+    system?: string;
+    messages: AnthropicMessage[];
+    stream?: boolean;
+    temperature?: number;
+}
+export type AnthropicSSEEvent = {
+    type: "message_start";
+    message: {
+        id: string;
+        model: string;
+    };
+} | {
+    type: "content_block_start";
+    index: number;
+    content_block: {
+        type: "text";
+        text: string;
+    };
+} | {
+    type: "content_block_delta";
+    index: number;
+    delta: {
+        type: "text_delta";
+        text: string;
+    };
+} | {
+    type: "content_block_stop";
+    index: number;
+} | {
+    type: "message_delta";
+    delta: {
+        stop_reason: string | null;
+    };
+    usage?: {
+        output_tokens: number;
+    };
+} | {
+    type: "message_stop";
+} | {
+    type: "error";
+    error: {
+        type: string;
+        message: string;
+        retry_after_seconds?: number;
+    };
+};
+export interface ProviderDetectResult {
+    installed: boolean;
+    binary?: string;
+    version?: string;
+    reason?: string;
+}
+export interface Provider {
+    readonly name: string;
+    detect(): Promise<ProviderDetectResult>;
+    stream(request: AnthropicLikeRequest, signal?: AbortSignal): AsyncIterable<AnthropicSSEEvent>;
+}
+/**
+ * Error category emitted when a provider's underlying CLI reports a
+ * subscription rate-limit (Claude Pro window cap, ChatGPT Plus cap, etc.).
+ * The browser maps this to ProviderErrorBlock's subscription_limit subtype.
+ */
+export declare class ClassifiedError extends Error {
+    readonly category: "subscription_limit" | "auth_required" | "cli_missing" | "cli_crashed" | "short_output" | "unknown";
+    readonly retryAfterSeconds?: number;
+    readonly provider?: string;
+    constructor(message: string, opts: {
+        category: ClassifiedError["category"];
+        retryAfterSeconds?: number;
+        provider?: string;
+    });
+}

package/dist/providers/base.js

@@ -0,0 +1,27 @@
+/**
+ * Common provider interface. Each provider wraps a local subscription CLI
+ * (Claude CLI, Codex CLI, future Gemini CLI) and exposes a streaming API in
+ * Anthropic's Messages SSE shape.
+ *
+ * The bridge speaks both Anthropic and OpenAI wire formats; providers
+ * normalize to Anthropic internally and the OpenAI endpoint translates
+ * on the way out.
+ */
+/**
+ * Error category emitted when a provider's underlying CLI reports a
+ * subscription rate-limit (Claude Pro window cap, ChatGPT Plus cap, etc.).
+ * The browser maps this to ProviderErrorBlock's subscription_limit subtype.
+ */
+export class ClassifiedError extends Error {
+    category;
+    retryAfterSeconds;
+    provider;
+    constructor(message, opts) {
+        super(message);
+        this.name = "ClassifiedError";
+        this.category = opts.category;
+        this.retryAfterSeconds = opts.retryAfterSeconds;
+        this.provider = opts.provider;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/providers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAyCH;;;;GAIG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxB,QAAQ,CAMV;IACE,iBAAiB,CAAU;IAC3B,QAAQ,CAAU;IAElC,YACE,OAAe,EACf,IAIC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAChC,CAAC;CACF"}

package/dist/providers/claude.d.ts

@@ -0,0 +1,22 @@
+import { spawn } from "node:child_process";
+import { type AnthropicLikeRequest, type AnthropicSSEEvent, type Provider, type ProviderDetectResult } from "./base.js";
+import { runCapture } from "./detect-util.js";
+/**
+ * Override hooks for testing. The provider takes optional injectables so we
+ * can mock subprocess behavior without complex module mocks.
+ */
+export interface ClaudeProviderDeps {
+    whichFn?: (bin: string) => Promise<string | null>;
+    runCaptureFn?: typeof runCapture;
+    spawnFn?: typeof spawn;
+    binaryName?: string;
+}
+export declare function detectRateLimit(text: string): boolean;
+export declare function parseRetryAfter(text: string): number | undefined;
+export declare class ClaudeProvider implements Provider {
+    readonly name = "claude";
+    private readonly deps;
+    constructor(deps?: ClaudeProviderDeps);
+    detect(): Promise<ProviderDetectResult>;
+    stream(request: AnthropicLikeRequest, signal?: AbortSignal): AsyncIterable<AnthropicSSEEvent>;
+}

package/dist/providers/claude.js

@@ -0,0 +1,157 @@
+import { spawn } from "node:child_process";
+import { ClassifiedError, } from "./base.js";
+import { runCapture, which } from "./detect-util.js";
+const DEFAULT_BINARY = "claude";
+const RATE_LIMIT_PATTERNS = [
+    /rate.?limit/i,
+    /429/,
+    /too many requests/i,
+    /subscription.*limit/i,
+    /window.*capped/i,
+];
+const RETRY_AFTER_PATTERNS = [
+    /retry.?after[:\s]+(\d+)\s*s/i,
+    /retry.?after[:\s]+(\d+)/i,
+    /try again in\s+(\d+)\s*s/i,
+];
+export function detectRateLimit(text) {
+    return RATE_LIMIT_PATTERNS.some((re) => re.test(text));
+}
+export function parseRetryAfter(text) {
+    for (const re of RETRY_AFTER_PATTERNS) {
+        const m = re.exec(text);
+        if (m && m[1]) {
+            const n = Number(m[1]);
+            if (Number.isFinite(n) && n >= 0)
+                return n;
+        }
+    }
+    return undefined;
+}
+function lastUserText(req) {
+    for (let i = req.messages.length - 1; i >= 0; i--) {
+        const m = req.messages[i];
+        if (!m)
+            continue;
+        if (m.role !== "user")
+            continue;
+        if (typeof m.content === "string")
+            return m.content;
+        return m.content
+            .filter((block) => block.type === "text" && typeof block.text === "string")
+            .map((block) => block.text ?? "")
+            .join("\n");
+    }
+    return "";
+}
+export class ClaudeProvider {
+    name = "claude";
+    deps;
+    constructor(deps = {}) {
+        this.deps = {
+            whichFn: deps.whichFn ?? which,
+            runCaptureFn: deps.runCaptureFn ?? runCapture,
+            spawnFn: deps.spawnFn ?? spawn,
+            binaryName: deps.binaryName ?? DEFAULT_BINARY,
+        };
+    }
+    async detect() {
+        const binary = await this.deps.whichFn(this.deps.binaryName);
+        if (!binary) {
+            return { installed: false, reason: "claude binary not found in PATH" };
+        }
+        const versionRun = await this.deps.runCaptureFn(binary, ["--version"], {
+            timeoutMs: 5000,
+        });
+        const version = versionRun.stdout.trim().split(/\s+/).pop() || versionRun.stderr.trim();
+        return { installed: true, binary, version: version || undefined };
+    }
+    async *stream(request, signal) {
+        const detected = await this.detect();
+        if (!detected.installed || !detected.binary) {
+            throw new ClassifiedError("Claude CLI not installed", {
+                category: "cli_missing",
+                provider: this.name,
+            });
+        }
+        const args = ["--print", "--model", request.model];
+        if (request.system) {
+            args.push("--system-prompt", request.system);
+        }
+        const stdinPayload = lastUserText(request);
+        const child = this.deps.spawnFn(detected.binary, args, {
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        const stderrChunks = [];
+        child.stderr?.on("data", (chunk) => {
+            stderrChunks.push(chunk.toString());
+        });
+        const abortHandler = () => {
+            child.kill("SIGTERM");
+        };
+        signal?.addEventListener("abort", abortHandler);
+        if (child.stdin) {
+            child.stdin.end(stdinPayload);
+        }
+        const messageId = `msg_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+        yield { type: "message_start", message: { id: messageId, model: request.model } };
+        yield {
+            type: "content_block_start",
+            index: 0,
+            content_block: { type: "text", text: "" },
+        };
+        try {
+            let totalOut = "";
+            if (child.stdout) {
+                for await (const chunk of child.stdout) {
+                    const text = typeof chunk === "string" ? chunk : chunk.toString();
+                    if (text.length === 0)
+                        continue;
+                    totalOut += text;
+                    // Check stdout for rate-limit signals too (CLIs sometimes write to stdout).
+                    if (detectRateLimit(text)) {
+                        const retryAfter = parseRetryAfter(text);
+                        throw new ClassifiedError("Subscription rate limit", {
+                            category: "subscription_limit",
+                            retryAfterSeconds: retryAfter,
+                            provider: this.name,
+                        });
+                    }
+                    yield {
+                        type: "content_block_delta",
+                        index: 0,
+                        delta: { type: "text_delta", text },
+                    };
+                }
+            }
+            const exitCode = await new Promise((resolve) => {
+                if (child.exitCode !== null)
+                    return resolve(child.exitCode);
+                child.once("close", (code) => resolve(code));
+            });
+            const stderr = stderrChunks.join("");
+            if (exitCode !== 0) {
+                if (detectRateLimit(stderr) || detectRateLimit(totalOut)) {
+                    const retryAfter = parseRetryAfter(stderr) ?? parseRetryAfter(totalOut);
+                    throw new ClassifiedError("Subscription rate limit", {
+                        category: "subscription_limit",
+                        retryAfterSeconds: retryAfter,
+                        provider: this.name,
+                    });
+                }
+                throw new ClassifiedError(`Claude CLI exited with code ${exitCode}: ${stderr.slice(0, 500)}`, { category: "cli_crashed", provider: this.name });
+            }
+            yield { type: "content_block_stop", index: 0 };
+            yield {
+                type: "message_delta",
+                delta: { stop_reason: "end_turn" },
+                usage: { output_tokens: 0 },
+            };
+            yield { type: "message_stop" };
+        }
+        finally {
+            signal?.removeEventListener("abort", abortHandler);
+        }
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/providers/claude.js.map

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

package/dist/providers/codex.d.ts

@@ -0,0 +1,38 @@
+import { spawn } from "node:child_process";
+import { type AnthropicLikeRequest, type AnthropicSSEEvent, type Provider, type ProviderDetectResult } from "./base.js";
+import { runCapture } from "./detect-util.js";
+export interface CodexProviderDeps {
+    whichFn?: (bin: string) => Promise<string | null>;
+    runCaptureFn?: typeof runCapture;
+    spawnFn?: typeof spawn;
+    binaryName?: string;
+}
+/**
+ * OpenAI Chat Completion format used internally before translating back
+ * to Anthropic SSE for the bridge's unified output.
+ */
+export interface OpenAIChatMessage {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+export interface OpenAIChatRequest {
+    model: string;
+    messages: OpenAIChatMessage[];
+    max_tokens?: number;
+    temperature?: number;
+    stream?: boolean;
+}
+/**
+ * Translate Anthropic Messages → OpenAI Chat Completions shape.
+ * Exported so tests can verify the translation surface directly.
+ */
+export declare function anthropicToOpenAI(req: AnthropicLikeRequest): OpenAIChatRequest;
+export declare function detectRateLimit(text: string): boolean;
+export declare function parseRetryAfter(text: string): number | undefined;
+export declare class CodexProvider implements Provider {
+    readonly name = "codex";
+    private readonly deps;
+    constructor(deps?: CodexProviderDeps);
+    detect(): Promise<ProviderDetectResult>;
+    stream(request: AnthropicLikeRequest, signal?: AbortSignal): AsyncIterable<AnthropicSSEEvent>;
+}