@with-logic/elwood 0.1.0

package/dist/core/loops/timers.js

@@ -0,0 +1,47 @@
+/**
+ * Injectable one-shot, unreferenced timers for recurring loops: the scheduler seam
+ * and the per-loop due/expiry timer bank. Implements PRD §5.9 and C-LOOP-05/C-LOOP-13.
+ * The cadence arithmetic that drives the bank lives in `timing.ts`. The seam's
+ * contract is deliberately loose — an injected scheduler MAY still fire a timer
+ * after `cancel` — so every timer callback re-checks that its loop still exists and
+ * the scheduler is live before acting.
+ */
+/** Production timer seam; tests inject a deterministic scheduler instead. */
+export const scheduleLoopTimer = (run, delayMs) => {
+    const timer = setTimeout(run, delayMs);
+    timer.unref();
+    return { cancel: () => clearTimeout(timer) };
+};
+export class LoopTimerBank {
+    timers = new Map();
+    schedule;
+    constructor(schedule) {
+        this.schedule = schedule;
+    }
+    arm(kind, loopId, delayMs, run) {
+        const key = `${kind}:${loopId}`;
+        this.timers.get(key)?.cancel();
+        const timer = this.schedule(() => {
+            this.timers.delete(key);
+            run();
+        }, Math.max(0, delayMs));
+        this.timers.set(key, timer);
+    }
+    cancelDue(loopId) {
+        this.cancel(`due:${loopId}`);
+    }
+    cancelLoop(loopId) {
+        this.cancelDue(loopId);
+        this.cancel(`expiry:${loopId}`);
+    }
+    clear() {
+        for (const timer of this.timers.values())
+            timer.cancel();
+        this.timers.clear();
+    }
+    cancel(key) {
+        this.timers.get(key)?.cancel();
+        this.timers.delete(key);
+    }
+}
+//# sourceMappingURL=timers.js.map

package/dist/core/loops/timers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.js","sourceRoot":"","sources":["../../../src/core/loops/timers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,6EAA6E;AAC7E,MAAM,CAAC,MAAM,iBAAiB,GAAuB,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;IACpE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACvC,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;AAC/C,CAAC,CAAC;AAEF,MAAM,OAAO,aAAa;IACP,MAAM,GAAG,IAAI,GAAG,EAAqB,CAAC;IACtC,QAAQ,CAAqB;IAE9C,YAAY,QAA4B;QACtC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,IAAsB,EAAE,MAAc,EAAE,OAAe,EAAE,GAAe;QAC1E,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CACzB,GAAG,EAAE;YACH,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,GAAG,EAAE,CAAC;QACR,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CACrB,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,MAAM,CAAC,OAAO,MAAM,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,UAAU,CAAC,MAAc;QACvB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACvB,IAAI,CAAC,MAAM,CAAC,UAAU,MAAM,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,KAAK;QACH,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;YAAE,KAAK,CAAC,MAAM,EAAE,CAAC;QACzD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAEO,MAAM,CAAC,GAAW;QACxB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/core/loops/timing.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Due/expiry timing for recurring loops: arms each loop's next due time and wall-clock
+ * expiry on the timer bank, retrying a failed arm once while live, and marks loops due
+ * (batching any other loop already past its due time) when a timer fires.
+ * Implements PRD §5.9 and C-LOOP-05/C-LOOP-08/C-LOOP-13.
+ */
+import type { LoopRuntimeEntry, LoopSchedulerState } from "./scheduler-state.ts";
+import type { LoopTimerBank } from "./timers.ts";
+type LoopTimingOptions = {
+    readonly state: LoopSchedulerState;
+    readonly now: () => number;
+    readonly live: () => boolean;
+    readonly fail: (entry: LoopRuntimeEntry) => void;
+    readonly expire: (loopId: string) => void;
+    readonly pump: () => void;
+};
+export declare class LoopTiming {
+    private readonly options;
+    private readonly timers;
+    constructor(timers: LoopTimerBank, options: LoopTimingOptions);
+    armDue(entry: LoopRuntimeEntry, anchor: number, retry?: boolean): void;
+    armExpiry(entry: LoopRuntimeEntry, retry?: boolean): void;
+    expireSafely(loopId: string): void;
+    private markDue;
+}
+export {};
+//# sourceMappingURL=timing.d.ts.map

package/dist/core/loops/timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.d.ts","sourceRoot":"","sources":["../../../src/core/loops/timing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAEF,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB;IAK7D,MAAM,CAAC,KAAK,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,UAAO,GAAG,IAAI;IAkBnE,SAAS,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,UAAO,GAAG,IAAI;IActD,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQlC,OAAO,CAAC,OAAO;CAehB"}

package/dist/core/loops/timing.js

@@ -0,0 +1,68 @@
+/**
+ * Due/expiry timing for recurring loops: arms each loop's next due time and wall-clock
+ * expiry on the timer bank, retrying a failed arm once while live, and marks loops due
+ * (batching any other loop already past its due time) when a timer fires.
+ * Implements PRD §5.9 and C-LOOP-05/C-LOOP-08/C-LOOP-13.
+ */
+import { IDLE_LOOP_INTERVAL_MS } from "./constants.js";
+export class LoopTiming {
+    options;
+    timers;
+    constructor(timers, options) {
+        this.timers = timers;
+        this.options = options;
+    }
+    armDue(entry, anchor, retry = true) {
+        const cadence = entry.definition.mode === "fixed" ? entry.definition.intervalMs : IDLE_LOOP_INTERVAL_MS;
+        const dueAt = anchor + cadence + entry.definition.jitterMs;
+        try {
+            this.timers.arm("due", entry.definition.id, dueAt - this.options.now(), () => this.markDue(entry.definition.id, dueAt));
+            entry.state = "scheduled";
+            entry.nextDueAt = dueAt;
+            entry.dueAt = undefined;
+        }
+        catch {
+            entry.state = "waiting";
+            this.options.fail(entry);
+            if (retry)
+                this.armDue(entry, this.options.now(), false); // one re-arm from a fresh anchor
+        }
+    }
+    armExpiry(entry, retry = true) {
+        try {
+            this.timers.arm("expiry", entry.definition.id, entry.definition.expiresAt - this.options.now(), () => this.expireSafely(entry.definition.id));
+        }
+        catch {
+            this.options.fail(entry);
+            if (retry)
+                this.armExpiry(entry, false);
+        }
+    }
+    expireSafely(loopId) {
+        try {
+            this.options.expire(loopId);
+        }
+        catch {
+            // Persistence failure was already converted into a contained loop event.
+        }
+    }
+    markDue(loopId, dueAt) {
+        const entry = this.options.state.get(loopId);
+        if (!(entry && this.options.live()))
+            return;
+        entry.state = "due";
+        entry.dueAt = dueAt;
+        entry.nextDueAt = undefined;
+        for (const scheduled of this.options.state.entries()) {
+            if (scheduled.state !== "scheduled" || scheduled.nextDueAt === undefined)
+                continue;
+            if (scheduled.nextDueAt > dueAt)
+                continue;
+            scheduled.state = "due";
+            scheduled.dueAt = scheduled.nextDueAt;
+            scheduled.nextDueAt = undefined;
+        }
+        this.options.pump();
+    }
+}
+//# sourceMappingURL=timing.js.map

package/dist/core/loops/timing.js.map

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

package/dist/core/loops/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Public recurring-loop requests, snapshots, and event variants.
+ * Implements PRD §5.9 and C-LOOP-02/C-LOOP-10.
+ */
+export type ElwoodLoopRequest = {
+    readonly mode: "fixed";
+    readonly intervalMs: number;
+    readonly message: string;
+} | {
+    readonly mode: "idle";
+    readonly message: string;
+};
+export type ElwoodLoopState = "waiting" | "scheduled" | "due" | "submitted";
+export interface ElwoodLoopSnapshot {
+    readonly id: string;
+    readonly message: string;
+    readonly mode: "fixed" | "idle";
+    readonly intervalMs?: number;
+    readonly jitterMs: number;
+    readonly createdAt: number;
+    readonly expiresAt: number;
+    readonly state: ElwoodLoopState;
+    readonly nextDueAt?: number;
+}
+export type ElwoodLoopEventSnapshot = Omit<ElwoodLoopSnapshot, "message">;
+export type ElwoodLoopEvent = {
+    readonly kind: "created";
+    readonly loopId: string;
+    readonly at: number;
+    readonly snapshot: ElwoodLoopEventSnapshot;
+} | {
+    readonly kind: "fired";
+    readonly loopId: string;
+    readonly scheduledDueAt: number;
+    readonly submittedAt: number;
+    readonly snapshot: ElwoodLoopEventSnapshot & {
+        readonly state: "submitted";
+    };
+} | {
+    readonly kind: "cancelled";
+    readonly loopId: string;
+    readonly at: number;
+    readonly reason: "caller" | "kill" | "teardown";
+} | {
+    readonly kind: "expired";
+    readonly loopId: string;
+    readonly at: number;
+} | {
+    readonly kind: "failed";
+    readonly loopId: string;
+    readonly at: number;
+    readonly phase: "persistence" | "scheduling" | "submission";
+    readonly snapshot?: ElwoodLoopEventSnapshot;
+    readonly code: "loop_persistence_failed" | "loop_submission_failed";
+    readonly message: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/core/loops/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/loops/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,iBAAiB,GACzB;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,WAAW,GAAG,KAAK,GAAG,WAAW,CAAC;AAE5E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;AAE1E,MAAM,MAAM,eAAe,GACvB;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;CAC5C,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;KAAE,CAAC;CAC9E,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;CACjD,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,GAAG,YAAY,CAAC;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,yBAAyB,GAAG,wBAAwB,CAAC;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC"}

package/dist/core/loops/types.js

@@ -0,0 +1,6 @@
+/**
+ * Public recurring-loop requests, snapshots, and event variants.
+ * Implements PRD §5.9 and C-LOOP-02/C-LOOP-10.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/loops/types.js.map

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

package/dist/core/loops/validate.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Runtime validation for recurring-loop creation requests.
+ * Implements PRD §5.9 and C-LOOP-03/C-LOOP-10.
+ */
+import type { ElwoodLoopRequest } from "./types.ts";
+export declare function validateLoopMessage(message: unknown): string;
+export declare function validateLoopIntervalMs(intervalMs: unknown): number;
+export declare function validateLoopRequest(request: unknown): ElwoodLoopRequest;
+//# sourceMappingURL=validate.d.ts.map

package/dist/core/loops/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/core/loops/validate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMpD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAO5D;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,CAUlE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAiBvE"}

package/dist/core/loops/validate.js

@@ -0,0 +1,46 @@
+/**
+ * Runtime validation for recurring-loop creation requests.
+ * Implements PRD §5.9 and C-LOOP-03/C-LOOP-10.
+ */
+import { elwoodError } from "../errors.js";
+import { MAX_LOOP_INTERVAL_MS, MAX_LOOP_MESSAGE_BYTES, MIN_LOOP_INTERVAL_MS, MIN_LOOP_MESSAGE_BYTES, } from "./constants.js";
+function invalidLoop(field) {
+    throw elwoodError("invalid_loop", "Loop request is invalid.", { field });
+}
+export function validateLoopMessage(message) {
+    if (typeof message !== "string")
+        invalidLoop("message");
+    const bytes = Buffer.byteLength(message, "utf8");
+    if (bytes < MIN_LOOP_MESSAGE_BYTES || bytes > MAX_LOOP_MESSAGE_BYTES) {
+        invalidLoop("message");
+    }
+    return message;
+}
+export function validateLoopIntervalMs(intervalMs) {
+    if (typeof intervalMs !== "number" ||
+        !Number.isSafeInteger(intervalMs) ||
+        intervalMs < MIN_LOOP_INTERVAL_MS ||
+        intervalMs >= MAX_LOOP_INTERVAL_MS) {
+        invalidLoop("intervalMs");
+    }
+    return intervalMs;
+}
+export function validateLoopRequest(request) {
+    if (typeof request !== "object" || request === null || Array.isArray(request)) {
+        invalidLoop("request");
+    }
+    const candidate = request;
+    const message = validateLoopMessage(candidate["message"]);
+    if (candidate["mode"] === "fixed") {
+        return {
+            mode: "fixed",
+            intervalMs: validateLoopIntervalMs(candidate["intervalMs"]),
+            message,
+        };
+    }
+    if (candidate["mode"] === "idle" && !("intervalMs" in candidate)) {
+        return { mode: "idle", message };
+    }
+    return invalidLoop("request");
+}
+//# sourceMappingURL=validate.js.map

package/dist/core/loops/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/core/loops/validate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,gBAAgB,CAAC;AAGxB,SAAS,WAAW,CAAC,KAA2C;IAC9D,MAAM,WAAW,CAAC,cAAc,EAAE,0BAA0B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACjD,IAAI,KAAK,GAAG,sBAAsB,IAAI,KAAK,GAAG,sBAAsB,EAAE,CAAC;QACrE,WAAW,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,UAAmB;IACxD,IACE,OAAO,UAAU,KAAK,QAAQ;QAC9B,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC;QACjC,UAAU,GAAG,oBAAoB;QACjC,UAAU,IAAI,oBAAoB,EAClC,CAAC;QACD,WAAW,CAAC,YAAY,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9E,WAAW,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,SAAS,GAAG,OAA4C,CAAC;IAC/D,MAAM,OAAO,GAAG,mBAAmB,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1D,IAAI,SAAS,CAAC,MAAM,CAAC,KAAK,OAAO,EAAE,CAAC;QAClC,OAAO;YACL,IAAI,EAAE,OAAO;YACb,UAAU,EAAE,sBAAsB,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;YAC3D,OAAO;SACR,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,YAAY,IAAI,SAAS,CAAC,EAAE,CAAC;QACjE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACnC,CAAC;IACD,OAAO,WAAW,CAAC,SAAS,CAAC,CAAC;AAChC,CAAC"}

package/dist/core/model-picker.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared /model picker automation for adapter sessions.
+ * Implements PRD §5.3, §5.7, C-API-23, and C-API-24.
+ */
+import type { AgentModelOption, ParsedModelPicker } from "./model-rows.ts";
+import { type ScreenTerminal } from "./tui-screen.ts";
+export declare function pickerTimeout(options?: {
+    readonly timeoutMs?: number;
+}): number;
+export type ModelPickerIo = {
+    readonly terminal: ScreenTerminal;
+    readonly submit: (command: string) => Promise<void>;
+};
+export type ModelPickerSpec = {
+    readonly agent: string;
+    readonly isOpen: (text: string) => boolean;
+    readonly parse: (text: string) => ParsedModelPicker;
+    readonly apply: (io: ModelPickerIo, timeoutMs: number) => Promise<void>;
+};
+export declare function listPickerModels(io: ModelPickerIo, spec: ModelPickerSpec, timeoutMs: number): Promise<readonly AgentModelOption[]>;
+export declare function setPickerModel(io: ModelPickerIo, spec: ModelPickerSpec, id: string, timeoutMs: number): Promise<void>;
+//# sourceMappingURL=model-picker.d.ts.map

package/dist/core/model-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-picker.d.ts","sourceRoot":"","sources":["../../src/core/model-picker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAGL,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAEzB,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE/E;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,iBAAiB,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE,CAAC;AAOF,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAUtC;AAED,wBAAsB,cAAc,CAClC,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,eAAe,EACrB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA2Bf"}

package/dist/core/model-picker.js

@@ -0,0 +1,58 @@
+/**
+ * Shared /model picker automation for adapter sessions.
+ * Implements PRD §5.3, §5.7, C-API-23, and C-API-24.
+ */
+import { delay } from "./delay.js";
+import { elwoodError } from "./errors.js";
+import { defaultModelTimeoutMs, openCommandScreen, waitForScreen, } from "./tui-screen.js";
+export function pickerTimeout(options) {
+    return options?.timeoutMs ?? defaultModelTimeoutMs;
+}
+const escapeKey = "\u001b";
+const arrowDown = "\u001b[B";
+const arrowUp = "\u001b[A";
+const arrowStepMs = 80;
+export async function listPickerModels(io, spec, timeoutMs) {
+    const parsed = await openAndParse(io, spec, timeoutMs);
+    await io.terminal.sendInput(escapeKey);
+    await waitForScreen(io.terminal, (text) => !spec.isOpen(text), timeoutMs, `${spec.agent} model picker to close`);
+    return parsed.options;
+}
+export async function setPickerModel(io, spec, id, timeoutMs) {
+    const parsed = await openAndParse(io, spec, timeoutMs);
+    const wanted = id.toLowerCase();
+    // Row ids are already lower-cased labels (`model-rows.ts`), so matching the id
+    // alone covers a caller that passes the display label in any case.
+    const target = parsed.options.findIndex((option) => option.id === wanted);
+    if (target === -1 || parsed.cursorIndex === -1) {
+        await io.terminal.sendInput(escapeKey);
+        const reason = target === -1 ? `Unknown model id "${id}".` : "Could not locate the picker cursor.";
+        throw elwoodError("model_automation_failed", reason, {
+            available: parsed.options.map((option) => option.id),
+        });
+    }
+    const delta = target - parsed.cursorIndex;
+    const key = delta > 0 ? arrowDown : arrowUp;
+    for (let step = 0; step < Math.abs(delta); step += 1) {
+        await io.terminal.sendInput(key);
+        await delay(arrowStepMs);
+    }
+    await waitForScreen(io.terminal, (text) => spec.parse(text).cursorIndex === target, timeoutMs, `${spec.agent} picker cursor on "${id}"`);
+    await spec.apply(io, timeoutMs);
+}
+async function openAndParse(io, spec, timeoutMs) {
+    const text = await openCommandScreen({
+        terminal: io.terminal,
+        submit: () => io.submit("/model"),
+        isOpen: spec.isOpen,
+        timeoutMs,
+        label: `${spec.agent} model picker`,
+    });
+    const parsed = spec.parse(text);
+    if (parsed.options.length === 0) {
+        await io.terminal.sendInput(escapeKey);
+        throw elwoodError("model_automation_failed", "Could not parse any model picker rows.");
+    }
+    return parsed;
+}
+//# sourceMappingURL=model-picker.js.map

package/dist/core/model-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-picker.js","sourceRoot":"","sources":["../../src/core/model-picker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EAEjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,MAAM,UAAU,aAAa,CAAC,OAAyC;IACrE,OAAO,OAAO,EAAE,SAAS,IAAI,qBAAqB,CAAC;AACrD,CAAC;AAcD,MAAM,SAAS,GAAG,QAAQ,CAAC;AAC3B,MAAM,SAAS,GAAG,UAAU,CAAC;AAC7B,MAAM,OAAO,GAAG,UAAU,CAAC;AAC3B,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,EAAiB,EACjB,IAAqB,EACrB,SAAiB;IAEjB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IACvD,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,aAAa,CACjB,EAAE,CAAC,QAAQ,EACX,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAC5B,SAAS,EACT,GAAG,IAAI,CAAC,KAAK,wBAAwB,CACtC,CAAC;IACF,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAiB,EACjB,IAAqB,EACrB,EAAU,EACV,SAAiB;IAEjB,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IAChC,+EAA+E;IAC/E,mEAAmE;IACnE,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IAC1E,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;QAC/C,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,MAAM,GACV,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC,CAAC,qCAAqC,CAAC;QACtF,MAAM,WAAW,CAAC,yBAAyB,EAAE,MAAM,EAAE;YACnD,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;SACrD,CAAC,CAAC;IACL,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC;IAC1C,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IAC5C,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,KAAK,CAAC,WAAW,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,aAAa,CACjB,EAAE,CAAC,QAAQ,EACX,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,KAAK,MAAM,EACjD,SAAS,EACT,GAAG,IAAI,CAAC,KAAK,sBAAsB,EAAE,GAAG,CACzC,CAAC;IACF,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,EAAiB,EACjB,IAAqB,EACrB,SAAiB;IAEjB,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC;QACnC,QAAQ,EAAE,EAAE,CAAC,QAAQ;QACrB,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;QACjC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS;QACT,KAAK,EAAE,GAAG,IAAI,CAAC,KAAK,eAAe;KACpC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,WAAW,CAAC,yBAAyB,EAAE,wCAAwC,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/model-rows.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Parses rendered adapter model picker rows into typed options.
+ * Implements PRD §5.3 AgentModelOption and C-API-23.
+ */
+export type AgentModelOption = {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+    readonly isCurrent: boolean;
+    readonly isDefault: boolean;
+    readonly raw: string;
+};
+export type ParsedModelPicker = {
+    readonly options: readonly AgentModelOption[];
+    readonly cursorIndex: number;
+};
+export declare const claudeModelPickerHeader: RegExp;
+export declare const codexModelPickerHeader: RegExp;
+export declare function parseClaudeModelPicker(text: string): ParsedModelPicker;
+export declare function parseCodexModelPicker(text: string): ParsedModelPicker;
+//# sourceMappingURL=model-rows.d.ts.map

package/dist/core/model-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-rows.d.ts","sourceRoot":"","sources":["../../src/core/model-rows.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,uBAAuB,QAAiB,CAAC;AACtD,eAAO,MAAM,sBAAsB,QAA4B,CAAC;AAIhE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAUtE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAarE"}

package/dist/core/model-rows.js

@@ -0,0 +1,57 @@
+/**
+ * Parses rendered adapter model picker rows into typed options.
+ * Implements PRD §5.3 AgentModelOption and C-API-23.
+ */
+export const claudeModelPickerHeader = /Select model/;
+export const codexModelPickerHeader = /Select Model and Effort/;
+const rowPattern = /^\s*(❯|›)?\s*\d+\.\s+(.+?)\s{2,}(\S.*?)\s*$/;
+export function parseClaudeModelPicker(text) {
+    return parseRows(pickerRegion(text, claudeModelPickerHeader), (labelText) => {
+        const isCurrent = labelText.includes("✔");
+        const isDefault = /\(recommended\)/i.test(labelText);
+        const label = labelText
+            .replace("✔", "")
+            .replace(/\(recommended\)/i, "")
+            .trim();
+        return { label, id: label.toLowerCase(), isCurrent, isDefault };
+    });
+}
+export function parseCodexModelPicker(text) {
+    const parsed = parseRows(pickerRegion(text, codexModelPickerHeader), (labelText) => {
+        const isCurrent = /\(current\)/i.test(labelText);
+        const isDefault = /\(default\)/i.test(labelText);
+        const label = labelText.replace(/\((?:current|default)\)/gi, "").trim();
+        return { label, id: label.toLowerCase(), isCurrent, isDefault };
+    });
+    // Codex omits the default marker when the current model is the default.
+    if (parsed.options.some((option) => option.isDefault))
+        return parsed;
+    const options = parsed.options.map((option) => option.isCurrent ? { ...option, isDefault: true } : option);
+    return { options, cursorIndex: parsed.cursorIndex };
+}
+function parseRows(region, decorate) {
+    const options = [];
+    let cursorIndex = -1;
+    for (const line of region.split("\n")) {
+        const match = rowPattern.exec(line);
+        if (!match)
+            continue;
+        if (match[1])
+            cursorIndex = options.length;
+        options.push({
+            ...decorate(match[2]),
+            description: match[3],
+            raw: line.trim(),
+        });
+    }
+    return { options, cursorIndex };
+}
+function pickerRegion(text, header) {
+    const lines = text.split("\n");
+    for (let index = lines.length - 1; index >= 0; index -= 1) {
+        if (header.test(lines[index]))
+            return lines.slice(index).join("\n");
+    }
+    return "";
+}
+//# sourceMappingURL=model-rows.js.map

package/dist/core/model-rows.js.map

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

package/dist/core/models/list.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Session-less model enumeration: start a throwaway session, list its models,
+ * and always tear it down. Implements PRD §5.3 and C-API-41.
+ */
+import type { ElwoodAgentSession } from "../agent-session.ts";
+import type { AgentModelOption } from "./rows.ts";
+/** Launch-relevant options for a throwaway model-listing probe (C-API-41). */
+export type ListModelsOptions = {
+    readonly cwd: string;
+    readonly stateDir?: string;
+    readonly autoupdate?: boolean;
+    readonly hookTimeoutMs?: number;
+    readonly strictVersionCheck?: boolean;
+    /** Bounds the picker automation, exactly as on a live session's `listModels`. */
+    readonly timeoutMs?: number;
+};
+/**
+ * The throwaway session surface a probe drives: wait for ready, list, tear down.
+ * Derived from the public session contract so it uses the SAME closed
+ * `ElwoodSessionStatus` type and cannot drift from the real methods.
+ */
+type ProbeSession = Pick<ElwoodAgentSession, "waitForStatus" | "listModels" | "teardown">;
+/** Adapter hooks for a probe: how to start the session and how to remove ALL its state. */
+export type ProbeAdapter<S extends ProbeSession> = {
+    /** Starts the throwaway session against the probe's owned state directory. */
+    readonly start: () => Promise<S>;
+    /**
+     * Removes ALL probe state (its owned temp directory and everything under it).
+     * Runs on EVERY outcome — success, readiness/picker failure, AND a start failure
+     * that already allocated a state directory or runtime files — so nothing leaks
+     * regardless of how far startup got (C-API-41). Best-effort and non-throwing.
+     */
+    readonly removeState: () => void;
+};
+/**
+ * Runs a throwaway session to its first readiness, lists its models, and cleans
+ * up EVERYTHING it allocated — the session (via `teardown`) and its owned state
+ * directory (via `removeState`) — on every outcome, so nothing is leaked (C-API-41).
+ * The probe only opens and cancels the picker, so the user's default stays
+ * untouched. A teardown/cleanup failure never masks a real list/readiness error.
+ */
+export declare function probeModels<S extends ProbeSession>(adapter: ProbeAdapter<S>, options: ListModelsOptions): Promise<readonly AgentModelOption[]>;
+export {};
+//# sourceMappingURL=list.d.ts.map

package/dist/core/models/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/core/models/list.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,8EAA8E;AAC9E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,iFAAiF;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,KAAK,YAAY,GAAG,IAAI,CAAC,kBAAkB,EAAE,eAAe,GAAG,YAAY,GAAG,UAAU,CAAC,CAAC;AAE1F,2FAA2F;AAC3F,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,YAAY,IAAI;IACjD,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC;CAClC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,CAAC,SAAS,YAAY,EACtD,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EACxB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAiBtC"}

package/dist/core/models/list.js

@@ -0,0 +1,73 @@
+/**
+ * Session-less model enumeration: start a throwaway session, list its models,
+ * and always tear it down. Implements PRD §5.3 and C-API-41.
+ */
+import { errnoCode, toError } from "../errors.js";
+/**
+ * Runs a throwaway session to its first readiness, lists its models, and cleans
+ * up EVERYTHING it allocated — the session (via `teardown`) and its owned state
+ * directory (via `removeState`) — on every outcome, so nothing is leaked (C-API-41).
+ * The probe only opens and cancels the picker, so the user's default stays
+ * untouched. A teardown/cleanup failure never masks a real list/readiness error.
+ */
+export async function probeModels(adapter, options) {
+    let session;
+    try {
+        session = await adapter.start();
+    }
+    catch (error) {
+        // Adapter startup can allocate a state directory / runtime files BEFORE the
+        // bridge or PTY fails, so "no returned session" does not mean "nothing
+        // allocated": remove the owned state directory before rethrowing (C-API-41).
+        adapter.removeState();
+        throw error;
+    }
+    try {
+        return await runProbe(session, options);
+    }
+    finally {
+        // Always sweep the owned state directory, even after a successful teardown.
+        adapter.removeState();
+    }
+}
+async function runProbe(session, options) {
+    let models;
+    try {
+        await session.waitForStatus((status) => status === "ready");
+        models = await session.listModels(options.timeoutMs === undefined ? undefined : { timeoutMs: options.timeoutMs });
+    }
+    catch (error) {
+        // The list/readiness error is what the caller must see, so it stays the thrown
+        // error and teardown never masks it. But a FAILED teardown here can leak a
+        // probe process tree, so surface it as a bounded `cause` rather than silently
+        // discarding it: the caller keeps the primary error AND learns of the leak.
+        await teardownWithoutMasking(session, toError(error));
+        throw error;
+    }
+    // The clean path DOES surface a genuine teardown failure — a leaked probe
+    // session is a real defect the caller should learn about (C-API-41).
+    await session.teardown();
+    return models;
+}
+/**
+ * Tear down the probe on the error path without masking the primary error. A
+ * rejecting teardown can leave a probe process tree alive, so instead of
+ * discarding it we attach a bounded diagnostic (the teardown error's allowlisted
+ * errno, or its name) to the primary error's `cause` — visible to the caller,
+ * never overriding the readiness/picker error that actually explains the failure.
+ */
+async function teardownWithoutMasking(session, primary) {
+    try {
+        await session.teardown();
+    }
+    catch (teardownError) {
+        // `cause` may already be set by the primary error; only fill it when empty so
+        // we never clobber a more specific upstream cause. The token is bounded — an
+        // errno like `EPERM` or the error's constructor name — never a raw message.
+        if (primary.cause === undefined) {
+            const token = errnoCode(teardownError) ?? toError(teardownError).name;
+            primary.cause = `probe_teardown_failed:${token}`;
+        }
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/core/models/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/core/models/list.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAkClD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAwB,EACxB,OAA0B;IAE1B,IAAI,OAAU,CAAC;IACf,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,4EAA4E;QAC5E,uEAAuE;QACvE,6EAA6E;QAC7E,OAAO,CAAC,WAAW,EAAE,CAAC;QACtB,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;YAAS,CAAC;QACT,4EAA4E;QAC5E,OAAO,CAAC,WAAW,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ,CACrB,OAAU,EACV,OAA0B;IAE1B,IAAI,MAAmC,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;QAC5D,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAC/B,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAC/E,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,+EAA+E;QAC/E,2EAA2E;QAC3E,8EAA8E;QAC9E,4EAA4E;QAC5E,MAAM,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACtD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,0EAA0E;IAC1E,qEAAqE;IACrE,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;IACzB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,sBAAsB,CAAC,OAAqB,EAAE,OAAc;IACzE,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,aAAa,EAAE,CAAC;QACvB,8EAA8E;QAC9E,6EAA6E;QAC7E,4EAA4E;QAC5E,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,SAAS,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC;YACtE,OAAO,CAAC,KAAK,GAAG,yBAAyB,KAAK,EAAE,CAAC;QACnD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/core/models/picker.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared /model picker automation for adapter sessions.
+ * Implements PRD §5.3, §5.7, C-API-23, and C-API-24.
+ */
+import type { AgentModelOption, ParsedModelPicker } from "./rows.ts";
+import { type ScreenTerminal } from "./tui-screen.ts";
+export declare function pickerTimeout(options?: {
+    readonly timeoutMs?: number;
+}): number;
+export type ModelPickerIo = {
+    readonly terminal: ScreenTerminal;
+    readonly submit: (command: string) => Promise<void>;
+};
+export type ModelPickerSpec = {
+    readonly agent: string;
+    readonly isOpen: (text: string) => boolean;
+    readonly parse: (text: string) => ParsedModelPicker;
+    readonly apply: (io: ModelPickerIo, timeoutMs: number) => Promise<void>;
+};
+export declare function listPickerModels(io: ModelPickerIo, spec: ModelPickerSpec, timeoutMs: number): Promise<readonly AgentModelOption[]>;
+export declare function setPickerModel(io: ModelPickerIo, spec: ModelPickerSpec, id: string, timeoutMs: number): Promise<void>;
+//# sourceMappingURL=picker.d.ts.map