@with-logic/elwood 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"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=image-attach.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image-attach.d.ts","sourceRoot":"","sources":["../../../src/runtime/session/image-attach.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,OAAO,EAAE,KAAK,UAAU,EAAe,MAAM,4BAA4B,CAAC;AAE1E;;;;;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=image-attach.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image-attach.js","sourceRoot":"","sources":["../../../src/runtime/session/image-attach.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAEL,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAmB,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE1E;;;;;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,58 @@
+/** 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 `base.ts`. */
+import type { ElwoodAgentKind } from "../../core/activity/index.ts";
+import { ControlQueue } from "../../core/control-queue/index.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 type { StatusDecision, StatusEvidenceKind } from "../status-evidence.ts";
+import { SessionLoops } from "./loops.ts";
+import { type SessionStatusEmitter } from "./status-wiring.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=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"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,161 @@
+/** 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 `base.ts`. */
+import { ControlQueue } from "../../core/control-queue/index.js";
+import { elwoodError, toError } from "../../core/errors.js";
+import { writeQueuedInput } from "../../core/input/index.js";
+import { registerPrivateOutputSecrets } from "../../core/private-output-secrets.js";
+import { terminalStatuses } from "../../core/status-categories.js";
+import { writeSessionRecord } from "../../state/store.js";
+import { advanceInitialReady } from "../readiness/advance.js";
+import { CleanupLatch } from "../shutdown/cleanup-latch.js";
+import { SessionLoops } from "./loops.js";
+import { SessionReapPolicy } from "./reap.js";
+import { SessionShutdownBinding } from "./shutdown-binding.js";
+import { createSessionStatusEngine } from "./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=lifecycle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../../src/runtime/session/lifecycle.ts"],"names":[],"mappings":"AAAA;;;wCAGwC;AAGxC,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAmB,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAMnE,OAAO,EAAsB,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAM5D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAA6B,MAAM,oBAAoB,CAAC;AAE1F,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,MAAM,KAAK,GAAG,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;IACtD,OAAO,WAAW,CAAC,qBAAqB,EAAE,GAAG,KAAK,0BAA0B,CAAC,CAAC;AAChF,CAAC;AAQD,MAAM,OAAgB,gBAAgB;IAC1B,MAAM,CAAgB;IACvB,QAAQ,CAAiB;IACf,GAAG,CAAa;IAChB,KAAK,CAAe;IACpB,YAAY,CAAe;IACpC,SAAS,GAAG,KAAK,CAAC;IACX,KAAK,CAAkB;IACvB,OAAO,CAAiB;IACxB,UAAU,CAAoB;IAC9B,cAAc,CAAuB;IACrC,YAAY,GAAG,IAAI,YAAY,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1D,QAAQ,CAAyB;IACjC,YAAY,CAAsB;IAClC,UAAU,GAAe;QACxC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI;QAC7C,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;QAC5D,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS;KACzC,CAAC;IAEF,YACE,KAAsB,EACtB,MAAqB,EACrB,QAAgB,EAChB,OAAuB,EACvB,GAAe,EACf,QAAwB,EACxB,YAAkC,EAClC,cAAoC,EACpC,eAAmD;QAEnD,4BAA4B,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,IAAI,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,eAAe,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;QAChF,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAClC,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CACtB,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,EACvE,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,EAC5B,CAAC,MAAM,EAAE,EAAE;YACT,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAC/B,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;QAC1C,CAAC,EACD,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAChC,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC;YAC5B,QAAQ;YACR,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,WAAW,EAAE,eAAe;YAC5B,KAAK,EAAE,IAAI,CAAC,YAAY;YACxB,OAAO,EAAE,YAAY;SACtB,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,GAAG,yBAAyB,CAAC;YAC5C,KAAK;YACL,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,IAAI,CAAC,YAAY;YACxB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,GAAG,EAAE;gBACd,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACxB,CAAC;YACD,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE;SACzC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,IAAI,sBAAsB,CAAC;YACzC,GAAG;YACH,QAAQ;YACR,OAAO;YACP,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe;YAC3C,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM;YACzB,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,EAAE;YAC3C,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;SACzD,CAAC,CAAC;IACL,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;IACrC,CAAC;IACD,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;IACzB,CAAC;IACD,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;IAClC,CAAC;IACD,IAAI;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IACD,IAAI;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IACD,QAAQ;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAClC,CAAC;IACD,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,2BAA2B,CAAC,eAA2B;QACrD,eAAe,EAAE,CAAC;QAClB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IACD,cAAc,CAAC,IAAwB;QACrC,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,UAAU;QACR,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;QAC9C,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,GAAG,QAAQ,KAAK,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YAC1F,IAAI,OAAO;gBAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC;IACvC,CAAC;IAMD,wFAAwF;IAC9E,SAAS,CAAC,KAAa,EAAE,OAAwB;QACzD,IAAI,KAAK,KAAK,eAAe;YAAE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAA+B,CAAC,CAAC;QAC3F,IAAI,KAAK,KAAK,UAAU;YAAE,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,OAA4B,CAAC,CAAC;IAC9F,CAAC;IACD,0FAA0F;IAChF,SAAS,CAAI,IAA0B,EAAE,aAAa,GAAG,KAAK;QACtE,IAAI,CAAC,aAAa,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACxD,OAAO,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC;YACH,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IACS,OAAO,CAAC,MAAqB;QACrC,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,gEAAgE;QACrH,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IACS,cAAc;QACtB,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;IACrC,CAAC;IACS,mBAAmB;QAC3B,mBAAmB,CAAC;YAClB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,kBAAkB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC;YAC9D,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE;YAC9C,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,32 @@
+/** Shared live-session loop controller for both adapters (PRD §5.9/§9.3). */
+import type { ControlQueue, ControlSubmissionOrigin } from "../../core/control-queue/index.ts";
+import type { ElwoodLoopEvent, ElwoodLoopRequest, ElwoodLoopSnapshot } from "../../core/loops/types.ts";
+import type { PersistedLoopDefinition } from "../../state/loop-store.ts";
+export type LoopEventEmitter = {
+    emit(event: "loop", payload: ElwoodLoopEvent): void;
+};
+type SessionLoopsInput = {
+    readonly stateDir: string;
+    readonly elwoodSessionId: string;
+    readonly definitions: readonly PersistedLoopDefinition[];
+    readonly queue: ControlQueue;
+    readonly emitter: LoopEventEmitter;
+};
+/** Owns one adapter-neutral scheduler and binds it to session persistence/input. */
+export declare class SessionLoops {
+    private readonly scheduler;
+    constructor(input: SessionLoopsInput);
+    /** Start durable scheduling only after the session's startup cleanup boundary exists. */
+    start(): void;
+    turnStarted(origin: ControlSubmissionOrigin): void;
+    ready(): void;
+    running(): void;
+    pause(): void;
+    create(request: ElwoodLoopRequest): ElwoodLoopSnapshot;
+    list(): readonly ElwoodLoopSnapshot[];
+    cancel(loopId: string): void;
+    clear(reason: "kill" | "teardown"): void;
+    callerActivity(): void;
+}
+export {};
+//# sourceMappingURL=loops.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loops.d.ts","sourceRoot":"","sources":["../../../src/runtime/session/loops.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAG7E,OAAO,KAAK,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAI/F,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGzE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;CACrD,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACzD,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;CACpC,CAAC;AAEF,oFAAoF;AACpF,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;gBAE9B,KAAK,EAAE,iBAAiB;IAwBpC,yFAAyF;IACzF,KAAK,IAAI,IAAI;IAIb,WAAW,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI;IAIlD,KAAK,IAAI,IAAI;IAIb,OAAO,IAAI,IAAI;IAIf,KAAK,IAAI,IAAI;IAIb,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,kBAAkB;IAItD,IAAI,IAAI,SAAS,kBAAkB,EAAE;IAIrC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI5B,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAIxC,cAAc,IAAI,IAAI;CAGvB"}

package/dist/runtime/session/loops.js

@@ -0,0 +1,62 @@
+/** Shared live-session loop controller for both adapters (PRD §5.9/§9.3). */
+import { randomUUID } from "node:crypto";
+import { elwoodError } from "../../core/errors.js";
+import { LoopScheduler } from "../../core/loops/scheduler.js";
+import { scheduleLoopTimer } from "../../core/loops/timers.js";
+import { writeLoopDefinitions } from "../../state/loop-store.js";
+/** Owns one adapter-neutral scheduler and binds it to session persistence/input. */
+export class SessionLoops {
+    scheduler;
+    constructor(input) {
+        this.scheduler = new LoopScheduler({
+            definitions: input.definitions,
+            now: Date.now,
+            schedule: scheduleLoopTimer,
+            createId: randomUUID,
+            persist: (definitions) => writeLoopDefinitions(input.stateDir, input.elwoodSessionId, definitions),
+            submit: (message, loopId, signal) => input.queue.send(message, "message", undefined, {
+                origin: { kind: "loop", loopId },
+                cancel: {
+                    signal,
+                    // §10: loop_submission_failed details identify only the loop id.
+                    error: () => elwoodError("loop_submission_failed", "Loop was cancelled before submission.", {
+                        loopId,
+                    }),
+                },
+            }),
+            emit: (event) => input.emitter.emit("loop", event),
+        });
+    }
+    /** Start durable scheduling only after the session's startup cleanup boundary exists. */
+    start() {
+        this.scheduler.start();
+    }
+    turnStarted(origin) {
+        this.scheduler.activity(origin.kind);
+    }
+    ready() {
+        this.scheduler.ready();
+    }
+    running() {
+        this.scheduler.running();
+    }
+    pause() {
+        this.scheduler.pause();
+    }
+    create(request) {
+        return this.scheduler.create(request);
+    }
+    list() {
+        return this.scheduler.list();
+    }
+    cancel(loopId) {
+        this.scheduler.cancel(loopId);
+    }
+    clear(reason) {
+        this.scheduler.clear(reason);
+    }
+    callerActivity() {
+        this.scheduler.activity("caller");
+    }
+}
+//# sourceMappingURL=loops.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loops.js","sourceRoot":"","sources":["../../../src/runtime/session/loops.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAO/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAcjE,oFAAoF;AACpF,MAAM,OAAO,YAAY;IACN,SAAS,CAAgB;IAE1C,YAAY,KAAwB;QAClC,IAAI,CAAC,SAAS,GAAG,IAAI,aAAa,CAAC;YACjC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,QAAQ,EAAE,iBAAiB;YAC3B,QAAQ,EAAE,UAAU;YACpB,OAAO,EAAE,CAAC,WAAW,EAAE,EAAE,CACvB,oBAAoB,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,eAAe,EAAE,WAAW,CAAC;YAC1E,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAClC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE;gBAC9C,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE;gBAChC,MAAM,EAAE;oBACN,MAAM;oBACN,iEAAiE;oBACjE,KAAK,EAAE,GAAG,EAAE,CACV,WAAW,CAAC,wBAAwB,EAAE,uCAAuC,EAAE;wBAC7E,MAAM;qBACP,CAAC;iBACL;aACF,CAAC;YACJ,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC;SACnD,CAAC,CAAC;IACL,CAAC;IAED,yFAAyF;IACzF,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,WAAW,CAAC,MAA+B;QACzC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,OAAO;QACL,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,OAA0B;QAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,MAA2B;QAC/B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,cAAc;QACZ,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;CACF"}

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

@@ -0,0 +1,18 @@
+/**
+ * Bundles a session's initial-readiness wiring so both adapters share one blocking-
+ * aware gate. `ready` fires the pre-input hook/deadline readiness; a per-frame
+ * `observeReadinessFrame` feeds it the frame's blocking fact so readiness never
+ * drains the queue INTO a dialog (even one shown during `starting`, which never
+ * latched `blocked`) and is never starved BY it — it reconciles once the dialog
+ * clears — and marks resume-composer readiness. Implements PRD §5.3 (C-API-28).
+ */
+import type { ComposerReadyFacts } from "../readiness/initial-ready.ts";
+import { type InitialReady } from "../readiness/initial-ready.ts";
+export type ReadinessGate = {
+    readonly ready: InitialReady;
+    /** Per rendered frame: update the blocking gate, reconcile a deferred mark, and
+     * (on resume) mark readiness on the first quiet, non-blocking composer. */
+    readonly observeReadinessFrame: (facts: ComposerReadyFacts) => void;
+};
+export declare function createReadinessGate(onReady: () => void, resumed: boolean): ReadinessGate;
+//# sourceMappingURL=readiness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../../../src/runtime/session/readiness.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EACL,KAAK,YAAY,EAGlB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B;+EAC2E;IAC3E,QAAQ,CAAC,qBAAqB,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACrE,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CAWxF"}

package/dist/runtime/session/readiness.js

@@ -0,0 +1,22 @@
+/**
+ * Bundles a session's initial-readiness wiring so both adapters share one blocking-
+ * aware gate. `ready` fires the pre-input hook/deadline readiness; a per-frame
+ * `observeReadinessFrame` feeds it the frame's blocking fact so readiness never
+ * drains the queue INTO a dialog (even one shown during `starting`, which never
+ * latched `blocked`) and is never starved BY it — it reconciles once the dialog
+ * clears — and marks resume-composer readiness. Implements PRD §5.3 (C-API-28).
+ */
+import { initialReady, markReadyOnResumeComposer, } from "../readiness/initial-ready.js";
+export function createReadinessGate(onReady, resumed) {
+    let blockingVisible = false;
+    const ready = initialReady(onReady, undefined, () => blockingVisible);
+    return {
+        ready,
+        observeReadinessFrame: (facts) => {
+            blockingVisible = facts.blocking_prompt_visible;
+            markReadyOnResumeComposer(ready, resumed, facts);
+            ready.retryWhenUnblocked(blockingVisible); // fire a block-deferred readiness once clear
+        },
+    };
+}
+//# sourceMappingURL=readiness.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.js","sourceRoot":"","sources":["../../../src/runtime/session/readiness.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAEL,YAAY,EACZ,yBAAyB,GAC1B,MAAM,+BAA+B,CAAC;AASvC,MAAM,UAAU,mBAAmB,CAAC,OAAmB,EAAE,OAAgB;IACvE,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;IACtE,OAAO;QACL,KAAK;QACL,qBAAqB,EAAE,CAAC,KAAK,EAAE,EAAE;YAC/B,eAAe,GAAG,KAAK,CAAC,uBAAuB,CAAC;YAChD,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YACjD,KAAK,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAAC,6CAA6C;QAC1F,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * Owns the session's one-shot survivor reaper and its two NON-interchangeable
+ * failure policies (PRD §5.3, C-LIFE-10):
+ *   - `bestEffort()` for the native unsolicited-exit callback: a reap failure must
+ *     never throw out of that callback, so it is contained and RETURNED as a
+ *     live `reap_failed` warning (emitted once when observed), never silently dropped.
+ *   - `orThrow()` for an explicit `stop()`/`kill()` on an already-terminal session:
+ *     it must NOT swallow — it throws a typed `termination_failed` so the caller
+ *     rejects with an ElwoodError (C-ERR-01) and teardown can retry the
+ *     still-unlatched reap.
+ * `reaper` exposes the underlying one-shot for `teardown`'s retry step and the
+ * `terminatePty` termination path, which own their own failure handling.
+ */
+import type { ElwoodAgentKind } from "../../core/activity/index.ts";
+import type { ElwoodWarningEvent } from "../../core/types.ts";
+import { SessionReaper } from "../shutdown/reap-tree.ts";
+export declare class SessionReapPolicy {
+    readonly reaper: SessionReaper;
+    private readonly agent;
+    private readonly elwoodSessionId;
+    private readonly leaderPid;
+    constructor(agent: ElwoodAgentKind, elwoodSessionId: string, leaderPid: number);
+    /** Contain a native-exit reap failure as a live warning to emit; never throw. */
+    bestEffort(): ElwoodWarningEvent | undefined;
+    /** Reap on explicit shutdown; wrap any failure as a typed `termination_failed`. */
+    orThrow(): void;
+}
+//# sourceMappingURL=reap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reap.d.ts","sourceRoot":"","sources":["../../../src/runtime/session/reap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAO9E,iFAAiF;IACjF,UAAU,IAAI,kBAAkB,GAAG,SAAS;IAS5C,mFAAmF;IACnF,OAAO,IAAI,IAAI;CAUhB"}

package/dist/runtime/session/reap.js

@@ -0,0 +1,51 @@
+/**
+ * Owns the session's one-shot survivor reaper and its two NON-interchangeable
+ * failure policies (PRD §5.3, C-LIFE-10):
+ *   - `bestEffort()` for the native unsolicited-exit callback: a reap failure must
+ *     never throw out of that callback, so it is contained and RETURNED as a
+ *     live `reap_failed` warning (emitted once when observed), never silently dropped.
+ *   - `orThrow()` for an explicit `stop()`/`kill()` on an already-terminal session:
+ *     it must NOT swallow — it throws a typed `termination_failed` so the caller
+ *     rejects with an ElwoodError (C-ERR-01) and teardown can retry the
+ *     still-unlatched reap.
+ * `reaper` exposes the underlying one-shot for `teardown`'s retry step and the
+ * `terminatePty` termination path, which own their own failure handling.
+ */
+import { reapFailureWarning } from "../../core/activity/index.js";
+import { causeDetails, elwoodError } from "../../core/errors.js";
+import { SessionReaper } from "../shutdown/reap-tree.js";
+export class SessionReapPolicy {
+    reaper;
+    agent;
+    elwoodSessionId;
+    leaderPid;
+    constructor(agent, elwoodSessionId, leaderPid) {
+        this.agent = agent;
+        this.elwoodSessionId = elwoodSessionId;
+        this.leaderPid = leaderPid;
+        this.reaper = new SessionReaper(leaderPid);
+    }
+    /** Contain a native-exit reap failure as a live warning to emit; never throw. */
+    bestEffort() {
+        try {
+            this.reaper.reap();
+            return undefined;
+        }
+        catch (error) {
+            return reapFailureWarning(this.agent, this.elwoodSessionId, this.leaderPid, error);
+        }
+    }
+    /** Reap on explicit shutdown; wrap any failure as a typed `termination_failed`. */
+    orThrow() {
+        try {
+            this.reaper.reap();
+        }
+        catch (error) {
+            throw elwoodError("termination_failed", "Could not reap the PTY process group.", {
+                ...causeDetails(error),
+                processGroupId: this.leaderPid,
+            });
+        }
+    }
+}
+//# sourceMappingURL=reap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reap.js","sourceRoot":"","sources":["../../../src/runtime/session/reap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,MAAM,OAAO,iBAAiB;IACnB,MAAM,CAAgB;IACd,KAAK,CAAkB;IACvB,eAAe,CAAS;IACxB,SAAS,CAAS;IAEnC,YAAY,KAAsB,EAAE,eAAuB,EAAE,SAAiB;QAC5E,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,iFAAiF;IACjF,UAAU;QACR,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACnB,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,kBAAkB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAED,mFAAmF;IACnF,OAAO;QACL,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,WAAW,CAAC,oBAAoB,EAAE,uCAAuC,EAAE;gBAC/E,GAAG,YAAY,CAAC,KAAK,CAAC;gBACtB,cAAc,EAAE,IAAI,CAAC,SAAS;aAC/B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}