@scanton/phase2s 0.13.0

package/dist/src/core/conversation.js.map

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

package/dist/src/core/memory.d.ts

@@ -0,0 +1,24 @@
+export interface Learning {
+    key: string;
+    insight: string;
+    confidence?: number;
+    type?: string;
+    ts?: string;
+}
+/**
+ * Load learnings from .phase2s/memory/learnings.jsonl.
+ *
+ * Returns an empty array if the file doesn't exist (first session, normal case).
+ * Invalid JSON lines are skipped silently — a corrupted line shouldn't block
+ * the rest of memory from loading.
+ */
+export declare function loadLearnings(cwd: string): Promise<Learning[]>;
+/**
+ * Format learnings for injection into the system prompt.
+ *
+ * Returns an empty string if there are no learnings (no injection).
+ * Trims oldest learnings first if the total character count exceeds MAX_LEARNINGS_CHARS.
+ * This keeps the most recent decisions and preferences, which are most relevant.
+ */
+export declare function formatLearningsForPrompt(learnings: Learning[]): string;
+//# sourceMappingURL=memory.d.ts.map

package/dist/src/core/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/core/memory.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAKD;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAyBpE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAmBtE"}

package/dist/src/core/memory.js

@@ -0,0 +1,65 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+const LEARNINGS_FILE = ".phase2s/memory/learnings.jsonl";
+const MAX_LEARNINGS_CHARS = 2000;
+/**
+ * Load learnings from .phase2s/memory/learnings.jsonl.
+ *
+ * Returns an empty array if the file doesn't exist (first session, normal case).
+ * Invalid JSON lines are skipped silently — a corrupted line shouldn't block
+ * the rest of memory from loading.
+ */
+export async function loadLearnings(cwd) {
+    const filePath = join(cwd, LEARNINGS_FILE);
+    let raw;
+    try {
+        raw = await readFile(filePath, "utf-8");
+    }
+    catch {
+        return [];
+    }
+    const results = [];
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            // Require key and insight as non-empty strings — minimum viable learning
+            if (typeof parsed.key === "string" && parsed.key.length > 0 &&
+                typeof parsed.insight === "string" && parsed.insight.length > 0) {
+                results.push(parsed);
+            }
+        }
+        catch {
+            // Skip invalid lines silently — don't block session startup on parse errors
+        }
+    }
+    return results;
+}
+/**
+ * Format learnings for injection into the system prompt.
+ *
+ * Returns an empty string if there are no learnings (no injection).
+ * Trims oldest learnings first if the total character count exceeds MAX_LEARNINGS_CHARS.
+ * This keeps the most recent decisions and preferences, which are most relevant.
+ */
+export function formatLearningsForPrompt(learnings) {
+    if (learnings.length === 0)
+        return "";
+    const lines = learnings.map((l) => `- [${l.key}]: ${l.insight}`);
+    // Trim oldest first (front of array) until within char budget
+    let trimmed = [...lines];
+    while (trimmed.join("\n").length > MAX_LEARNINGS_CHARS && trimmed.length > 0) {
+        trimmed = trimmed.slice(1);
+    }
+    if (trimmed.length === 0)
+        return "";
+    return [
+        "## Project memory",
+        "The following learnings from previous sessions apply to this project:",
+        ...trimmed,
+        `(${trimmed.length} learning${trimmed.length === 1 ? "" : "s"} loaded from .phase2s/memory/learnings.jsonl)`,
+    ].join("\n");
+}
+//# sourceMappingURL=memory.js.map

package/dist/src/core/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/core/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAUjC,MAAM,cAAc,GAAG,iCAAiC,CAAC;AACzD,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC3C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAa,CAAC;YAC/C,yEAAyE;YACzE,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC;gBACvD,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,4EAA4E;QAC9E,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,SAAqB;IAC5D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEtC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAEjE,8DAA8D;IAC9D,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACzB,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,mBAAmB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7E,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,OAAO;QACL,mBAAmB;QACnB,uEAAuE;QACvE,GAAG,OAAO;QACV,IAAI,OAAO,CAAC,MAAM,YAAY,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,+CAA+C;KAC7G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/src/mcp/server.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Phase2S MCP server.
+ *
+ * Implements the Model Context Protocol (JSON-RPC 2.0 over stdio) so that
+ * Claude Code can invoke Phase2S skills as tools. Every SKILL.md file in
+ * .phase2s/skills/ becomes a Claude Code tool dynamically at server startup.
+ *
+ * Transport: stdio (one JSON message per line, responses on stdout).
+ * Protocol: MCP 2024-11-05.
+ *
+ * Start via: phase2s mcp
+ * Configure in: .claude/settings.json
+ */
+import type { Skill } from "../skills/types.js";
+export declare const MCP_SERVER_VERSION = "0.13.0";
+interface JSONRPCRequest {
+    jsonrpc: "2.0";
+    id: number | string | null;
+    method: string;
+    params?: unknown;
+}
+interface JSONRPCResponse {
+    jsonrpc: "2.0";
+    id: number | string | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+    };
+}
+export interface MCPTool {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required: string[];
+    };
+}
+/**
+ * Convert a Phase2S Skill into an MCP tool descriptor.
+ *
+ * Naming convention: `phase2s__<skill-name-with-underscores>`
+ * e.g. "adversarial" → "phase2s__adversarial"
+ *      "consensus-plan" → "phase2s__consensus_plan"
+ */
+export declare function skillToTool(skill: Skill): MCPTool;
+/**
+ * Reverse the tool naming convention back to a skill name.
+ * "phase2s__consensus_plan" → "consensus-plan"
+ */
+export declare function toolNameToSkillName(toolName: string): string;
+/**
+ * Handle a single JSON-RPC request and return the response.
+ *
+ * Exported so tests can call it directly without stdio.
+ *
+ * @param request  Parsed JSON-RPC request
+ * @param skills   Loaded Phase2S skills (passed in so tests can inject fixtures)
+ * @param cwd      Working directory for config loading and agent runs
+ */
+export declare function handleRequest(request: JSONRPCRequest, skills: Skill[], cwd: string): Promise<JSONRPCResponse>;
+/**
+ * Start the MCP server. Reads JSON-RPC messages from stdin, writes responses
+ * to stdout. Runs until stdin closes (i.e. Claude Code terminates the session).
+ *
+ * Uses a manual event-queue pattern (same as the CLI REPL) to avoid the known
+ * issue where the readline async iterator terminates if the event loop drains
+ * while awaiting between messages.
+ */
+export declare function runMCPServer(cwd: string): Promise<void>;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/src/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAM3C,UAAU,cAAc;IACtB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAejD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5D;AAMD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,KAAK,EAAE,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,CAAC,CA+E1B;AAMD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmE7D"}

package/dist/src/mcp/server.js

@@ -0,0 +1,215 @@
+/**
+ * Phase2S MCP server.
+ *
+ * Implements the Model Context Protocol (JSON-RPC 2.0 over stdio) so that
+ * Claude Code can invoke Phase2S skills as tools. Every SKILL.md file in
+ * .phase2s/skills/ becomes a Claude Code tool dynamically at server startup.
+ *
+ * Transport: stdio (one JSON message per line, responses on stdout).
+ * Protocol: MCP 2024-11-05.
+ *
+ * Start via: phase2s mcp
+ * Configure in: .claude/settings.json
+ */
+import { createInterface } from "node:readline";
+import { loadSkillsFromDir } from "../skills/loader.js";
+import { loadConfig } from "../core/config.js";
+import { Agent } from "../core/agent.js";
+import { join } from "node:path";
+export const MCP_SERVER_VERSION = "0.13.0";
+// ---------------------------------------------------------------------------
+// Tool generation
+// ---------------------------------------------------------------------------
+/**
+ * Convert a Phase2S Skill into an MCP tool descriptor.
+ *
+ * Naming convention: `phase2s__<skill-name-with-underscores>`
+ * e.g. "adversarial" → "phase2s__adversarial"
+ *      "consensus-plan" → "phase2s__consensus_plan"
+ */
+export function skillToTool(skill) {
+    return {
+        name: `phase2s__${skill.name.replace(/-/g, "_")}`,
+        description: skill.description || `Run the ${skill.name} skill`,
+        inputSchema: {
+            type: "object",
+            properties: {
+                prompt: {
+                    type: "string",
+                    description: `Task or content for the ${skill.name} skill. Paste the text you want analyzed or acted on.`,
+                },
+            },
+            required: ["prompt"],
+        },
+    };
+}
+/**
+ * Reverse the tool naming convention back to a skill name.
+ * "phase2s__consensus_plan" → "consensus-plan"
+ */
+export function toolNameToSkillName(toolName) {
+    return toolName.replace(/^phase2s__/, "").replace(/_/g, "-");
+}
+// ---------------------------------------------------------------------------
+// Request handler (exported for testing)
+// ---------------------------------------------------------------------------
+/**
+ * Handle a single JSON-RPC request and return the response.
+ *
+ * Exported so tests can call it directly without stdio.
+ *
+ * @param request  Parsed JSON-RPC request
+ * @param skills   Loaded Phase2S skills (passed in so tests can inject fixtures)
+ * @param cwd      Working directory for config loading and agent runs
+ */
+export async function handleRequest(request, skills, cwd) {
+    // -----------------------------------------------------------------------
+    // initialize
+    // -----------------------------------------------------------------------
+    if (request.method === "initialize") {
+        return {
+            jsonrpc: "2.0",
+            id: request.id,
+            result: {
+                protocolVersion: "2024-11-05",
+                capabilities: { tools: {} },
+                serverInfo: { name: "phase2s", version: MCP_SERVER_VERSION },
+            },
+        };
+    }
+    // -----------------------------------------------------------------------
+    // tools/list
+    // -----------------------------------------------------------------------
+    if (request.method === "tools/list") {
+        return {
+            jsonrpc: "2.0",
+            id: request.id,
+            result: { tools: skills.map(skillToTool) },
+        };
+    }
+    // -----------------------------------------------------------------------
+    // tools/call
+    // -----------------------------------------------------------------------
+    if (request.method === "tools/call") {
+        const params = request.params;
+        const toolName = params?.name ?? "";
+        const skillName = toolNameToSkillName(toolName);
+        const skill = skills.find((s) => s.name === skillName);
+        if (!skill) {
+            return {
+                jsonrpc: "2.0",
+                id: request.id,
+                error: { code: -32601, message: `Tool not found: ${toolName}` },
+            };
+        }
+        const userPrompt = params?.arguments?.prompt ?? "";
+        // Prepend the skill's system prompt to the user's content
+        const fullPrompt = skill.promptTemplate + (userPrompt ? `\n\n## Input\n\n${userPrompt}` : "");
+        try {
+            const config = await loadConfig();
+            const agent = new Agent({ config });
+            const text = await agent.run(fullPrompt, { modelOverride: skill.model });
+            return {
+                jsonrpc: "2.0",
+                id: request.id,
+                result: {
+                    content: [{ type: "text", text }],
+                },
+            };
+        }
+        catch (err) {
+            return {
+                jsonrpc: "2.0",
+                id: request.id,
+                error: {
+                    code: -32603,
+                    message: err instanceof Error ? err.message : String(err),
+                },
+            };
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Unknown method
+    // -----------------------------------------------------------------------
+    return {
+        jsonrpc: "2.0",
+        id: request.id,
+        error: { code: -32601, message: `Method not found: ${request.method}` },
+    };
+}
+// ---------------------------------------------------------------------------
+// Server entry point
+// ---------------------------------------------------------------------------
+/**
+ * Start the MCP server. Reads JSON-RPC messages from stdin, writes responses
+ * to stdout. Runs until stdin closes (i.e. Claude Code terminates the session).
+ *
+ * Uses a manual event-queue pattern (same as the CLI REPL) to avoid the known
+ * issue where the readline async iterator terminates if the event loop drains
+ * while awaiting between messages.
+ */
+export async function runMCPServer(cwd) {
+    const skillsDir = join(cwd, ".phase2s", "skills");
+    const skills = await loadSkillsFromDir(skillsDir);
+    const respond = (response) => {
+        process.stdout.write(JSON.stringify(response) + "\n");
+    };
+    // Manual event queue — safer than readline async iterator for long-lived servers
+    const lineQueue = [];
+    let pendingResolve = null;
+    let isOpen = true;
+    const rl = createInterface({ input: process.stdin, terminal: false });
+    rl.on("line", (line) => {
+        if (pendingResolve) {
+            const resolve = pendingResolve;
+            pendingResolve = null;
+            resolve(line);
+        }
+        else {
+            lineQueue.push(line);
+        }
+    });
+    rl.on("close", () => {
+        isOpen = false;
+        if (pendingResolve) {
+            pendingResolve(null);
+            pendingResolve = null;
+        }
+        // Force exit so any in-flight codex subprocess doesn't keep us alive after
+        // Claude Code has closed the connection. The "exit" event still fires on
+        // process.exit(), so codex.ts cleanupTempDirs() runs before we die.
+        process.exit(0);
+    });
+    const nextLine = () => {
+        if (lineQueue.length > 0)
+            return Promise.resolve(lineQueue.shift());
+        if (!isOpen)
+            return Promise.resolve(null);
+        return new Promise((resolve) => {
+            pendingResolve = resolve;
+        });
+    };
+    while (true) {
+        const line = await nextLine();
+        if (line === null)
+            break; // stdin closed
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let request;
+        try {
+            request = JSON.parse(trimmed);
+        }
+        catch {
+            respond({
+                jsonrpc: "2.0",
+                id: null,
+                error: { code: -32700, message: "Parse error" },
+            });
+            continue;
+        }
+        const response = await handleRequest(request, skills, cwd);
+        respond(response);
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/src/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/src/providers/codex.d.ts

@@ -0,0 +1,28 @@
+import type { Config } from "../core/config.js";
+import type { Provider, Message, ProviderEvent } from "./types.js";
+import type { OpenAIFunctionDef } from "../tools/types.js";
+/**
+ * Codex CLI provider.
+ *
+ * Uses `codex exec` in fully non-interactive scripting mode:
+ *   --json                   suppresses the terminal UI (outputs JSONL instead)
+ *   --output-last-message    writes the final response to a temp file
+ *
+ * This means codex never needs to open /dev/tty, so it cannot corrupt
+ * the parent process's terminal/readline session.
+ *
+ * Real Codex streaming is deferred — the JSONL stdout format is undocumented.
+ * `chatStream()` wraps `_chat()` in a passthrough single-event generator
+ * (same batch UX as before, but through the Provider streaming interface).
+ * Tool calling is not supported via the --output-last-message mechanism;
+ * toolCalls is always [].
+ */
+export declare class CodexProvider implements Provider {
+    name: string;
+    private codexPath;
+    private model;
+    constructor(config: Config);
+    chatStream(messages: Message[], tools: OpenAIFunctionDef[], options?: import("./types.js").ChatStreamOptions): AsyncIterable<ProviderEvent>;
+    private _chat;
+}
+//# sourceMappingURL=codex.d.ts.map

package/dist/src/providers/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../../src/providers/codex.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAY,aAAa,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAsC3D;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC5C,IAAI,SAAe;IACnB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAS;gBAEV,MAAM,EAAE,MAAM;IAKnB,UAAU,CACf,QAAQ,EAAE,OAAO,EAAE,EACnB,KAAK,EAAE,iBAAiB,EAAE,EAC1B,OAAO,CAAC,EAAE,OAAO,YAAY,EAAE,iBAAiB,GAC/C,aAAa,CAAC,aAAa,CAAC;YAejB,KAAK;CAmGpB"}

package/dist/src/providers/codex.js

@@ -0,0 +1,162 @@
+import { spawn } from "node:child_process";
+import { rmSync } from "node:fs";
+import { mkdtemp, readFile, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+/** Track all temp dirs created this process so we can clean up on crash/exit. */
+const activeTempDirs = new Set();
+function cleanupTempDirs() {
+    // Synchronous cleanup — rmSync is available here (unlike the async rm).
+    for (const dir of activeTempDirs) {
+        try {
+            rmSync(dir, { recursive: true, force: true });
+        }
+        catch {
+            // Best-effort — ignore errors (e.g. already deleted by normal path)
+        }
+    }
+}
+/**
+ * Guard against double-registration if the module is evaluated multiple times.
+ * In vitest environments, modules may be re-evaluated between test files, which
+ * would register duplicate handlers and trigger MaxListenersExceededWarning.
+ */
+let _signalHandlersRegistered = false;
+if (!_signalHandlersRegistered) {
+    _signalHandlersRegistered = true;
+    process.on("exit", cleanupTempDirs);
+    // SIGTERM and SIGINT don't trigger "exit" automatically — register them explicitly
+    // so that temp dirs (which may contain prompt text) are cleaned up on Ctrl+C and kill.
+    process.on("SIGTERM", () => {
+        cleanupTempDirs();
+        process.exit(0);
+    });
+    process.on("SIGINT", () => {
+        cleanupTempDirs();
+        process.exit(0);
+    });
+}
+/**
+ * Codex CLI provider.
+ *
+ * Uses `codex exec` in fully non-interactive scripting mode:
+ *   --json                   suppresses the terminal UI (outputs JSONL instead)
+ *   --output-last-message    writes the final response to a temp file
+ *
+ * This means codex never needs to open /dev/tty, so it cannot corrupt
+ * the parent process's terminal/readline session.
+ *
+ * Real Codex streaming is deferred — the JSONL stdout format is undocumented.
+ * `chatStream()` wraps `_chat()` in a passthrough single-event generator
+ * (same batch UX as before, but through the Provider streaming interface).
+ * Tool calling is not supported via the --output-last-message mechanism;
+ * toolCalls is always [].
+ */
+export class CodexProvider {
+    name = "codex-cli";
+    codexPath;
+    model;
+    constructor(config) {
+        this.codexPath = config.codexPath;
+        this.model = config.model;
+    }
+    async *chatStream(messages, tools, options) {
+        const result = await this._chat(messages, tools, options?.model);
+        if (result.text) {
+            yield { type: "text", content: result.text };
+        }
+        // Codex provider currently always returns toolCalls: [] — tool calling
+        // is not supported via the --output-last-message mechanism.
+        if (result.toolCalls.length > 0) {
+            yield { type: "tool_calls", calls: result.toolCalls };
+            yield { type: "done", stopReason: "tool_calls" };
+        }
+        else {
+            yield { type: "done", stopReason: "stop" };
+        }
+    }
+    async _chat(messages, _tools, modelOverride) {
+        // Build the full prompt: system context + conversation history
+        const parts = [];
+        const systemMessages = messages.filter((m) => m.role === "system");
+        if (systemMessages.length > 0) {
+            parts.push(systemMessages.map((m) => m.content).join("\n"));
+            parts.push("---");
+        }
+        const nonSystem = messages.filter((m) => m.role !== "system");
+        for (const msg of nonSystem) {
+            if (msg.role === "user") {
+                parts.push(`User: ${msg.content}`);
+            }
+            else if (msg.role === "assistant" && msg.content) {
+                parts.push(`Assistant: ${msg.content}`);
+            }
+        }
+        const prompt = parts.join("\n\n");
+        // Use a temp dir for the output file so we don't pollute the project
+        const tmpDir = await mkdtemp(join(tmpdir(), "phase2s-"));
+        activeTempDirs.add(tmpDir);
+        const outputFile = join(tmpDir, "last-message.txt");
+        // codex exec --json suppresses the interactive UI (no /dev/tty access)
+        // --output-last-message writes the final response to a file we control
+        //
+        // The "--" separator signals end-of-flags to codex's own arg parser.
+        // Without it, a prompt beginning with "--" (e.g. "--help" or "--flags")
+        // would be misinterpreted as a codex CLI flag rather than as the prompt.
+        // spawn() with an array is NOT shell-injected, so this is the only risk.
+        const args = [
+            "exec",
+            "-m", modelOverride ?? this.model,
+            "--full-auto",
+            "-C", process.cwd(),
+            "--json",
+            "--output-last-message", outputFile,
+            "--",
+            prompt,
+        ];
+        return new Promise((resolve, reject) => {
+            const proc = spawn(this.codexPath, args, {
+                stdio: ["ignore", "pipe", "pipe"],
+                env: {
+                    ...process.env,
+                    NO_COLOR: "1",
+                    FORCE_COLOR: "0",
+                },
+            });
+            let stderr = "";
+            // Consume stdout (JSONL events) so the pipe buffer never fills and
+            // blocks codex. We don't parse it — we use --output-last-message instead.
+            proc.stdout.resume();
+            proc.stderr.on("data", (data) => {
+                stderr += data.toString();
+            });
+            proc.on("close", async (code) => {
+                // Try reading the output file first (most reliable)
+                try {
+                    const text = await readFile(outputFile, "utf-8");
+                    await rm(tmpDir, { recursive: true }).catch(() => { });
+                    activeTempDirs.delete(tmpDir);
+                    resolve({ text: text.trim(), toolCalls: [] });
+                    return;
+                }
+                catch {
+                    // Output file missing — fall through to error handling
+                }
+                await rm(tmpDir, { recursive: true }).catch(() => { });
+                activeTempDirs.delete(tmpDir);
+                if (code !== 0) {
+                    reject(new Error(`Codex exited with code ${code}: ${stderr.trim()}`));
+                    return;
+                }
+                // Unexpected: exited 0 but no output file
+                reject(new Error("Codex produced no output"));
+            });
+            proc.on("error", async (err) => {
+                await rm(tmpDir, { recursive: true }).catch(() => { });
+                activeTempDirs.delete(tmpDir);
+                reject(new Error(`Failed to spawn codex: ${err.message}`));
+            });
+        });
+    }
+}
+//# sourceMappingURL=codex.js.map

package/dist/src/providers/codex.js.map

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

package/dist/src/providers/index.d.ts

@@ -0,0 +1,6 @@
+import type { Config } from "../core/config.js";
+import type { Provider } from "./types.js";
+export declare function createProvider(config: Config): Provider;
+export type { Provider, Message, ToolCall, ProviderEvent } from "./types.js";
+export type { OpenAIClientLike } from "./openai.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CASvD;AAED,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC7E,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/providers/index.js

@@ -0,0 +1,13 @@
+import { CodexProvider } from "./codex.js";
+import { OpenAIProvider } from "./openai.js";
+export function createProvider(config) {
+    switch (config.provider) {
+        case "codex-cli":
+            return new CodexProvider(config);
+        case "openai-api":
+            return new OpenAIProvider(config);
+        default:
+            throw new Error(`Unknown provider: ${config.provider}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,WAAW;YACd,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;QACnC,KAAK,YAAY;YACf,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QACpC;YACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}