@with-logic/elwood 0.1.0 → 0.1.2

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"}

package/dist/runtime/reap-tree.d.ts

@@ -1,62 +0,0 @@
-/**
- * Reaps the process tree of a PTY leader on session teardown.
- * Implements PRD §5.3 and §9.4 (C-LIFE-10): a CLI-spawned helper such as the
- * Claude hook bridge is a descendant of the PTY leader. Because POSIX reparents
- * a surviving descendant to PID 1 the instant its parent exits, a parent-pid
- * walk (`pgrep -P`) cannot find it afterwards — but node-pty starts the leader
- * as its own session/process-group leader, and group membership is inherited
- * and survives reparenting. So we reap by SIGKILLing the leader's process group,
- * which reaches every descendant in one in-process syscall: no subprocess, no
- * PATH lookup, no post-exit reparenting blind spot.
- */
-/** Injectable so tests never signal real process groups; production uses `process.kill`. */
-export type ProcessGroupKiller = {
-    /** SIGKILLs the process group `pgid` (via `kill(-pgid)`); tolerates an empty/dead group. */
-    readonly killGroup: (pgid: number) => void;
-};
-/**
- * SIGKILLs the process group led by `leaderPid`, reaping every descendant still
- * in the group — including one already reparented to PID 1. node-pty starts the
- * leader via `setsid()`, so it heads its own session and its pgid equals its pid;
- * that group is always distinct from the host's own group, so this cannot signal
- * the host process. Refuses only pids the kernel would misroute (see
- * `isReapableGroupId`), never an arbitrary numeric floor. An already-dead group
- * (leader and children exited together) is the normal case and its `ESRCH` is
- * swallowed; a real kill failure such as `EPERM` propagates.
- */
-export declare function reapProcessGroup(leaderPid: number, ops?: ProcessGroupKiller): void;
-export declare function setGroupKillerForTests(killer: ProcessGroupKiller): void;
-export declare function resetGroupKillerForTests(): void;
-/**
- * Swallows the ESRCH raised when the group is already empty (the normal case:
- * the leader and its children exited together) and re-throws any other error —
- * a real failure (e.g. EPERM) that must not be reported as a successful reap.
- * Reads the errno through `errnoCode`, which narrows object-ness first, so a
- * thrown `null`/non-Error is preserved and rethrown rather than triggering a
- * secondary TypeError while inspecting it (C-ERR-01). Exported for focused
- * coverage of both branches without an unsafe real signal.
- */
-export declare function rethrowUnlessGroupGone(error: unknown): void;
-/**
- * Owns a single PTY leader's group reap. A SUCCESSFUL reap MUST happen at most
- * once: `stop()` then a later `teardown()` both want to guarantee the group is
- * gone, but signaling the same numeric pgid twice is unsafe — once the group is
- * empty the kernel may recycle the pid, and a second `kill(-pgid)` would hit an
- * unrelated group. So the latch is set only AFTER the kill succeeds (an already
- * empty group's `ESRCH` is normalized to success by `reapProcessGroup`). A real
- * failure (e.g. EPERM) leaves the latch OPEN and rethrows, so a later teardown
- * call can retry rather than leaving the descendant leak permanently unreaped.
- */
-export declare class SessionReaper {
-    private readonly leaderPid;
-    private readonly ops;
-    private done;
-    constructor(leaderPid: number, ops?: ProcessGroupKiller);
-    /**
-     * Reap the group once it succeeds; a successful call latches so subsequent
-     * calls no-op (no recycled-pgid double-kill). A failed kill does NOT latch and
-     * rethrows, keeping the reap retryable on a later lifecycle call.
-     */
-    reap(): void;
-}
-//# sourceMappingURL=reap-tree.d.ts.map

package/dist/runtime/reap-tree.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"reap-tree.d.ts","sourceRoot":"","sources":["../../src/runtime/reap-tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,4FAA4F;AAC5F,MAAM,MAAM,kBAAkB,GAAG;IAC/B,4FAA4F;IAC5F,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C,CAAC;AAoBF;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAE,kBAAiC,GAAG,IAAI,CAGhG;AAiBD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAEvE;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE3D;AAED;;;;;;;;;GASG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAqB;IACzC,OAAO,CAAC,IAAI,CAAS;gBAET,SAAS,EAAE,MAAM,EAAE,GAAG,GAAE,kBAAiC;IAKrE;;;;OAIG;IACH,IAAI,IAAI,IAAI;CAKb"}