@with-logic/elwood 0.1.0

package/dist/runtime/session-base.js

@@ -0,0 +1,76 @@
+/**
+ * The caller-facing control surface shared by both adapter sessions — prompt,
+ * message, and guidance submission (with image attachment), raw keys, resize,
+ * interrupt/compact, the model picker, and recurring loops — layered over the
+ * lifecycle core in `session-lifecycle.ts`. Implements PRD §5.3, §5.7, §5.9.
+ */
+import { CommandSurface } from "./session-commands.js";
+import { enqueueSubmission, QueuedImageBudget, } from "./session-image-attach.js";
+import { SessionLifecycle } from "./session-lifecycle.js";
+import { applyResize, restoreHeldResize } from "./session-resize.js";
+export class AgentSessionBase extends SessionLifecycle {
+    commands;
+    imageBudget = new QueuedImageBudget();
+    constructor(agent, record, stateDir, runtime, pty, terminal, statusEvents, terminalReplay, loopDefinitions) {
+        super(agent, record, stateDir, runtime, pty, terminal, statusEvents, terminalReplay, loopDefinitions);
+        // `picker` is a subclass field initializer that runs AFTER this constructor, so the
+        // surface resolves it per call rather than capturing it here.
+        this.commands = new CommandSurface({
+            terminal,
+            statusEvents,
+            status: () => this.status,
+            everReady: () => this.everReady,
+            picker: () => this.picker,
+            submit: (command, kind) => this.controlQueue.send(command, kind),
+        });
+    }
+    sendPrompt(prompt, options) {
+        return this.enqueue(prompt, "prompt", options);
+    }
+    sendMessage(message, options) {
+        return this.enqueue(message, "message", options);
+    }
+    sendGuidance(message, options) {
+        return this.enqueue(message, "guidance", options);
+    }
+    sendKeys(input) {
+        return this.inSession(async () => {
+            await this.terminal.sendInput(input);
+            this.loops.callerActivity();
+        });
+    }
+    resize(size) {
+        return this.inSession(() => applyResize(this.pty, this.terminal, size));
+    }
+    interrupt(options) {
+        return this.inSession(() => this.commands.interrupt(options));
+    }
+    compact(options) {
+        return this.inSession(() => this.commands.compact(options));
+    }
+    listModels(options) {
+        return this.inSession(() => this.commands.listModels(options));
+    }
+    setModel(id, options) {
+        return this.inSession(() => this.commands.setModel(id, options));
+    }
+    createLoop(request) {
+        return this.inSession(() => this.loops.create(request));
+    }
+    listLoops() {
+        return this.inSession(() => this.loops.list(), true);
+    }
+    cancelLoop(loopId) {
+        return this.inSession(() => this.loops.cancel(loopId), true);
+    }
+    /** Re-apply a resize that was held during startup (a best-effort restore). */
+    restoreHeldSize(size) {
+        void restoreHeldResize(this.pty, this.terminal, size);
+    }
+    enqueue(input, kind, options) {
+        const driver = (paths, signal) => this.attachImages(paths, signal);
+        const send = (attach) => this.controlQueue.send(input, kind, attach);
+        return this.inSession(() => enqueueSubmission(options?.images, driver, send, this.imageBudget));
+    }
+}
+//# sourceMappingURL=session-base.js.map

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

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

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

@@ -0,0 +1,43 @@
+/**
+ * The session's control surface, shared by every adapter session and extracted
+ * from AgentSessionBase to keep it within the file-size cap. It owns `interrupt`
+ * (direct Escape delivery gated on readiness state, with a timeout and
+ * coalescing of concurrent interrupts, bypassing command submission) alongside
+ * the `compact` and `/model` picker commands (which do go through submission).
+ * Implements PRD §5.3.
+ */
+import { type ModelPickerSpec } from "../core/model-picker.ts";
+import type { AgentModelOption } from "../core/model-rows.ts";
+import type { ScreenTerminal } from "../core/tui-screen.ts";
+import type { ElwoodSessionStatus } from "../core/types.ts";
+import type { SessionStatusEmitter } from "./session-status-wiring.ts";
+type Timeout = {
+    readonly timeoutMs?: number;
+};
+/**
+ * The session primitives the control surface drives (interrupt readiness/status,
+ * compact submission, and the model picker). The picker is a thunk because the
+ * concrete adapter sets `picker` in a subclass field initializer that runs AFTER
+ * the base constructor, so it is resolved per call.
+ */
+export type CommandSurfaceDeps = {
+    readonly terminal: ScreenTerminal;
+    readonly statusEvents: SessionStatusEmitter;
+    readonly status: () => ElwoodSessionStatus;
+    readonly everReady: () => boolean;
+    readonly picker: () => ModelPickerSpec;
+    readonly submit: (command: string, kind: "compact" | "list_models" | "set_model") => Promise<void>;
+};
+/** Builds each command's interrupt/compact/picker closures from the injected primitives. */
+export declare class CommandSurface {
+    private readonly deps;
+    private interrupting;
+    constructor(deps: CommandSurfaceDeps);
+    interrupt(options?: Timeout): Promise<void>;
+    compact(options?: Timeout): Promise<void>;
+    listModels(options?: Timeout): Promise<readonly AgentModelOption[]>;
+    setModel(id: string, options?: Timeout): Promise<void>;
+    private io;
+}
+export {};
+//# sourceMappingURL=session-commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-commands.d.ts","sourceRoot":"","sources":["../../src/runtime/session-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAGL,KAAK,eAAe,EAGrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEvE,KAAK,OAAO,GAAG;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,OAAO,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,eAAe,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,CACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,KAC1C,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB,CAAC;AAEF,4FAA4F;AAC5F,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAI1C,OAAO,CAAC,YAAY,CAA4B;gBAEpC,IAAI,EAAE,kBAAkB;IAIpC,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB3C,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzC,UAAU,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC;IAInE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,OAAO,CAAC,EAAE;CAGX"}

package/dist/runtime/session-commands.js

@@ -0,0 +1,52 @@
+/**
+ * The session's control surface, shared by every adapter session and extracted
+ * from AgentSessionBase to keep it within the file-size cap. It owns `interrupt`
+ * (direct Escape delivery gated on readiness state, with a timeout and
+ * coalescing of concurrent interrupts, bypassing command submission) alongside
+ * the `compact` and `/model` picker commands (which do go through submission).
+ * Implements PRD §5.3.
+ */
+import { compactCommand, sessionCompact } from "../core/compact.js";
+import { interruptKey, sessionInterrupt } from "../core/interrupt.js";
+import { listPickerModels, pickerTimeout, setPickerModel, } from "../core/model-picker.js";
+import { ignoreInputFailure } from "../core/session-input.js";
+/** Builds each command's interrupt/compact/picker closures from the injected primitives. */
+export class CommandSurface {
+    deps;
+    // Coalesces concurrent interrupts: a second call while one is in flight joins
+    // the first rather than writing a second Escape, which could land on the now
+    // idle composer after the first cancels the turn (a non-neutral keystroke).
+    interrupting;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    interrupt(options) {
+        if (this.interrupting)
+            return this.interrupting;
+        const sendEscape = () => Promise.resolve(this.deps.terminal.sendInput(interruptKey));
+        const { statusEvents, status, everReady } = this.deps;
+        const running = sessionInterrupt(statusEvents, status, everReady, sendEscape, options?.timeoutMs);
+        // Clear the in-flight guard on settle so a later interrupt can run afresh.
+        this.interrupting = running.finally(() => {
+            this.interrupting = undefined;
+        });
+        return this.interrupting;
+    }
+    compact(options) {
+        const submit = () => this.deps.submit(compactCommand, "compact");
+        const nudge = () => {
+            ignoreInputFailure(this.deps.terminal.sendInput("\r"));
+        };
+        return sessionCompact(this.deps.statusEvents, submit, nudge, options?.timeoutMs);
+    }
+    listModels(options) {
+        return listPickerModels(this.io("list_models"), this.deps.picker(), pickerTimeout(options));
+    }
+    setModel(id, options) {
+        return setPickerModel(this.io("set_model"), this.deps.picker(), id, pickerTimeout(options));
+    }
+    io(kind) {
+        return { terminal: this.deps.terminal, submit: (c) => this.deps.submit(c, kind) };
+    }
+}
+//# sourceMappingURL=session-commands.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-commands.js","sourceRoot":"","sources":["../../src/runtime/session-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EACL,gBAAgB,EAGhB,aAAa,EACb,cAAc,GACf,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAyB9D,4FAA4F;AAC5F,MAAM,OAAO,cAAc;IACR,IAAI,CAAqB;IAC1C,8EAA8E;IAC9E,6EAA6E;IAC7E,4EAA4E;IACpE,YAAY,CAA4B;IAEhD,YAAY,IAAwB;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,SAAS,CAAC,OAAiB;QACzB,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC,YAAY,CAAC;QAChD,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC;QACrF,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QACtD,MAAM,OAAO,GAAG,gBAAgB,CAC9B,YAAY,EACZ,MAAM,EACN,SAAS,EACT,UAAU,EACV,OAAO,EAAE,SAAS,CACnB,CAAC;QACF,2EAA2E;QAC3E,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE;YACvC,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAChC,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,OAAO,CAAC,OAAiB;QACvB,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC;QACF,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACnF,CAAC;IAED,UAAU,CAAC,OAAiB;QAC1B,OAAO,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,QAAQ,CAAC,EAAU,EAAE,OAAiB;QACpC,OAAO,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9F,CAAC;IAEO,EAAE,CAAC,IAAiC;QAC1C,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC;IACpF,CAAC;CACF"}

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

@@ -0,0 +1,16 @@
+/**
+ * Adapter-neutral PTY-exit orchestration (PRD §5.3, C-LIFE-10). Both the Claude
+ * and Codex exit boundaries drain the transcript, emit `terminal:exit` + activity,
+ * and submit terminal status (which reaps the descendant tree in its own `finally`)
+ * in the same order behind the same error boundary. This is that one shared shape.
+ */
+/**
+ * Run the exit-boundary `flushAndEmit` (transcript drain + `terminal:exit`/activity
+ * emission) behind an error boundary, then ALWAYS run `submitExit` in a `finally`.
+ * `submitExit` submits terminal status and reaps in its OWN `finally`, so a throwing
+ * transcript flush, `terminal:exit` listener, or activity listener can never skip
+ * the terminal status or the unconditional reap, and no listener failure escapes
+ * the native PTY-exit callback (which would leave the reap unrun).
+ */
+export declare function finishSessionExit(flushAndEmit: () => void, submitExit: () => void): void;
+//# sourceMappingURL=session-exit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-exit.d.ts","sourceRoot":"","sources":["../../src/runtime/session-exit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,IAAI,EAAE,UAAU,EAAE,MAAM,IAAI,GAAG,IAAI,CAaxF"}

package/dist/runtime/session-exit.js

@@ -0,0 +1,32 @@
+/**
+ * Adapter-neutral PTY-exit orchestration (PRD §5.3, C-LIFE-10). Both the Claude
+ * and Codex exit boundaries drain the transcript, emit `terminal:exit` + activity,
+ * and submit terminal status (which reaps the descendant tree in its own `finally`)
+ * in the same order behind the same error boundary. This is that one shared shape.
+ */
+/**
+ * Run the exit-boundary `flushAndEmit` (transcript drain + `terminal:exit`/activity
+ * emission) behind an error boundary, then ALWAYS run `submitExit` in a `finally`.
+ * `submitExit` submits terminal status and reaps in its OWN `finally`, so a throwing
+ * transcript flush, `terminal:exit` listener, or activity listener can never skip
+ * the terminal status or the unconditional reap, and no listener failure escapes
+ * the native PTY-exit callback (which would leave the reap unrun).
+ */
+export function finishSessionExit(flushAndEmit, submitExit) {
+    try {
+        flushAndEmit();
+    }
+    catch {
+        // A throwing flush/emit listener must not skip terminal status + reap.
+    }
+    finally {
+        try {
+            submitExit();
+        }
+        catch {
+            // Status was submitted and the reap ran inside submitExit's own finally;
+            // contain any late status-listener throw so it can't abort the callback.
+        }
+    }
+}
+//# sourceMappingURL=session-exit.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-exit.js","sourceRoot":"","sources":["../../src/runtime/session-exit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,YAAwB,EAAE,UAAsB;IAChF,IAAI,CAAC;QACH,YAAY,EAAE,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;IACzE,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,UAAU,EAAE,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACP,yEAAyE;YACzE,yEAAyE;QAC3E,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/runtime/session-image-attach.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Builds the per-submission image-attach task handed to the control queue. The
+ * inputs are SNAPSHOTTED synchronously at the public boundary (byte buffers cloned
+ * at the call, paths absolutized), so a caller who mutates its buffer after the
+ * call cannot change what is attached — the clone does not wait for queue dispatch.
+ * The submission is then enqueued synchronously in call order (preserving FIFO).
+ * Inside the queued task, at dispatch, the async pass (path readability/size) runs,
+ * then byte materialization and the adapter attach — so a bad input rejects the op
+ * (never wedging the queue) and pending submissions accumulate no temp-disk usage.
+ * Implements PRD §5.3 (C-API-44).
+ */
+import { type ImageInput } from "../core/images/types.ts";
+/**
+ * A per-session aggregate byte budget for image clones held across ALL not-yet-attached
+ * queued submissions. Reserved synchronously when a submission's bytes are cloned and
+ * released when it settles, so a slow paste can't let a caller retain gigabytes of
+ * queued clones (C-API-44).
+ */
+export declare class QueuedImageBudget {
+    private used;
+    private readonly ceiling;
+    constructor(ceiling?: number);
+    reserve(bytes: number): void;
+    release(bytes: number): void;
+}
+/** A text-submission kind carried by the control queue. */
+export type SubmitKind = "prompt" | "message" | "guidance";
+/** An attach step run inside a queued op, before the text write. */
+export type AttachTask = (signal: AbortSignal) => Promise<void>;
+/** Drives an adapter's native attach for already-resolved absolute image paths. */
+export type AttachDriver = (paths: readonly string[], signal: AbortSignal) => Promise<void>;
+/** Queues a submission through the control queue, optionally with an attach task. */
+type QueueSend = (attach?: AttachTask) => Promise<void>;
+/**
+ * Queues a text submission, optionally attaching `images`. With no images it is a
+ * plain `send()`; the queue call happens synchronously so a later plain submission
+ * cannot overtake an image submission in FIFO order. With images, the byte buffers
+ * are cloned SYNCHRONOUSLY here (before the op is queued), so a caller that mutates
+ * its buffer after the call cannot change what is attached. A synchronous snapshot
+ * failure (bad shape, over-limit bytes) surfaces as a REJECTED promise, never a
+ * synchronous throw out of the send API (C-API-44).
+ */
+export declare function enqueueSubmission(images: readonly ImageInput[] | undefined, driver: AttachDriver, send: QueueSend, budget?: QueuedImageBudget): Promise<void>;
+export {};
+//# sourceMappingURL=session-image-attach.d.ts.map

package/dist/runtime/session-image-attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-image-attach.d.ts","sourceRoot":"","sources":["../../src/runtime/session-image-attach.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,yBAAyB,CAAC;AAEvE;;;;;GAKG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBACrB,OAAO,SAA6B;IAGhD,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK5B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAG7B;AAED,2DAA2D;AAC3D,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAE3D,oEAAoE;AACpE,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhE,mFAAmF;AACnF,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5F,qFAAqF;AACrF,KAAK,SAAS,GAAG,CAAC,MAAM,CAAC,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAExD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,EACzC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,SAAS,EACf,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAuBf"}

package/dist/runtime/session-image-attach.js

@@ -0,0 +1,82 @@
+/**
+ * Builds the per-submission image-attach task handed to the control queue. The
+ * inputs are SNAPSHOTTED synchronously at the public boundary (byte buffers cloned
+ * at the call, paths absolutized), so a caller who mutates its buffer after the
+ * call cannot change what is attached — the clone does not wait for queue dispatch.
+ * The submission is then enqueued synchronously in call order (preserving FIFO).
+ * Inside the queued task, at dispatch, the async pass (path readability/size) runs,
+ * then byte materialization and the adapter attach — so a bad input rejects the op
+ * (never wedging the queue) and pending submissions accumulate no temp-disk usage.
+ * Implements PRD §5.3 (C-API-44).
+ */
+import { elwoodError } from "../core/errors.js";
+import { materializeImages, snapshotImages, validateImagePaths, } from "../core/images/index.js";
+import { imageLimits } from "../core/images/types.js";
+/**
+ * A per-session aggregate byte budget for image clones held across ALL not-yet-attached
+ * queued submissions. Reserved synchronously when a submission's bytes are cloned and
+ * released when it settles, so a slow paste can't let a caller retain gigabytes of
+ * queued clones (C-API-44).
+ */
+export class QueuedImageBudget {
+    used = 0;
+    ceiling;
+    constructor(ceiling = imageLimits.maxQueuedBytes) {
+        this.ceiling = ceiling;
+    }
+    reserve(bytes) {
+        if (this.used + bytes > this.ceiling)
+            throw elwoodError("invalid_image", "Too many queued image bytes for this session.");
+        this.used += bytes;
+    }
+    release(bytes) {
+        this.used = Math.max(0, this.used - bytes);
+    }
+}
+/**
+ * Queues a text submission, optionally attaching `images`. With no images it is a
+ * plain `send()`; the queue call happens synchronously so a later plain submission
+ * cannot overtake an image submission in FIFO order. With images, the byte buffers
+ * are cloned SYNCHRONOUSLY here (before the op is queued), so a caller that mutates
+ * its buffer after the call cannot change what is attached. A synchronous snapshot
+ * failure (bad shape, over-limit bytes) surfaces as a REJECTED promise, never a
+ * synchronous throw out of the send API (C-API-44).
+ */
+export function enqueueSubmission(images, driver, send, budget) {
+    // Fast-path ONLY a truly absent list. Any supplied value — including a non-array
+    // like `""` or a zero-length array-like `{ length: 0 }` from an untyped caller —
+    // must go through snapshotImages so it rejects with `invalid_image` rather than
+    // slipping past validation as a no-image send (C-API-44).
+    if (images === undefined)
+        return send();
+    let snapshot;
+    try {
+        snapshot = snapshotImages(images); // validates shape + clones bytes at the call
+        budget?.reserve(snapshot.inlineByteTotal); // reserve the clone bytes vs the session ceiling
+    }
+    catch (error) {
+        return Promise.reject(error);
+    }
+    const bytes = snapshot.inlineByteTotal;
+    if (snapshot.images.length === 0) {
+        budget?.release(bytes); // nothing to attach: give the reservation back
+        return send();
+    }
+    // Release on EVERY settle path (attach done, reject, or the op never dispatching), so
+    // the clone memory is always accounted back even when a session closes mid-queue.
+    const done = send((signal) => runAttach(snapshot, driver, signal));
+    done.finally(() => budget?.release(bytes)).catch(() => undefined);
+    return done;
+}
+/** Validate paths (async) → materialize → drive the adapter attach → clean up temp files. */
+async function runAttach(snapshot, driver, signal) {
+    const validated = await validateImagePaths(snapshot);
+    const materialized = await materializeImages(validated);
+    try {
+        await driver(materialized.paths, signal);
+    }
+    finally {
+        await materialized.cleanup().catch(() => undefined);
+    }
+}
+//# sourceMappingURL=session-image-attach.js.map

package/dist/runtime/session-image-attach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-image-attach.js","sourceRoot":"","sources":["../../src/runtime/session-image-attach.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAEL,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAmB,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IACpB,IAAI,GAAG,CAAC,CAAC;IACA,OAAO,CAAS;IACjC,YAAY,OAAO,GAAG,WAAW,CAAC,cAAc;QAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IACD,OAAO,CAAC,KAAa;QACnB,IAAI,IAAI,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,OAAO;YAClC,MAAM,WAAW,CAAC,eAAe,EAAE,+CAA+C,CAAC,CAAC;QACtF,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC;IACrB,CAAC;IACD,OAAO,CAAC,KAAa;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;IAC7C,CAAC;CACF;AAcD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAyC,EACzC,MAAoB,EACpB,IAAe,EACf,MAA0B;IAE1B,iFAAiF;IACjF,iFAAiF;IACjF,gFAAgF;IAChF,0DAA0D;IAC1D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,EAAE,CAAC;IACxC,IAAI,QAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,6CAA6C;QAChF,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,iDAAiD;IAC9F,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,eAAe,CAAC;IACvC,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,+CAA+C;QACvE,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC;IACD,sFAAsF;IACtF,kFAAkF;IAClF,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAClE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6FAA6F;AAC7F,KAAK,UAAU,SAAS,CACtB,QAAuB,EACvB,MAAoB,EACpB,MAAmB;IAEnB,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;YAAS,CAAC;QACT,MAAM,YAAY,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,61 @@
+/**
+ * Lifecycle core shared by both adapter sessions: identity, status evidence, the
+ * control queue, loop/reap/shutdown wiring, record persistence, and the
+ * not-running guard every operation runs behind. Implements PRD §5.3, §5.7, §8.2,
+ * and §9.4. The caller-facing send/loop/command methods layer on top of this in
+ * `session-base.ts`.
+ */
+import type { ElwoodAgentKind } from "../core/activity.ts";
+import { ControlQueue } from "../core/control-queue.ts";
+import type { TerminalReplayBuffer } from "../core/terminal-replay.ts";
+import type { ElwoodSessionStatus, ElwoodWarningEvent } from "../core/types.ts";
+import type { PtyProcess } from "../pty/types.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 { SessionLoops } from "./session-loops.ts";
+import { type SessionStatusEmitter } from "./session-status-wiring.ts";
+import type { StatusDecision, StatusEvidenceKind } from "./status-evidence.ts";
+export declare function notRunningError(agent: ElwoodAgentKind): Error;
+type SessionListener = (event: never) => unknown;
+export declare abstract class SessionLifecycle {
+    protected record: SessionRecord;
+    readonly terminal: ElwoodTerminal;
+    protected readonly pty: PtyProcess;
+    protected readonly loops: SessionLoops;
+    protected readonly controlQueue: ControlQueue;
+    protected everReady: boolean;
+    private readonly agent;
+    private readonly runtime;
+    private readonly reapPolicy;
+    private readonly terminalReplay;
+    private readonly cleanupLatch;
+    private readonly shutdown;
+    private readonly statusEngine;
+    private readonly pasteGuard;
+    protected constructor(agent: ElwoodAgentKind, record: SessionRecord, stateDir: string, runtime: SessionRuntime, pty: PtyProcess, terminal: ElwoodTerminal, statusEvents: SessionStatusEmitter, terminalReplay: TerminalReplayBuffer, loopDefinitions: readonly PersistedLoopDefinition[]);
+    get elwoodSessionId(): string;
+    get cwd(): string;
+    get status(): ElwoodSessionStatus;
+    stop(): Promise<void>;
+    kill(): Promise<void>;
+    teardown(): Promise<void>;
+    startLoops(): void;
+    pauseLoopsForStartupCleanup(cancelReadiness: () => void): void;
+    submitEvidence(kind: StatusEvidenceKind): StatusDecision;
+    submitExit(): StatusDecision;
+    statusDecisions(): readonly StatusDecision[];
+    protected abstract stagedPaste(screen: string, prompt: string): boolean;
+    protected abstract stopRuntime(): Promise<void>;
+    protected abstract emitWarnings(warnings: readonly ElwoodWarningEvent[]): void;
+    /** Replay buffered past `terminal:data` / pre-return attention to a late subscriber. */
+    protected replayFor(event: string, handler: SessionListener): void;
+    /** Run `work` unless the session is terminal (or `allowTerminal`); sync throws reject. */
+    protected inSession<T>(work: () => Promise<T> | T, allowTerminal?: boolean): Promise<T>;
+    protected persist(record: SessionRecord): void;
+    protected cleanupRuntime(): Promise<void>;
+    protected advanceInitialReady(): void;
+}
+export {};
+//# sourceMappingURL=session-lifecycle.d.ts.map

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

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

package/dist/runtime/session-lifecycle.js

@@ -0,0 +1,164 @@
+/**
+ * Lifecycle core shared by both adapter sessions: identity, status evidence, the
+ * control queue, loop/reap/shutdown wiring, record persistence, and the
+ * not-running guard every operation runs behind. Implements PRD §5.3, §5.7, §8.2,
+ * and §9.4. The caller-facing send/loop/command methods layer on top of this in
+ * `session-base.ts`.
+ */
+import { ControlQueue } from "../core/control-queue.js";
+import { elwoodError, toError } from "../core/errors.js";
+import { registerPrivateOutputSecrets } from "../core/private-output-secrets.js";
+import { writeQueuedInput } from "../core/session-input.js";
+import { terminalStatuses } from "../core/status-categories.js";
+import { writeSessionRecord } from "../state/store.js";
+import { CleanupLatch } from "./cleanup-latch.js";
+import { advanceInitialReady } from "./initial-ready-advance.js";
+import { SessionLoops } from "./session-loops.js";
+import { SessionReapPolicy } from "./session-reap.js";
+import { SessionShutdownBinding } from "./session-shutdown-binding.js";
+import { createSessionStatusEngine } from "./session-status-wiring.js";
+export function notRunningError(agent) {
+    const title = agent === "claude" ? "Claude" : "Codex";
+    return elwoodError("session_not_running", `${title} session is not running.`);
+}
+export class SessionLifecycle {
+    record;
+    terminal;
+    pty;
+    loops;
+    controlQueue;
+    everReady = false;
+    agent;
+    runtime;
+    reapPolicy;
+    terminalReplay;
+    cleanupLatch = new CleanupLatch(() => this.stopRuntime());
+    shutdown;
+    statusEngine;
+    pasteGuard = {
+        snapshot: () => this.terminal.snapshot().text,
+        staged: (screen, prompt) => this.stagedPaste(screen, prompt),
+        blocked: () => this.status === "blocked",
+    };
+    constructor(agent, record, stateDir, runtime, pty, terminal, statusEvents, terminalReplay, loopDefinitions) {
+        registerPrivateOutputSecrets(this, [runtime.bridgeToken]);
+        this.agent = agent;
+        this.record = record;
+        this.runtime = runtime;
+        this.pty = pty;
+        this.terminal = terminal;
+        this.terminalReplay = terminalReplay;
+        this.reapPolicy = new SessionReapPolicy(agent, record.elwoodSessionId, pty.pid);
+        this.controlQueue = new ControlQueue((input, mode, signal) => writeQueuedInput(this.terminal, input, mode, this.pasteGuard, signal), () => notRunningError(agent), (origin) => {
+            this.loops.turnStarted(origin);
+            this.submitEvidence("caller_submitted");
+        }, () => this.status === "running");
+        this.loops = new SessionLoops({
+            stateDir,
+            elwoodSessionId: record.elwoodSessionId,
+            definitions: loopDefinitions,
+            queue: this.controlQueue,
+            emitter: statusEvents,
+        });
+        this.statusEngine = createSessionStatusEngine({
+            agent,
+            elwoodSessionId: record.elwoodSessionId,
+            emitter: statusEvents,
+            queue: this.controlQueue,
+            loops: this.loops,
+            markReady: () => {
+                this.everReady = true;
+            },
+            cleanup: () => this.cleanupLatch.float(),
+        });
+        this.shutdown = new SessionShutdownBinding({
+            pty,
+            stateDir,
+            runtime,
+            reapPolicy: this.reapPolicy,
+            loops: this.loops,
+            elwoodSessionId: () => this.elwoodSessionId,
+            status: () => this.status,
+            cleanupRuntime: () => this.cleanupRuntime(),
+            submitEvidence: (kind) => void this.submitEvidence(kind),
+        });
+    }
+    get elwoodSessionId() {
+        return this.record.elwoodSessionId;
+    }
+    get cwd() {
+        return this.record.cwd;
+    }
+    get status() {
+        return this.statusEngine.status;
+    }
+    stop() {
+        return this.shutdown.stop();
+    }
+    kill() {
+        return this.shutdown.kill();
+    }
+    teardown() {
+        return this.shutdown.teardown();
+    }
+    startLoops() {
+        this.loops.start();
+    }
+    pauseLoopsForStartupCleanup(cancelReadiness) {
+        cancelReadiness();
+        this.loops.pause();
+    }
+    submitEvidence(kind) {
+        return this.statusEngine.submit(kind);
+    }
+    submitExit() {
+        const evidence = this.shutdown.exitEvidence();
+        try {
+            return this.statusEngine.submit(evidence);
+        }
+        finally {
+            const warning = evidence === "terminal_exited" ? this.reapPolicy.bestEffort() : undefined;
+            if (warning)
+                this.emitWarnings([warning]);
+        }
+    }
+    statusDecisions() {
+        return this.statusEngine.decisions();
+    }
+    /** Replay buffered past `terminal:data` / pre-return attention to a late subscriber. */
+    replayFor(event, handler) {
+        if (event === "terminal:data")
+            this.terminalReplay.replay(handler);
+        if (event === "activity")
+            this.terminalReplay.replayAttention(handler);
+    }
+    /** Run `work` unless the session is terminal (or `allowTerminal`); sync throws reject. */
+    inSession(work, allowTerminal = false) {
+        if (!allowTerminal && terminalStatuses.has(this.status)) {
+            return Promise.reject(notRunningError(this.agent));
+        }
+        try {
+            return Promise.resolve(work());
+        }
+        catch (error) {
+            return Promise.reject(toError(error));
+        }
+    }
+    persist(record) {
+        writeSessionRecord(record, this.runtime.sessionDir); // atomic record write FIRST, commit in-memory on success (§8.2)
+        this.record = record;
+    }
+    cleanupRuntime() {
+        return this.cleanupLatch.attempt();
+    }
+    advanceInitialReady() {
+        advanceInitialReady({
+            agent: this.agent,
+            elwoodSessionId: this.elwoodSessionId,
+            submitInitialReady: () => this.submitEvidence("initial_ready"),
+            markReady: () => this.controlQueue.markReady(),
+            emitWarnings: (warnings) => this.emitWarnings(warnings),
+        });
+    }
+}
+//# sourceMappingURL=session-lifecycle.js.map

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

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