@with-logic/elwood 0.1.0

package/dist/runtime/session/resize.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Resize helpers shared by every adapter session.
+ * Implements PRD §5.3 and C-API-39/C-PTY-05: a direct resize updates both terminal
+ * models, while a HELD (deferred-physical) resize leaves the live pty/terminal at
+ * their bootstrap geometry until the initial-ready transition applies it. Terminal
+ * size is NOT persisted — the live PTY resizes, and nothing is written to disk.
+ */
+import type { TerminalSize } from "../../core/types.ts";
+import type { PtyProcess } from "../../pty/types.ts";
+import type { ElwoodTerminal } from "../../terminal/headless.ts";
+/** Apply a resize to both terminal models; a closed fd is a no-op. */
+export declare function applyResize(pty: PtyProcess, terminal: ElwoodTerminal, size: TerminalSize): void;
+/**
+ * Apply a held resize's deferred PHYSICAL geometry (PTY + terminal) at the
+ * initial-ready transition. Only a genuine native PTY resize error (a real,
+ * non-closed failure) is treated as "stayed at bootstrap width"; a closed fd stays a
+ * silent no-op (C-API-39). Returns whether the physical resize applied.
+ */
+export declare function restoreHeldResize(pty: PtyProcess, terminal: ElwoodTerminal, size: TerminalSize): boolean;
+//# sourceMappingURL=resize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resize.d.ts","sourceRoot":"","sources":["../../../src/runtime/session/resize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAG/F;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,cAAc,EACxB,IAAI,EAAE,YAAY,GACjB,OAAO,CAIT"}

package/dist/runtime/session/resize.js

@@ -0,0 +1,26 @@
+/**
+ * Resize helpers shared by every adapter session.
+ * Implements PRD §5.3 and C-API-39/C-PTY-05: a direct resize updates both terminal
+ * models, while a HELD (deferred-physical) resize leaves the live pty/terminal at
+ * their bootstrap geometry until the initial-ready transition applies it. Terminal
+ * size is NOT persisted — the live PTY resizes, and nothing is written to disk.
+ */
+/** Apply a resize to both terminal models; a closed fd is a no-op. */
+export function applyResize(pty, terminal, size) {
+    if (pty.resize(size) === "closed")
+        return;
+    terminal.resize(size);
+}
+/**
+ * Apply a held resize's deferred PHYSICAL geometry (PTY + terminal) at the
+ * initial-ready transition. Only a genuine native PTY resize error (a real,
+ * non-closed failure) is treated as "stayed at bootstrap width"; a closed fd stays a
+ * silent no-op (C-API-39). Returns whether the physical resize applied.
+ */
+export function restoreHeldResize(pty, terminal, size) {
+    if (pty.resize(size) === "closed")
+        return false;
+    terminal.resize(size);
+    return true;
+}
+//# sourceMappingURL=resize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resize.js","sourceRoot":"","sources":["../../../src/runtime/session/resize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAC,GAAe,EAAE,QAAwB,EAAE,IAAkB;IACvF,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO;IAC1C,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAe,EACf,QAAwB,EACxB,IAAkB;IAElB,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/runtime/session/shutdown-binding.d.ts

@@ -0,0 +1,30 @@
+/** Binds one session's lifecycle callbacks to coordinated shutdown (PRD §9.4). */
+import type { ElwoodSessionStatus } from "../../core/types.ts";
+import type { PtyProcess } from "../../pty/types.ts";
+import type { SessionRuntime } from "../../state/runtime-paths.ts";
+import type { StatusEvidenceKind } from "../status-evidence.ts";
+import type { SessionLoops } from "./loops.ts";
+import type { SessionReapPolicy } from "./reap.ts";
+import { type ShutdownEvidence } from "./shutdown.ts";
+type ShutdownBindingInput = {
+    readonly pty: PtyProcess;
+    readonly stateDir: string;
+    readonly runtime: SessionRuntime;
+    readonly reapPolicy: SessionReapPolicy;
+    readonly loops: SessionLoops;
+    readonly elwoodSessionId: () => string;
+    readonly status: () => ElwoodSessionStatus;
+    readonly cleanupRuntime: () => Promise<void>;
+    readonly submitEvidence: (kind: StatusEvidenceKind) => void;
+};
+export declare class SessionShutdownBinding {
+    private pending;
+    private readonly managed;
+    constructor(input: ShutdownBindingInput);
+    stop(): Promise<void>;
+    kill(): Promise<void>;
+    teardown(): Promise<void>;
+    exitEvidence(): ShutdownEvidence | "terminal_exited";
+}
+export {};
+//# sourceMappingURL=shutdown-binding.d.ts.map

package/dist/runtime/session/shutdown-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown-binding.d.ts","sourceRoot":"","sources":["../../../src/runtime/session/shutdown-binding.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEvE,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,MAAM,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,QAAQ,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC7D,CAAC;AAEF,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;gBAEjD,KAAK,EAAE,oBAAoB;IAkBvC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,YAAY,IAAI,gBAAgB,GAAG,iBAAiB;CAGrD"}

package/dist/runtime/session/shutdown-binding.js

@@ -0,0 +1,37 @@
+/** Binds one session's lifecycle callbacks to coordinated shutdown (PRD §9.4). */
+import { ShutdownCoordinator } from "../shutdown/coordinator.js";
+import { managedShutdown } from "./shutdown.js";
+export class SessionShutdownBinding {
+    pending;
+    managed;
+    constructor(input) {
+        this.managed = managedShutdown(new ShutdownCoordinator(), () => ({
+            pty: input.pty,
+            stateDir: input.stateDir,
+            elwoodSessionId: input.elwoodSessionId(),
+            socketHome: input.runtime.socketHome,
+            reapPolicy: input.reapPolicy,
+            status: input.status,
+            claimShutdown: (evidence) => {
+                this.pending ??= evidence;
+            },
+            pauseLoops: () => input.loops.pause(),
+            clearLoops: async (reason) => input.loops.clear(reason),
+            cleanupRuntime: input.cleanupRuntime,
+            submitEvidence: input.submitEvidence,
+        }));
+    }
+    stop() {
+        return this.managed.stop();
+    }
+    kill() {
+        return this.managed.kill();
+    }
+    teardown() {
+        return this.managed.teardown();
+    }
+    exitEvidence() {
+        return this.pending ?? "terminal_exited";
+    }
+}
+//# sourceMappingURL=shutdown-binding.js.map

package/dist/runtime/session/shutdown-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown-binding.js","sourceRoot":"","sources":["../../../src/runtime/session/shutdown-binding.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAKlF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAIjE,OAAO,EAAE,eAAe,EAAyB,MAAM,eAAe,CAAC;AAcvE,MAAM,OAAO,sBAAsB;IACzB,OAAO,CAA+B;IAC7B,OAAO,CAAqC;IAE7D,YAAY,KAA2B;QACrC,IAAI,CAAC,OAAO,GAAG,eAAe,CAAC,IAAI,mBAAmB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YAC/D,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,eAAe,EAAE,KAAK,CAAC,eAAe,EAAE;YACxC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU;YACpC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,aAAa,EAAE,CAAC,QAAQ,EAAE,EAAE;gBAC1B,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC;YAC5B,CAAC;YACD,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE;YACrC,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;YACvD,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,cAAc,EAAE,KAAK,CAAC,cAAc;SACrC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,OAAO,IAAI,iBAAiB,CAAC;IAC3C,CAAC;CACF"}

package/dist/runtime/session/shutdown.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Explicit shutdown/teardown orchestration for AgentSessionBase, extracted to keep
+ * the base within the file-size cap. Implements PRD §5.3/§9.4 (C-LIFE-10): every
+ * path ATTEMPTS/RETRIES the leader's process-group reap and propagates a reap failure
+ * as a typed error (never swallows it), while an already-terminal session is never
+ * re-signaled — node-pty does not replay the exit and the pid may be recycled.
+ */
+import type { ElwoodSessionStatus } from "../../core/types.ts";
+import type { PtyProcess } from "../../pty/types.ts";
+import type { ShutdownContext, ShutdownCoordinator } from "../shutdown/coordinator.ts";
+import type { StatusEvidenceKind } from "../status-evidence.ts";
+import type { SessionReapPolicy } from "./reap.ts";
+/** Evidence kinds an explicit shutdown submits once it drives the PTY to exit. */
+export type ShutdownEvidence = "stop_completed" | "kill_completed" | "teardown_completed";
+/** The reap surface shutdown drives: the typed-throw reap plus the retryable one-shot. */
+export type ShutdownReapPolicy = Pick<SessionReapPolicy, "orThrow"> & {
+    readonly reaper: Pick<SessionReapPolicy["reaper"], "reap">;
+};
+/** The session surface the shutdown/teardown orchestration drives. */
+export type ShutdownHost = {
+    readonly pty: PtyProcess;
+    readonly stateDir: string;
+    readonly elwoodSessionId: string;
+    /** The session's stable socket home; teardown removes it whole (§8.1). */
+    readonly socketHome: string;
+    readonly reapPolicy: ShutdownReapPolicy;
+    readonly status: () => ElwoodSessionStatus;
+    readonly claimShutdown: (evidence: ShutdownEvidence) => void;
+    readonly pauseLoops: () => void;
+    readonly clearLoops: (reason: "kill" | "teardown") => Promise<void>;
+    readonly cleanupRuntime: () => Promise<void>;
+    readonly submitEvidence: (kind: StatusEvidenceKind) => void;
+};
+/** The three public shutdown verbs bound to a coordinator and lazy host. */
+type ManagedShutdown = {
+    readonly stop: () => Promise<void>;
+    readonly kill: () => Promise<void>;
+    readonly teardown: () => Promise<void>;
+};
+/** Binds `stop`/`kill`/`teardown` to one coordinator + lazily-built host (C-LIFE-10). */
+export declare function managedShutdown(coordinator: ShutdownCoordinator, host: () => ShutdownHost): ManagedShutdown;
+/**
+ * Graceful stop / force kill. Does NOT re-signal when the PTY was already signaled
+ * (by a prior shutdown, even one that threw before going terminal) or the session is
+ * already terminal — node-pty won't replay exit (the wait would time out) and the pid
+ * may be recycled. In that case it performs a one-shot survivor reap that rejects with
+ * a typed error on failure and leaves the reap retryable; a first, live shutdown marks
+ * signal ownership, terminates the PTY (which reaps on every path), and records
+ * shutdown evidence (C-LIFE-10).
+ */
+export declare function runShutdown(host: ShutdownHost, signal: "SIGTERM" | "SIGKILL", evidence: ShutdownEvidence, ctx: ShutdownContext): Promise<void>;
+/**
+ * Teardown: terminate a still-live PTY (unless it was already signaled), reap
+ * (retrying a prior failed reap), stop the runtime, record teardown evidence, and
+ * remove owned session files. Each step runs even if an earlier one rejected, so a
+ * leaked group is always reaped; a re-signal is refused once signal ownership is held.
+ */
+export declare function runTeardown(host: ShutdownHost, ctx: ShutdownContext): Promise<void>;
+export {};
+//# sourceMappingURL=shutdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shutdown.d.ts","sourceRoot":"","sources":["../../../src/runtime/session/shutdown.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGvF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEnD,kFAAkF;AAClF,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,oBAAoB,CAAC;AAE1F,0FAA0F;AAC1F,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC,GAAG;IACpE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;CAC5D,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,QAAQ,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC7D,CAAC;AAEF,4EAA4E;AAC5E,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC,CAAC;AAEF,yFAAyF;AACzF,wBAAgB,eAAe,CAC7B,WAAW,EAAE,mBAAmB,EAChC,IAAI,EAAE,MAAM,YAAY,GACvB,eAAe,CAMjB;AAuCD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,SAAS,GAAG,SAAS,EAC7B,QAAQ,EAAE,gBAAgB,EAC1B,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,IAAI,CAAC,CAWf;AAkBD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBzF"}

package/dist/runtime/session/shutdown.js

@@ -0,0 +1,140 @@
+/**
+ * Explicit shutdown/teardown orchestration for AgentSessionBase, extracted to keep
+ * the base within the file-size cap. Implements PRD §5.3/§9.4 (C-LIFE-10): every
+ * path ATTEMPTS/RETRIES the leader's process-group reap and propagates a reap failure
+ * as a typed error (never swallows it), while an already-terminal session is never
+ * re-signaled — node-pty does not replay the exit and the pid may be recycled.
+ */
+import { elwoodError } from "../../core/errors.js";
+import { terminalStatuses } from "../../core/status-categories.js";
+import { removeSessionFiles } from "../../state/store.js";
+import { runTeardownSteps } from "../shutdown/teardown.js";
+import { terminatePty } from "../shutdown/terminate.js";
+/** Binds `stop`/`kill`/`teardown` to one coordinator + lazily-built host (C-LIFE-10). */
+export function managedShutdown(coordinator, host) {
+    return {
+        stop: () => runManagedShutdown(coordinator, "stop", host),
+        kill: () => runManagedShutdown(coordinator, "kill", host),
+        teardown: () => runManagedShutdown(coordinator, "teardown", host),
+    };
+}
+// Each public verb's orchestration. The host is the ONE owner of loop pausing: `stop`
+// pauses timers and keeps definitions for resume; `kill`/`teardown` clear them (§8.4).
+const shutdownVerbs = {
+    stop: (host, ctx) => {
+        host.pauseLoops();
+        return runShutdown(host, "SIGTERM", "stop_completed", ctx);
+    },
+    kill: (host, ctx) => runKillShutdown(host, () => runShutdown(host, "SIGKILL", "kill_completed", ctx)),
+    teardown: (host, ctx) => runTeardown(host, ctx),
+};
+/**
+ * Route a public `stop`/`kill`/`teardown` through the session's coordinator so the
+ * PTY is signaled at most once and overlapping callers join the in-flight shutdown
+ * (C-LIFE-10). The host is built lazily inside the coordinated operation, which is
+ * told whether the PTY was `alreadySignaled` so a retry never re-signals it.
+ */
+function runManagedShutdown(coordinator, verb, host) {
+    return coordinator.run(verb, (ctx) => shutdownVerbs[verb](host(), ctx));
+}
+/**
+ * True when the PTY must NOT be signaled: either a prior shutdown already signaled it
+ * (a predecessor that signaled+reaped but threw before submitting terminal status must
+ * not trigger a re-signal of a possibly-recycled PID) OR the session already reached a
+ * terminal status. Signal ownership is tracked INDEPENDENTLY of lifecycle status so a
+ * non-terminal-but-already-signaled state still refuses a second signal (C-LIFE-10).
+ */
+function mustNotSignal(host, ctx) {
+    return ctx.alreadySignaled || terminalStatuses.has(host.status());
+}
+/**
+ * Graceful stop / force kill. Does NOT re-signal when the PTY was already signaled
+ * (by a prior shutdown, even one that threw before going terminal) or the session is
+ * already terminal — node-pty won't replay exit (the wait would time out) and the pid
+ * may be recycled. In that case it performs a one-shot survivor reap that rejects with
+ * a typed error on failure and leaves the reap retryable; a first, live shutdown marks
+ * signal ownership, terminates the PTY (which reaps on every path), and records
+ * shutdown evidence (C-LIFE-10).
+ */
+export async function runShutdown(host, signal, evidence, ctx) {
+    host.claimShutdown(evidence); // Claim the exit before signaling.
+    if (mustNotSignal(host, ctx)) {
+        host.reapPolicy.orThrow(); // Typed rejection on failure; never swallows.
+        await cleanupOrThrowTermination(host);
+        return; // Already signaled / terminal: no new signal, no evidence to submit.
+    }
+    ctx.markSignaled();
+    await terminatePty(host.pty, signal, host.reapPolicy.reaper);
+    await cleanupOrThrowTermination(host);
+    host.submitEvidence(evidence);
+}
+/**
+ * Runs runtime cleanup, folding its raw aggregate failure into the stable public
+ * `termination_failed` error. `runCleanupSteps` rejects with a bare `Error` on the
+ * assumption that its caller wraps it; `stop()`/`kill()` are that caller, so without
+ * this an untyped Error would escape the public shutdown boundary (PRD §10).
+ */
+async function cleanupOrThrowTermination(host) {
+    try {
+        await host.cleanupRuntime();
+    }
+    catch (error) {
+        throw elwoodError("termination_failed", "Could not clean up the Elwood runtime.", {
+            cause: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+/**
+ * Teardown: terminate a still-live PTY (unless it was already signaled), reap
+ * (retrying a prior failed reap), stop the runtime, record teardown evidence, and
+ * remove owned session files. Each step runs even if an earlier one rejected, so a
+ * leaked group is always reaped; a re-signal is refused once signal ownership is held.
+ */
+export async function runTeardown(host, ctx) {
+    host.claimShutdown("teardown_completed");
+    const shouldSignal = () => !mustNotSignal(host, ctx);
+    await runPermanentShutdown(host, "teardown", () => runTeardownSteps([
+        () => {
+            if (!shouldSignal())
+                return undefined;
+            ctx.markSignaled();
+            return terminatePty(host.pty, "SIGKILL", host.reapPolicy.reaper);
+        },
+        () => host.reapPolicy.reaper.reap(), // No-op once latched; retries a failed reap.
+        () => host.cleanupRuntime(),
+        () => host.submitEvidence("teardown_completed"),
+        () => removeSessionFiles({
+            stateDir: host.stateDir,
+            elwoodSessionId: host.elwoodSessionId,
+            socketHome: host.socketHome,
+        }),
+    ]));
+}
+/** Clear durable loops first, but always finish process/file cleanup before rejecting. */
+async function runPermanentShutdown(host, reason, cleanup) {
+    let loopFailure;
+    let cleanupFailure;
+    try {
+        await host.clearLoops(reason);
+    }
+    catch (error) {
+        loopFailure = error;
+    }
+    try {
+        await cleanup();
+    }
+    catch (error) {
+        cleanupFailure = error;
+    }
+    if (loopFailure !== undefined)
+        throw loopFailure;
+    if (cleanupFailure !== undefined)
+        throw cleanupFailure;
+}
+/** Kill stops live timers first, but keeps durable definitions until termination succeeds. */
+async function runKillShutdown(host, cleanup) {
+    host.pauseLoops();
+    await cleanup();
+    await host.clearLoops("kill");
+}
+//# sourceMappingURL=shutdown.js.map

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

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

package/dist/runtime/session/status-wiring.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Connects lifecycle status transitions to the control queue, loops, event
+ * delivery, and cleanup (PRD §5.3/§5.9, C-API-42). Status and activity events are
+ * emitted here; a throwing status listener PROPAGATES by design — the
+ * `initial_ready` transition relies on it to trigger its release-and-warn fallback.
+ * The engine commits its live `current` status BEFORE emitting, so a throw here can
+ * never leave the emitted event disagreeing with that live status (§8.2).
+ */
+import { type ElwoodActivityEvent, type ElwoodAgentKind } from "../../core/activity/index.ts";
+import type { CompactEmitter } from "../../core/compact.ts";
+import type { ControlQueue } from "../../core/control-queue/index.ts";
+import type { ElwoodSessionStatus, Unsubscribe } from "../../core/types.ts";
+import { SessionStatusEngine } from "../status-evidence.ts";
+import type { LoopEventEmitter, SessionLoops } from "./loops.ts";
+type StatusEvent = {
+    readonly elwoodSessionId: string;
+    readonly status: ElwoodSessionStatus;
+};
+/** The emitter surface a session's status, compact, loop, and activity wiring needs. */
+export type SessionStatusEmitter = CompactEmitter & LoopEventEmitter & {
+    emit(event: "status", payload: StatusEvent): void;
+    emit(event: "activity", payload: ElwoodActivityEvent): void;
+    on(event: "activity", handler: (event: ElwoodActivityEvent) => void): Unsubscribe;
+};
+type StatusWiringInput = {
+    readonly agent: ElwoodAgentKind;
+    readonly elwoodSessionId: string;
+    readonly emitter: SessionStatusEmitter;
+    readonly queue: ControlQueue;
+    readonly loops: SessionLoops;
+    readonly markReady: () => void;
+    readonly cleanup: () => void;
+};
+export declare function createSessionStatusEngine(input: StatusWiringInput): SessionStatusEngine;
+/** Deliver the status event and its derived activity event (a listener throw propagates). */
+export declare function emitStatusEvents(emitter: SessionStatusEmitter, agent: ElwoodAgentKind, id: string, status: ElwoodSessionStatus): void;
+export {};
+//# sourceMappingURL=status-wiring.d.ts.map

package/dist/runtime/session/status-wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-wiring.d.ts","sourceRoot":"","sources":["../../../src/runtime/session/status-wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEjE,KAAK,WAAW,GAAG;IAAE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAE9F,wFAAwF;AACxF,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAC/C,gBAAgB,GAAG;IACjB,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAClD,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC5D,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAAG,WAAW,CAAC;CACnF,CAAC;AAEJ,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,iBAAiB,GAAG,mBAAmB,CAyBvF;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE,eAAe,EACtB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,mBAAmB,GAC1B,IAAI,CAGN"}

package/dist/runtime/session/status-wiring.js

@@ -0,0 +1,41 @@
+/**
+ * Connects lifecycle status transitions to the control queue, loops, event
+ * delivery, and cleanup (PRD §5.3/§5.9, C-API-42). Status and activity events are
+ * emitted here; a throwing status listener PROPAGATES by design — the
+ * `initial_ready` transition relies on it to trigger its release-and-warn fallback.
+ * The engine commits its live `current` status BEFORE emitting, so a throw here can
+ * never leave the emitted event disagreeing with that live status (§8.2).
+ */
+import { activityFromStatus, } from "../../core/activity/index.js";
+import { SessionStatusEngine } from "../status-evidence.js";
+export function createSessionStatusEngine(input) {
+    // Both a turn in progress and a blocking dialog suspend delivery the same way:
+    // the queue stops draining and due loops wait (§5.9: "a due loop waits while the
+    // session is running, blocked, or otherwise unable to accept a message"). Neither
+    // implies a NEW turn — that is `turnStarted`, driven by the queue's own submission.
+    const suspend = () => {
+        input.loops.running();
+        input.queue.suspendReadiness();
+    };
+    return new SessionStatusEngine({
+        onReady: input.markReady,
+        emitStatus: (status) => emitStatusEvents(input.emitter, input.agent, input.elwoodSessionId, status),
+        queueRunning: suspend,
+        queueReady: () => {
+            input.loops.ready();
+            input.queue.markReady();
+        },
+        queueBlocked: suspend,
+        queueClose: () => {
+            input.loops.pause();
+            input.queue.close();
+        },
+        cleanup: input.cleanup,
+    });
+}
+/** Deliver the status event and its derived activity event (a listener throw propagates). */
+export function emitStatusEvents(emitter, agent, id, status) {
+    emitter.emit("status", { elwoodSessionId: id, status });
+    emitter.emit("activity", activityFromStatus(agent, id, status));
+}
+//# sourceMappingURL=status-wiring.js.map

package/dist/runtime/session/status-wiring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-wiring.js","sourceRoot":"","sources":["../../../src/runtime/session/status-wiring.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,kBAAkB,GAGnB,MAAM,8BAA8B,CAAC;AAItC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAuB5D,MAAM,UAAU,yBAAyB,CAAC,KAAwB;IAChE,+EAA+E;IAC/E,iFAAiF;IACjF,kFAAkF;IAClF,oFAAoF;IACpF,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACtB,KAAK,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;IACjC,CAAC,CAAC;IACF,OAAO,IAAI,mBAAmB,CAAC;QAC7B,OAAO,EAAE,KAAK,CAAC,SAAS;QACxB,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,CACrB,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,eAAe,EAAE,MAAM,CAAC;QAC7E,YAAY,EAAE,OAAO;QACrB,UAAU,EAAE,GAAG,EAAE;YACf,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACpB,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QAC1B,CAAC;QACD,YAAY,EAAE,OAAO;QACrB,UAAU,EAAE,GAAG,EAAE;YACf,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACpB,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;QACD,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;AACL,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,gBAAgB,CAC9B,OAA6B,EAC7B,KAAsB,EACtB,EAAU,EACV,MAA2B;IAE3B,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/runtime/session/status.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Shared lifecycle status helpers for in-memory sessions.
+ * Implements PRD §5 lifecycle guarantees.
+ */
+import type { ElwoodSessionStatus } from "../../core/types.ts";
+export declare function canTransition(current: ElwoodSessionStatus, next: ElwoodSessionStatus): boolean;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/runtime/session/status.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,wBAAgB,aAAa,CAAC,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAW9F"}

package/dist/runtime/session/status.js

@@ -0,0 +1,22 @@
+/**
+ * Shared lifecycle status helpers for in-memory sessions.
+ * Implements PRD §5 lifecycle guarantees.
+ */
+import { terminalStatuses } from "../../core/status-categories.js";
+export function canTransition(current, next) {
+    if (current === next)
+        return false;
+    if (current === "torn_down")
+        return false;
+    // `teardown` is the final cleanup and may supersede any earlier terminal
+    // status (e.g. tearing down an already-exited session).
+    if (next === "torn_down")
+        return true;
+    // Otherwise a terminated session keeps its first terminal status: no
+    // terminal status transitions to another, so a racing `exited` cannot
+    // override a controlled `stopped`/`killed`.
+    if (terminalStatuses.has(current))
+        return false;
+    return true;
+}
+//# sourceMappingURL=status.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/runtime/session/status.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAGnE,MAAM,UAAU,aAAa,CAAC,OAA4B,EAAE,IAAyB;IACnF,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,OAAO,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAC1C,yEAAyE;IACzE,wDAAwD;IACxD,IAAI,IAAI,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IACtC,qEAAqE;IACrE,sEAAsE;IACtE,4CAA4C;IAC5C,IAAI,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/runtime/session-base-types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Types and labels shared by the adapter session base class.
+ * Implements PRD §5.3 and §5.7 common session semantics.
+ */
+import type { ElwoodActivityEvent, ElwoodAgentKind } from "../core/activity.ts";
+import type { CompactEmitter } from "../core/compact.ts";
+import type { ElwoodSessionStatus, Unsubscribe } from "../core/types.ts";
+import type { LoopEventEmitter } from "./session-loops.ts";
+export type { ElwoodAgentKind } from "../core/activity.ts";
+export type { SendOptions } from "../core/images/types.ts";
+export type { ElwoodLoopRequest, ElwoodLoopSnapshot } from "../core/loops/types.ts";
+export type { ModelPickerSpec } from "../core/model-picker.ts";
+export type { AgentModelOption } from "../core/model-rows.ts";
+export type { PasteGuard } from "../core/session-input.ts";
+export { terminalStatuses } from "../core/status-categories.ts";
+export type { TerminalReplayBuffer } from "../core/terminal-replay.ts";
+export type { ElwoodSessionStatus, ElwoodWarningEvent, TerminalSize } from "../core/types.ts";
+export type { PtyProcess } from "../pty/types.ts";
+export type { PersistedLoopDefinition } from "../state/loop-store.ts";
+export type { SessionRuntime } from "../state/runtime-paths.ts";
+export type { SessionRecord } from "../state/store.ts";
+export type { ElwoodTerminal } from "../terminal/headless.ts";
+export type { AttachDriver, AttachTask, SubmitKind } from "./session-image-attach.ts";
+export type { SessionStatusEngine, StatusDecision, StatusEvidenceKind } from "./status-evidence.ts";
+type StatusEvent = {
+    readonly elwoodSessionId: string;
+    readonly status: ElwoodSessionStatus;
+};
+export type SessionStatusEmitter = CompactEmitter & LoopEventEmitter & {
+    emit(event: "status", payload: StatusEvent): void;
+    emit(event: "activity", payload: ElwoodActivityEvent): void;
+    on(event: "activity", handler: (event: ElwoodActivityEvent) => void): Unsubscribe;
+};
+export declare const agentTitles: Readonly<Record<ElwoodAgentKind, string>>;
+export declare function notRunningError(agent: ElwoodAgentKind): Error;
+//# sourceMappingURL=session-base-types.d.ts.map

package/dist/runtime/session-base-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-base-types.d.ts","sourceRoot":"","sources":["../../src/runtime/session-base-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACpF,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,YAAY,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,YAAY,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC9F,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACtF,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEpG,KAAK,WAAW,GAAG;IAAE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAE9F,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAC/C,gBAAgB,GAAG;IACjB,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAClD,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC5D,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAAG,WAAW,CAAC;CACnF,CAAC;AAEJ,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAGjE,CAAC;AAEF,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,KAAK,CAE7D"}

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

@@ -0,0 +1,14 @@
+/**
+ * Types and labels shared by the adapter session base class.
+ * Implements PRD §5.3 and §5.7 common session semantics.
+ */
+import { elwoodError } from "../core/errors.js";
+export { terminalStatuses } from "../core/status-categories.js";
+export const agentTitles = {
+    claude: "Claude",
+    codex: "Codex",
+};
+export function notRunningError(agent) {
+    return elwoodError("session_not_running", `${agentTitles[agent]} session is not running.`);
+}
+//# sourceMappingURL=session-base-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-base-types.js","sourceRoot":"","sources":["../../src/runtime/session-base-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAUhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAoBhE,MAAM,CAAC,MAAM,WAAW,GAA8C;IACpE,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;CACf,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,OAAO,WAAW,CAAC,qBAAqB,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;AAC7F,CAAC"}

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

@@ -0,0 +1,48 @@
+/**
+ * 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 type { ElwoodAgentKind } from "../core/activity.ts";
+import type { SendOptions } from "../core/images/types.ts";
+import type { ElwoodLoopRequest, ElwoodLoopSnapshot } from "../core/loops/types.ts";
+import type { ModelPickerSpec } from "../core/model-picker.ts";
+import type { AgentModelOption } from "../core/model-rows.ts";
+import type { TerminalReplayBuffer } from "../core/terminal-replay.ts";
+import type { TerminalSize } 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 { SessionLifecycle } from "./session-lifecycle.ts";
+import type { SessionStatusEmitter } from "./session-status-wiring.ts";
+type Timeout = {
+    readonly timeoutMs?: number;
+};
+export declare abstract class AgentSessionBase extends SessionLifecycle {
+    protected abstract readonly picker: ModelPickerSpec;
+    private readonly commands;
+    private readonly imageBudget;
+    protected constructor(agent: ElwoodAgentKind, record: SessionRecord, stateDir: string, runtime: SessionRuntime, pty: PtyProcess, terminal: ElwoodTerminal, statusEvents: SessionStatusEmitter, terminalReplay: TerminalReplayBuffer, loopDefinitions: readonly PersistedLoopDefinition[]);
+    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?: Timeout): Promise<void>;
+    compact(options?: Timeout): Promise<void>;
+    listModels(options?: Timeout): Promise<readonly AgentModelOption[]>;
+    setModel(id: string, options?: Timeout): Promise<void>;
+    createLoop(request: ElwoodLoopRequest): Promise<ElwoodLoopSnapshot>;
+    listLoops(): Promise<readonly ElwoodLoopSnapshot[]>;
+    cancelLoop(loopId: string): Promise<void>;
+    /** Attach `paths` to the composer before the queued text is submitted (C-API-44). */
+    protected abstract attachImages(paths: readonly string[], signal: AbortSignal): Promise<void>;
+    /** Re-apply a resize that was held during startup (a best-effort restore). */
+    protected restoreHeldSize(size: TerminalSize): void;
+    private enqueue;
+}
+export {};
+//# sourceMappingURL=session-base.d.ts.map

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

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