@with-logic/elwood 0.1.0

package/dist/core/control-queue-traits.js

@@ -0,0 +1,118 @@
+/**
+ * Static per-operation traits for the control queue: the kinds a session can
+ * submit and their readiness/turn semantics. Split from the queue logic per the
+ * repo convention of separating static tables from behavior (PRD §5.3).
+ */
+/**
+ * Whether an operation with this readiness policy may dispatch while the session
+ * is not ready. Exhaustive over ReadinessPolicy with no runtime default (100%
+ * coverage holds): a new member leaves a return-less path, so `noImplicitReturns`
+ * fails the build rather than letting it silently become non-bypassable.
+ */
+function dispatchesWhileNotReady(policy, mayBypass) {
+    switch (policy) {
+        case "always":
+            return true;
+        case "running_after_ready":
+            return mayBypass;
+        case "ready":
+            return false;
+    }
+}
+/** Whether a queued operation may dispatch even though the session is not ready. */
+export function overtakesReadiness(op) {
+    return dispatchesWhileNotReady(controlOperationTraits[op.kind].readiness, op.mayBypassReadiness);
+}
+/**
+ * Index of the next operation to dispatch, or -1. Head dispatches when ready;
+ * otherwise the first overtaker goes. `bypassable === 0` skips the scan when no
+ * queued op can dispatch while not ready (keeps a message backlog amortized O(1)).
+ */
+export function nextDispatchIndex(queue, ready, bypassable) {
+    if (ready)
+        return 0;
+    if (overtakesReadiness(queue[0]))
+        return 0;
+    if (bypassable === 0)
+        return -1;
+    return queue.findIndex(overtakesReadiness);
+}
+/**
+ * Slash-command operations do not start a user turn, so no completion hook
+ * will re-arm readiness afterwards; consuming readiness would deadlock later
+ * sends. `guidance` is the only conditional policy: see `ReadinessPolicy`.
+ */
+export const controlOperationTraits = {
+    message: {
+        reportsCallerSubmission: true,
+        consumesReadiness: true,
+        readiness: "ready",
+        submitMode: "pasted_input",
+    },
+    guidance: {
+        reportsCallerSubmission: true,
+        consumesReadiness: true,
+        readiness: "running_after_ready",
+        submitMode: "pasted_input",
+    },
+    prompt: {
+        reportsCallerSubmission: true,
+        consumesReadiness: true,
+        readiness: "always",
+        submitMode: "pasted_input",
+    },
+    compact: {
+        reportsCallerSubmission: false,
+        consumesReadiness: false,
+        readiness: "ready",
+        submitMode: "command",
+    },
+    list_models: {
+        reportsCallerSubmission: false,
+        consumesReadiness: false,
+        readiness: "always",
+        submitMode: "command",
+    },
+    set_model: {
+        reportsCallerSubmission: false,
+        consumesReadiness: false,
+        readiness: "always",
+        submitMode: "command",
+    },
+    // `/login` recovery: a picker command that must dispatch even while the session
+    // is not ready (login has lapsed, so it may never reach `ready` on its own).
+    login: {
+        reportsCallerSubmission: false,
+        consumesReadiness: false,
+        readiness: "always",
+        submitMode: "command",
+    },
+};
+/** Owns abort-listener cleanup and the one in-flight cancellation marker. */
+export class ControlCancellation {
+    hooks = new Map();
+    cancelled;
+    listen(operation, cancel, drop) {
+        const listener = () => drop(cancel.error());
+        cancel.signal.addEventListener("abort", listener, { once: true });
+        this.hooks.set(operation, () => cancel.signal.removeEventListener("abort", listener));
+        if (cancel.signal.aborted)
+            listener();
+    }
+    mark(operation, error) {
+        this.cancelled = { operation, error };
+    }
+    errorFor(operation) {
+        return this.cancelled?.operation === operation ? this.cancelled.error : undefined;
+    }
+    remove(operation) {
+        this.hooks.get(operation)?.();
+        this.hooks.delete(operation);
+        if (this.cancelled?.operation === operation)
+            this.cancelled = undefined;
+    }
+    clear() {
+        this.cancelled = undefined;
+    }
+}
+//# sourceMappingURL=control-queue-traits.js.map

package/dist/core/control-queue-traits.js.map

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

package/dist/core/control-queue-types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Types for the serialized control queue: the submitter contract, the exclusive
+ * task shape, cancellation, and a queued operation. Split from the queue class
+ * to keep each file focused (PRD §5.3, C-API-19/37/44).
+ */
+import type { ControlOperationKind, ControlSubmitMode } from "./control-queue-traits.ts";
+export type ControlSubmitter = (input: string, mode: ControlSubmitMode, signal: AbortSignal) => Promise<void>;
+/** An abortable task run while its queue op holds the queue; aborts on close. */
+export type AbortableQueueTask = (signal: AbortSignal) => Promise<void>;
+/** Drops a still-queued op when `signal` aborts, rejecting it with `error()`. */
+export type Cancel = {
+    readonly signal: AbortSignal;
+    readonly error: () => Error;
+};
+/** Internal provenance for activity and recurring-loop scheduling decisions. */
+export type ControlSubmissionOrigin = {
+    readonly kind: "caller";
+} | {
+    readonly kind: "loop";
+    readonly loopId: string;
+};
+/** Optional internal controls for an attributed, cancellable text submission. */
+export type ControlSendOptions = {
+    readonly cancel?: Cancel;
+    readonly origin?: ControlSubmissionOrigin;
+};
+type QueuedOperationBase = {
+    readonly input: string;
+    readonly kind: ControlOperationKind;
+    readonly mayBypassReadiness: boolean;
+    readonly origin: ControlSubmissionOrigin;
+    readonly resolve: () => void;
+    readonly reject: (error: Error) => void;
+};
+type RunOrAttach = {
+    readonly run: AbortableQueueTask;
+    readonly attach?: never;
+} | {
+    readonly run?: never;
+    readonly attach?: AbortableQueueTask;
+};
+export type QueuedOperation = QueuedOperationBase & RunOrAttach;
+export type PendingOperation = Omit<QueuedOperationBase, "resolve" | "reject"> & RunOrAttach;
+export {};
+//# sourceMappingURL=control-queue-types.d.ts.map

package/dist/core/control-queue-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-queue-types.d.ts","sourceRoot":"","sources":["../../src/core/control-queue-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAKzF,MAAM,MAAM,gBAAgB,GAAG,CAC7B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,iFAAiF;AACjF,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAExE,iFAAiF;AACjF,MAAM,MAAM,MAAM,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,KAAK,CAAA;CAAE,CAAC;AAEnF,gFAAgF;AAChF,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,iFAAiF;AACjF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,uBAAuB,CAAC;CAC3C,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IAEpC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACzC,CAAC;AAMF,KAAK,WAAW,GACZ;IAAE,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,GAC7D;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAEnE,MAAM,MAAM,eAAe,GAAG,mBAAmB,GAAG,WAAW,CAAC;AAIhE,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,EAAE,SAAS,GAAG,QAAQ,CAAC,GAAG,WAAW,CAAC"}

package/dist/core/control-queue-types.js

@@ -0,0 +1,7 @@
+/**
+ * Types for the serialized control queue: the submitter contract, the exclusive
+ * task shape, cancellation, and a queued operation. Split from the queue class
+ * to keep each file focused (PRD §5.3, C-API-19/37/44).
+ */
+export {};
+//# sourceMappingURL=control-queue-types.js.map

package/dist/core/control-queue-types.js.map

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

package/dist/core/control-queue.d.ts

@@ -0,0 +1,21 @@
+/** Serialized adapter controls with readiness semantics (PRD §5.3/§5.9). */
+import { ControlQueueState } from "./control-queue-state.ts";
+import { type ControlOperationKind, type ControlQueueError } from "./control-queue-traits.ts";
+import type { AbortableQueueTask, Cancel, ControlSendOptions, ControlSubmissionOrigin, ControlSubmitter } from "./control-queue-types.ts";
+export type { ControlOperationKind, ControlOperationTraits, ControlQueueError, ControlSubmitMode, ReadinessPolicy, } from "./control-queue-traits.ts";
+export { controlOperationTraits } from "./control-queue-traits.ts";
+export type { AbortableQueueTask, Cancel, ControlSendOptions, ControlSubmissionOrigin, ControlSubmitter, } from "./control-queue-types.ts";
+export declare class ControlQueue extends ControlQueueState {
+    private readonly submit;
+    private readonly onTurnStarted;
+    private readonly guidanceMayBypass;
+    constructor(submit: ControlSubmitter, stoppedError: ControlQueueError, onTurnStarted: (origin: ControlSubmissionOrigin) => void, guidanceMayBypass?: () => boolean);
+    send(input: string, kind: ControlOperationKind, attach?: AbortableQueueTask, options?: ControlSendOptions): Promise<void>;
+    runExclusive(kind: ControlOperationKind, run: AbortableQueueTask, cancel?: Cancel): Promise<void>;
+    protected drain(): void;
+    private submitWithAttach;
+    private beginSubmission;
+    private commit;
+    private rollback;
+}
+//# sourceMappingURL=control-queue.d.ts.map

package/dist/core/control-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-queue.d.ts","sourceRoot":"","sources":["../../src/core/control-queue.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAG5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EACL,KAAK,oBAAoB,EAEzB,KAAK,iBAAiB,EAIvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACV,kBAAkB,EAClB,MAAM,EACN,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAEjB,MAAM,0BAA0B,CAAC;AAGlC,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,YAAY,EACV,kBAAkB,EAClB,MAAM,EACN,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAIlC,qBAAa,YAAa,SAAQ,iBAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4C;IAC1E,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgB;gBAGhD,MAAM,EAAE,gBAAgB,EACxB,YAAY,EAAE,iBAAiB,EAC/B,aAAa,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,EACxD,iBAAiB,GAAE,MAAM,OAAqB;IAQhD,IAAI,CACF,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,oBAAoB,EAC1B,MAAM,CAAC,EAAE,kBAAkB,EAC3B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC;IAiBhB,YAAY,CACV,IAAI,EAAE,oBAAoB,EAC1B,GAAG,EAAE,kBAAkB,EACvB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAahB,SAAS,CAAC,KAAK,IAAI,IAAI;YA8BT,gBAAgB;IAa9B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,QAAQ;CASjB"}

package/dist/core/control-queue.js

@@ -0,0 +1,98 @@
+/** Serialized adapter controls with readiness semantics (PRD §5.3/§5.9). */
+import { runContained } from "./contained.js";
+import { ControlQueueState } from "./control-queue-state.js";
+import { controlOperationTraits, nextDispatchIndex, overtakesReadiness, } from "./control-queue-traits.js";
+import { toError } from "./errors.js";
+export { controlOperationTraits } from "./control-queue-traits.js";
+const callerOrigin = { kind: "caller" };
+export class ControlQueue extends ControlQueueState {
+    submit;
+    onTurnStarted;
+    guidanceMayBypass;
+    constructor(submit, stoppedError, onTurnStarted, guidanceMayBypass = () => false) {
+        super(stoppedError);
+        this.submit = submit;
+        this.onTurnStarted = onTurnStarted;
+        this.guidanceMayBypass = guidanceMayBypass;
+    }
+    send(input, kind, attach, options = {}) {
+        const mayBypassReadiness = controlOperationTraits[kind].readiness === "running_after_ready" &&
+            this.everReady &&
+            this.guidanceMayBypass();
+        return this.enqueue({
+            input,
+            kind,
+            mayBypassReadiness,
+            origin: options.origin ?? callerOrigin,
+            ...(attach ? { attach } : {}),
+        }, options.cancel);
+    }
+    runExclusive(kind, run, cancel) {
+        return this.enqueue({
+            input: "",
+            kind,
+            mayBypassReadiness: false,
+            origin: callerOrigin,
+            run,
+        }, cancel);
+    }
+    drain() {
+        if (this.inFlight || this.queue.length === 0)
+            return;
+        const index = nextDispatchIndex(this.queue, this.ready, this.bypassable);
+        if (index < 0)
+            return;
+        const operation = this.queue.splice(index, 1)[0];
+        if (overtakesReadiness(operation))
+            this.bypassable -= 1;
+        this.inFlight = operation;
+        const traits = controlOperationTraits[operation.kind];
+        const priorReady = this.ready;
+        const epoch = this.readinessEpoch;
+        let dispatched;
+        try {
+            const signal = this.armAbort();
+            if (!operation.attach)
+                this.beginSubmission(operation, traits);
+            dispatched = operation.run
+                ? operation.run(signal)
+                : this.submitWithAttach(operation, traits, signal);
+        }
+        catch (error) {
+            this.rollback(operation, priorReady, epoch, toError(error));
+            return;
+        }
+        dispatched.then(() => this.commit(operation, traits), (error) => {
+            const cancellation = this.cancellation.errorFor(operation);
+            this.rollback(operation, priorReady, epoch, cancellation ?? toError(error));
+        });
+    }
+    async submitWithAttach(operation, traits, signal) {
+        if (operation.attach) {
+            await operation.attach(signal);
+            if (signal.aborted)
+                throw this.abortError(signal);
+            this.beginSubmission(operation, traits);
+        }
+        await this.submit(operation.input, traits.submitMode, signal);
+    }
+    beginSubmission(operation, traits) {
+        if (traits.consumesReadiness)
+            this.ready = false;
+        if (traits.reportsCallerSubmission && operation.origin.kind === "caller") {
+            runContained(() => this.onTurnStarted(operation.origin));
+        }
+    }
+    commit(operation, traits) {
+        if (traits.reportsCallerSubmission && operation.origin.kind === "loop") {
+            runContained(() => this.onTurnStarted(operation.origin));
+        }
+        this.settle(operation, () => operation.resolve());
+    }
+    rollback(operation, priorReady, epoch, error) {
+        if (!this.closed && this.readinessEpoch === epoch)
+            this.ready = priorReady;
+        this.settle(operation, () => operation.reject(error));
+    }
+}
+//# sourceMappingURL=control-queue.js.map

package/dist/core/control-queue.js.map

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

package/dist/core/defaults.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Shared runtime defaults for Elwood sessions.
+ * Implements PRD §5.1 and §5.5.
+ */
+import type { TerminalSize } from "./types.ts";
+export declare const defaultTerminalSize: TerminalSize;
+//# sourceMappingURL=defaults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/core/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,mBAAmB,EAAE,YAAsC,CAAC"}

package/dist/core/defaults.js

@@ -0,0 +1,6 @@
+/**
+ * Shared runtime defaults for Elwood sessions.
+ * Implements PRD §5.1 and §5.5.
+ */
+export const defaultTerminalSize = { cols: 189, rows: 48 };
+//# sourceMappingURL=defaults.js.map

package/dist/core/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/core/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,CAAC,MAAM,mBAAmB,GAAiB,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC"}

package/dist/core/delay.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The one promise-returning sleep used by the TUI automation flows (model picker
+ * polling, cursor trust navigation). Implements PRD §5.3: a plain referenced timer,
+ * so an automation step that is mid-wait keeps the process alive until it settles.
+ */
+export declare function delay(ms: number): Promise<void>;
+//# sourceMappingURL=delay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delay.d.ts","sourceRoot":"","sources":["../../src/core/delay.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/core/delay.js

@@ -0,0 +1,9 @@
+/**
+ * The one promise-returning sleep used by the TUI automation flows (model picker
+ * polling, cursor trust navigation). Implements PRD §5.3: a plain referenced timer,
+ * so an automation step that is mid-wait keeps the process alive until it settles.
+ */
+export function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=delay.js.map

package/dist/core/delay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delay.js","sourceRoot":"","sources":["../../src/core/delay.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/core/errors.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Stable public error names and error class.
+ * Implements PRD §10.
+ */
+export type ElwoodErrorName = "unsupported_platform" | "claude_not_found" | "claude_start_failed" | "claude_update_failed" | "claude_not_authenticated" | "claude_version_unsupported" | "claude_invalid_reasoning_effort" | "codex_not_found" | "codex_start_failed" | "codex_update_failed" | "codex_not_authenticated" | "codex_version_unsupported" | "codex_invalid_reasoning_effort" | "state_not_found" | "state_corrupt" | "adapter_mismatch" | "resume_unavailable" | "pty_start_failed" | "hook_bridge_failed" | "session_not_running" | "termination_failed" | "teardown_failed" | "compact_failed" | "interrupt_failed" | "model_automation_failed" | "login_failed" | "login_timeout" | "invalid_image" | "image_attach_failed" | "invalid_loop" | "loop_limit_reached" | "loop_not_found" | "loop_persistence_failed" | "loop_submission_failed" | "wait_timeout";
+export declare class ElwoodError extends Error {
+    readonly name = "ElwoodError";
+    readonly code: ElwoodErrorName;
+    readonly details: Readonly<Record<string, unknown>>;
+    constructor(code: ElwoodErrorName, message: string, details?: Readonly<Record<string, unknown>>);
+}
+export declare function elwoodError(code: ElwoodErrorName, message: string, details?: Readonly<Record<string, unknown>>): ElwoodError;
+/** Normalize a thrown value into an Error so a non-Error throw never escapes raw. */
+export declare function toError(value: unknown): Error;
+/**
+ * The errno string of a thrown value, or `undefined` when it has none. Narrows
+ * object-ness FIRST so a thrown `null`/`undefined`/primitive can never make the
+ * inspection itself throw a secondary TypeError that would replace the original
+ * failure — the caller keeps and rethrows the real thrown value (C-ERR-01).
+ */
+export declare function errnoCode(error: unknown): string | undefined;
+/**
+ * Extracts diagnosable details from an underlying failure (C-ERR-08):
+ * message as cause, plus errno/syscall/path when the error exposes them.
+ */
+export declare function causeDetails(error: unknown): Readonly<Record<string, string>>;
+/**
+ * Diagnosable details for a failed CLI probe (C-ERR-08): stderr plus the
+ * runner's typed cause/errno (e.g. `ETIMEDOUT` on a probe timeout, `E2BIG` on
+ * output overflow) so a start failure never drops the underlying reason.
+ */
+export declare function probeFailureDetails(result: {
+    readonly stderr: string;
+    readonly error?: {
+        readonly code?: string | undefined;
+        readonly message: string;
+    };
+}): Readonly<Record<string, string>>;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,eAAe,GACvB,sBAAsB,GACtB,kBAAkB,GAClB,qBAAqB,GACrB,sBAAsB,GACtB,0BAA0B,GAC1B,4BAA4B,GAC5B,iCAAiC,GACjC,iBAAiB,GACjB,oBAAoB,GACpB,qBAAqB,GACrB,yBAAyB,GACzB,2BAA2B,GAC3B,gCAAgC,GAChC,iBAAiB,GACjB,eAAe,GACf,kBAAkB,GAClB,oBAAoB,GACpB,kBAAkB,GAClB,oBAAoB,GACpB,qBAAqB,GACrB,oBAAoB,GACpB,iBAAiB,GACjB,gBAAgB,GAChB,kBAAkB,GAClB,yBAAyB,GACzB,cAAc,GACd,eAAe,GACf,eAAe,GACf,qBAAqB,GACrB,cAAc,GACd,oBAAoB,GACpB,gBAAgB,GAChB,yBAAyB,GACzB,wBAAwB,GACxB,cAAc,CAAC;AAEnB,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAkB,IAAI,iBAAiB;IACvC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;gBAGlD,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM;CAMlD;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAM,GAC9C,WAAW,CAEb;AAED,qFAAqF;AACrF,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI5D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAQ7E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACnF,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAOnC"}

package/dist/core/errors.js

@@ -0,0 +1,65 @@
+/**
+ * Stable public error names and error class.
+ * Implements PRD §10.
+ */
+export class ElwoodError extends Error {
+    name = "ElwoodError";
+    code;
+    details;
+    constructor(code, message, details = {}) {
+        super(message);
+        this.code = code;
+        this.details = details;
+    }
+}
+export function elwoodError(code, message, details = {}) {
+    return new ElwoodError(code, message, details);
+}
+/** Normalize a thrown value into an Error so a non-Error throw never escapes raw. */
+export function toError(value) {
+    return value instanceof Error ? value : new Error(String(value));
+}
+/**
+ * The errno string of a thrown value, or `undefined` when it has none. Narrows
+ * object-ness FIRST so a thrown `null`/`undefined`/primitive can never make the
+ * inspection itself throw a secondary TypeError that would replace the original
+ * failure — the caller keeps and rethrows the real thrown value (C-ERR-01).
+ */
+export function errnoCode(error) {
+    if (typeof error !== "object" || error === null)
+        return undefined;
+    const code = error.code;
+    return typeof code === "string" ? code : undefined;
+}
+/**
+ * Extracts diagnosable details from an underlying failure (C-ERR-08):
+ * message as cause, plus errno/syscall/path when the error exposes them.
+ */
+export function causeDetails(error) {
+    if (!(error instanceof Error))
+        return { cause: String(error) };
+    const details = { cause: error.message };
+    const { code, syscall, path } = error;
+    if (typeof code === "string")
+        details["errno"] = code;
+    if (typeof syscall === "string")
+        details["syscall"] = syscall;
+    if (typeof path === "string")
+        details["path"] = path;
+    return details;
+}
+/**
+ * Diagnosable details for a failed CLI probe (C-ERR-08): stderr plus the
+ * runner's typed cause/errno (e.g. `ETIMEDOUT` on a probe timeout, `E2BIG` on
+ * output overflow) so a start failure never drops the underlying reason.
+ */
+export function probeFailureDetails(result) {
+    const details = { stderr: result.stderr };
+    if (result.error) {
+        details["cause"] = result.error.message;
+        if (typeof result.error.code === "string")
+            details["errno"] = result.error.code;
+    }
+    return details;
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuCH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAClB,IAAI,GAAG,aAAa,CAAC;IAC9B,IAAI,CAAkB;IACtB,OAAO,CAAoC;IAEpD,YACE,IAAqB,EACrB,OAAe,EACf,UAA6C,EAAE;QAE/C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CACzB,IAAqB,EACrB,OAAe,EACf,UAA6C,EAAE;IAE/C,OAAO,IAAI,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AACnE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAClE,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;IAChD,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/D,MAAM,OAAO,GAA2B,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IACjE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAA8B,CAAC;IAC/D,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACtD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;IAC9D,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACrD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAGnC;IACC,MAAM,OAAO,GAA2B,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAClE,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;QACxC,IAAI,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;IAClF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/hook-dispatch.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Shared hook-handler dispatch with fail-open validation for both adapters.
+ * Implements PRD §6.3 (Claude) and §7A.2 (Codex): a handler is raced against
+ * the hook timeout, its return value is runtime-validated for the event, and a
+ * timeout, throw, rejection, or invalid value yields no decision plus a
+ * categorized `hookError` (with `timeoutMs` only on a genuine timeout).
+ */
+import { type ElwoodActivityEvent, type ElwoodAgentKind } from "./activity/index.ts";
+import type { HookErrorEvent } from "./types.ts";
+/** A hook event as dispatch sees it: its name is one the `hookError` event can carry. */
+export type DispatchableHookEvent = {
+    readonly hook_event_name: Exclude<HookErrorEvent["hookEventName"], "Unknown">;
+};
+export type HookDispatchOutcome<Result> = {
+    readonly result: Result | undefined;
+    readonly failedOpen: boolean;
+};
+/**
+ * The slice of an adapter's typed emitter that dispatch needs: `hook:<name>`
+ * request keys plus the `hookError`/`activity` channels. Both `TypedEmitter<ElwoodEventMap>`
+ * and `TypedEmitter<CodexEventMap>` satisfy it structurally, so neither adapter
+ * casts its emitter.
+ */
+export type HookDispatchEmitter<Event extends DispatchableHookEvent> = {
+    hasListeners(event: `hook:${Event["hook_event_name"]}`): boolean;
+    request(event: `hook:${Event["hook_event_name"]}`, payload: Event): Promise<unknown>;
+    emit(event: "hookError", payload: HookErrorEvent): void;
+    emit(event: "activity", payload: ElwoodActivityEvent): void;
+};
+export type HookDispatcher<Event extends DispatchableHookEvent, Result> = (emitter: HookDispatchEmitter<Event>, event: Event, timeoutMs: number, elwoodSessionId: string) => Promise<HookDispatchOutcome<Result>>;
+/**
+ * Builds an adapter's dispatcher from its agent tag (for `hook_error` activity)
+ * and its per-event result validator.
+ */
+export declare function createHookDispatcher<Event extends DispatchableHookEvent, Result>(agent: ElwoodAgentKind, isValidResult: (event: Event, value: unknown) => value is Result): HookDispatcher<Event, Result>;
+//# sourceMappingURL=hook-dispatch.d.ts.map

package/dist/core/hook-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-dispatch.d.ts","sourceRoot":"","sources":["../../src/core/hook-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,yFAAyF;AACzF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,cAAc,CAAC,eAAe,CAAC,EAAE,SAAS,CAAC,CAAC;CAC/E,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,MAAM,IAAI;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,CAAC,KAAK,SAAS,qBAAqB,IAAI;IACrE,YAAY,CAAC,KAAK,EAAE,QAAQ,KAAK,CAAC,iBAAiB,CAAC,EAAE,GAAG,OAAO,CAAC;IACjE,OAAO,CAAC,KAAK,EAAE,QAAQ,KAAK,CAAC,iBAAiB,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrF,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IACxD,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;CAC7D,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,KAAK,SAAS,qBAAqB,EAAE,MAAM,IAAI,CACxE,OAAO,EAAE,mBAAmB,CAAC,KAAK,CAAC,EACnC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,KACpB,OAAO,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,SAAS,qBAAqB,EAAE,MAAM,EAC9E,KAAK,EAAE,eAAe,EACtB,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,MAAM,GAC/D,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,CAkC/B"}

package/dist/core/hook-dispatch.js

@@ -0,0 +1,51 @@
+/**
+ * Shared hook-handler dispatch with fail-open validation for both adapters.
+ * Implements PRD §6.3 (Claude) and §7A.2 (Codex): a handler is raced against
+ * the hook timeout, its return value is runtime-validated for the event, and a
+ * timeout, throw, rejection, or invalid value yields no decision plus a
+ * categorized `hookError` (with `timeoutMs` only on a genuine timeout).
+ */
+import { activityFromHookError, } from "./activity/index.js";
+import { raceHookTimeout } from "./hook-timeout.js";
+/**
+ * Builds an adapter's dispatcher from its agent tag (for `hook_error` activity)
+ * and its per-event result validator.
+ */
+export function createHookDispatcher(agent, isValidResult) {
+    return async (emitter, event, timeoutMs, elwoodSessionId) => {
+        const failOpen = (error) => {
+            const hookError = { elwoodSessionId, hookEventName: event.hook_event_name, ...error };
+            emitter.emit("hookError", hookError);
+            emitter.emit("activity", activityFromHookError(agent, hookError));
+            return { result: undefined, failedOpen: true };
+        };
+        try {
+            const hookName = `hook:${event.hook_event_name}`;
+            const hasListener = emitter.hasListeners(hookName);
+            const outcome = await raceHookTimeout(emitter.request(hookName, event), timeoutMs);
+            if (outcome.timedOut) {
+                return failOpen({
+                    category: "timeout",
+                    message: `Hook handler timed out after ${timeoutMs} ms.`,
+                    timeoutMs,
+                });
+            }
+            if (!hasListener)
+                return { result: undefined, failedOpen: false };
+            if (!isValidResult(event, outcome.value)) {
+                return failOpen({
+                    category: "invalid_response",
+                    message: "Hook handler returned an invalid response for this event.",
+                });
+            }
+            return { result: outcome.value, failedOpen: false };
+        }
+        catch (error) {
+            return failOpen({
+                category: "handler_error",
+                message: error instanceof Error ? error.message : "Hook handler failed",
+            });
+        }
+    };
+}
+//# sourceMappingURL=hook-dispatch.js.map

package/dist/core/hook-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-dispatch.js","sourceRoot":"","sources":["../../src/core/hook-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,qBAAqB,GAGtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAiCpD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAsB,EACtB,aAAgE;IAEhE,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,EAAE;QAC1D,MAAM,QAAQ,GAAG,CAAC,KAAgE,EAAE,EAAE;YACpF,MAAM,SAAS,GAAG,EAAE,eAAe,EAAE,aAAa,EAAE,KAAK,CAAC,eAAe,EAAE,GAAG,KAAK,EAAE,CAAC;YACtF,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,qBAAqB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;YAClE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QACjD,CAAC,CAAC;QACF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,QAAQ,KAAK,CAAC,eAAe,EAAW,CAAC;YAC1D,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACnD,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC;YACnF,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACrB,OAAO,QAAQ,CAAC;oBACd,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,gCAAgC,SAAS,MAAM;oBACxD,SAAS;iBACV,CAAC,CAAC;YACL,CAAC;YACD,IAAI,CAAC,WAAW;gBAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;YAClE,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzC,OAAO,QAAQ,CAAC;oBACd,QAAQ,EAAE,kBAAkB;oBAC5B,OAAO,EAAE,2DAA2D;iBACrE,CAAC,CAAC;YACL,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,QAAQ,CAAC;gBACd,QAAQ,EAAE,eAAe;gBACzB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB;aACxE,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/hook-result.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Hook result display labels for adapter-neutral activity.
+ * Implements PRD §5.4.
+ */
+import type { ElwoodActivityKind } from "./activity/index.ts";
+export declare function hookResultLabel(result: unknown, failedOpen: boolean): string;
+export declare function transcriptActivityKind(kind: string): ElwoodActivityKind;
+//# sourceMappingURL=hook-result.d.ts.map

package/dist/core/hook-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-result.d.ts","sourceRoot":"","sources":["../../src/core/hook-result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAa5E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAWvE"}