@with-logic/elwood 0.1.0

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

@@ -0,0 +1,95 @@
+/** Queue lifecycle and cancellation bookkeeping (PRD §5.3/§5.9). */
+import { toError } from "../errors.js";
+import { ControlCancellation, overtakesReadiness } from "./traits.js";
+/** Shared mutable state for the serialized control queue. */
+export class ControlQueueState {
+    queue = [];
+    ready = false;
+    everReady = false;
+    closed = false;
+    readinessEpoch = 0;
+    bypassable = 0;
+    inFlight;
+    submitAbort;
+    cancellation = new ControlCancellation();
+    stoppedError;
+    constructor(stoppedError) {
+        this.stoppedError = stoppedError;
+    }
+    markReady() {
+        if (this.closed)
+            return;
+        this.everReady = this.ready = true;
+        this.readinessEpoch += 1;
+        this.drain();
+    }
+    suspendReadiness() {
+        this.ready = false;
+        this.readinessEpoch += 1;
+    }
+    close() {
+        this.closed = true;
+        const error = this.stoppedError();
+        this.submitAbort?.abort(error);
+        const settling = this.inFlight;
+        this.inFlight = undefined;
+        this.bypassable = 0;
+        if (settling) {
+            this.cancellation.remove(settling);
+            settling.reject(error);
+        }
+        this.cancellation.clear();
+        for (const operation of this.queue.splice(0)) {
+            this.cancellation.remove(operation);
+            operation.reject(error);
+        }
+    }
+    enqueue(op, cancel) {
+        if (this.closed)
+            return Promise.reject(this.stoppedError());
+        return new Promise((resolve, reject) => {
+            const operation = { ...op, resolve, reject };
+            this.queue.push(operation);
+            if (overtakesReadiness(operation))
+                this.bypassable += 1;
+            if (cancel)
+                this.listenForCancel(operation, cancel);
+            if (!cancel?.signal.aborted)
+                this.drain();
+        });
+    }
+    settle(operation, finish) {
+        if (this.inFlight !== operation)
+            return;
+        this.inFlight = undefined;
+        this.cancellation.remove(operation);
+        finish();
+        this.drain();
+    }
+    armAbort() {
+        this.submitAbort?.abort();
+        this.submitAbort = new AbortController();
+        return this.submitAbort.signal;
+    }
+    abortError(signal) {
+        return toError(signal.reason);
+    }
+    listenForCancel(operation, cancel) {
+        this.cancellation.listen(operation, cancel, (error) => this.cancelOperation(operation, error));
+    }
+    cancelOperation(operation, error) {
+        const index = this.queue.indexOf(operation);
+        if (index >= 0) {
+            this.queue.splice(index, 1);
+            if (overtakesReadiness(operation))
+                this.bypassable -= 1;
+            this.cancellation.remove(operation);
+            operation.reject(error);
+        }
+        else if (this.inFlight === operation && !operation.run) {
+            this.cancellation.mark(operation, error);
+            this.submitAbort?.abort(error);
+        }
+    }
+}
+//# sourceMappingURL=state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/core/control-queue/state.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGtE,6DAA6D;AAC7D,MAAM,OAAgB,iBAAiB;IAClB,KAAK,GAAsB,EAAE,CAAC;IACvC,KAAK,GAAG,KAAK,CAAC;IACd,SAAS,GAAG,KAAK,CAAC;IAClB,MAAM,GAAG,KAAK,CAAC;IACf,cAAc,GAAG,CAAC,CAAC;IACnB,UAAU,GAAG,CAAC,CAAC;IACf,QAAQ,CAA8B;IACtC,WAAW,CAA8B;IAChC,YAAY,GAAG,IAAI,mBAAmB,EAAE,CAAC;IACzC,YAAY,CAAoB;IAEnD,YAAsB,YAA+B;QACnD,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED,SAAS;QACP,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACnC,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED,gBAAgB;QACd,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAClC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC1B,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACpB,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACnC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACpC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAES,OAAO,CAAC,EAAoB,EAAE,MAAe;QACrD,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAC5D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,SAAS,GAAoB,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YAC9D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3B,IAAI,kBAAkB,CAAC,SAAS,CAAC;gBAAE,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;YACxD,IAAI,MAAM;gBAAE,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACpD,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO;gBAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC;IAES,MAAM,CAAC,SAA0B,EAAE,MAAkB;QAC7D,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,OAAO;QACxC,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC1B,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,EAAE,CAAC;QACT,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAES,QAAQ;QAChB,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;IACjC,CAAC;IAES,UAAU,CAAC,MAAmB;QACtC,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAIO,eAAe,CAAC,SAA0B,EAAE,MAAc;QAChE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IACjG,CAAC;IAEO,eAAe,CAAC,SAA0B,EAAE,KAAY;QAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC5B,IAAI,kBAAkB,CAAC,SAAS,CAAC;gBAAE,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;YACxD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACpC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;aAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;YACzD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACzC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,54 @@
+/**
+ * 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).
+ */
+import type { Cancel, QueuedOperation } from "./types.ts";
+export type ControlQueueError = () => Error;
+/** How an operation's text is written to the terminal (not a domain name). */
+export type ControlSubmitMode = "pasted_input" | "command";
+export type ControlOperationKind = "message" | "guidance" | "prompt" | "compact" | "list_models" | "set_model" | "login";
+/**
+ * When an operation may leave the readiness queue's holding lane.
+ * - `"ready"`: only once the session is ready (ordinary messages, compact).
+ * - `"always"`: immediately, even before readiness (prompts, picker commands).
+ * - `"running_after_ready"`: once ready, OR — after the session has been ready
+ *   at least once — during a live turn the caller is intervening in (guidance).
+ */
+export type ReadinessPolicy = "ready" | "always" | "running_after_ready";
+/** The bypass-eligibility shape `overtakesReadiness`/`nextDispatchIndex` read. */
+export type OvertakeCandidate = {
+    readonly kind: ControlOperationKind;
+    readonly mayBypassReadiness: boolean;
+};
+/** Whether a queued operation may dispatch even though the session is not ready. */
+export declare function overtakesReadiness(op: OvertakeCandidate): boolean;
+/**
+ * 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 declare function nextDispatchIndex(queue: readonly OvertakeCandidate[], ready: boolean, bypassable: number): number;
+export type ControlOperationTraits = {
+    readonly reportsCallerSubmission: boolean;
+    readonly consumesReadiness: boolean;
+    readonly readiness: ReadinessPolicy;
+    readonly submitMode: ControlSubmitMode;
+};
+/**
+ * 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 declare const controlOperationTraits: Readonly<Record<ControlOperationKind, ControlOperationTraits>>;
+/** Owns abort-listener cleanup and the one in-flight cancellation marker. */
+export declare class ControlCancellation {
+    private readonly hooks;
+    private cancelled;
+    listen(operation: QueuedOperation, cancel: Cancel, drop: (error: Error) => void): void;
+    mark(operation: QueuedOperation, error: Error): void;
+    errorFor(operation: QueuedOperation): Error | undefined;
+    remove(operation: QueuedOperation): void;
+    clear(): void;
+}
+//# sourceMappingURL=traits.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"traits.d.ts","sourceRoot":"","sources":["../../../src/core/control-queue/traits.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,MAAM,iBAAiB,GAAG,MAAM,KAAK,CAAC;AAC5C,8EAA8E;AAC9E,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,SAAS,CAAC;AAC3D,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,UAAU,GACV,QAAQ,GACR,SAAS,GACT,aAAa,GACb,WAAW,GACX,OAAO,CAAC;AAEZ;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,qBAAqB,CAAC;AAmBzE,kFAAkF;AAClF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;CACtC,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,iBAAiB,EAAE,EACnC,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED,MAAM,MAAM,sBAAsB,GAAG;IAKnC,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;CACxC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAC3C,MAAM,CAAC,oBAAoB,EAAE,sBAAsB,CAAC,CA8CrD,CAAC;AAEF,6EAA6E;AAC7E,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;IAChE,OAAO,CAAC,SAAS,CAA2D;IAE5E,MAAM,CAAC,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAOtF,IAAI,CAAC,SAAS,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAIpD,QAAQ,CAAC,SAAS,EAAE,eAAe,GAAG,KAAK,GAAG,SAAS;IAIvD,MAAM,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI;IAMxC,KAAK,IAAI,IAAI;CAGd"}

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=traits.js.map

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/control-queue/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAK3E,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=types.js.map

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

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

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

@@ -0,0 +1,29 @@
+/** Queue lifecycle and cancellation bookkeeping (PRD §5.3/§5.9). */
+import type { ControlQueueError } from "./control-queue-traits.ts";
+import { ControlCancellation } from "./control-queue-traits.ts";
+import type { Cancel, PendingOperation, QueuedOperation } from "./control-queue-types.ts";
+/** Shared mutable state for the serialized control queue. */
+export declare abstract class ControlQueueState {
+    protected readonly queue: QueuedOperation[];
+    protected ready: boolean;
+    protected everReady: boolean;
+    protected closed: boolean;
+    protected readinessEpoch: number;
+    protected bypassable: number;
+    protected inFlight: QueuedOperation | undefined;
+    protected submitAbort: AbortController | undefined;
+    protected readonly cancellation: ControlCancellation;
+    protected readonly stoppedError: ControlQueueError;
+    protected constructor(stoppedError: ControlQueueError);
+    markReady(): void;
+    suspendReadiness(): void;
+    close(): void;
+    protected enqueue(op: PendingOperation, cancel?: Cancel): Promise<void>;
+    protected settle(operation: QueuedOperation, finish: () => void): void;
+    protected armAbort(): AbortSignal;
+    protected abortError(signal: AbortSignal): Error;
+    protected abstract drain(): void;
+    private listenForCancel;
+    private cancelOperation;
+}
+//# sourceMappingURL=control-queue-state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"control-queue-state.d.ts","sourceRoot":"","sources":["../../src/core/control-queue-state.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAsB,MAAM,2BAA2B,CAAC;AACpF,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAG1F,6DAA6D;AAC7D,8BAAsB,iBAAiB;IACrC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,eAAe,EAAE,CAAM;IACjD,SAAS,CAAC,KAAK,UAAS;IACxB,SAAS,CAAC,SAAS,UAAS;IAC5B,SAAS,CAAC,MAAM,UAAS;IACzB,SAAS,CAAC,cAAc,SAAK;IAC7B,SAAS,CAAC,UAAU,SAAK;IACzB,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,SAAS,CAAC;IAChD,SAAS,CAAC,WAAW,EAAE,eAAe,GAAG,SAAS,CAAC;IACnD,SAAS,CAAC,QAAQ,CAAC,YAAY,sBAA6B;IAC5D,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IAEnD,SAAS,aAAa,YAAY,EAAE,iBAAiB;IAIrD,SAAS,IAAI,IAAI;IAOjB,gBAAgB,IAAI,IAAI;IAKxB,KAAK,IAAI,IAAI;IAkBb,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvE,SAAS,CAAC,MAAM,CAAC,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI;IAQtE,SAAS,CAAC,QAAQ,IAAI,WAAW;IAMjC,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK;IAIhD,SAAS,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI;IAEhC,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,eAAe;CAYxB"}

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

@@ -0,0 +1,95 @@
+/** Queue lifecycle and cancellation bookkeeping (PRD §5.3/§5.9). */
+import { ControlCancellation, overtakesReadiness } from "./control-queue-traits.js";
+import { toError } from "./errors.js";
+/** Shared mutable state for the serialized control queue. */
+export class ControlQueueState {
+    queue = [];
+    ready = false;
+    everReady = false;
+    closed = false;
+    readinessEpoch = 0;
+    bypassable = 0;
+    inFlight;
+    submitAbort;
+    cancellation = new ControlCancellation();
+    stoppedError;
+    constructor(stoppedError) {
+        this.stoppedError = stoppedError;
+    }
+    markReady() {
+        if (this.closed)
+            return;
+        this.everReady = this.ready = true;
+        this.readinessEpoch += 1;
+        this.drain();
+    }
+    suspendReadiness() {
+        this.ready = false;
+        this.readinessEpoch += 1;
+    }
+    close() {
+        this.closed = true;
+        const error = this.stoppedError();
+        this.submitAbort?.abort(error);
+        const settling = this.inFlight;
+        this.inFlight = undefined;
+        this.bypassable = 0;
+        if (settling) {
+            this.cancellation.remove(settling);
+            settling.reject(error);
+        }
+        this.cancellation.clear();
+        for (const operation of this.queue.splice(0)) {
+            this.cancellation.remove(operation);
+            operation.reject(error);
+        }
+    }
+    enqueue(op, cancel) {
+        if (this.closed)
+            return Promise.reject(this.stoppedError());
+        return new Promise((resolve, reject) => {
+            const operation = { ...op, resolve, reject };
+            this.queue.push(operation);
+            if (overtakesReadiness(operation))
+                this.bypassable += 1;
+            if (cancel)
+                this.listenForCancel(operation, cancel);
+            if (!cancel?.signal.aborted)
+                this.drain();
+        });
+    }
+    settle(operation, finish) {
+        if (this.inFlight !== operation)
+            return;
+        this.inFlight = undefined;
+        this.cancellation.remove(operation);
+        finish();
+        this.drain();
+    }
+    armAbort() {
+        this.submitAbort?.abort();
+        this.submitAbort = new AbortController();
+        return this.submitAbort.signal;
+    }
+    abortError(signal) {
+        return toError(signal.reason);
+    }
+    listenForCancel(operation, cancel) {
+        this.cancellation.listen(operation, cancel, (error) => this.cancelOperation(operation, error));
+    }
+    cancelOperation(operation, error) {
+        const index = this.queue.indexOf(operation);
+        if (index >= 0) {
+            this.queue.splice(index, 1);
+            if (overtakesReadiness(operation))
+                this.bypassable -= 1;
+            this.cancellation.remove(operation);
+            operation.reject(error);
+        }
+        else if (this.inFlight === operation && !operation.run) {
+            this.cancellation.mark(operation, error);
+            this.submitAbort?.abort(error);
+        }
+    }
+}
+//# sourceMappingURL=control-queue-state.js.map

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

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

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

@@ -0,0 +1,54 @@
+/**
+ * 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).
+ */
+import type { Cancel, QueuedOperation } from "./control-queue-types.ts";
+export type ControlQueueError = () => Error;
+/** How an operation's text is written to the terminal (not a domain name). */
+export type ControlSubmitMode = "pasted_input" | "command";
+export type ControlOperationKind = "message" | "guidance" | "prompt" | "compact" | "list_models" | "set_model" | "login";
+/**
+ * When an operation may leave the readiness queue's holding lane.
+ * - `"ready"`: only once the session is ready (ordinary messages, compact).
+ * - `"always"`: immediately, even before readiness (prompts, picker commands).
+ * - `"running_after_ready"`: once ready, OR — after the session has been ready
+ *   at least once — during a live turn the caller is intervening in (guidance).
+ */
+export type ReadinessPolicy = "ready" | "always" | "running_after_ready";
+/** The bypass-eligibility shape `overtakesReadiness`/`nextDispatchIndex` read. */
+export type OvertakeCandidate = {
+    readonly kind: ControlOperationKind;
+    readonly mayBypassReadiness: boolean;
+};
+/** Whether a queued operation may dispatch even though the session is not ready. */
+export declare function overtakesReadiness(op: OvertakeCandidate): boolean;
+/**
+ * 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 declare function nextDispatchIndex(queue: readonly OvertakeCandidate[], ready: boolean, bypassable: number): number;
+export type ControlOperationTraits = {
+    readonly reportsCallerSubmission: boolean;
+    readonly consumesReadiness: boolean;
+    readonly readiness: ReadinessPolicy;
+    readonly submitMode: ControlSubmitMode;
+};
+/**
+ * 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 declare const controlOperationTraits: Readonly<Record<ControlOperationKind, ControlOperationTraits>>;
+/** Owns abort-listener cleanup and the one in-flight cancellation marker. */
+export declare class ControlCancellation {
+    private readonly hooks;
+    private cancelled;
+    listen(operation: QueuedOperation, cancel: Cancel, drop: (error: Error) => void): void;
+    mark(operation: QueuedOperation, error: Error): void;
+    errorFor(operation: QueuedOperation): Error | undefined;
+    remove(operation: QueuedOperation): void;
+    clear(): void;
+}
+//# sourceMappingURL=control-queue-traits.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"control-queue-traits.d.ts","sourceRoot":"","sources":["../../src/core/control-queue-traits.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAExE,MAAM,MAAM,iBAAiB,GAAG,MAAM,KAAK,CAAC;AAC5C,8EAA8E;AAC9E,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,SAAS,CAAC;AAC3D,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,UAAU,GACV,QAAQ,GACR,SAAS,GACT,aAAa,GACb,WAAW,GACX,OAAO,CAAC;AAEZ;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,qBAAqB,CAAC;AAmBzE,kFAAkF;AAClF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;CACtC,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,iBAAiB,EAAE,EACnC,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED,MAAM,MAAM,sBAAsB,GAAG;IAKnC,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;CACxC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAC3C,MAAM,CAAC,oBAAoB,EAAE,sBAAsB,CAAC,CA8CrD,CAAC;AAEF,6EAA6E;AAC7E,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;IAChE,OAAO,CAAC,SAAS,CAA2D;IAE5E,MAAM,CAAC,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;IAOtF,IAAI,CAAC,SAAS,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAIpD,QAAQ,CAAC,SAAS,EAAE,eAAe,GAAG,KAAK,GAAG,SAAS;IAIvD,MAAM,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI;IAMxC,KAAK,IAAI,IAAI;CAGd"}