@with-logic/elwood 0.1.0 → 0.1.1

package/dist/core/warning-reasons.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"warning-reasons.d.ts","sourceRoot":"","sources":["../../src/core/warning-reasons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAChD,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,CAAC,GACpC,CAAC,GAAG,OAAO,iBAAiB,CAK9B;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,6QAyBnB,CAAC;AAEX,qEAAqE;AACrE,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIhE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,iIAajB,CAAC;AAEX,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAI5D,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAEtE;AAED,kEAAkE;AAClE,eAAO,MAAM,UAAU,yDAA0D,CAAC;AAElF,0DAA0D;AAC1D,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,uIAcnB,CAAC;AAEX,sEAAsE;AACtE,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIhE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe,CAE1E;AAED,8DAA8D;AAC9D,eAAO,MAAM,UAAU,kCAAmC,CAAC;AAE3D,uDAAuD;AACvD,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/core/warning-reasons.js

@@ -1,121 +0,0 @@
-/**
- * The fixed allowlists of bounded reason/error-code tokens carried by content-free
- * warnings, and their derived types + guards.
- * Implements PRD §5.7 (C-CLAUDE-15, C-LIFE-10): the `reason` field of a
- * `transcript_poll_stopped` warning and the `errorCode` field of a `reap_failed`
- * warning may carry ONLY a value from a fixed allowlist — never a raw system
- * message or a caller-controlled string that could leak content into a live
- * warning. This module is the single source of truth the unions and their
- * producers derive from, so a producer and its type can never drift apart.
- */
-import { errnoCode } from "./errors.js";
-/** The fixed fallback token every bounded error-token allowlist collapses to. */
-export const unknownErrorToken = "UnknownError";
-/**
- * Maps an arbitrary thrown value to a bounded, ALLOWLISTED token, shared by every
- * content-free warning that carries a normalized error code (reap, transcript
- * poll, resize restore). An error's `.code` (errno), `Error.name`, and message are
- * all system/caller-controlled and can embed an env path or conversation text, so
- * only a value the caller's `allow` guard accepts passes through; anything else —
- * including a raw system message — collapses to `UnknownError`. This is the single
- * place the sanitizing rule lives, so no producer can weaken it (§5.7).
- */
-export function boundedErrorToken(error, allow) {
-    const code = errnoCode(error);
-    if (allow(code))
-        return code;
-    if (error instanceof Error && allow(error.name))
-        return error.name;
-    return unknownErrorToken;
-}
-/**
- * The allowlisted tokens for `transcript_poll_stopped.reason`: standard JS error
- * constructor names + common Node filesystem/stream errnos, plus the fixed
- * `UnknownError` fallback that any unrecognized value collapses to.
- */
-export const pollErrorReasons = [
-    "UnknownError",
-    // Standard ECMAScript error constructor names.
-    "Error",
-    "TypeError",
-    "RangeError",
-    "ReferenceError",
-    "SyntaxError",
-    "EvalError",
-    "URIError",
-    "AggregateError",
-    // Common Node.js filesystem/stream errno codes seen on a transcript read.
-    "ENOENT",
-    "EACCES",
-    "EPERM",
-    "EISDIR",
-    "ENOTDIR",
-    "EBADF",
-    "EMFILE",
-    "ENFILE",
-    "ELOOP",
-    "ENAMETOOLONG",
-    "EBUSY",
-    "EAGAIN",
-    "EIO",
-];
-const pollErrorReasonSet = new Set(pollErrorReasons);
-export function isPollErrorReason(value) {
-    return typeof value === "string" && pollErrorReasonSet.has(value);
-}
-/**
- * The allowlisted tokens for `reap_failed.errorCode`: standard JS error
- * constructor names + the process-signalling errnos a group SIGKILL can surface,
- * plus the fixed `UnknownError` fallback any unrecognized value collapses to. A
- * reap failure's error `name`/`.code`/message are caller/system-controlled, so
- * only a value on this allowlist may reach the live warning.
- */
-export const reapErrorCodes = [
-    "UnknownError",
-    // Standard ECMAScript error constructor names.
-    "Error",
-    "TypeError",
-    "RangeError",
-    "ReferenceError",
-    // Errnos a process-group signal (kill(-pgid, SIGKILL)) can surface.
-    "EPERM",
-    "ESRCH",
-    "EINVAL",
-    "EACCES",
-    "EAGAIN",
-];
-const reapErrorCodeSet = new Set(reapErrorCodes);
-export function isReapErrorCode(value) {
-    return typeof value === "string" && reapErrorCodeSet.has(value);
-}
-/** Why transcript data was lost, so cause is never mislabeled. */
-export const dropCauses = ["unparseable", "oversized", "unread_backlog"];
-/**
- * The allowlisted tokens for `resize_restore_failed.errorCode`: standard JS error
- * constructor names + the errnos a native PTY resize can surface, plus the fixed
- * `UnknownError` fallback any unrecognized value collapses to. A resize failure's
- * error `name`/`.code`/message are system-controlled, so only a value on this
- * allowlist may reach the live warning (§5.7).
- */
-export const resizeErrorCodes = [
-    "UnknownError",
-    // Standard ECMAScript error constructor names.
-    "Error",
-    "TypeError",
-    "RangeError",
-    "ReferenceError",
-    // Errnos a native PTY resize (ioctl TIOCSWINSZ) or terminal write can surface.
-    "EBADF",
-    "EINVAL",
-    "EIO",
-    "ENXIO",
-    "EPERM",
-    "EACCES",
-];
-const resizeErrorCodeSet = new Set(resizeErrorCodes);
-export function isResizeErrorCode(value) {
-    return typeof value === "string" && resizeErrorCodeSet.has(value);
-}
-/** Which lifecycle phase a transcript failure occurred in. */
-export const pollPhases = ["poll", "final_flush"];
-//# sourceMappingURL=warning-reasons.js.map

package/dist/core/warning-reasons.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"warning-reasons.js","sourceRoot":"","sources":["../../src/core/warning-reasons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,iFAAiF;AACjF,MAAM,CAAC,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAc,EACd,KAAqC;IAErC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC;IACnE,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,cAAc;IACd,+CAA+C;IAC/C,OAAO;IACP,WAAW;IACX,YAAY;IACZ,gBAAgB;IAChB,aAAa;IACb,WAAW;IACX,UAAU;IACV,gBAAgB;IAChB,0EAA0E;IAC1E,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,SAAS;IACT,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,cAAc;IACd,OAAO;IACP,QAAQ;IACR,KAAK;CACG,CAAC;AAKX,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAE1E,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,cAAc;IACd,+CAA+C;IAC/C,OAAO;IACP,WAAW;IACX,YAAY;IACZ,gBAAgB;IAChB,oEAAoE;IACpE,OAAO;IACP,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,QAAQ;CACA,CAAC;AAKX,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;AAEtE,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,aAAa,EAAE,WAAW,EAAE,gBAAgB,CAAU,CAAC;AAKlF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,cAAc;IACd,+CAA+C;IAC/C,OAAO;IACP,WAAW;IACX,YAAY;IACZ,gBAAgB;IAChB,+EAA+E;IAC/E,OAAO;IACP,QAAQ;IACR,KAAK;IACL,OAAO;IACP,OAAO;IACP,QAAQ;CACA,CAAC;AAKX,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAE1E,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC;AAED,8DAA8D;AAC9D,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,aAAa,CAAU,CAAC"}

package/dist/core/warnings.d.ts

@@ -1,145 +0,0 @@
-/**
- * The typed non-fatal warning contract shared across adapters.
- * Implements PRD §5.7 and §8.2: every warning is a named variant carrying only
- * diagnostics (cause/phase labels, error codes, recovery hints) — no counts or
- * byte magnitudes — and never raw prompts, transcripts, or conversation content.
- * Most error-code fields are allowlisted tokens (`warning-reasons.ts`); the one
- * exception is `transcript_read_error.lastErrorCode`, which the PRD types as the
- * raw fs errno string (a system-controlled code, never transcript content).
- * Warnings are live-only: emitted once when observed, never persisted.
- */
-import type { ElwoodAgentKind } from "./activity.ts";
-import type { StartupPromptLabelFor } from "./startup-automation.ts";
-import type { AgentUpdateFailedWarning } from "./warning-lifecycle.ts";
-import type { DropCause, PollErrorReason, PollPhase, ReapErrorCode, ResizeErrorCode } from "./warning-reasons.ts";
-export type ElwoodWarningEvent = {
-    readonly elwoodSessionId: string;
-    readonly agent: ElwoodAgentKind;
-    readonly source: "lifecycle";
-    readonly code: "version_unparseable";
-    readonly severity: "warning";
-    readonly message: string;
-    readonly raw: string;
-} | AgentUpdateFailedWarning | {
-    readonly elwoodSessionId: string;
-    readonly agent: "codex";
-    readonly source: "terminal";
-    readonly code: "mcp_server_not_logged_in";
-    readonly severity: "warning";
-    readonly message: string;
-    readonly mcpServerName: string;
-    readonly recoveryCommand: string;
-    readonly raw: string;
-} | {
-    readonly elwoodSessionId: string;
-    readonly agent: "claude";
-    readonly source: "terminal";
-    readonly code: "login_expired";
-    readonly severity: "warning";
-    readonly message: string;
-    readonly recoveryCommand: "/login";
-    readonly raw: string;
-} | {
-    readonly elwoodSessionId: string;
-    readonly agent: "codex";
-    readonly source: "terminal";
-    readonly code: "mcp_startup_incomplete";
-    readonly severity: "warning";
-    readonly message: string;
-    readonly failedServers: readonly string[];
-    readonly recoveryCommands: readonly string[];
-    readonly raw: string;
-} | {
-    readonly elwoodSessionId: string;
-    readonly agent: "codex";
-    readonly source: "lifecycle";
-    readonly code: "codex_default_model_persisted";
-    readonly severity: "warning";
-    readonly message: string;
-    readonly raw: string;
-} | {
-    readonly elwoodSessionId: string;
-    readonly agent: "codex";
-    readonly source: "lifecycle";
-    readonly code: "clipboard_restore_failed";
-    readonly severity: "warning";
-    readonly message: string;
-    readonly raw: string;
-} | {
-    readonly elwoodSessionId: string;
-    readonly agent: ElwoodAgentKind;
-    readonly source: "terminal";
-    readonly code: "transcript_records_dropped";
-    readonly severity: "warning";
-    readonly message: string;
-    readonly cause: DropCause;
-    readonly transcriptPath: string;
-    readonly raw: string;
-} | {
-    readonly elwoodSessionId: string;
-    readonly agent: ElwoodAgentKind;
-    readonly source: "terminal";
-    readonly code: "transcript_read_error";
-    readonly severity: "warning";
-    readonly message: string;
-    readonly lastErrorCode: string;
-    readonly transcriptPath: string;
-    readonly raw: string;
-} | {
-    readonly elwoodSessionId: string;
-    readonly agent: ElwoodAgentKind;
-    readonly source: "terminal";
-    readonly code: "transcript_poll_stopped";
-    readonly severity: "warning";
-    readonly message: string;
-    readonly reason: PollErrorReason;
-    readonly phase: PollPhase;
-    readonly raw: string;
-} | StartupPromptWriteFailed<"claude"> | StartupPromptWriteFailed<"codex"> | {
-    readonly elwoodSessionId: string;
-    readonly agent: ElwoodAgentKind;
-    readonly source: "lifecycle";
-    readonly code: "reap_failed";
-    readonly severity: "warning";
-    readonly message: string;
-    readonly processGroupId: number;
-    readonly errorCode: ReapErrorCode;
-    readonly raw: string;
-} | {
-    readonly elwoodSessionId: string;
-    readonly agent: "claude";
-    readonly source: "lifecycle";
-    readonly code: "resize_restore_failed";
-    readonly severity: "warning";
-    readonly message: string;
-    readonly requestedCols: number;
-    readonly requestedRows: number;
-    readonly errorCode: ResizeErrorCode;
-    readonly raw: string;
-} | {
-    readonly elwoodSessionId: string;
-    readonly agent: ElwoodAgentKind;
-    readonly source: "lifecycle";
-    readonly code: "initial_ready_fallback";
-    readonly severity: "warning";
-    readonly message: string;
-    readonly raw: string;
-};
-/**
- * A rejected startup-prompt PTY write, discriminated by agent so the LABEL is
- * agent-correlated: an impossible pairing like Claude + `update` or Codex +
- * `browser_tools` is unrepresentable (§5.4). The label is a bounded id from the
- * agent's fixed startup-prompt set only — never raw prompt/screen content — and
- * the prompt is left retryable so a later frame re-attempts the write.
- */
-export type StartupPromptWriteFailed<A extends ElwoodAgentKind> = {
-    readonly elwoodSessionId: string;
-    readonly agent: A;
-    readonly source: "terminal";
-    readonly code: "startup_prompt_write_failed";
-    readonly severity: "warning";
-    readonly message: string;
-    readonly label: StartupPromptLabelFor<A>;
-    readonly raw: string;
-};
-//# sourceMappingURL=warnings.d.ts.map

package/dist/core/warnings.d.ts.map

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

package/dist/core/warnings.js

@@ -1,12 +0,0 @@
-/**
- * The typed non-fatal warning contract shared across adapters.
- * Implements PRD §5.7 and §8.2: every warning is a named variant carrying only
- * diagnostics (cause/phase labels, error codes, recovery hints) — no counts or
- * byte magnitudes — and never raw prompts, transcripts, or conversation content.
- * Most error-code fields are allowlisted tokens (`warning-reasons.ts`); the one
- * exception is `transcript_read_error.lastErrorCode`, which the PRD types as the
- * raw fs errno string (a system-controlled code, never transcript content).
- * Warnings are live-only: emitted once when observed, never persisted.
- */
-export {};
-//# sourceMappingURL=warnings.js.map

package/dist/core/warnings.js.map

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

package/dist/runtime/cleanup-latch.d.ts

@@ -1,27 +0,0 @@
-/**
- * Coalesces runtime-cleanup attempts while keeping a FAILED cleanup retryable.
- * PRD §9.4 requires that a settled cleanup failure is not permanently sticky — a
- * later explicit stop/kill/teardown must run a fresh attempt. A plain `??=` cache
- * would latch a rejected promise forever, so this latch clears its cache the moment
- * the attempt rejects. `cachedAttempt` is therefore only ever the reusable non-rejected
- * attempt (in flight or successfully settled). Implements PRD §9.4.
- */
-export declare class CleanupLatch {
-    private cachedAttempt;
-    private readonly run;
-    constructor(run: () => Promise<void>);
-    /**
-     * Runs cleanup, coalescing concurrent callers onto one in-flight attempt. On
-     * failure the cache is cleared so the NEXT call re-runs `run` instead of
-     * replaying the old rejection; the rejection still propagates to this caller.
-     */
-    attempt(): Promise<void>;
-    /**
-     * Runs cleanup from a path with no caller to reject to (an unsolicited exit).
-     * Owns the rejection so it never becomes an unhandled rejection; the failure is
-     * swallowed because `attempt` cleared its cache, so a later explicit shutdown
-     * retries cleanup and surfaces any persistent failure through its own error.
-     */
-    float(): void;
-}
-//# sourceMappingURL=cleanup-latch.d.ts.map

package/dist/runtime/cleanup-latch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cleanup-latch.d.ts","sourceRoot":"","sources":["../../src/runtime/cleanup-latch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsB;gBAE9B,GAAG,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAIpC;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAaxB;;;;;OAKG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/runtime/cleanup-latch.js

@@ -1,43 +0,0 @@
-/**
- * Coalesces runtime-cleanup attempts while keeping a FAILED cleanup retryable.
- * PRD §9.4 requires that a settled cleanup failure is not permanently sticky — a
- * later explicit stop/kill/teardown must run a fresh attempt. A plain `??=` cache
- * would latch a rejected promise forever, so this latch clears its cache the moment
- * the attempt rejects. `cachedAttempt` is therefore only ever the reusable non-rejected
- * attempt (in flight or successfully settled). Implements PRD §9.4.
- */
-export class CleanupLatch {
-    cachedAttempt;
-    run;
-    constructor(run) {
-        this.run = run;
-    }
-    /**
-     * Runs cleanup, coalescing concurrent callers onto one in-flight attempt. On
-     * failure the cache is cleared so the NEXT call re-runs `run` instead of
-     * replaying the old rejection; the rejection still propagates to this caller.
-     */
-    attempt() {
-        // A cached attempt is reused only when it is in flight or already settled
-        // SUCCESSFULLY; a rejecting attempt clears the cache below before any other
-        // caller can observe it, so no identity guard is needed on the clear.
-        if (this.cachedAttempt)
-            return this.cachedAttempt;
-        const attempt = this.run().catch((error) => {
-            this.cachedAttempt = undefined;
-            throw error;
-        });
-        this.cachedAttempt = attempt;
-        return attempt;
-    }
-    /**
-     * Runs cleanup from a path with no caller to reject to (an unsolicited exit).
-     * Owns the rejection so it never becomes an unhandled rejection; the failure is
-     * swallowed because `attempt` cleared its cache, so a later explicit shutdown
-     * retries cleanup and surfaces any persistent failure through its own error.
-     */
-    float() {
-        void this.attempt().catch(() => undefined);
-    }
-}
-//# sourceMappingURL=cleanup-latch.js.map

package/dist/runtime/cleanup-latch.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cleanup-latch.js","sourceRoot":"","sources":["../../src/runtime/cleanup-latch.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,OAAO,YAAY;IACf,aAAa,CAA4B;IAChC,GAAG,CAAsB;IAE1C,YAAY,GAAwB;QAClC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,OAAO;QACL,0EAA0E;QAC1E,4EAA4E;QAC5E,sEAAsE;QACtE,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC,aAAa,CAAC;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YAClD,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;YAC/B,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;QAC7B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACH,KAAK;QACH,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/runtime/initial-ready-advance.d.ts

@@ -1,22 +0,0 @@
-/**
- * The one-shot initial-ready transition with an anti-starvation completion boundary,
- * shared by BOTH adapters (PRD §5.3, C-API-42). The status engine commits
- * `current = ready` BEFORE it emits and releases the queue, so a lifecycle-listener
- * throw there would leave the queue suspended AND make a retry a no-op (status is
- * already `ready`). On any throw this releases the queue DIRECTLY and surfaces the
- * risk as a typed, content-free `initial_ready_fallback` warning (emitted lifecycle
- * events may be stale), so queued input is never starved by a partially-committed
- * ready transition.
- */
-import type { ElwoodAgentKind } from "../core/activity.ts";
-import type { ElwoodWarningEvent } from "../core/types.ts";
-/** The narrow session surface the initial-ready advance needs. */
-export type InitialReadyAdvanceDeps = {
-    readonly agent: ElwoodAgentKind;
-    readonly elwoodSessionId: string;
-    readonly submitInitialReady: () => void;
-    readonly markReady: () => void;
-    readonly emitWarnings: (warnings: readonly ElwoodWarningEvent[]) => void;
-};
-export declare function advanceInitialReady(deps: InitialReadyAdvanceDeps): void;
-//# sourceMappingURL=initial-ready-advance.d.ts.map

package/dist/runtime/initial-ready-advance.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"initial-ready-advance.d.ts","sourceRoot":"","sources":["../../src/runtime/initial-ready-advance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,kEAAkE;AAClE,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,IAAI,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,KAAK,IAAI,CAAC;CAC1E,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,uBAAuB,GAAG,IAAI,CAavE"}

package/dist/runtime/initial-ready-advance.js

@@ -1,39 +0,0 @@
-/**
- * The one-shot initial-ready transition with an anti-starvation completion boundary,
- * shared by BOTH adapters (PRD §5.3, C-API-42). The status engine commits
- * `current = ready` BEFORE it emits and releases the queue, so a lifecycle-listener
- * throw there would leave the queue suspended AND make a retry a no-op (status is
- * already `ready`). On any throw this releases the queue DIRECTLY and surfaces the
- * risk as a typed, content-free `initial_ready_fallback` warning (emitted lifecycle
- * events may be stale), so queued input is never starved by a partially-committed
- * ready transition.
- */
-export function advanceInitialReady(deps) {
-    try {
-        deps.submitInitialReady();
-    }
-    catch {
-        // A lifecycle-event LISTENER threw after `current` committed to `ready`; release
-        // the queue unconditionally so queued input is never starved, then warn.
-        deps.markReady();
-        try {
-            deps.emitWarnings([fallbackWarning(deps.agent, deps.elwoodSessionId)]);
-        }
-        catch {
-            // A warning-sink/listener failure must never block the readiness release.
-        }
-    }
-}
-/** Live-only and content-free: no raw system message, no listener error text. */
-function fallbackWarning(agent, elwoodSessionId) {
-    return {
-        elwoodSessionId,
-        agent,
-        source: "lifecycle",
-        code: "initial_ready_fallback",
-        severity: "warning",
-        message: "Recording the initial-ready transition failed; released the queue directly, so lifecycle events may be stale.",
-        raw: "initial_ready_fallback",
-    };
-}
-//# sourceMappingURL=initial-ready-advance.js.map

package/dist/runtime/initial-ready-advance.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"initial-ready-advance.js","sourceRoot":"","sources":["../../src/runtime/initial-ready-advance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,MAAM,UAAU,mBAAmB,CAAC,IAA6B;IAC/D,IAAI,CAAC;QACH,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,iFAAiF;QACjF,yEAAyE;QACzE,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,CAAC,YAAY,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACzE,CAAC;QAAC,MAAM,CAAC;YACP,0EAA0E;QAC5E,CAAC;IACH,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,SAAS,eAAe,CAAC,KAAsB,EAAE,eAAuB;IACtE,OAAO;QACL,eAAe;QACf,KAAK;QACL,MAAM,EAAE,WAAW;QACnB,IAAI,EAAE,wBAAwB;QAC9B,QAAQ,EAAE,SAAS;QACnB,OAAO,EACL,+GAA+G;QACjH,GAAG,EAAE,wBAAwB;KAC9B,CAAC;AACJ,CAAC"}

package/dist/runtime/initial-ready-fallback.d.ts

@@ -1,12 +0,0 @@
-/**
- * The live, content-free warning for a fallback initial-ready transition.
- * Implements PRD §5.3 and C-API-42: when recording a session's one-shot initial-ready
- * transition throws (a lifecycle-event listener), Elwood still releases the control
- * queue directly so queued input is never starved, but emitted lifecycle events may be
- * stale. This surfaces that risk as a typed `initial_ready_fallback` warning carrying
- * no raw system message or session content. Both adapters.
- */
-import type { ElwoodAgentKind } from "../core/activity.ts";
-import type { ElwoodWarningEvent } from "../core/types.ts";
-export declare function initialReadyFallbackWarning(agent: ElwoodAgentKind, elwoodSessionId: string): ElwoodWarningEvent;
-//# sourceMappingURL=initial-ready-fallback.d.ts.map

package/dist/runtime/initial-ready-fallback.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"initial-ready-fallback.d.ts","sourceRoot":"","sources":["../../src/runtime/initial-ready-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,eAAe,EACtB,eAAe,EAAE,MAAM,GACtB,kBAAkB,CAWpB"}

package/dist/runtime/initial-ready-fallback.js

@@ -1,20 +0,0 @@
-/**
- * The live, content-free warning for a fallback initial-ready transition.
- * Implements PRD §5.3 and C-API-42: when recording a session's one-shot initial-ready
- * transition throws (a lifecycle-event listener), Elwood still releases the control
- * queue directly so queued input is never starved, but emitted lifecycle events may be
- * stale. This surfaces that risk as a typed `initial_ready_fallback` warning carrying
- * no raw system message or session content. Both adapters.
- */
-export function initialReadyFallbackWarning(agent, elwoodSessionId) {
-    return {
-        elwoodSessionId,
-        agent,
-        source: "lifecycle",
-        code: "initial_ready_fallback",
-        severity: "warning",
-        message: "Recording the initial-ready transition failed; released the queue directly, so lifecycle events may be stale.",
-        raw: "initial_ready_fallback",
-    };
-}
-//# sourceMappingURL=initial-ready-fallback.js.map

package/dist/runtime/initial-ready-fallback.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"initial-ready-fallback.js","sourceRoot":"","sources":["../../src/runtime/initial-ready-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,UAAU,2BAA2B,CACzC,KAAsB,EACtB,eAAuB;IAEvB,OAAO;QACL,eAAe;QACf,KAAK;QACL,MAAM,EAAE,WAAW;QACnB,IAAI,EAAE,wBAAwB;QAC9B,QAAQ,EAAE,SAAS;QACnB,OAAO,EACL,+GAA+G;QACjH,GAAG,EAAE,wBAAwB;KAC9B,CAAC;AACJ,CAAC"}

package/dist/runtime/initial-ready.d.ts

@@ -1,49 +0,0 @@
-/**
- * Shared hook-backed initial-readiness marker with a starvation deadline.
- * Implements PRD §5.3, C-API-19, and C-API-28.
- *
- * On a COLD start both adapters gate the first queued message on a pre-input
- * readiness hook — Claude's `InstructionsLoaded`, Codex's `SessionStart` — the CLI's
- * authoritative "initialized and accepting input" signal, fired via `mark`. The
- * rendered composer is NOT a readiness signal on cold start: it paints as a boot
- * placeholder before input is accepted, so releasing the first queued message on it
- * would swallow the message. On RESUME the input loop is live when the composer paints,
- * so `markReadyOnResumeComposer` releases readiness on the first composer marker
- * (verified accepted, not swallowed) — UNLESS a blocking dialog is on screen, whose
- * option caret is byte-identical to the composer marker. The hooks differ on resume:
- * Codex does NOT re-fire `SessionStart` (so the composer is the fast signal), while
- * Claude's `InstructionsLoaded` DOES re-fire — so a resumed Claude is a hook/composer
- * race, whichever arrives first (readiness is idempotent). `armDeadline` is the ultimate
- * fallback for both start and resume so a missing readiness signal never starves the
- * queue forever.
- */
-export type InitialReady = {
-    readonly cancel: () => void;
-    readonly replay: () => void;
-    readonly armDeadline: () => void;
-    /** Fire readiness now (one-shot) — the pre-input readiness hook path. */
-    readonly mark: () => void;
-    /**
-     * Re-attempt a readiness mark that a hook/deadline requested while a blocking
-     * dialog was on screen. Call per rendered frame with the frame's blocking fact:
-     * once the dialog clears, the deferred readiness fires so the queue is never
-     * drained INTO the dialog and is never permanently starved BY it (C-API-28).
-     */
-    readonly retryWhenUnblocked: (blockingVisible: boolean) => void;
-};
-/** The rendered-frame facts the resume-composer readiness path inspects. */
-export type ComposerReadyFacts = {
-    readonly composer_visible: boolean;
-    readonly blocking_prompt_visible: boolean;
-};
-/**
- * On RESUME, mark readiness on the first genuine composer frame: the composer is
- * visible AND no blocking dialog is on screen. The dialog's option caret (`›`/`❯`) is
- * byte-identical to the composer marker, so a dialog frame must NOT latch readiness —
- * otherwise a draining queued message's Enter could approve the dialog; readiness waits
- * for the dialog to clear. Cold start (`resumed: false`) never fires here, so the
- * composer stays an unsafe signal there (C-API-28).
- */
-export declare function markReadyOnResumeComposer(ready: Pick<InitialReady, "mark">, resumed: boolean, facts: ComposerReadyFacts): void;
-export declare function initialReady(callback: () => void, maxWaitMs?: number, isBlocked?: () => boolean): InitialReady;
-//# sourceMappingURL=initial-ready.d.ts.map

package/dist/runtime/initial-ready.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"initial-ready.d.ts","sourceRoot":"","sources":["../../src/runtime/initial-ready.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC;IACjC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,kBAAkB,EAAE,CAAC,eAAe,EAAE,OAAO,KAAK,IAAI,CAAC;CACjE,CAAC;AAEF,4EAA4E;AAC5E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAC;CAC3C,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,EACjC,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,kBAAkB,GACxB,IAAI,CAEN;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,IAAI,EACpB,SAAS,SAAS,EAClB,SAAS,GAAE,MAAM,OAAqB,GACrC,YAAY,CA4Cd"}

package/dist/runtime/initial-ready.js

@@ -1,81 +0,0 @@
-/**
- * Shared hook-backed initial-readiness marker with a starvation deadline.
- * Implements PRD §5.3, C-API-19, and C-API-28.
- *
- * On a COLD start both adapters gate the first queued message on a pre-input
- * readiness hook — Claude's `InstructionsLoaded`, Codex's `SessionStart` — the CLI's
- * authoritative "initialized and accepting input" signal, fired via `mark`. The
- * rendered composer is NOT a readiness signal on cold start: it paints as a boot
- * placeholder before input is accepted, so releasing the first queued message on it
- * would swallow the message. On RESUME the input loop is live when the composer paints,
- * so `markReadyOnResumeComposer` releases readiness on the first composer marker
- * (verified accepted, not swallowed) — UNLESS a blocking dialog is on screen, whose
- * option caret is byte-identical to the composer marker. The hooks differ on resume:
- * Codex does NOT re-fire `SessionStart` (so the composer is the fast signal), while
- * Claude's `InstructionsLoaded` DOES re-fire — so a resumed Claude is a hook/composer
- * race, whichever arrives first (readiness is idempotent). `armDeadline` is the ultimate
- * fallback for both start and resume so a missing readiness signal never starves the
- * queue forever.
- */
-/**
- * On RESUME, mark readiness on the first genuine composer frame: the composer is
- * visible AND no blocking dialog is on screen. The dialog's option caret (`›`/`❯`) is
- * byte-identical to the composer marker, so a dialog frame must NOT latch readiness —
- * otherwise a draining queued message's Enter could approve the dialog; readiness waits
- * for the dialog to clear. Cold start (`resumed: false`) never fires here, so the
- * composer stays an unsafe signal there (C-API-28).
- */
-export function markReadyOnResumeComposer(ready, resumed, facts) {
-    if (resumed && facts.composer_visible && !facts.blocking_prompt_visible)
-        ready.mark();
-}
-export function initialReady(callback, maxWaitMs = 10_000, isBlocked = () => false) {
-    let ready = false;
-    let deferredByBlock = false;
-    let deadline;
-    const mark = () => {
-        if (ready)
-            return;
-        // A blocking dialog is on screen (it may have rendered while still `starting`,
-        // so it never latched `blocked`): do NOT release the queue into it. Remember the
-        // request and re-fire it from `retryWhenUnblocked` once the dialog clears — never
-        // latch here, so readiness is neither drained into the dialog nor starved by it.
-        if (isBlocked()) {
-            deferredByBlock = true;
-            return;
-        }
-        deferredByBlock = false;
-        // Latch AFTER the callback returns, so if it throws (a throwing status/activity
-        // listener) readiness is NOT consumed and a later hook/deadline/frame retries —
-        // a failed transition must never permanently starve the queue (C-API-28).
-        callback();
-        ready = true;
-    };
-    return {
-        cancel: () => {
-            if (deadline)
-                clearTimeout(deadline);
-        },
-        mark,
-        retryWhenUnblocked: (blockingVisible) => {
-            if (!ready && deferredByBlock && !blockingVisible)
-                mark();
-        },
-        replay: () => void (ready && callback()),
-        // Arms on the first frame regardless of hook arrival, so a missing or failed
-        // readiness hook cannot starve readiness forever. The deadline's mark is contained
-        // (a throwing callback on a timer would otherwise be an uncaught exception); if it
-        // fails, `ready` stays false so a later hook or composer frame still retries.
-        armDeadline: () => {
-            deadline ??= setTimeout(() => {
-                try {
-                    mark();
-                }
-                catch {
-                    // Retried by a subsequent readiness hook or rendered composer frame.
-                }
-            }, maxWaitMs);
-        },
-    };
-}
-//# sourceMappingURL=initial-ready.js.map

package/dist/runtime/initial-ready.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"initial-ready.js","sourceRoot":"","sources":["../../src/runtime/initial-ready.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAuBH;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAiC,EACjC,OAAgB,EAChB,KAAyB;IAEzB,IAAI,OAAO,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,KAAK,CAAC,uBAAuB;QAAE,KAAK,CAAC,IAAI,EAAE,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,QAAoB,EACpB,SAAS,GAAG,MAAM,EAClB,YAA2B,GAAG,EAAE,CAAC,KAAK;IAEtC,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,IAAI,QAAmD,CAAC;IACxD,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,IAAI,KAAK;YAAE,OAAO;QAClB,+EAA+E;QAC/E,iFAAiF;QACjF,kFAAkF;QAClF,iFAAiF;QACjF,IAAI,SAAS,EAAE,EAAE,CAAC;YAChB,eAAe,GAAG,IAAI,CAAC;YACvB,OAAO;QACT,CAAC;QACD,eAAe,GAAG,KAAK,CAAC;QACxB,gFAAgF;QAChF,gFAAgF;QAChF,0EAA0E;QAC1E,QAAQ,EAAE,CAAC;QACX,KAAK,GAAG,IAAI,CAAC;IACf,CAAC,CAAC;IACF,OAAO;QACL,MAAM,EAAE,GAAG,EAAE;YACX,IAAI,QAAQ;gBAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;QACD,IAAI;QACJ,kBAAkB,EAAE,CAAC,eAAe,EAAE,EAAE;YACtC,IAAI,CAAC,KAAK,IAAI,eAAe,IAAI,CAAC,eAAe;gBAAE,IAAI,EAAE,CAAC;QAC5D,CAAC;QACD,MAAM,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,QAAQ,EAAE,CAAC;QACxC,6EAA6E;QAC7E,mFAAmF;QACnF,mFAAmF;QACnF,8EAA8E;QAC9E,WAAW,EAAE,GAAG,EAAE;YAChB,QAAQ,KAAK,UAAU,CAAC,GAAG,EAAE;gBAC3B,IAAI,CAAC;oBACH,IAAI,EAAE,CAAC;gBACT,CAAC;gBAAC,MAAM,CAAC;oBACP,qEAAqE;gBACvE,CAAC;YACH,CAAC,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}