@with-logic/elwood 0.1.0

package/dist/codex/session-instance.d.ts

@@ -0,0 +1,50 @@
+/**
+ * In-memory Codex session object exposed to callers.
+ * Implements PRD §5.7, §7A, §8, and §9.
+ */
+import type { ElwoodActivityEvent } from "../core/activity.ts";
+import type { TerminalReplayBuffer } from "../core/terminal-replay.ts";
+import type { ElwoodSessionStatus, ElwoodWarningEvent } from "../core/types.ts";
+import type { TypedEmitter } from "../events/emitter.ts";
+import type { PtyProcess } from "../pty/types.ts";
+import { AgentSessionBase } from "../runtime/session-base.ts";
+import type { PersistedLoopDefinition } from "../state/loop-store.ts";
+import type { SessionRuntime } from "../state/runtime-paths.ts";
+import { type SessionRecord } from "../state/store.ts";
+import type { ElwoodTerminal } from "../terminal/headless.ts";
+import type { CodexHookBridge } from "./session-bridge.ts";
+import type { CodexEventHandler, CodexEventMap, CodexEventName, CodexSessionApi } from "./session-types.ts";
+import type { CodexTranscriptWatcher } from "./transcript.ts";
+export declare class CodexSessionImpl extends AgentSessionBase implements CodexSessionApi {
+    protected readonly picker: import("../core/model-picker.ts").ModelPickerSpec;
+    private readonly bridge;
+    private readonly emitter;
+    private readonly transcriptWatcher;
+    private onInitialReady;
+    constructor(record: SessionRecord, stateDir: string, runtime: SessionRuntime, pty: PtyProcess, terminal: ElwoodTerminal, bridge: CodexHookBridge, emitter: TypedEmitter<CodexEventMap>, terminalReplay: TerminalReplayBuffer, transcriptWatcher: CodexTranscriptWatcher | undefined, loopDefinitions: readonly PersistedLoopDefinition[]);
+    on<E extends CodexEventName>(event: E, handler: CodexEventHandler<E>): import("../index.ts").Unsubscribe;
+    setModel(id: string, options?: {
+        readonly timeoutMs?: number;
+    }): Promise<void>;
+    private restoreCodexDefault;
+    off<E extends CodexEventName>(event: E, handler: CodexEventHandler<E>): void;
+    completeInitialReady(): void;
+    waitForStatus(match: (status: ElwoodSessionStatus) => boolean, timeoutMs?: number): Promise<"starting" | "running" | "ready" | "blocked" | "exited" | "stopped" | "killed" | "torn_down">;
+    waitForActivity(match: (event: ElwoodActivityEvent) => boolean, timeoutMs?: number): Promise<ElwoodActivityEvent>;
+    protected stagedPaste(screen: string, prompt: string): boolean;
+    protected attachImages: (paths: readonly string[], signal: AbortSignal) => Promise<void>;
+    rememberCodexSessionId(sessionId: string): void;
+    /** Registers the readiness trigger fired by the `SessionStart` hook — Codex's
+     * authoritative "initialized and accepting input" signal (C-API-28). */
+    setInitialReadyHook(fire: () => void): void;
+    /** Fires initial readiness from the `SessionStart` hook so the first queued
+     * message is released only once Codex is actually accepting input, not on the
+     * boot-time composer placeholder that would swallow it (C-API-28). */
+    markInitialReadyFromHook(): void;
+    observeTranscript(path?: string | null): void;
+    /** One bounded per-pass scan of the committed transcript (an unblocked `Stop`, §7A.3). */
+    scanTranscript(): void;
+    emitWarnings(warnings: readonly ElwoodWarningEvent[]): void;
+    protected stopRuntime(): Promise<void>;
+}
+//# sourceMappingURL=session-instance.d.ts.map

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

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

package/dist/codex/session-instance.js

@@ -0,0 +1,117 @@
+/**
+ * In-memory Codex session object exposed to callers.
+ * Implements PRD §5.7, §7A, §8, and §9.
+ */
+import { sessionWaitForActivity, sessionWaitForStatus } from "../core/session-wait.js";
+import { emitSessionWarnings } from "../core/session-warnings.js";
+import { AgentSessionBase } from "../runtime/session-base.js";
+import { updateSessionResumeId } from "../state/store.js";
+import { attachCodexImages } from "./attach-images.js";
+import { restoreCodexConfig, snapshotCodexConfig } from "./config-restore.js";
+import { runCodexModelSwitch } from "./config-transaction.js";
+import { codexModelPicker } from "./model-picker.js";
+import { stopCodexRuntime } from "./session-cleanup.js";
+import { clipboardRestoreFailedWarning, codexRestoreFailedWarning, codexRestoreSkippedWarning, } from "./session-warnings.js";
+export class CodexSessionImpl extends AgentSessionBase {
+    picker = codexModelPicker;
+    bridge;
+    emitter;
+    transcriptWatcher;
+    onInitialReady;
+    constructor(record, stateDir, runtime, pty, terminal, bridge, emitter, terminalReplay, transcriptWatcher, loopDefinitions) {
+        super("codex", record, stateDir, runtime, pty, terminal, emitter, terminalReplay, loopDefinitions);
+        this.bridge = bridge;
+        this.emitter = emitter;
+        this.transcriptWatcher = transcriptWatcher;
+    }
+    on(event, handler) {
+        // REGISTER before replaying buffered `terminal:data` (mirrors Claude): a throwing replay
+        // handler must still be subscribed for FUTURE data. Replay is synchronous, so nothing interleaves.
+        const unsubscribe = this.emitter.on(event, handler);
+        this.replayFor(event, handler);
+        return unsubscribe;
+    }
+    // The Codex CLI persists picker selections into user config.toml; restore
+    // the user's prior default after the switch (C-CODEX-14). The live session
+    // keeps the switched model because Codex reads its config at launch.
+    //
+    // The whole transaction runs under a PROCESS-WIDE config lock (see
+    // config-transaction.ts) so two sessions switching at once cannot interleave
+    // snapshot/restore on the shared file and persist the wrong model, and the
+    // restore still fires when the picker automation rejects AFTER Codex wrote
+    // config.toml — otherwise a late `waitForScreen` timeout would leave the
+    // user's global default changed (C-CODEX-14).
+    setModel(id, options) {
+        return runCodexModelSwitch({
+            snapshot: snapshotCodexConfig,
+            apply: () => super.setModel(id, options),
+            restore: (snapshot) => this.restoreCodexDefault(snapshot),
+            onRestoreError: (error) => this.emitWarnings([codexRestoreFailedWarning(this.elwoodSessionId, error)]),
+        });
+    }
+    restoreCodexDefault(snapshot) {
+        const outcome = restoreCodexConfig(snapshot);
+        if (outcome === "restored" || outcome === "unchanged")
+            return;
+        this.emitWarnings([codexRestoreSkippedWarning(this.elwoodSessionId, outcome)]);
+    }
+    off(event, handler) {
+        this.emitter.off(event, handler);
+    }
+    // One-shot initial-ready transition via the shared anti-starvation boundary: a
+    // failed persist/listener releases the queue directly and warns (C-API-42). Codex
+    // has no narrow-bootstrap resize to restore, so this is just the base advance.
+    completeInitialReady() {
+        this.advanceInitialReady();
+    }
+    waitForStatus(match, timeoutMs) {
+        return sessionWaitForStatus(this, match, timeoutMs);
+    }
+    waitForActivity(match, timeoutMs) {
+        return sessionWaitForActivity(this, match, timeoutMs);
+    }
+    // Codex has no staged chip; the composer still shows the paste's last line.
+    stagedPaste(screen, prompt) {
+        const lastLine = prompt.trim().split("\n").at(-1)?.trim();
+        return lastLine !== undefined && lastLine.length > 0 && screen.includes(lastLine);
+    }
+    // Codex ingests an interactive image only from the OS clipboard; the Ctrl+V is
+    // held while a dialog is on screen so it never confirms one (C-API-46/37).
+    attachImages = (paths, signal) => attachCodexImages(this.terminal, paths, signal, () => this.status === "blocked", () => this.emitWarnings([clipboardRestoreFailedWarning(this.elwoodSessionId)]));
+    rememberCodexSessionId(sessionId) {
+        if (this.record.codex.resumeId)
+            return;
+        this.persist(updateSessionResumeId(this.record, "codex", sessionId));
+    }
+    /** Registers the readiness trigger fired by the `SessionStart` hook — Codex's
+     * authoritative "initialized and accepting input" signal (C-API-28). */
+    setInitialReadyHook(fire) {
+        this.onInitialReady = fire;
+    }
+    /** Fires initial readiness from the `SessionStart` hook so the first queued
+     * message is released only once Codex is actually accepting input, not on the
+     * boot-time composer placeholder that would swallow it (C-API-28). */
+    markInitialReadyFromHook() {
+        this.onInitialReady?.();
+    }
+    observeTranscript(path) {
+        if (path)
+            this.transcriptWatcher?.observe(path);
+    }
+    /** One bounded per-pass scan of the committed transcript (an unblocked `Stop`, §7A.3). */
+    scanTranscript() {
+        this.transcriptWatcher?.scan();
+    }
+    emitWarnings(warnings) {
+        // No cast: each callback is the emitter's own `emit` bound to a correlated
+        // event name, so a map/payload drift is a compile error here.
+        emitSessionWarnings(warnings, {
+            warning: (event) => this.emitter.emit("warning", event),
+            activity: (event) => this.emitter.emit("activity", event),
+        });
+    }
+    async stopRuntime() {
+        await stopCodexRuntime(this.bridge, this.transcriptWatcher, this.terminal);
+    }
+}
+//# sourceMappingURL=session-instance.js.map

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

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

package/dist/codex/session-resume.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Codex session resume entry point built on the shared start path.
+ * Implements PRD §5.6, §9.3, and C-API-16.
+ */
+import type { CodexSessionApi, ResumeCodexOptions } from "./session-types.ts";
+export declare function resumeCodex(options: ResumeCodexOptions): Promise<CodexSessionApi>;
+//# sourceMappingURL=session-resume.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-resume.d.ts","sourceRoot":"","sources":["../../src/codex/session-resume.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAwCvF"}

package/dist/codex/session-resume.js

@@ -0,0 +1,44 @@
+/**
+ * Codex session resume entry point built on the shared start path.
+ * Implements PRD §5.6, §9.3, and C-API-16.
+ */
+import { resolve } from "node:path";
+import { elwoodError } from "../core/errors.js";
+import { codexLaunchPosture, effectivePosture, withCodexLaunch } from "../state/launch-posture.js";
+import { defaultStateDir, readSessionRecord } from "../state/store.js";
+import * as preflight from "./preflight.js";
+import { startCodexFromRecord } from "./session.js";
+export async function resumeCodex(options) {
+    // Resolve stateDir to ABSOLUTE ONCE, before any read/await, so a `process.chdir()`
+    // between the record read and the runtime-file writes can't split them (§8.1).
+    const stateDir = resolve(options.stateDir ?? defaultStateDir(options.cwd ?? process.cwd()));
+    const record = readSessionRecord(stateDir, options.elwoodSessionId);
+    if (record.adapter !== "codex")
+        throw elwoodError("adapter_mismatch", "Cannot resume a non-Codex session as Codex.");
+    if (!record.codex.resumeId)
+        throw elwoodError("resume_unavailable", "Cannot resume Codex without a Codex session id.");
+    const warning = await preflight.preflightCodex(options.strictVersionCheck ?? false, options.autoupdate ?? false);
+    // Resume defaults to the posture this session launched with; explicit options
+    // override field by field, and the effective posture is re-persisted (C-API-32,
+    // C-STATE-13). Terminal size is not persisted: it falls back to options.initialSize.
+    const launch = effectivePosture(record.codex.launch, codexLaunchPosture(options));
+    const resumedRecord = withCodexLaunch(record, launch);
+    return await startCodexFromRecord(resumedRecord, stateDir, {
+        cwd: options.cwd ?? record.cwd,
+        stateDir,
+        ...(options.hooks === undefined ? {} : { hooks: options.hooks }),
+        ...(options.initialSize === undefined ? {} : { initialSize: options.initialSize }),
+        ...(options.hookTimeoutMs === undefined ? {} : { hookTimeoutMs: options.hookTimeoutMs }),
+        ...(options.autotrust === undefined ? {} : { autotrust: options.autotrust }),
+        // Reasoning effort is NOT persisted posture — re-supply it per resume (C-CODEX-21).
+        ...(options.reasoningEffort === undefined
+            ? {}
+            : { reasoningEffort: options.reasoningEffort }),
+        ...launch,
+        ...(options.strictVersionCheck === undefined
+            ? {}
+            : { strictVersionCheck: options.strictVersionCheck }),
+    }, true, // resumed: mark ready on the first composer marker, not the 10s deadline
+    warning);
+}
+//# sourceMappingURL=session-resume.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-resume.js","sourceRoot":"","sources":["../../src/codex/session-resume.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACnG,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA2B;IAC3D,mFAAmF;IACnF,+EAA+E;IAC/E,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,IAAI,eAAe,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC5F,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACpE,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO;QAC5B,MAAM,WAAW,CAAC,kBAAkB,EAAE,6CAA6C,CAAC,CAAC;IACvF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ;QACxB,MAAM,WAAW,CAAC,oBAAoB,EAAE,iDAAiD,CAAC,CAAC;IAC7F,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,cAAc,CAC5C,OAAO,CAAC,kBAAkB,IAAI,KAAK,EACnC,OAAO,CAAC,UAAU,IAAI,KAAK,CAC5B,CAAC;IACF,8EAA8E;IAC9E,gFAAgF;IAChF,qFAAqF;IACrF,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IAClF,MAAM,aAAa,GAAG,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,OAAO,MAAM,oBAAoB,CAC/B,aAAa,EACb,QAAQ,EACR;QACE,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG;QAC9B,QAAQ;QACR,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAChE,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;QAClF,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;QACxF,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;QAC5E,oFAAoF;QACpF,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS;YACvC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;QACjD,GAAG,MAAM;QACT,GAAG,CAAC,OAAO,CAAC,kBAAkB,KAAK,SAAS;YAC1C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,EAAE,CAAC;KACxD,EACD,IAAI,EAAE,yEAAyE;IAC/E,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/codex/session-runtime.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Writes the per-session runtime files (the hook bridge script) for Codex sessions.
+ * Implements PRD §7A and §8.2.
+ */
+import type { SessionRuntime } from "../state/runtime-paths.ts";
+export declare function writeCodexRuntimeFiles(runtime: SessionRuntime): void;
+//# sourceMappingURL=session-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-runtime.d.ts","sourceRoot":"","sources":["../../src/codex/session-runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAKpE"}

package/dist/codex/session-runtime.js

@@ -0,0 +1,10 @@
+/**
+ * Writes the per-session runtime files (the hook bridge script) for Codex sessions.
+ * Implements PRD §7A and §8.2.
+ */
+import { bridgeScriptSource } from "../bridge/script.js";
+import { writePrivateFileAtomic } from "../state/files.js";
+export function writeCodexRuntimeFiles(runtime) {
+    writePrivateFileAtomic(runtime.bridgeScriptPath, bridgeScriptSource(runtime.socketPath, runtime.bridgeToken));
+}
+//# sourceMappingURL=session-runtime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-runtime.js","sourceRoot":"","sources":["../../src/codex/session-runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,MAAM,UAAU,sBAAsB,CAAC,OAAuB;IAC5D,sBAAsB,CACpB,OAAO,CAAC,gBAAgB,EACxB,kBAAkB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,WAAW,CAAC,CAC5D,CAAC;AACJ,CAAC"}

package/dist/codex/session-transcript.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Wires the bounded Codex transcript watcher to the session's warning sink.
+ * The watcher is constructed BEFORE the session object, so a drop/read-error
+ * notice observed early is BUFFERED and flushed through `emitWarnings` (which
+ * emits it as a live `warning` + `activity`) once the sink exists — never dropped.
+ * The caller MUST invoke `flushPendingWarnings` right after building the session so
+ * a single early notice with no follow-up is not stranded. Warnings are live-only
+ * (never persisted, counted, or replayed). Mirrors Claude's wiring. PRD §5.4/§5.7.
+ */
+import { type TranscriptWarningSink } from "../core/transcript/warning-router.ts";
+import type { TypedEmitter } from "../events/emitter.ts";
+import type { CodexEventMap } from "./session-types.ts";
+import { CodexTranscriptWatcher } from "./transcript.ts";
+/** A watcher plus the hook to flush any diagnostics buffered before the sink existed. */
+type WiredCodexTranscriptWatcher = {
+    readonly watcher: CodexTranscriptWatcher;
+    readonly flushPendingWarnings: () => void;
+    /** Drive `watcher.finish()` behind an error boundary, then run `afterFlush` in a
+     * `finally` so a throwing final-flush listener never skips terminal:exit (C-LIFE-10). */
+    readonly finishSafely: (afterFlush?: () => void) => void;
+};
+/**
+ * Builds the transcript watcher, routing content-free drop/read-error notices to
+ * the session's warning sink. Notices seen before `getSink()` resolves are held in
+ * `pending`; both `route` and the returned `flushPendingWarnings` drain them, so a
+ * lone early notice still surfaces once the caller flushes post-construction.
+ */
+export declare function createCodexTranscriptWatcher(elwoodSessionId: string, emitter: TypedEmitter<CodexEventMap>, getSink: () => TranscriptWarningSink | undefined): WiredCodexTranscriptWatcher;
+export {};
+//# sourceMappingURL=session-transcript.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-transcript.d.ts","sourceRoot":"","sources":["../../src/codex/session-transcript.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,sBAAsB,EAIvB,MAAM,iBAAiB,CAAC;AAEzB,yFAAyF;AACzF,KAAK,2BAA2B,GAAG;IACjC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,IAAI,CAAC;IAC1C;6FACyF;IACzF,QAAQ,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CAC1D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,YAAY,CAAC,aAAa,CAAC,EACpC,OAAO,EAAE,MAAM,qBAAqB,GAAG,SAAS,GAC/C,2BAA2B,CAkC7B"}

package/dist/codex/session-transcript.js

@@ -0,0 +1,53 @@
+/**
+ * Wires the bounded Codex transcript watcher to the session's warning sink.
+ * The watcher is constructed BEFORE the session object, so a drop/read-error
+ * notice observed early is BUFFERED and flushed through `emitWarnings` (which
+ * emits it as a live `warning` + `activity`) once the sink exists — never dropped.
+ * The caller MUST invoke `flushPendingWarnings` right after building the session so
+ * a single early notice with no follow-up is not stranded. Warnings are live-only
+ * (never persisted, counted, or replayed). Mirrors Claude's wiring. PRD §5.4/§5.7.
+ */
+import * as activity from "../core/activity.js";
+import { createTranscriptWarningRouter, } from "../core/transcript/warning-router.js";
+import { CodexTranscriptWatcher, codexDropWarning, codexPollStoppedWarning, codexReadErrorWarning, } from "./transcript.js";
+/**
+ * Builds the transcript watcher, routing content-free drop/read-error notices to
+ * the session's warning sink. Notices seen before `getSink()` resolves are held in
+ * `pending`; both `route` and the returned `flushPendingWarnings` drain them, so a
+ * lone early notice still surfaces once the caller flushes post-construction.
+ */
+export function createCodexTranscriptWatcher(elwoodSessionId, emitter, getSink) {
+    // The shared router buffers diagnostics observed BEFORE the sink exists (the watcher
+    // is built first) and delivers each exactly once with clear-before-delivery + throw
+    // containment (see core/transcript/warning-router).
+    const { route, flushPendingWarnings } = createTranscriptWarningRouter(getSink);
+    const watcher = new CodexTranscriptWatcher(elwoodSessionId, (event) => {
+        emitter.emit("codex:transcript", event);
+        emitter.emit("activity", activity.activityFromCodexTranscript(event));
+    }, {
+        onDrop: (notice) => route(codexDropWarning(notice)),
+        onReadError: (notice) => route(codexReadErrorWarning(notice)),
+        onPollError: (error) => route(codexPollStoppedWarning(elwoodSessionId, error)),
+    });
+    // C-LIFE-10: drive the FINAL flush behind an error boundary, then run `afterFlush`
+    // (terminal:exit emission, status, reap) in a `finally` so a throwing final-flush
+    // listener can NEVER skip terminal:exit. A flush failure is contained and surfaced as
+    // a bounded `transcript_poll_stopped` diagnostic phase-labelled `final_flush` (so lost
+    // trailing shutdown activity is distinguishable from a live poll failure). Mirrors Claude.
+    const finishSafely = (afterFlush = () => undefined) => {
+        try {
+            watcher.finish();
+        }
+        catch (error) {
+            try {
+                route(codexPollStoppedWarning(elwoodSessionId, error, "final_flush"));
+            }
+            catch { } // a diagnostic-listener bug must not block lifecycle completion
+        }
+        finally {
+            afterFlush();
+        }
+    };
+    return { watcher, flushPendingWarnings, finishSafely };
+}
+//# sourceMappingURL=session-transcript.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-transcript.js","sourceRoot":"","sources":["../../src/codex/session-transcript.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,EACL,6BAA6B,GAE9B,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAWzB;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,eAAuB,EACvB,OAAoC,EACpC,OAAgD;IAEhD,qFAAqF;IACrF,oFAAoF;IACpF,oDAAoD;IACpD,MAAM,EAAE,KAAK,EAAE,oBAAoB,EAAE,GAAG,6BAA6B,CAAC,OAAO,CAAC,CAAC;IAC/E,MAAM,OAAO,GAAG,IAAI,sBAAsB,CACxC,eAAe,EACf,CAAC,KAAK,EAAE,EAAE;QACR,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,2BAA2B,CAAC,KAAK,CAAC,CAAC,CAAC;IACxE,CAAC,EACD;QACE,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACnD,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC7D,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;KAC/E,CACF,CAAC;IACF,mFAAmF;IACnF,kFAAkF;IAClF,sFAAsF;IACtF,uFAAuF;IACvF,2FAA2F;IAC3F,MAAM,YAAY,GAAG,CAAC,aAAyB,GAAG,EAAE,CAAC,SAAS,EAAE,EAAE;QAChE,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,KAAK,CAAC,uBAAuB,CAAC,eAAe,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC;YACxE,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC,CAAC,gEAAgE;QAC7E,CAAC;gBAAS,CAAC;YACT,UAAU,EAAE,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,CAAC;AACzD,CAAC"}

package/dist/codex/session-types.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Public Codex session API types.
+ * Implements PRD §5.5, §5.6, and §5.7.
+ */
+import type { ElwoodActivityEvent } from "../core/activity.ts";
+import type { SendOptions } from "../core/images/types.ts";
+import type { LoopControls } from "../core/loops/loop-controls.ts";
+import type { AgentModelOption } from "../core/model-rows.ts";
+import type { CodexReasoningEffort } from "../core/reasoning-effort.ts";
+import type { ActivityMatch, ElwoodCommonEventMap, ElwoodSessionStatus, ElwoodStatusDecision, StatusMatch, TerminalSize, Unsubscribe } from "../core/types.ts";
+import type { ElwoodTerminal } from "../terminal/headless.ts";
+import type { CodexHookEvent, CodexHookEventFor, CodexHookEventName, CodexHookHandlers, CodexHookResultFor } from "./hooks.ts";
+import type { CodexTranscriptEvent } from "./transcript.ts";
+export type CodexSandboxMode = "read-only" | "workspace-write" | "danger-full-access";
+export type CodexApprovalPolicy = "untrusted" | "on-request" | "never";
+export type StartCodexOptions = {
+    readonly cwd: string;
+    readonly stateDir?: string;
+    readonly initialSize?: TerminalSize;
+    readonly hooks?: CodexHookHandlers;
+    readonly persona?: string;
+    readonly model?: string;
+    readonly reasoningEffort?: CodexReasoningEffort;
+    readonly profile?: string;
+    readonly sandbox?: CodexSandboxMode;
+    readonly approvalPolicy?: CodexApprovalPolicy;
+    readonly configOverrides?: readonly string[];
+    readonly autoupdate?: boolean;
+    readonly autotrust?: boolean;
+    readonly hookTimeoutMs?: number;
+    readonly strictVersionCheck?: boolean;
+};
+export type ResumeCodexOptions = {
+    readonly elwoodSessionId: string;
+    readonly cwd?: string;
+    readonly stateDir?: string;
+    readonly hooks?: CodexHookHandlers;
+    readonly initialSize?: TerminalSize;
+    readonly reasoningEffort?: CodexReasoningEffort;
+    readonly sandbox?: CodexSandboxMode;
+    readonly approvalPolicy?: CodexApprovalPolicy;
+    readonly autoupdate?: boolean;
+    readonly autotrust?: boolean;
+    readonly hookTimeoutMs?: number;
+    readonly strictVersionCheck?: boolean;
+};
+export type CodexEventMap = ElwoodCommonEventMap & {
+    readonly hook: CodexHookEvent;
+    readonly "codex:transcript": CodexTranscriptEvent;
+} & {
+    readonly [K in `hook:${CodexHookEventName}`]: K extends `hook:${infer N}` ? N extends CodexHookEventName ? CodexHookEventFor<N> : never : never;
+};
+export type CodexEventName = keyof CodexEventMap;
+export type CodexEventHandler<E extends CodexEventName> = (event: CodexEventMap[E]) => E extends `hook:${infer K}` ? K extends CodexHookEventName ? CodexHookResultFor<K> | Promise<CodexHookResultFor<K>> : undefined : void;
+export interface CodexSessionApi extends LoopControls {
+    readonly elwoodSessionId: string;
+    readonly cwd: string;
+    readonly status: ElwoodSessionStatus;
+    readonly terminal: ElwoodTerminal;
+    /** Live-only log of recent status decisions, oldest first, for diagnostics. */
+    statusDecisions(): readonly ElwoodStatusDecision[];
+    waitForStatus(match: StatusMatch, timeoutMs?: number): Promise<ElwoodSessionStatus>;
+    waitForActivity(match: ActivityMatch, timeoutMs?: number): Promise<ElwoodActivityEvent>;
+    on<E extends CodexEventName>(event: E, handler: CodexEventHandler<E>): Unsubscribe;
+    off<E extends CodexEventName>(event: E, handler: CodexEventHandler<E>): void;
+    sendPrompt(prompt: string, options?: SendOptions): Promise<void>;
+    sendMessage(message: string, options?: SendOptions): Promise<void>;
+    sendGuidance(message: string, options?: SendOptions): Promise<void>;
+    sendKeys(input: string | Uint8Array): Promise<void>;
+    resize(size: TerminalSize): Promise<void>;
+    interrupt(options?: {
+        readonly timeoutMs?: number;
+    }): Promise<void>;
+    compact(options?: {
+        readonly timeoutMs?: number;
+    }): Promise<void>;
+    listModels(options?: {
+        readonly timeoutMs?: number;
+    }): Promise<readonly AgentModelOption[]>;
+    setModel(id: string, options?: {
+        readonly timeoutMs?: number;
+    }): Promise<void>;
+    stop(): Promise<void>;
+    kill(): Promise<void>;
+    teardown(): Promise<void>;
+}
+//# sourceMappingURL=session-types.d.ts.map

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

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

package/dist/codex/session-types.js

@@ -0,0 +1,6 @@
+/**
+ * Public Codex session API types.
+ * Implements PRD §5.5, §5.6, and §5.7.
+ */
+export {};
+//# sourceMappingURL=session-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-types.js","sourceRoot":"","sources":["../../src/codex/session-types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/codex/session-warnings.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Builders for the Codex session's lifecycle warnings: the config.toml restore
+ * outcomes after a model switch (PRD §5.3, C-CODEX-14) and the clipboard-restore
+ * failure after an image attach (§5.3, C-API-46). Every warning is live-only
+ * (§5.7) and content-free: `raw` carries a path or a bounded errno code, never
+ * config contents, clipboard data, or a raw error message.
+ */
+import type { ElwoodWarningEvent } from "../core/types.ts";
+type RestoreWarning = Extract<ElwoodWarningEvent, {
+    readonly code: "codex_default_model_persisted";
+}>;
+declare const restoreSkippedMessages: {
+    readonly skipped: "Codex persisted the picker selection as the user's default model, and Elwood skipped the restore because config.toml changed in other ways during the switch.";
+    readonly no_snapshot: "Codex persisted the picker selection as the user's default model in a config.toml that did not exist before the switch; Elwood left the new file in place because there was no prior config to restore.";
+};
+/** The restore was not applied: the file changed in other ways, or there was nothing to restore. */
+export declare function codexRestoreSkippedWarning(elwoodSessionId: string, outcome: keyof typeof restoreSkippedMessages): RestoreWarning;
+/**
+ * Both the picker automation and the config restore failed: the primary error is
+ * preserved to the caller, so the swallowed restore failure is surfaced as a bounded
+ * diagnostic — otherwise the user gets no signal that config.toml may stay mutated.
+ */
+export declare function codexRestoreFailedWarning(elwoodSessionId: string, error: unknown): RestoreWarning;
+/** The clipboard text could not be restored after an image attach (content-free). */
+export declare function clipboardRestoreFailedWarning(elwoodSessionId: string): ElwoodWarningEvent;
+export {};
+//# sourceMappingURL=session-warnings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-warnings.d.ts","sourceRoot":"","sources":["../../src/codex/session-warnings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAI3D,KAAK,cAAc,GAAG,OAAO,CAC3B,kBAAkB,EAClB;IAAE,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAA;CAAE,CACnD,CAAC;AAEF,QAAA,MAAM,sBAAsB;;;CAKlB,CAAC;AAEX,oGAAoG;AACpG,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,OAAO,sBAAsB,GAC3C,cAAc,CAUhB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,cAAc,CAWjG;AAED,qFAAqF;AACrF,wBAAgB,6BAA6B,CAAC,eAAe,EAAE,MAAM,GAAG,kBAAkB,CAUzF"}

package/dist/codex/session-warnings.js

@@ -0,0 +1,54 @@
+/**
+ * Builders for the Codex session's lifecycle warnings: the config.toml restore
+ * outcomes after a model switch (PRD §5.3, C-CODEX-14) and the clipboard-restore
+ * failure after an image attach (§5.3, C-API-46). Every warning is live-only
+ * (§5.7) and content-free: `raw` carries a path or a bounded errno code, never
+ * config contents, clipboard data, or a raw error message.
+ */
+import { CLIPBOARD_RESTORE_FAILED_MESSAGE } from "./clipboard.js";
+import { codexConfigPath, restoreFailureRaw } from "./config-restore.js";
+const restoreSkippedMessages = {
+    skipped: "Codex persisted the picker selection as the user's default model, and Elwood skipped the restore because config.toml changed in other ways during the switch.",
+    no_snapshot: "Codex persisted the picker selection as the user's default model in a config.toml that did not exist before the switch; Elwood left the new file in place because there was no prior config to restore.",
+};
+/** The restore was not applied: the file changed in other ways, or there was nothing to restore. */
+export function codexRestoreSkippedWarning(elwoodSessionId, outcome) {
+    return {
+        elwoodSessionId,
+        agent: "codex",
+        source: "lifecycle",
+        code: "codex_default_model_persisted",
+        severity: "warning",
+        message: restoreSkippedMessages[outcome],
+        raw: codexConfigPath(),
+    };
+}
+/**
+ * Both the picker automation and the config restore failed: the primary error is
+ * preserved to the caller, so the swallowed restore failure is surfaced as a bounded
+ * diagnostic — otherwise the user gets no signal that config.toml may stay mutated.
+ */
+export function codexRestoreFailedWarning(elwoodSessionId, error) {
+    return {
+        elwoodSessionId,
+        agent: "codex",
+        source: "lifecycle",
+        code: "codex_default_model_persisted",
+        severity: "warning",
+        message: "Codex may have persisted the picker selection as the user's default model: the model switch failed and restoring config.toml also failed.",
+        raw: restoreFailureRaw(codexConfigPath(), error),
+    };
+}
+/** The clipboard text could not be restored after an image attach (content-free). */
+export function clipboardRestoreFailedWarning(elwoodSessionId) {
+    return {
+        elwoodSessionId,
+        agent: "codex",
+        source: "lifecycle",
+        code: "clipboard_restore_failed",
+        severity: "warning",
+        message: CLIPBOARD_RESTORE_FAILED_MESSAGE,
+        raw: "clipboard_restore_failed",
+    };
+}
+//# sourceMappingURL=session-warnings.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-warnings.js","sourceRoot":"","sources":["../../src/codex/session-warnings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,gCAAgC,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAOzE,MAAM,sBAAsB,GAAG;IAC7B,OAAO,EACL,+JAA+J;IACjK,WAAW,EACT,yMAAyM;CACnM,CAAC;AAEX,oGAAoG;AACpG,MAAM,UAAU,0BAA0B,CACxC,eAAuB,EACvB,OAA4C;IAE5C,OAAO;QACL,eAAe;QACf,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,WAAW;QACnB,IAAI,EAAE,+BAA+B;QACrC,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,sBAAsB,CAAC,OAAO,CAAC;QACxC,GAAG,EAAE,eAAe,EAAE;KACvB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,eAAuB,EAAE,KAAc;IAC/E,OAAO;QACL,eAAe;QACf,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,WAAW;QACnB,IAAI,EAAE,+BAA+B;QACrC,QAAQ,EAAE,SAAS;QACnB,OAAO,EACL,2IAA2I;QAC7I,GAAG,EAAE,iBAAiB,CAAC,eAAe,EAAE,EAAE,KAAK,CAAC;KACjD,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,6BAA6B,CAAC,eAAuB;IACnE,OAAO;QACL,eAAe;QACf,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,WAAW;QACnB,IAAI,EAAE,0BAA0B;QAChC,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,gCAAgC;QACzC,GAAG,EAAE,0BAA0B;KAChC,CAAC;AACJ,CAAC"}

package/dist/codex/session.d.ts

@@ -0,0 +1,16 @@
+/** CodexSessionApi entry points: preflight, record creation, and socket-home-guarded start. Implements PRD §5.5, §5.6, §5.7, §7A, §8, §9. */
+import { type SessionRecord } from "../state/store.ts";
+import * as preflight from "./preflight.ts";
+import type { CodexSessionApi, StartCodexOptions } from "./session-types.ts";
+export { resetCodexSessionSeamsForTests, setCodexHookBridgeFactoryForTests, } from "./session-bridge.ts";
+/**
+ * @deprecated Prefer the `CodexSession` class (`new CodexSession(options)`), which starts
+ * lazily and exposes both `send`/`stream` and this full control surface. `startCodex`
+ * remains the low-level eager factory and is used internally; it will be removed once the
+ * sole consumer migrates.
+ */
+export declare function startCodex(rawOptions: StartCodexOptions): Promise<CodexSessionApi>;
+/** Internal deterministic-identity start used by owners that must clean failed launch state. */
+export declare function startCodexWithId(rawOptions: StartCodexOptions, elwoodSessionId: string): Promise<CodexSessionApi>;
+export declare function startCodexFromRecord(record: SessionRecord, stateDir: string, options: StartCodexOptions, resumed: boolean, preflightWarning: preflight.CodexPreflightWarning | undefined): Promise<import("./session-instance.ts").CodexSessionImpl>;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/codex/session.ts"],"names":[],"mappings":"AAAA,6IAA6I;AAU7I,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAE5C,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE7E,OAAO,EACL,8BAA8B,EAC9B,iCAAiC,GAClC,MAAM,qBAAqB,CAAC;AAE7B;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAElF;AAED,gGAAgG;AAChG,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,iBAAiB,EAC7B,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,eAAe,CAAC,CAqB1B;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,OAAO,EAChB,gBAAgB,EAAE,SAAS,CAAC,qBAAqB,GAAG,SAAS,6DAyB9D"}