@with-logic/elwood 0.1.0

package/dist/cli/head/display.js

@@ -0,0 +1,108 @@
+/** Ordered raw VT display and terminal restoration for CLI head mode (§12A.6, C-CLI-18). */
+import { AsyncOutputSink } from "../stream.js";
+export const terminalRestore = "\u001b[?2026l\u001b[?1000l\u001b[?1002l\u001b[?1003l\u001b[?1004l\u001b[?1006l" +
+    "\u001b[?2004l\u001b[0m\u001b[?25h\u001b[<u\u001b[?1049l";
+export const maxPendingHeadBytes = 4 * 1024 * 1024;
+export const maxPendingHeadWrites = 1024;
+export class HeadedDisplay {
+    initialSize;
+    target;
+    sink;
+    priorRaw = false;
+    started = false;
+    wrote = false;
+    outputFailed = false;
+    pendingBytes = 0;
+    pendingWrites = 0;
+    removeInput;
+    removeResize;
+    closePromise;
+    handlers;
+    constructor(target) {
+        this.target = target;
+        this.initialSize = target.size();
+        this.sink = new AsyncOutputSink(target.output);
+    }
+    start(handlers) {
+        if (this.started)
+            return;
+        this.started = true;
+        this.handlers = handlers;
+        this.priorRaw = this.target.isRaw();
+        this.target.setRawMode(true);
+        this.removeInput = this.target.onInput((data) => this.handleInput(data));
+        this.removeResize = this.target.onResize((size) => this.handleResize(size));
+        this.target.resume();
+    }
+    write(data) {
+        if (!this.started || this.closePromise !== undefined || this.outputFailed)
+            return;
+        const bytes = Buffer.byteLength(data);
+        if (this.pendingWrites >= maxPendingHeadWrites ||
+            this.pendingBytes + bytes > maxPendingHeadBytes) {
+            this.failOutput(new Error("Headed terminal output backlog exceeded."));
+            return;
+        }
+        this.wrote = true;
+        this.pendingBytes += bytes;
+        this.pendingWrites += 1;
+        void this.sink.write(data).then((open) => {
+            this.settleWrite(bytes);
+            if (!open)
+                this.failOutput(new Error("Headed terminal closed."));
+        }, (error) => {
+            this.settleWrite(bytes);
+            this.failOutput(error);
+        });
+    }
+    close() {
+        this.closePromise ??= this.performClose();
+        return this.closePromise;
+    }
+    async performClose() {
+        if (!this.started) {
+            this.sink.dispose();
+            return;
+        }
+        const failures = [];
+        contain(() => this.removeResize?.(), failures);
+        contain(() => this.target.pause(), failures);
+        contain(() => this.target.setRawMode(this.priorRaw), failures);
+        await new Promise((resolve) => setImmediate(resolve));
+        contain(() => this.removeInput?.(), failures);
+        await this.sink.flush();
+        if (this.wrote)
+            await this.sink.write(terminalRestore).catch(() => false);
+        this.sink.dispose();
+        if (failures[0] !== undefined)
+            this.handlers?.failed(failures[0]);
+    }
+    handleInput(data) {
+        for (const byte of Buffer.from(data)) {
+            if (byte === 0x03)
+                this.handlers?.interrupt();
+        }
+    }
+    handleResize(size) {
+        void Promise.resolve(this.handlers?.resize(size)).catch((error) => this.handlers?.failed(error));
+    }
+    settleWrite(bytes) {
+        this.pendingBytes -= bytes;
+        this.pendingWrites -= 1;
+    }
+    failOutput(error) {
+        if (this.outputFailed)
+            return;
+        this.outputFailed = true;
+        this.handlers?.failed(error);
+    }
+}
+function contain(operation, failures) {
+    try {
+        operation();
+    }
+    catch (error) {
+        failures.push(error);
+    }
+}
+//# sourceMappingURL=display.js.map

package/dist/cli/head/display.js.map

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

package/dist/cli/head/process.d.ts

@@ -0,0 +1,4 @@
+/** Adapts Node's terminal stdin/stderr into the CLI head boundary (§12A.6, C-CLI-18). */
+import type { CliHeadTarget } from "./types.ts";
+export declare function createProcessHeadTarget(stdin: unknown, stderr: unknown): CliHeadTarget | undefined;
+//# sourceMappingURL=process.d.ts.map

package/dist/cli/head/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../src/cli/head/process.ts"],"names":[],"mappings":"AAAA,yFAAyF;AAIzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,OAAO,GACd,aAAa,GAAG,SAAS,CAuD3B"}

package/dist/cli/head/process.js

@@ -0,0 +1,94 @@
+/** Adapts Node's terminal stdin/stderr into the CLI head boundary (§12A.6, C-CLI-18). */
+import { defaultTerminalSize } from "../../core/defaults.js";
+export function createProcessHeadTarget(stdin, stderr) {
+    if (!(isCandidate(stdin) && isCandidate(stderr)))
+        return undefined;
+    if (stdin["isTTY"] !== true || stderr["isTTY"] !== true)
+        return undefined;
+    const setRawMode = method(stdin, "setRawMode");
+    const resume = method(stdin, "resume");
+    const pause = method(stdin, "pause");
+    const inputOn = method(stdin, "on");
+    const inputOff = method(stdin, "off");
+    const resizeOn = method(stderr, "on");
+    const resizeOff = method(stderr, "off");
+    const write = method(stderr, "write");
+    const once = method(stderr, "once");
+    if (!(setRawMode &&
+        resume &&
+        pause &&
+        inputOn &&
+        inputOff &&
+        resizeOn &&
+        resizeOff &&
+        write &&
+        once)) {
+        return undefined;
+    }
+    const size = () => terminalSize(stderr);
+    let inputFailure;
+    const recordInputFailure = (error) => {
+        if (!isTerminalGone(error))
+            inputFailure = error;
+    };
+    return {
+        output: stderr,
+        size,
+        isRaw: () => stdin["isRaw"] === true,
+        setRawMode: (enabled) => setTerminalRawMode(setRawMode, stdin, enabled),
+        resume: () => void resume.call(stdin),
+        pause: () => void pause.call(stdin),
+        onInput: (handler) => {
+            inputOn.call(stdin, "error", recordInputFailure);
+            try {
+                inputOn.call(stdin, "data", handler);
+            }
+            catch (error) {
+                inputOff.call(stdin, "error", recordInputFailure);
+                throw error;
+            }
+            return () => {
+                inputOff.call(stdin, "data", handler);
+                inputOff.call(stdin, "error", recordInputFailure);
+                if (inputFailure !== undefined)
+                    throw inputFailure;
+            };
+        },
+        onResize: (handler) => bind(resizeOn, resizeOff, stderr, "resize", () => handler(size())),
+    };
+}
+const terminalGoneCodes = new Set(["EBADF", "EIO", "ENXIO"]);
+function setTerminalRawMode(method, stdin, enabled) {
+    try {
+        method.call(stdin, enabled);
+    }
+    catch (error) {
+        if (!enabled && isTerminalGone(error))
+            return;
+        throw error;
+    }
+}
+function isTerminalGone(error) {
+    return terminalGoneCodes.has(error.code ?? "");
+}
+function terminalSize(stderr) {
+    const cols = dimension(stderr["columns"], defaultTerminalSize.cols);
+    const rows = dimension(stderr["rows"], defaultTerminalSize.rows);
+    return { cols, rows };
+}
+function dimension(value, fallback) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0 ? value : fallback;
+}
+function bind(on, off, owner, event, handler) {
+    const listener = handler;
+    on.call(owner, event, listener);
+    return () => void off.call(owner, event, listener);
+}
+function method(value, key) {
+    const candidate = value[key];
+    return typeof candidate === "function" ? candidate : undefined;
+}
+function isCandidate(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=process.js.map

package/dist/cli/head/process.js.map

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

package/dist/cli/head/types.d.ts

@@ -0,0 +1,19 @@
+/** Terminal boundary for CLI head mode. Implements PRD §12A.6 and C-CLI-18. */
+import type { TerminalSize, Unsubscribe } from "../../core/types.ts";
+import type { CliWritable } from "../stream.ts";
+export type CliHeadTarget = {
+    readonly output: CliWritable;
+    readonly size: () => TerminalSize;
+    readonly isRaw: () => boolean;
+    readonly setRawMode: (enabled: boolean) => void;
+    readonly resume: () => void;
+    readonly pause: () => void;
+    readonly onInput: (handler: (data: string | Uint8Array) => void) => Unsubscribe;
+    readonly onResize: (handler: (size: TerminalSize) => void) => Unsubscribe;
+};
+export type HeadedDisplayHandlers = {
+    readonly interrupt: () => void;
+    readonly resize: (size: TerminalSize) => void | Promise<void>;
+    readonly failed: (error: unknown) => void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/head/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/head/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,YAAY,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,KAAK,IAAI,KAAK,WAAW,CAAC;IAChF,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,KAAK,WAAW,CAAC;CAC3E,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC3C,CAAC"}

package/dist/cli/head/types.js

@@ -0,0 +1,3 @@
+/** Terminal boundary for CLI head mode. Implements PRD §12A.6 and C-CLI-18. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/head/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/head/types.ts"],"names":[],"mappings":"AAAA,+EAA+E"}

package/dist/cli/help.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Static production help for the first-party headless Elwood command.
+ * Implements PRD §12A.1 and C-CLI-02.
+ */
+export declare const cliHelp = "Usage: elwood [options] [prompt...]\n       elwood run [options] [prompt...]\n       elwood config <command>\n\nRun one Claude Code or Codex turn and write its combined assistant response.\nPositional text and piped stdin are combined with one blank line.\n\nExamples:\n  elwood \"Summarize this repository\"\n  git diff | elwood \"Review this diff for correctness\"\n  elwood run --output json < prompt.txt\n  elwood --keep --output json \"Remember this decision\"\n\nCommands:\n  run                         Run one agent turn (default)\n  config                      Inspect or update global defaults; see config --help\n  help                        Show this help\n\nAgent and turn options:\n  --agent <claude|codex>      Select the agent (default: first available of claude, codex)\n  --model <id>                Select or switch the model\n  --reasoning-effort <level>  Claude: low|medium|high|xhigh|max\n                              Codex: none|minimal|low|medium|high|xhigh|max\n  --persona <prompt>          Run a real side-effect-capable setup turn; hide its answer\n  -C, --cwd <path>            Workspace for a new run (default: current directory)\n  --image <path>              Attach an image; repeat to preserve order\n  --timeout <duration>        Bound launch, setup, and turn (default: none; ms|s|m|h)\n  --trust / --no-trust        Toggle allowlisted trust automation (default: trust)\n  --no-defaults               Ignore saved config and ELWOOD_* run defaults\n\nContinuation and output:\n  --keep                      Preserve Elwood state for a new session\n  --resume <id>               Resume the exact stored agent and workspace\n  --ephemeral                 Remove resumed Elwood state afterward\n  --output <text|json|jsonl>  Stdout protocol (default: text)\n  --stream / --no-stream      Toggle incremental text output (default: off)\n  --verbose / --no-verbose    Toggle concise elapsed progress on stderr (default: off)\n  --debug                     Write full sanitized event details to stderr\n  --head                      View the full agent TUI in this terminal\n  --state-dir <path>          Override CLI-owned state storage\n\nAgent posture defaults and supported values:\n  --claude-permission-mode <default|acceptEdits|plan|auto|dontAsk|bypassPermissions>\n                              Default: dontAsk\n  --codex-sandbox <read-only|workspace-write|danger-full-access>\n                              Default: workspace-write\n  --codex-approval-policy <untrusted|on-request|never>\n                              Default: never\n\nHead mode is view-only and requires terminal stdin and stderr. It cannot be\ncombined with stream, verbose, debug, or JSONL output. Ctrl-C still interrupts.\n\nWarnings and diagnostics use stderr; stdout remains the selected protocol.\nUse \"elwood config effective\" to explain resolved values and their sources.\n\n  -h, --help                  Show this help\n  -V, --version               Show the Elwood version\n";
+export declare const cliConfigHelp = "Usage: elwood config <command> [arguments]\n\nInspect or update Elwood's global user configuration without starting an agent.\n\nCommands:\n  path                        Print the global config path\n  show                        Print the saved configuration document\n  effective [run options]     Explain resolved launch/output settings and sources\n  get <key>                   Print one configured scalar\n  set <key> <value>           Set one documented config key\n  unset <key>                 Remove one configured key\n\n  -h, --help                  Show this help\n\nExamples:\n  elwood config show\n  elwood config effective --agent claude\n  elwood config set codex.sandbox workspace-write\n";
+//# sourceMappingURL=help.d.ts.map

package/dist/cli/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,OAAO,s7FAyDnB,CAAC;AAEF,eAAO,MAAM,aAAa,usBAkBzB,CAAC"}

package/dist/cli/help.js

@@ -0,0 +1,82 @@
+/**
+ * Static production help for the first-party headless Elwood command.
+ * Implements PRD §12A.1 and C-CLI-02.
+ */
+export const cliHelp = `Usage: elwood [options] [prompt...]
+       elwood run [options] [prompt...]
+       elwood config <command>
+
+Run one Claude Code or Codex turn and write its combined assistant response.
+Positional text and piped stdin are combined with one blank line.
+
+Examples:
+  elwood "Summarize this repository"
+  git diff | elwood "Review this diff for correctness"
+  elwood run --output json < prompt.txt
+  elwood --keep --output json "Remember this decision"
+
+Commands:
+  run                         Run one agent turn (default)
+  config                      Inspect or update global defaults; see config --help
+  help                        Show this help
+
+Agent and turn options:
+  --agent <claude|codex>      Select the agent (default: first available of claude, codex)
+  --model <id>                Select or switch the model
+  --reasoning-effort <level>  Claude: low|medium|high|xhigh|max
+                              Codex: none|minimal|low|medium|high|xhigh|max
+  --persona <prompt>          Run a real side-effect-capable setup turn; hide its answer
+  -C, --cwd <path>            Workspace for a new run (default: current directory)
+  --image <path>              Attach an image; repeat to preserve order
+  --timeout <duration>        Bound launch, setup, and turn (default: none; ms|s|m|h)
+  --trust / --no-trust        Toggle allowlisted trust automation (default: trust)
+  --no-defaults               Ignore saved config and ELWOOD_* run defaults
+
+Continuation and output:
+  --keep                      Preserve Elwood state for a new session
+  --resume <id>               Resume the exact stored agent and workspace
+  --ephemeral                 Remove resumed Elwood state afterward
+  --output <text|json|jsonl>  Stdout protocol (default: text)
+  --stream / --no-stream      Toggle incremental text output (default: off)
+  --verbose / --no-verbose    Toggle concise elapsed progress on stderr (default: off)
+  --debug                     Write full sanitized event details to stderr
+  --head                      View the full agent TUI in this terminal
+  --state-dir <path>          Override CLI-owned state storage
+
+Agent posture defaults and supported values:
+  --claude-permission-mode <default|acceptEdits|plan|auto|dontAsk|bypassPermissions>
+                              Default: dontAsk
+  --codex-sandbox <read-only|workspace-write|danger-full-access>
+                              Default: workspace-write
+  --codex-approval-policy <untrusted|on-request|never>
+                              Default: never
+
+Head mode is view-only and requires terminal stdin and stderr. It cannot be
+combined with stream, verbose, debug, or JSONL output. Ctrl-C still interrupts.
+
+Warnings and diagnostics use stderr; stdout remains the selected protocol.
+Use "elwood config effective" to explain resolved values and their sources.
+
+  -h, --help                  Show this help
+  -V, --version               Show the Elwood version
+`;
+export const cliConfigHelp = `Usage: elwood config <command> [arguments]
+
+Inspect or update Elwood's global user configuration without starting an agent.
+
+Commands:
+  path                        Print the global config path
+  show                        Print the saved configuration document
+  effective [run options]     Explain resolved launch/output settings and sources
+  get <key>                   Print one configured scalar
+  set <key> <value>           Set one documented config key
+  unset <key>                 Remove one configured key
+
+  -h, --help                  Show this help
+
+Examples:
+  elwood config show
+  elwood config effective --agent claude
+  elwood config set codex.sandbox workspace-write
+`;
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyDtB,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;CAkB5B,CAAC"}

package/dist/cli/input.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Incrementally composes positional and non-terminal stdin prompt input.
+ * Implements PRD §12A.1 and C-CLI-04.
+ */
+import { type PromptStdin } from "./types.ts";
+export declare const maxPromptBytes: number;
+export declare function readPromptInput(promptWords: readonly string[], stdin: PromptStdin): Promise<string>;
+//# sourceMappingURL=input.d.ts.map

package/dist/cli/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/cli/input.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAElE,eAAO,MAAM,cAAc,QAAkB,CAAC;AAE9C,wBAAsB,eAAe,CACnC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,MAAM,CAAC,CAyBjB"}

package/dist/cli/input.js

@@ -0,0 +1,37 @@
+/**
+ * Incrementally composes positional and non-terminal stdin prompt input.
+ * Implements PRD §12A.1 and C-CLI-04.
+ */
+import { CliValidationError } from "./types.js";
+export const maxPromptBytes = 8 * 1024 * 1024;
+export async function readPromptInput(promptWords, stdin) {
+    const positional = promptWords.join(" ");
+    let byteCount = Buffer.byteLength(positional);
+    let separatorCounted = positional === "";
+    assertWithinLimit(byteCount);
+    const chunks = [];
+    if (stdin.isTTY !== true) {
+        for await (const chunk of stdin.source) {
+            const buffer = Buffer.from(chunk);
+            byteCount += buffer.byteLength;
+            if (!separatorCounted && buffer.byteLength > 0) {
+                byteCount += 2;
+                separatorCounted = true;
+            }
+            assertWithinLimit(byteCount);
+            chunks.push(buffer);
+        }
+    }
+    const piped = Buffer.concat(chunks).toString("utf8");
+    const prompt = positional !== "" && piped !== "" ? `${positional}\n\n${piped}` : positional || piped;
+    if (prompt.trim() === "") {
+        throw new CliValidationError("invalid_arguments", "A non-empty prompt is required.");
+    }
+    return prompt;
+}
+function assertWithinLimit(bytes) {
+    if (bytes > maxPromptBytes) {
+        throw new CliValidationError("invalid_arguments", "Prompt input exceeds the 8 MiB limit.");
+    }
+}
+//# sourceMappingURL=input.js.map

package/dist/cli/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/cli/input.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAoB,MAAM,YAAY,CAAC;AAElE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAA8B,EAC9B,KAAkB;IAElB,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,gBAAgB,GAAG,UAAU,KAAK,EAAE,CAAC;IACzC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACzB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClC,SAAS,IAAI,MAAM,CAAC,UAAU,CAAC;YAC/B,IAAI,CAAC,gBAAgB,IAAI,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;gBAC/C,SAAS,IAAI,CAAC,CAAC;gBACf,gBAAgB,GAAG,IAAI,CAAC;YAC1B,CAAC;YACD,iBAAiB,CAAC,SAAS,CAAC,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,MAAM,GACV,UAAU,KAAK,EAAE,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,UAAU,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,KAAK,CAAC;IACxF,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,kBAAkB,CAAC,mBAAmB,EAAE,iCAAiC,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACtC,IAAI,KAAK,GAAG,cAAc,EAAE,CAAC;QAC3B,MAAM,IAAI,kBAAkB,CAAC,mBAAmB,EAAE,uCAAuC,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC"}

package/dist/cli/lifecycle/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Single owner for CLI deadlines, SIGINT escalation, primary outcomes, and cleanup.
+ * Implements PRD §12A.2/§12A.5 and C-CLI-07 through C-CLI-09/C-CLI-17.
+ */
+import type { Unsubscribe } from "../../core/types.ts";
+import type { CliCleanup } from "../output/types.ts";
+import type { CliSessionFacade } from "../session/index.ts";
+import type { EffectiveRunRequest } from "../types.ts";
+import { type CliFailure } from "./outcome.ts";
+export type CliSignalSource = {
+    readonly onSigint: (handler: () => void) => Unsubscribe;
+};
+export type CliLifecycleClock = {
+    readonly now: () => number;
+    readonly setTimer: (handler: () => void, delayMs: number) => unknown;
+    readonly clearTimer: (timer: unknown) => void;
+};
+export type LifecycleRace<T> = {
+    readonly completed: true;
+    readonly value: T;
+} | {
+    readonly completed: false;
+};
+export declare class CliLifecycle {
+    private readonly request;
+    private readonly session;
+    private readonly signals;
+    private readonly clock;
+    private readonly startedAt;
+    private readonly stopped;
+    private stop;
+    private failureValue;
+    private consumerClosedValue;
+    private launchStarted;
+    private cleaning;
+    private sigints;
+    private timer;
+    private unbind;
+    private cleanupPromise;
+    constructor(request: EffectiveRunRequest, session: CliSessionFacade, signals: CliSignalSource, clock?: CliLifecycleClock);
+    start(): void;
+    beginLaunch(): void;
+    get failure(): CliFailure | undefined;
+    get consumerClosed(): boolean;
+    durationMs(): number;
+    race<T>(operation: Promise<T>): Promise<LifecycleRace<T>>;
+    block(label: string): void;
+    agentExited(): void;
+    fail(error: unknown): void;
+    closeConsumer(): void;
+    cleanup(): Promise<CliCleanup>;
+    dispose(): void;
+    interrupt(): void;
+    private record;
+    private onSigint;
+    private requestControl;
+    private armDeadline;
+    private clearDeadline;
+    private performCleanup;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/lifecycle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/lifecycle/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,KAAK,UAAU,EAAmC,MAAM,cAAc,CAAC;AAIhF,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,WAAW,CAAA;CAAE,CAAC;AAC1F,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACrE,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC/C,CAAC;AACF,MAAM,MAAM,aAAa,CAAC,CAAC,IACvB;IAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAA;CAAE,CAAC;AAQlC,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,cAAc,CAAkC;gBAGtD,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,eAAe,EACxB,KAAK,GAAE,iBAA6B;IAYtC,KAAK,IAAI,IAAI;IAKb,WAAW,IAAI,IAAI;IAInB,IAAI,OAAO,IAAI,UAAU,GAAG,SAAS,CAEpC;IAED,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,UAAU,IAAI,MAAM;IAIpB,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAOzD,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK1B,WAAW,IAAI,IAAI;IASnB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI1B,aAAa,IAAI,IAAI;IAOrB,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAK9B,OAAO,IAAI,IAAI;IAMf,SAAS,IAAI,IAAI;IAIjB,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,aAAa;YAKP,cAAc;CAY7B"}

package/dist/cli/lifecycle/index.js

@@ -0,0 +1,152 @@
+/**
+ * Single owner for CLI deadlines, SIGINT escalation, primary outcomes, and cleanup.
+ * Implements PRD §12A.2/§12A.5 and C-CLI-07 through C-CLI-09/C-CLI-17.
+ */
+import { cleanupAction, executionFailure } from "./outcome.js";
+const MAX_TIMER_MS = 2_147_483_647;
+const realClock = {
+    now: Date.now,
+    setTimer: (handler, delayMs) => setTimeout(handler, delayMs),
+    clearTimer: (timer) => clearTimeout(timer),
+};
+export class CliLifecycle {
+    request;
+    session;
+    signals;
+    clock;
+    startedAt;
+    stopped;
+    stop;
+    failureValue;
+    consumerClosedValue = false;
+    launchStarted = false;
+    cleaning = false;
+    sigints = 0;
+    timer;
+    unbind;
+    cleanupPromise;
+    constructor(request, session, signals, clock = realClock) {
+        this.request = request;
+        this.session = session;
+        this.signals = signals;
+        this.clock = clock;
+        this.startedAt = clock.now();
+        this.stopped = new Promise((resolve) => {
+            this.stop = resolve;
+        });
+    }
+    start() {
+        this.unbind = this.signals.onSigint(() => this.onSigint());
+        if (this.request.timeoutMs !== undefined)
+            this.armDeadline(this.request.timeoutMs);
+    }
+    beginLaunch() {
+        this.launchStarted = true;
+    }
+    get failure() {
+        return this.failureValue;
+    }
+    get consumerClosed() {
+        return this.consumerClosedValue;
+    }
+    durationMs() {
+        return Math.max(0, Math.trunc(this.clock.now() - this.startedAt));
+    }
+    race(operation) {
+        return Promise.race([
+            operation.then((value) => ({ completed: true, value })),
+            this.stopped.then(() => ({ completed: false })),
+        ]);
+    }
+    block(label) {
+        if (this.record({ code: "blocked_prompt", message: `Blocked prompt: ${label}.`, exitCode: 1 }))
+            this.requestControl("kill");
+    }
+    agentExited() {
+        if (this.cleaning)
+            return;
+        this.record({
+            code: "agent_exited",
+            message: "Agent exited before completing the turn.",
+            exitCode: 1,
+        });
+    }
+    fail(error) {
+        this.record(executionFailure(error));
+    }
+    closeConsumer() {
+        if (this.failureValue !== undefined || this.consumerClosedValue)
+            return;
+        this.consumerClosedValue = true;
+        this.stop();
+        this.requestControl("interrupt");
+    }
+    cleanup() {
+        this.cleanupPromise ??= this.performCleanup();
+        return this.cleanupPromise;
+    }
+    dispose() {
+        this.unbind?.();
+        this.unbind = undefined;
+        this.clearDeadline();
+    }
+    interrupt() {
+        this.onSigint();
+    }
+    record(failure) {
+        if (this.failureValue !== undefined || this.consumerClosedValue)
+            return false;
+        this.failureValue = failure;
+        this.stop();
+        return true;
+    }
+    onSigint() {
+        this.sigints += 1;
+        if (this.sigints === 1) {
+            this.record({ code: "interrupted", message: "Interrupted.", exitCode: 130 });
+            this.requestControl("interrupt");
+        }
+        else
+            this.requestControl("kill");
+    }
+    requestControl(action) {
+        if (!this.launchStarted)
+            return;
+        void this.session
+            .start()
+            .then(() => (action === "interrupt" ? this.session.interrupt() : this.session.kill()))
+            .catch(() => undefined);
+    }
+    armDeadline(timeoutMs) {
+        const deadline = Math.min(Number.MAX_SAFE_INTEGER, this.startedAt + timeoutMs);
+        const tick = () => {
+            const remaining = deadline - this.clock.now();
+            if (remaining > 0) {
+                this.timer = this.clock.setTimer(tick, Math.min(remaining, MAX_TIMER_MS));
+                return;
+            }
+            if (this.record({ code: "timeout", message: "Timed out.", exitCode: 124 }))
+                this.requestControl("interrupt");
+        };
+        this.timer = this.clock.setTimer(tick, Math.min(timeoutMs, MAX_TIMER_MS));
+    }
+    clearDeadline() {
+        if (this.timer !== undefined)
+            this.clock.clearTimer(this.timer);
+        this.timer = undefined;
+    }
+    async performCleanup() {
+        this.cleaning = true;
+        this.clearDeadline();
+        const action = cleanupAction(this.request);
+        try {
+            await (action === "teardown" ? this.session.teardown() : this.session.close());
+            return { action, status: "succeeded" };
+        }
+        catch {
+            this.record({ code: "cleanup_failed", message: "Cleanup failed.", exitCode: 1 });
+            return { action, status: "failed", error: "Cleanup failed." };
+        }
+    }
+}
+//# sourceMappingURL=index.js.map