@with-logic/elwood 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../../src/codex/session/cleanup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAErE,KAAK,kBAAkB,GAAG;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC,CAAC;AAEF,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,kBAAkB,EAC1B,iBAAiB,EAAE,sBAAsB,GAAG,SAAS,EACrD,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/codex/session/cleanup.js

@@ -0,0 +1,15 @@
+/**
+ * Codex session runtime cleanup helpers.
+ * Implements PRD §9.3.
+ */
+import { runCleanupSteps } from "../../runtime/shutdown/teardown.js";
+export function stopCodexRuntime(bridge, transcriptWatcher, terminal) {
+    // Every step runs even if an earlier one throws, so a failing bridge stop still
+    // finishes the transcript watcher and disposes the terminal (no leak; PRD §9.4).
+    return runCleanupSteps([
+        () => bridge.stop(),
+        () => transcriptWatcher?.finish(),
+        () => terminal.dispose(),
+    ]);
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/codex/session/cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../../src/codex/session/cleanup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAQrE,MAAM,UAAU,gBAAgB,CAC9B,MAA0B,EAC1B,iBAAqD,EACrD,QAAwB;IAExB,gFAAgF;IAChF,iFAAiF;IACjF,OAAO,eAAe,CAAC;QACrB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE;QACnB,GAAG,EAAE,CAAC,iBAAiB,EAAE,MAAM,EAAE;QACjC,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE;KACzB,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Registers and dispatches Codex hook handlers on a session emitter.
+ * Implements PRD §5.7, §7A.2 (tool-keyed `PreToolUse` handlers; the `unknown`
+ * handler receives only `mcp__*` / `unknown:*` tools), and §7A.3 (an unblocked
+ * `Stop` reads the committed turn with a bounded per-pass scan before readiness).
+ */
+import type { TypedEmitter } from "../../events/emitter.ts";
+import type { SessionRecord } from "../../state/store.ts";
+import type { CodexSessionImpl } from "./instance.ts";
+import type { CodexEventMap, StartCodexOptions } from "./types.ts";
+export declare function registerInitialHooks(emitter: TypedEmitter<CodexEventMap>, handlers: StartCodexOptions["hooks"]): void;
+export declare function dispatchHook(input: unknown, emitter: TypedEmitter<CodexEventMap>, options: StartCodexOptions, record: SessionRecord, session?: CodexSessionImpl): Promise<import("../../bridge/types.ts").BridgeProcessResult>;
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/codex/session/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAEV,aAAa,EAEb,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,YAAY,CAAC,aAAa,CAAC,EACpC,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,GACnC,IAAI,CAKN;AAiBD,wBAAsB,YAAY,CAChC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,YAAY,CAAC,aAAa,CAAC,EACpC,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,gBAAgB,gEAmC3B"}

package/dist/codex/session/hooks.js

@@ -0,0 +1,54 @@
+/**
+ * Registers and dispatches Codex hook handlers on a session emitter.
+ * Implements PRD §5.7, §7A.2 (tool-keyed `PreToolUse` handlers; the `unknown`
+ * handler receives only `mcp__*` / `unknown:*` tools), and §7A.3 (an unblocked
+ * `Stop` reads the committed turn with a bounded per-pass scan before readiness).
+ */
+import * as activity from "../../core/activity/index.js";
+import { isRecord } from "../../core/predicates.js";
+import { isCodexBlock, requestCodexHook } from "../hooks/dispatch.js";
+import { serializeCodexHookResult } from "../hooks/serialize.js";
+import { isKnownCommandTool, normalizeCodexHookEvent } from "../hooks/validate.js";
+export function registerInitialHooks(emitter, handlers) {
+    if (!handlers)
+        return;
+    for (const [name, handler] of Object.entries(handlers)) {
+        emitter.listen(`hook:${name}`, hookHandler(name, handler));
+    }
+}
+function hookHandler(name, handler) {
+    if (typeof handler === "function")
+        return handler;
+    if (name !== "PreToolUse" || !isRecord(handler))
+        return () => undefined;
+    return ((event) => {
+        const toolName = isRecord(event) && typeof event["tool_name"] === "string" ? event["tool_name"] : "";
+        // The `unknown` handler is typed for `mcp__*` / `unknown:*` tools only, so a known
+        // command tool with no per-tool handler resolves to no decision rather than being
+        // routed into a handler whose parameter type it does not satisfy (§7A.2).
+        const toolHandler = handler[toolName] ?? (isKnownCommandTool(toolName) ? undefined : handler["unknown"]);
+        return typeof toolHandler === "function" ? toolHandler(event) : undefined;
+    });
+}
+export async function dispatchHook(input, emitter, options, record, session) {
+    const event = normalizeCodexHookEvent(input);
+    session?.observeTranscript(event.transcript_path);
+    if (event.hook_event_name === "SessionStart") {
+        session?.rememberCodexSessionId(event.session_id);
+        // Codex's authoritative pre-input readiness signal: release the first queued
+        // message here, not on the boot-time composer placeholder (C-API-28).
+        session?.markInitialReadyFromHook();
+    }
+    emitter.emit("hook", event);
+    emitter.emit("activity", activity.activityFromCodexHook(record.elwoodSessionId, event));
+    const outcome = await requestCodexHook(emitter, event, options.hookTimeoutMs ?? 25_000, record.elwoodSessionId);
+    emitter.emit("activity", activity.activityFromHookResult("codex", record.elwoodSessionId, event.hook_event_name, outcome.result, outcome.failedOpen));
+    if (event.hook_event_name === "Stop" && !isCodexBlock(outcome.result)) {
+        // A bounded per-pass scan (like Claude's): the terminal drain budget is reserved
+        // for finish(), so hundreds of turns never exhaust it into false backlog drops.
+        session?.scanTranscript();
+        session?.submitEvidence("hook_turn_ended");
+    }
+    return serializeCodexHookResult(event.hook_event_name, outcome.result);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/codex/session/hooks.js.map

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

package/dist/codex/session/index.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 "./types.ts";
+export { resetCodexSessionSeamsForTests, setCodexHookBridgeFactoryForTests, } from "./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("./instance.ts").CodexSessionImpl>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/codex/session/index.ts"],"names":[],"mappings":"AAAA,6IAA6I;AAU7I,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAE7C,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAErE,OAAO,EACL,8BAA8B,EAC9B,iCAAiC,GAClC,MAAM,aAAa,CAAC;AAErB;;;;;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,qDAyB9D"}

package/dist/codex/session/index.js

@@ -0,0 +1,61 @@
+/** CodexSessionApi entry points: preflight, record creation, and socket-home-guarded start. Implements PRD §5.5, §5.6, §5.7, §7A, §8, §9. */
+import { randomUUID } from "node:crypto";
+import { resolve } from "node:path";
+import { queuePersonaMessage } from "../../core/persona.js";
+import { codexReasoningEfforts, validateReasoningEffort } from "../../core/reasoning-effort.js";
+import { withSocketHomeCleanup } from "../../runtime/startup/cleanup.js";
+import { codexLaunchPosture, withCodexLaunch } from "../../state/launch-posture.js";
+import { sessionRuntime } from "../../state/runtime-paths.js";
+import { removeOwnSocketFile } from "../../state/socket-home.js";
+import { createSessionRecord, defaultStateDir, prepareStateDir, } from "../../state/store.js";
+import * as preflight from "../preflight.js";
+import { buildCodexSession } from "./build.js";
+export { resetCodexSessionSeamsForTests, setCodexHookBridgeFactoryForTests, } from "./bridge.js";
+/**
+ * @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 function startCodex(rawOptions) {
+    return startCodexWithId(rawOptions, randomUUID());
+}
+/** Internal deterministic-identity start used by owners that must clean failed launch state. */
+export async function startCodexWithId(rawOptions, elwoodSessionId) {
+    // Resolve BOTH cwd and stateDir to ABSOLUTE before the preflight `await`: a relative
+    // path resolved after the await could point elsewhere if the caller's (or preflight's)
+    // process.cwd() changed during it, splitting where state is written from where the CLI
+    // launches (§8.1, §8.2). Thread the resolved cwd everywhere so the record, launch, and
+    // PTY spawn all agree.
+    const options = { ...rawOptions, cwd: resolve(rawOptions.cwd) };
+    const stateDir = resolve(options.stateDir ?? defaultStateDir(options.cwd));
+    const warning = await preflight.preflightCodex(options.strictVersionCheck ?? false, options.autoupdate ?? false);
+    prepareStateDir(stateDir, { gitignore: options.stateDir === undefined });
+    const createdRecord = createSessionRecord({
+        cwd: options.cwd,
+        id: elwoodSessionId,
+        adapter: "codex",
+    });
+    const record = withCodexLaunch(createdRecord, codexLaunchPosture(options));
+    const session = await startCodexFromRecord(record, stateDir, options, false, warning);
+    return queuePersonaMessage(session, options.persona);
+}
+export function startCodexFromRecord(record, stateDir, options, resumed, preflightWarning) {
+    // Validate the effort enum before any spawn (C-CODEX-21): both start and resume funnel
+    // through here. Codex validates server-side (a bad value fails at the first turn), so
+    // this turns a deferred provider error into a fast, clear start-time rejection.
+    validateReasoningEffort(options.reasoningEffort, codexReasoningEfforts, "codex_invalid_reasoning_effort");
+    // `sessionRuntime` ensures the session's STABLE out-of-tree home and reserves a FRESH
+    // per-launch socket PATH inside it; the socket is bound later, by `bridge.start()`
+    // (after the state/runtime files are written). Wrap the WHOLE build so ANY failure
+    // before the session takes ownership removes THIS launch's own socket file — never the
+    // shared home, which a concurrent launch may own (§9.1). On success ownership transfers
+    // to the returned session, whose teardown removes the whole home via removeSessionFiles.
+    const runtime = sessionRuntime({
+        stateDir,
+        elwoodSessionId: record.elwoodSessionId,
+        adapter: "codex",
+    });
+    return withSocketHomeCleanup(() => removeOwnSocketFile(runtime.socketPath), () => buildCodexSession({ record, stateDir, runtime, options, resumed, preflightWarning }));
+}
+//# sourceMappingURL=index.js.map

package/dist/codex/session/index.js.map

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

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/index.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 { CodexTranscriptWatcher } from "../transcript/index.ts";
+import type { CodexHookBridge } from "./bridge.ts";
+import type { CodexEventHandler, CodexEventMap, CodexEventName, CodexSessionApi } from "./types.ts";
+export declare class CodexSessionImpl extends AgentSessionBase implements CodexSessionApi {
+    protected readonly picker: import("../../core/models/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=instance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"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/warnings/session.js";
+import { AgentSessionBase } from "../../runtime/session/base.js";
+import { updateSessionResumeId } from "../../state/store.js";
+import { restoreCodexConfig, snapshotCodexConfig } from "../config/restore.js";
+import { runCodexModelSwitch } from "../config/transaction.js";
+import { attachCodexImages } from "../images/attach.js";
+import { codexModelPicker } from "../model-picker.js";
+import { stopCodexRuntime } from "./cleanup.js";
+import { clipboardRestoreFailedWarning, codexRestoreFailedWarning, codexRestoreSkippedWarning, } from "./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=instance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"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 "./types.ts";
+export declare function resumeCodex(options: ResumeCodexOptions): Promise<CodexSessionApi>;
+//# sourceMappingURL=resume.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../../src/codex/session/resume.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEtE,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 "./index.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=resume.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"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,sBAAsB,CAAC;AACnD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,GAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD,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=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/codex/session/runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,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=runtime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/codex/session/runtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,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/start-or-resume.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Codex try-resume-else-start convenience entry point.
+ * Implements PRD §5.6 and C-API-26; every resume-relevant start option (including
+ * `reasoningEffort`, which a resume must re-supply per C-CODEX-21) is forwarded.
+ */
+import { type StartOrResumeResult } from "../../core/start-or-resume.ts";
+import type { CodexSessionApi, StartCodexOptions } from "./types.ts";
+export type StartOrResumeCodexOptions = StartCodexOptions & {
+    readonly elwoodSessionId?: string;
+};
+export declare function startOrResumeCodex(options: StartOrResumeCodexOptions): Promise<StartOrResumeResult<CodexSessionApi>>;
+//# sourceMappingURL=start-or-resume.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start-or-resume.d.ts","sourceRoot":"","sources":["../../../src/codex/session/start-or-resume.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,mBAAmB,EAAiB,MAAM,+BAA+B,CAAC;AAIxF,OAAO,KAAK,EAAE,eAAe,EAAsB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEzF,MAAM,MAAM,yBAAyB,GAAG,iBAAiB,GAAG;IAC1D,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC,CAO/C"}

package/dist/codex/session/start-or-resume.js

@@ -0,0 +1,31 @@
+/**
+ * Codex try-resume-else-start convenience entry point.
+ * Implements PRD §5.6 and C-API-26; every resume-relevant start option (including
+ * `reasoningEffort`, which a resume must re-supply per C-CODEX-21) is forwarded.
+ */
+import { startOrResume } from "../../core/start-or-resume.js";
+import { compact } from "../../state/launch-posture.js";
+import { startCodex } from "./index.js";
+import { resumeCodex } from "./resume.js";
+export function startOrResumeCodex(options) {
+    const { elwoodSessionId, ...startOptions } = options;
+    return startOrResume(elwoodSessionId, (id) => resumeCodex(resumeOptions(id, startOptions)), () => startCodex(startOptions));
+}
+// Every resume-relevant start option is forwarded (PRD §5.6); `compact` drops the
+// absent ones so `exactOptionalPropertyTypes` sees no explicit `undefined`.
+function resumeOptions(elwoodSessionId, start) {
+    const forwarded = compact({
+        stateDir: start.stateDir,
+        hooks: start.hooks,
+        initialSize: start.initialSize,
+        reasoningEffort: start.reasoningEffort,
+        sandbox: start.sandbox,
+        approvalPolicy: start.approvalPolicy,
+        autoupdate: start.autoupdate,
+        autotrust: start.autotrust,
+        hookTimeoutMs: start.hookTimeoutMs,
+        strictVersionCheck: start.strictVersionCheck,
+    });
+    return { elwoodSessionId, cwd: start.cwd, ...forwarded };
+}
+//# sourceMappingURL=start-or-resume.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start-or-resume.js","sourceRoot":"","sources":["../../../src/codex/session/start-or-resume.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAA4B,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO1C,MAAM,UAAU,kBAAkB,CAChC,OAAkC;IAElC,MAAM,EAAE,eAAe,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IACrD,OAAO,aAAa,CAClB,eAAe,EACf,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,EACpD,GAAG,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAC/B,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,4EAA4E;AAC5E,SAAS,aAAa,CAAC,eAAuB,EAAE,KAAwB;IACtE,MAAM,SAAS,GAAG,OAAO,CAAsD;QAC7E,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;KAC7C,CAAC,CAAC;IACH,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC;AAC3D,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 { CodexTranscriptWatcher } from "../transcript/index.ts";
+import type { CodexEventMap } from "./types.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=transcript.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../../src/codex/session/transcript.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EACL,sBAAsB,EAIvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,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"}