@with-logic/elwood 0.1.0 → 0.1.2

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

@@ -1,95 +0,0 @@
-/** 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

@@ -1 +0,0 @@
-{"version":3,"file":"control-queue-state.js","sourceRoot":"","sources":["../../src/core/control-queue-state.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAGpE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpF,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,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

@@ -1,54 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}

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

@@ -1,118 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,45 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,7 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,21 +0,0 @@
-/** 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

@@ -1 +0,0 @@
-{"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

@@ -1,98 +0,0 @@
-/** 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

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

package/dist/core/list-models.d.ts

@@ -1,44 +0,0 @@
-/**
- * Session-less model enumeration: start a throwaway session, list its models,
- * and always tear it down. Implements PRD §5.3 and C-API-41.
- */
-import type { ElwoodAgentSession } from "./agent-session.ts";
-import type { AgentModelOption } from "./model-rows.ts";
-/** Launch-relevant options for a throwaway model-listing probe (C-API-41). */
-export type ListModelsOptions = {
-    readonly cwd: string;
-    readonly stateDir?: string;
-    readonly autoupdate?: boolean;
-    readonly hookTimeoutMs?: number;
-    readonly strictVersionCheck?: boolean;
-    /** Bounds the picker automation, exactly as on a live session's `listModels`. */
-    readonly timeoutMs?: number;
-};
-/**
- * The throwaway session surface a probe drives: wait for ready, list, tear down.
- * Derived from the public session contract so it uses the SAME closed
- * `ElwoodSessionStatus` type and cannot drift from the real methods.
- */
-type ProbeSession = Pick<ElwoodAgentSession, "waitForStatus" | "listModels" | "teardown">;
-/** Adapter hooks for a probe: how to start the session and how to remove ALL its state. */
-export type ProbeAdapter<S extends ProbeSession> = {
-    /** Starts the throwaway session against the probe's owned state directory. */
-    readonly start: () => Promise<S>;
-    /**
-     * Removes ALL probe state (its owned temp directory and everything under it).
-     * Runs on EVERY outcome — success, readiness/picker failure, AND a start failure
-     * that already allocated a state directory or runtime files — so nothing leaks
-     * regardless of how far startup got (C-API-41). Best-effort and non-throwing.
-     */
-    readonly removeState: () => void;
-};
-/**
- * Runs a throwaway session to its first readiness, lists its models, and cleans
- * up EVERYTHING it allocated — the session (via `teardown`) and its owned state
- * directory (via `removeState`) — on every outcome, so nothing is leaked (C-API-41).
- * The probe only opens and cancels the picker, so the user's default stays
- * untouched. A teardown/cleanup failure never masks a real list/readiness error.
- */
-export declare function probeModels<S extends ProbeSession>(adapter: ProbeAdapter<S>, options: ListModelsOptions): Promise<readonly AgentModelOption[]>;
-export {};
-//# sourceMappingURL=list-models.d.ts.map

package/dist/core/list-models.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"list-models.d.ts","sourceRoot":"","sources":["../../src/core/list-models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,8EAA8E;AAC9E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,iFAAiF;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;GAIG;AACH,KAAK,YAAY,GAAG,IAAI,CAAC,kBAAkB,EAAE,eAAe,GAAG,YAAY,GAAG,UAAU,CAAC,CAAC;AAE1F,2FAA2F;AAC3F,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,YAAY,IAAI;IACjD,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,IAAI,CAAC;CAClC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,CAAC,SAAS,YAAY,EACtD,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EACxB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAiBtC"}

package/dist/core/list-models.js

@@ -1,73 +0,0 @@
-/**
- * Session-less model enumeration: start a throwaway session, list its models,
- * and always tear it down. Implements PRD §5.3 and C-API-41.
- */
-import { errnoCode, toError } from "./errors.js";
-/**
- * Runs a throwaway session to its first readiness, lists its models, and cleans
- * up EVERYTHING it allocated — the session (via `teardown`) and its owned state
- * directory (via `removeState`) — on every outcome, so nothing is leaked (C-API-41).
- * The probe only opens and cancels the picker, so the user's default stays
- * untouched. A teardown/cleanup failure never masks a real list/readiness error.
- */
-export async function probeModels(adapter, options) {
-    let session;
-    try {
-        session = await adapter.start();
-    }
-    catch (error) {
-        // Adapter startup can allocate a state directory / runtime files BEFORE the
-        // bridge or PTY fails, so "no returned session" does not mean "nothing
-        // allocated": remove the owned state directory before rethrowing (C-API-41).
-        adapter.removeState();
-        throw error;
-    }
-    try {
-        return await runProbe(session, options);
-    }
-    finally {
-        // Always sweep the owned state directory, even after a successful teardown.
-        adapter.removeState();
-    }
-}
-async function runProbe(session, options) {
-    let models;
-    try {
-        await session.waitForStatus((status) => status === "ready");
-        models = await session.listModels(options.timeoutMs === undefined ? undefined : { timeoutMs: options.timeoutMs });
-    }
-    catch (error) {
-        // The list/readiness error is what the caller must see, so it stays the thrown
-        // error and teardown never masks it. But a FAILED teardown here can leak a
-        // probe process tree, so surface it as a bounded `cause` rather than silently
-        // discarding it: the caller keeps the primary error AND learns of the leak.
-        await teardownWithoutMasking(session, toError(error));
-        throw error;
-    }
-    // The clean path DOES surface a genuine teardown failure — a leaked probe
-    // session is a real defect the caller should learn about (C-API-41).
-    await session.teardown();
-    return models;
-}
-/**
- * Tear down the probe on the error path without masking the primary error. A
- * rejecting teardown can leave a probe process tree alive, so instead of
- * discarding it we attach a bounded diagnostic (the teardown error's allowlisted
- * errno, or its name) to the primary error's `cause` — visible to the caller,
- * never overriding the readiness/picker error that actually explains the failure.
- */
-async function teardownWithoutMasking(session, primary) {
-    try {
-        await session.teardown();
-    }
-    catch (teardownError) {
-        // `cause` may already be set by the primary error; only fill it when empty so
-        // we never clobber a more specific upstream cause. The token is bounded — an
-        // errno like `EPERM` or the error's constructor name — never a raw message.
-        if (primary.cause === undefined) {
-            const token = errnoCode(teardownError) ?? toError(teardownError).name;
-            primary.cause = `probe_teardown_failed:${token}`;
-        }
-    }
-}
-//# sourceMappingURL=list-models.js.map

package/dist/core/list-models.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"list-models.js","sourceRoot":"","sources":["../../src/core/list-models.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAkCjD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAwB,EACxB,OAA0B;IAE1B,IAAI,OAAU,CAAC;IACf,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,4EAA4E;QAC5E,uEAAuE;QACvE,6EAA6E;QAC7E,OAAO,CAAC,WAAW,EAAE,CAAC;QACtB,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;YAAS,CAAC;QACT,4EAA4E;QAC5E,OAAO,CAAC,WAAW,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,QAAQ,CACrB,OAAU,EACV,OAA0B;IAE1B,IAAI,MAAmC,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;QAC5D,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAC/B,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAC/E,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,+EAA+E;QAC/E,2EAA2E;QAC3E,8EAA8E;QAC9E,4EAA4E;QAC5E,MAAM,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACtD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,0EAA0E;IAC1E,qEAAqE;IACrE,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;IACzB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,sBAAsB,CAAC,OAAqB,EAAE,OAAc;IACzE,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,aAAa,EAAE,CAAC;QACvB,8EAA8E;QAC9E,6EAA6E;QAC7E,4EAA4E;QAC5E,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,SAAS,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC;YACtE,OAAO,CAAC,KAAK,GAAG,yBAAyB,KAAK,EAAE,CAAC;QACnD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/core/model-picker.d.ts

@@ -1,22 +0,0 @@
-/**
- * Shared /model picker automation for adapter sessions.
- * Implements PRD §5.3, §5.7, C-API-23, and C-API-24.
- */
-import type { AgentModelOption, ParsedModelPicker } from "./model-rows.ts";
-import { type ScreenTerminal } from "./tui-screen.ts";
-export declare function pickerTimeout(options?: {
-    readonly timeoutMs?: number;
-}): number;
-export type ModelPickerIo = {
-    readonly terminal: ScreenTerminal;
-    readonly submit: (command: string) => Promise<void>;
-};
-export type ModelPickerSpec = {
-    readonly agent: string;
-    readonly isOpen: (text: string) => boolean;
-    readonly parse: (text: string) => ParsedModelPicker;
-    readonly apply: (io: ModelPickerIo, timeoutMs: number) => Promise<void>;
-};
-export declare function listPickerModels(io: ModelPickerIo, spec: ModelPickerSpec, timeoutMs: number): Promise<readonly AgentModelOption[]>;
-export declare function setPickerModel(io: ModelPickerIo, spec: ModelPickerSpec, id: string, timeoutMs: number): Promise<void>;
-//# sourceMappingURL=model-picker.d.ts.map

package/dist/core/model-picker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"model-picker.d.ts","sourceRoot":"","sources":["../../src/core/model-picker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAGL,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAEzB,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE/E;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,iBAAiB,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzE,CAAC;AAOF,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAUtC;AAED,wBAAsB,cAAc,CAClC,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,eAAe,EACrB,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CA2Bf"}