pulseed 0.0.1 → 0.1.0

package/dist/cli-runner.js

@@ -0,0 +1,396 @@
+#!/usr/bin/env node
+// ─── CLIRunner ───
+//
+// PulSeed CLI entry point. Wires all dependencies and exposes subcommands:
+//   pulseed run --goal <id>            Run CoreLoop once for a given goal
+//   pulseed goal add "<description>"   Negotiate and register a new goal (interactive)
+//   pulseed goal list                  List all registered goals
+//   pulseed goal archive <id>          Archive a completed goal
+//   pulseed goal show <id>             Show goal details
+//   pulseed goal reset <id>            Reset goal state for re-running
+//   pulseed status --goal <id>         Show current progress report
+//   pulseed report --goal <id>         Show latest report
+//   pulseed log --goal <id>            View execution/observation log
+//   pulseed start --goal <id>          Start daemon mode for one or more goals
+//   pulseed stop                       Stop the running daemon
+//   pulseed cron --goal <id>           Print crontab entry for a goal
+//   pulseed cleanup                    Archive all completed goals and remove stale data
+//   pulseed improve [path]             Analyze, suggest goals, and run improvement loop
+//   pulseed suggest "<context>"        Suggest improvement goals for a project
+//   pulseed capability list            List all registered capabilities
+//   pulseed capability remove <name>   Remove a capability by name
+//   pulseed knowledge list             List all shared knowledge entries
+//   pulseed knowledge search <query>   Search knowledge entries by keyword
+//   pulseed knowledge stats            Show knowledge base statistics
+import { parseArgs } from "node:util";
+import { getCliLogger } from "./cli/cli-logger.js";
+import { StateManager } from "./state-manager.js";
+import { CharacterConfigManager } from "./traits/character-config.js";
+// Commands
+import { cmdRun } from "./cli/commands/run.js";
+import { cmdStatus, cmdLog, cmdCleanup } from "./cli/commands/goal.js";
+import { dispatchGoalCommand } from "./cli/commands/goal-dispatch.js";
+import { cmdPluginList, cmdPluginInstall, cmdPluginRemove, cmdPluginUpdate, cmdPluginSearch } from "./cli/commands/plugin.js";
+import { cmdReport } from "./cli/commands/report.js";
+import { cmdProvider, cmdConfigCharacter, cmdDatasourceAdd, cmdDatasourceList, cmdDatasourceRemove, cmdDatasourceDedup, cmdCapabilityList, cmdCapabilityRemove, } from "./cli/commands/config.js";
+import { cmdStart, cmdStop, cmdCron } from "./cli/commands/daemon.js";
+import { cmdSuggest, cmdImprove } from "./cli/commands/suggest.js";
+import { cmdSetup } from "./cli/commands/setup.js";
+import { cmdKnowledgeList, cmdKnowledgeSearch, cmdKnowledgeStats } from "./cli/commands/knowledge.js";
+import { printUsage, formatOperationError } from "./cli/utils.js";
+import { ensureProviderConfig } from "./cli/ensure-api-key.js";
+const logger = getCliLogger();
+// ─── CLIRunner ───
+/**
+ * @description Coordinates CLI argument parsing, dependency wiring, and subcommand execution for the PulSeed command-line interface.
+ */
+export class CLIRunner {
+    stateManager;
+    characterConfigManager;
+    activeCoreLoop = null;
+    /**
+     * @description Creates a CLI runner with state and character configuration managers rooted at the optional base directory.
+     * @param {string} [baseDir] Optional base directory for PulSeed state storage.
+     * @returns {void} Does not return a value.
+     */
+    constructor(baseDir) {
+        this.stateManager = new StateManager(baseDir);
+        this.characterConfigManager = new CharacterConfigManager(this.stateManager);
+    }
+    /**
+     * @description Initialises the state directory structure. Must be awaited before issuing any subcommands.
+     * @returns {Promise<void>}
+     */
+    async init() {
+        await this.stateManager.init();
+    }
+    /**
+     * @description Stops the active core loop if one is currently running. Safe to call before `run()` or when no loop is active.
+     * @returns {void} Does not return a value.
+     */
+    stop() {
+        if (this.activeCoreLoop) {
+            this.activeCoreLoop.stop();
+        }
+    }
+    // ─── Main dispatch ───
+    /**
+     * @description Parses CLI arguments, dispatches the matching PulSeed subcommand, and returns the resulting exit code.
+     * @param {string[]} argv Raw subcommand arguments, excluding the `node` executable and script path.
+     * @returns {Promise<number>} A promise that resolves to `0` for success, `1` for errors, or `2` for stall escalation.
+     */
+    async run(argv) {
+        await this.init();
+        if (argv.length === 0) {
+            await ensureProviderConfig();
+            printUsage();
+            return 1;
+        }
+        // Extract --yes / -y globally so it works regardless of position
+        let globalYes = false;
+        const filteredArgv = [];
+        for (const arg of argv) {
+            if (arg === "--yes" || arg === "-y") {
+                globalYes = true;
+            }
+            else {
+                filteredArgv.push(arg);
+            }
+        }
+        argv = filteredArgv;
+        const subcommand = argv[0];
+        if (subcommand === "run") {
+            let values;
+            try {
+                ({ values } = parseArgs({
+                    args: argv.slice(1),
+                    options: {
+                        goal: { type: "string", multiple: true },
+                        "max-iterations": { type: "string" },
+                        adapter: { type: "string" },
+                        tree: { type: "boolean" },
+                        yes: { type: "boolean", short: "y" },
+                        verbose: { type: "boolean" },
+                    },
+                    strict: false,
+                }));
+            }
+            catch (err) {
+                logger.error(formatOperationError("parse run command arguments", err));
+                values = {};
+            }
+            const goalIds = values.goal ?? [];
+            if (goalIds.length === 0) {
+                logger.error("Error: --goal <id> is required for `pulseed run`.");
+                return 1;
+            }
+            if (goalIds.length > 1) {
+                logger.error("Error: only one --goal is supported per `pulseed run`. Run separately for each goal, or use --tree for tree traversal.");
+                return 1;
+            }
+            const goalId = goalIds[0];
+            const loopConfig = {};
+            if (values["max-iterations"] !== undefined) {
+                const parsed = parseInt(values["max-iterations"], 10);
+                if (!isNaN(parsed)) {
+                    loopConfig.maxIterations = parsed;
+                }
+            }
+            if (values.adapter !== undefined) {
+                loopConfig.adapterType = values.adapter;
+            }
+            if (values.tree) {
+                loopConfig.treeMode = true;
+            }
+            const activeCoreLoopRef = { value: this.activeCoreLoop };
+            const result = await cmdRun(this.stateManager, this.characterConfigManager, goalId, loopConfig, globalYes || values.yes, values.verbose, activeCoreLoopRef);
+            this.activeCoreLoop = activeCoreLoopRef.value;
+            return result;
+        }
+        if (subcommand === "goal") {
+            return dispatchGoalCommand(argv[1], argv.slice(2), globalYes, this.stateManager, this.characterConfigManager);
+        }
+        if (subcommand === "status") {
+            let values;
+            try {
+                ({ values } = parseArgs({
+                    args: argv.slice(1),
+                    options: {
+                        goal: { type: "string" },
+                    },
+                    strict: false,
+                }));
+            }
+            catch (err) {
+                logger.error(formatOperationError("parse status command arguments", err));
+                values = {};
+            }
+            const goalId = values.goal;
+            if (!goalId || typeof goalId !== "string") {
+                logger.error("Error: --goal <id> is required for `pulseed status`.");
+                return 1;
+            }
+            return cmdStatus(this.stateManager, goalId);
+        }
+        if (subcommand === "report") {
+            let values;
+            let reportPositionals = [];
+            try {
+                const parsed = parseArgs({
+                    args: argv.slice(1),
+                    options: {
+                        goal: { type: "string" },
+                    },
+                    allowPositionals: true,
+                    strict: false,
+                });
+                values = parsed.values;
+                reportPositionals = parsed.positionals;
+            }
+            catch (err) {
+                logger.error(formatOperationError("parse report command arguments", err));
+                values = {};
+            }
+            const goalId = values.goal ?? reportPositionals[0];
+            if (!goalId || typeof goalId !== "string") {
+                logger.error("Error: goal ID is required. Usage: pulseed report --goal <id>  or  pulseed report <id>");
+                return 1;
+            }
+            return cmdReport(this.stateManager, goalId);
+        }
+        if (subcommand === "log") {
+            let values;
+            let logPositionals = [];
+            try {
+                const parsed = parseArgs({
+                    args: argv.slice(1),
+                    options: {
+                        goal: { type: "string" },
+                    },
+                    allowPositionals: true,
+                    strict: false,
+                });
+                values = parsed.values;
+                logPositionals = parsed.positionals;
+            }
+            catch (err) {
+                logger.error(formatOperationError("parse log command arguments", err));
+                values = {};
+            }
+            const goalId = values.goal ?? logPositionals[0];
+            if (!goalId || typeof goalId !== "string") {
+                logger.error("Error: goal ID is required. Usage: pulseed log --goal <id>  or  pulseed log <id>");
+                return 1;
+            }
+            return await cmdLog(this.stateManager, goalId);
+        }
+        if (subcommand === "start") {
+            await cmdStart(this.stateManager, this.characterConfigManager, argv.slice(1));
+            return 0;
+        }
+        if (subcommand === "stop") {
+            await cmdStop(argv.slice(1));
+            return 0;
+        }
+        if (subcommand === "cron") {
+            await cmdCron(argv.slice(1));
+            return 0;
+        }
+        if (subcommand === "datasource") {
+            const dsSubcommand = argv[1];
+            if (!dsSubcommand) {
+                logger.error("Error: datasource subcommand required. Available: datasource add, datasource list, datasource remove, datasource dedup");
+                return 1;
+            }
+            if (dsSubcommand === "add") {
+                return await cmdDatasourceAdd(this.stateManager, argv.slice(2));
+            }
+            if (dsSubcommand === "list") {
+                return cmdDatasourceList(this.stateManager);
+            }
+            if (dsSubcommand === "remove") {
+                return cmdDatasourceRemove(this.stateManager, argv.slice(2));
+            }
+            if (dsSubcommand === "dedup") {
+                return cmdDatasourceDedup(this.stateManager);
+            }
+            logger.error(`Unknown datasource subcommand: "${dsSubcommand}"`);
+            logger.error("Available: datasource add, datasource list, datasource remove, datasource dedup");
+            return 1;
+        }
+        if (subcommand === "capability") {
+            const capSubcommand = argv[1];
+            if (!capSubcommand) {
+                logger.error("Error: capability subcommand required. Available: capability list, capability remove");
+                return 1;
+            }
+            if (capSubcommand === "list") {
+                return await cmdCapabilityList(this.stateManager);
+            }
+            if (capSubcommand === "remove") {
+                return await cmdCapabilityRemove(this.stateManager, argv.slice(2));
+            }
+            logger.error(`Unknown capability subcommand: "${capSubcommand}"`);
+            logger.error("Available: capability list, capability remove");
+            return 1;
+        }
+        if (subcommand === "plugin") {
+            const pluginSubcommand = argv[1];
+            if (!pluginSubcommand) {
+                logger.error("Error: plugin subcommand required. Available: plugin list, plugin install, plugin remove");
+                return 1;
+            }
+            if (pluginSubcommand === "list") {
+                return await cmdPluginList();
+            }
+            if (pluginSubcommand === "install") {
+                return await cmdPluginInstall(undefined, argv.slice(2));
+            }
+            if (pluginSubcommand === "remove") {
+                return await cmdPluginRemove(undefined, argv.slice(2));
+            }
+            if (pluginSubcommand === "update") {
+                return await cmdPluginUpdate(undefined, argv.slice(2));
+            }
+            if (pluginSubcommand === "search") {
+                return await cmdPluginSearch(undefined, argv.slice(2));
+            }
+            logger.error(`Unknown plugin subcommand: "${pluginSubcommand}"`);
+            logger.error("Available: plugin list, plugin install, plugin remove, plugin update, plugin search");
+            return 1;
+        }
+        if (subcommand === "cleanup") {
+            return cmdCleanup(this.stateManager);
+        }
+        if (subcommand === "provider") {
+            return cmdProvider(argv.slice(1));
+        }
+        if (subcommand === "config") {
+            const configSubcommand = argv[1];
+            if (!configSubcommand) {
+                logger.error("Error: config subcommand required. Available: config character");
+                return 1;
+            }
+            if (configSubcommand === "character") {
+                return cmdConfigCharacter(this.characterConfigManager, argv.slice(2));
+            }
+            logger.error(`Unknown config subcommand: "${configSubcommand}"`);
+            logger.error("Available: config character");
+            return 1;
+        }
+        if (subcommand === "suggest") {
+            return await cmdSuggest(this.stateManager, this.characterConfigManager, argv.slice(1));
+        }
+        if (subcommand === "improve") {
+            const improveArgs = globalYes ? [...argv.slice(1), "--yes"] : argv.slice(1);
+            return await cmdImprove(this.stateManager, this.characterConfigManager, improveArgs);
+        }
+        if (subcommand === "setup") {
+            return await cmdSetup(argv.slice(1));
+        }
+        if (subcommand === "knowledge") {
+            const knowledgeSubcommand = argv[1];
+            if (!knowledgeSubcommand) {
+                logger.error("Error: knowledge subcommand required. Available: knowledge list, knowledge search, knowledge stats");
+                return 1;
+            }
+            if (knowledgeSubcommand === "list") {
+                return await cmdKnowledgeList(this.stateManager);
+            }
+            if (knowledgeSubcommand === "search") {
+                return await cmdKnowledgeSearch(this.stateManager, argv.slice(2));
+            }
+            if (knowledgeSubcommand === "stats") {
+                return await cmdKnowledgeStats(this.stateManager);
+            }
+            logger.error(`Unknown knowledge subcommand: "${knowledgeSubcommand}"`);
+            logger.error("Available: knowledge list, knowledge search, knowledge stats");
+            return 1;
+        }
+        if (subcommand === "tui") {
+            // Dynamically import to avoid bundling Ink into the CLI when not needed
+            const { startTUI } = await import("./tui/entry.js");
+            await startTUI();
+            return 0;
+        }
+        if (subcommand === "--help" || subcommand === "-h" || subcommand === "help") {
+            printUsage();
+            return 0;
+        }
+        logger.error(`Unknown subcommand: "${subcommand}"`);
+        printUsage();
+        return 1;
+    }
+}
+// ─── Entry point (when run directly as a binary) ───
+async function main() {
+    const argv = process.argv.slice(2);
+    const runner = new CLIRunner();
+    try {
+        const code = await runner.run(argv);
+        process.exit(code);
+    }
+    catch (err) {
+        logger.error(formatOperationError("execute CLI entry point", err));
+        process.exit(1);
+    }
+}
+import { fileURLToPath } from "node:url";
+import { realpathSync } from "node:fs";
+const isMain = (() => {
+    if (typeof process === "undefined" || !process.argv[1])
+        return false;
+    try {
+        const thisFile = realpathSync(fileURLToPath(import.meta.url));
+        const entryFile = realpathSync(process.argv[1]);
+        return thisFile === entryFile;
+    }
+    catch (err) {
+        logger.error(formatOperationError("resolve CLI entry point path", err));
+        return false;
+    }
+})();
+if (isMain) {
+    main();
+}
+//# sourceMappingURL=cli-runner.js.map

package/dist/cli-runner.js.map

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

package/dist/codex-llm-client.d.ts

@@ -0,0 +1,47 @@
+import type { ZodSchema } from "zod";
+import { type ILLMClient, type LLMMessage, type LLMRequestOptions, type LLMResponse } from "./llm-client.js";
+export interface CodexLLMClientConfig {
+    /** Path to the codex CLI executable. Default: "codex" */
+    cliPath?: string;
+    /** Model to pass via --model flag. Default: uses codex's default (OPENAI_MODEL env or codex config) */
+    model?: string;
+    /** Repository path passed to Codex for workspace-aware execution. Default: "." */
+    repoPath?: string;
+    /** Timeout per call in milliseconds. Default: 120000 (2 minutes) */
+    timeoutMs?: number;
+}
+/**
+ * ILLMClient implementation that uses the `codex exec` CLI for LLM calls.
+ * Routes all Motiva internal LLM calls through the Codex CLI, which uses
+ * the ChatGPT subscription (no separate API key needed).
+ *
+ * Uses `codex exec --ephemeral --full-auto -o <tmpfile> "PROMPT"` per call.
+ * The -o flag writes the final response to a temp file for clean output.
+ * Usage stats are not available from the CLI and will always be 0.
+ *
+ * Set MOTIVA_LLM_PROVIDER=codex to activate via CLIRunner / provider-factory.
+ */
+export declare class CodexLLMClient implements ILLMClient {
+    private readonly cliPath;
+    private readonly model;
+    private readonly repoPath;
+    private readonly timeoutMs;
+    constructor(config?: CodexLLMClientConfig);
+    /**
+     * Send a message to the Codex CLI with retry logic.
+     * Retries up to MAX_RETRY_ATTEMPTS times with exponential backoff on spawn failures.
+     */
+    sendMessage(messages: LLMMessage[], options?: LLMRequestOptions): Promise<LLMResponse>;
+    /**
+     * Spawn `codex exec --ephemeral --full-auto [-o <tmpfile>] [--model <model>] "PROMPT"`
+     * and return the response content read from the temp output file.
+     */
+    private _spawnCodex;
+    /**
+     * Extract JSON from LLM response text (handles markdown code blocks)
+     * and validate against the given Zod schema.
+     * Throws on parse failure or schema validation failure.
+     */
+    parseJSON<T>(content: string, schema: ZodSchema<T>): T;
+}
+//# sourceMappingURL=codex-llm-client.d.ts.map

package/dist/codex-llm-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-llm-client.d.ts","sourceRoot":"","sources":["../src/codex-llm-client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AACrC,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AA0CzB,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uGAAuG;IACvG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,GAAE,oBAAyB;IAO7C;;;OAGG;IACG,WAAW,CACf,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,CAAC;IA8BvB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAiGnB;;;;OAIG;IACH,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;CAYvD"}

package/dist/codex-llm-client.js

@@ -0,0 +1,193 @@
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { spawn } from "node:child_process";
+import { extractJSON, } from "./llm-client.js";
+// ─── Constants ───
+const DEFAULT_TIMEOUT_MS = 120_000; // 2 minutes per call
+const MAX_RETRY_ATTEMPTS = 3;
+/** Exponential backoff delays in milliseconds: 1s, 2s, 4s */
+const RETRY_DELAYS_MS = [1000, 2000, 4000];
+// ─── Helpers ───
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Build a single prompt string from messages and system prompt.
+ * Format:
+ *   System instruction: <system>
+ *
+ *   user: <content>
+ *   assistant: <content>
+ *   ...
+ */
+function buildPrompt(messages, system) {
+    const parts = [];
+    if (system) {
+        parts.push(`System instruction: ${system}`);
+        parts.push("");
+    }
+    for (const msg of messages) {
+        parts.push(`${msg.role}: ${msg.content}`);
+    }
+    return parts.join("\n");
+}
+/**
+ * ILLMClient implementation that uses the `codex exec` CLI for LLM calls.
+ * Routes all Motiva internal LLM calls through the Codex CLI, which uses
+ * the ChatGPT subscription (no separate API key needed).
+ *
+ * Uses `codex exec --ephemeral --full-auto -o <tmpfile> "PROMPT"` per call.
+ * The -o flag writes the final response to a temp file for clean output.
+ * Usage stats are not available from the CLI and will always be 0.
+ *
+ * Set MOTIVA_LLM_PROVIDER=codex to activate via CLIRunner / provider-factory.
+ */
+export class CodexLLMClient {
+    cliPath;
+    model;
+    repoPath;
+    timeoutMs;
+    constructor(config = {}) {
+        this.cliPath = config.cliPath ?? "codex";
+        this.model = config.model ?? process.env["OPENAI_MODEL"];
+        this.repoPath = config.repoPath?.trim() || ".";
+        this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    }
+    /**
+     * Send a message to the Codex CLI with retry logic.
+     * Retries up to MAX_RETRY_ATTEMPTS times with exponential backoff on spawn failures.
+     */
+    async sendMessage(messages, options) {
+        const model = options?.model ?? this.model;
+        const system = options?.system;
+        const prompt = buildPrompt(messages, system);
+        let lastError;
+        for (let attempt = 0; attempt < MAX_RETRY_ATTEMPTS; attempt++) {
+            try {
+                const content = await this._spawnCodex(prompt, model);
+                return {
+                    content,
+                    usage: {
+                        input_tokens: 0,
+                        output_tokens: 0,
+                    },
+                    stop_reason: "end_turn",
+                };
+            }
+            catch (err) {
+                lastError = err;
+                if (attempt < MAX_RETRY_ATTEMPTS - 1) {
+                    await sleep(RETRY_DELAYS_MS[attempt] ?? 1000);
+                }
+            }
+        }
+        throw lastError;
+    }
+    /**
+     * Spawn `codex exec --ephemeral --full-auto [-o <tmpfile>] [--model <model>] "PROMPT"`
+     * and return the response content read from the temp output file.
+     */
+    _spawnCodex(prompt, model) {
+        return new Promise((resolve, reject) => {
+            // Create a temporary file for the response output
+            const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "motiva-codex-"));
+            const tmpFile = path.join(tmpDir, "response.txt");
+            // Build spawn args: exec --ephemeral --full-auto -o <tmpfile> [--model <model>] -
+            // Prompt is sent via stdin (using "-" as positional arg) to avoid arg length limits.
+            const spawnArgs = ["exec", "--ephemeral", "--full-auto", "--path", this.repoPath, "-o", tmpFile];
+            if (model) {
+                spawnArgs.push("--model", model);
+            }
+            spawnArgs.push("-");
+            const child = spawn(this.cliPath, spawnArgs, {
+                stdio: ["pipe", "pipe", "pipe"],
+                env: process.env,
+            });
+            let timedOut = false;
+            let stderrData = "";
+            child.stderr.on("data", (chunk) => { stderrData += chunk.toString(); });
+            // Timeout: send SIGTERM, then SIGKILL after 5s
+            const timeoutHandle = setTimeout(() => {
+                timedOut = true;
+                child.kill("SIGTERM");
+                setTimeout(() => {
+                    try {
+                        child.kill("SIGKILL");
+                    }
+                    catch {
+                        // process already exited
+                    }
+                }, 5000);
+            }, this.timeoutMs);
+            // Suppress EPIPE errors on stdin
+            child.stdin.on("error", (err) => {
+                if (err.code !== "EPIPE")
+                    throw err;
+            });
+            // Write prompt via stdin and close
+            child.stdin.write(prompt);
+            child.stdin.end();
+            child.on("error", (err) => {
+                clearTimeout(timeoutHandle);
+                _cleanupTmp(tmpDir, tmpFile);
+                reject(new Error(`CodexLLMClient: spawn error — ${err.message}`));
+            });
+            child.on("close", (code) => {
+                clearTimeout(timeoutHandle);
+                if (timedOut) {
+                    _cleanupTmp(tmpDir, tmpFile);
+                    reject(new Error(`CodexLLMClient: timed out after ${this.timeoutMs}ms`));
+                    return;
+                }
+                if (code !== 0) {
+                    _cleanupTmp(tmpDir, tmpFile);
+                    const detail = stderrData.trim() ? ` — ${stderrData.trim().slice(0, 500)}` : "";
+                    reject(new Error(`CodexLLMClient: process exited with code ${code}${detail}`));
+                    return;
+                }
+                // Read response from temp file
+                let content;
+                try {
+                    content = fs.readFileSync(tmpFile, "utf-8").trim();
+                }
+                catch (readErr) {
+                    _cleanupTmp(tmpDir, tmpFile);
+                    reject(new Error(`CodexLLMClient: failed to read output file — ${String(readErr)}`));
+                    return;
+                }
+                _cleanupTmp(tmpDir, tmpFile);
+                resolve(content);
+            });
+        });
+    }
+    /**
+     * Extract JSON from LLM response text (handles markdown code blocks)
+     * and validate against the given Zod schema.
+     * Throws on parse failure or schema validation failure.
+     */
+    parseJSON(content, schema) {
+        const jsonText = extractJSON(content);
+        let raw;
+        try {
+            raw = JSON.parse(jsonText);
+        }
+        catch (err) {
+            throw new Error(`CodexLLMClient.parseJSON: failed to parse JSON — ${String(err)}\nContent: ${content}`);
+        }
+        return schema.parse(raw);
+    }
+}
+// ─── Helpers ───
+function _cleanupTmp(tmpDir, tmpFile) {
+    try {
+        if (fs.existsSync(tmpFile)) {
+            fs.unlinkSync(tmpFile);
+        }
+        fs.rmdirSync(tmpDir);
+    }
+    catch {
+        // best-effort cleanup
+    }
+}
+//# sourceMappingURL=codex-llm-client.js.map