@coool/opencode-adaptive 0.0.0-stage → 1.0.0

package/dist/state/receipts/store.d.ts

@@ -0,0 +1,35 @@
+import type { Receipt, ReceiptInput, ReceiptOutcome, ReceiptsStorage } from "./types.js";
+export interface ReceiptRef {
+    readonly sessionID: string;
+    /** When given, only receipts of that unit are updated; otherwise only receipts without a unit. */
+    readonly unitID?: string | undefined;
+}
+export declare class ReceiptStore {
+    #private;
+    private readonly storage;
+    constructor(storage: ReceiptsStorage);
+    /** Rebuild from storage (restart behavior). A read failure yields an empty store. */
+    load(): Promise<void>;
+    /** All retained receipts, oldest → newest. */
+    snapshot(): readonly Receipt[];
+    record(input: ReceiptInput): Promise<Receipt>;
+    /**
+     * Attach a unit outcome to matching receipts that do not have one yet
+     * (first outcome wins). Returns how many receipts were updated; zero
+     * updates do not touch storage.
+     */
+    attachOutcome(ref: ReceiptRef, outcome: ReceiptOutcome): Promise<number>;
+    /**
+     * Stamps the unit that just opened onto the session's pending unit-less
+     * admission receipts (recorded in the awaited prompt hook, before the unit
+     * existed). After adoption the receipt carries the unitID, so outcomes
+     * attach to it like any unit-scoped receipt.
+     *
+     * One opened unit adopts ONE admission — the newest pending receipt. With
+     * several pending receipts (a prompt admitted but superseded before its
+     * unit ever opened), stamping all of them would attach this unit's outcome
+     * to foreign admission decisions; the older receipts stay pending instead.
+     */
+    adoptUnit(sessionID: string, unitID: string): Promise<number>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/state/receipts/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/state/receipts/store.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EACZ,cAAc,EAEd,eAAe,EAChB,MAAM,YAAY,CAAA;AAEnB,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,kGAAkG;IAClG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACrC;AAED,qBAAa,YAAY;;IAIX,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,eAAe;IAErD,qFAAqF;IAC/E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,8CAA8C;IAC9C,QAAQ,IAAI,SAAS,OAAO,EAAE;IAIxB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IA8BnD;;;;OAIG;IACG,aAAa,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB9E;;;;;;;;;;OAUG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAyBpE"}

package/dist/state/receipts/store.js

@@ -0,0 +1,128 @@
+/**
+ * Bounded receipt store (ADP-030). Receipts live in a ring capped at
+ * `MAX_RECEIPTS` (newest kept, oldest evicted) and persist through the
+ * storage seam on every mutation. Ids are monotonic across restarts (they
+ * continue from the persisted maximum) so a receipt can always be told apart
+ * from its neighbors. Write failures propagate to the caller — the wiring
+ * layer's fail-open wrapper decides how to degrade (ADP-031) — and the
+ * in-memory ring is only advanced after a successful write, so memory and
+ * disk never diverge.
+ */
+import { boundDecision, boundText } from "./bound.js";
+import { parseReceiptsPayload } from "./parse.js";
+import { MAX_RECEIPTS, RECEIPTS_VERSION } from "./types.js";
+export class ReceiptStore {
+    storage;
+    #receipts = [];
+    #counter = 0;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /** Rebuild from storage (restart behavior). A read failure yields an empty store. */
+    async load() {
+        let raw;
+        try {
+            raw = await this.storage.read();
+        }
+        catch {
+            this.#receipts = [];
+            return;
+        }
+        const parsed = parseReceiptsPayload(raw);
+        this.#receipts = parsed;
+        this.#counter = parsed.reduce((max, receipt) => Math.max(max, receipt.id), 0);
+    }
+    /** All retained receipts, oldest → newest. */
+    snapshot() {
+        return this.#receipts;
+    }
+    async record(input) {
+        // A receipt with no session can never be attributed to anything, and the
+        // read path drops empty identifiers — persisting one would make it vanish
+        // across a restart. Throw instead; the wiring layer fail-open-catches.
+        if (input.sessionID.trim() === "") {
+            throw new Error("invalid receipt: sessionID must be a non-empty string");
+        }
+        const id = this.#counter + 1;
+        const receipt = {
+            id,
+            at: input.at,
+            // Identifiers are bounded with the same bound the read path applies, so
+            // what is persisted is exactly what comes back (types.ts invariant).
+            sessionID: boundText(input.sessionID),
+            ...(input.unitID !== undefined ? { unitID: boundText(input.unitID) } : {}),
+            ...(input.tier !== undefined ? { tier: input.tier } : {}),
+            decision: boundDecision(input.decision),
+        };
+        const next = this.#receipts.length >= MAX_RECEIPTS
+            ? [...this.#receipts.slice(1 - MAX_RECEIPTS), receipt]
+            : [...this.#receipts, receipt];
+        // Persist BEFORE committing memory: a write failure must leave memory and
+        // disk consistent (the caller decides how to fail open).
+        await this.#persist(next);
+        this.#receipts = next;
+        this.#counter = id;
+        return receipt;
+    }
+    /**
+     * Attach a unit outcome to matching receipts that do not have one yet
+     * (first outcome wins). Returns how many receipts were updated; zero
+     * updates do not touch storage.
+     */
+    async attachOutcome(ref, outcome) {
+        let updated = 0;
+        const next = this.#receipts.map((receipt) => {
+            if (receipt.outcome !== undefined)
+                return receipt;
+            if (receipt.sessionID !== ref.sessionID)
+                return receipt;
+            const matches = ref.unitID !== undefined ? receipt.unitID === ref.unitID : receipt.unitID === undefined;
+            if (!matches)
+                return receipt;
+            updated++;
+            return { ...receipt, outcome };
+        });
+        if (updated === 0)
+            return 0;
+        await this.#persist(next);
+        this.#receipts = next;
+        return updated;
+    }
+    /**
+     * Stamps the unit that just opened onto the session's pending unit-less
+     * admission receipts (recorded in the awaited prompt hook, before the unit
+     * existed). After adoption the receipt carries the unitID, so outcomes
+     * attach to it like any unit-scoped receipt.
+     *
+     * One opened unit adopts ONE admission — the newest pending receipt. With
+     * several pending receipts (a prompt admitted but superseded before its
+     * unit ever opened), stamping all of them would attach this unit's outcome
+     * to foreign admission decisions; the older receipts stay pending instead.
+     */
+    async adoptUnit(sessionID, unitID) {
+        let target;
+        this.#receipts.forEach((receipt, index) => {
+            if (receipt.unitID !== undefined || receipt.outcome !== undefined)
+                return;
+            if (receipt.sessionID !== sessionID)
+                return;
+            target = index;
+        });
+        if (target === undefined)
+            return 0;
+        const at = target;
+        const next = this.#receipts.map((receipt, index) => index === at ? { ...receipt, unitID } : receipt);
+        await this.#persist(next);
+        this.#receipts = next;
+        return 1;
+    }
+    /** Writes the given next state; the caller commits memory only on success. */
+    async #persist(receipts) {
+        const payload = {
+            version: RECEIPTS_VERSION,
+            receipts,
+        };
+        await this.storage.write(payload);
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/state/receipts/store.js.map

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

package/dist/state/receipts/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Decision receipts (ADP-030): small bounded local records explaining why
+ * Adaptive made each decision. Receipts exist for explainability, debugging,
+ * tests, and a future outcome-learning policy — never injected into prompts,
+ * never leaving the machine. Retention is bounded (oldest evicted).
+ */
+import type { Decision } from "../../core/scheduler/types.js";
+import type { TierName } from "../../core/tier-policy/types.js";
+import type { InterruptReason } from "../../core/work-unit/interruption.js";
+import type { FailureCategory } from "../../health/classifier/types.js";
+export declare const RECEIPTS_KEY = "coool.adaptive/receipts";
+export declare const RECEIPTS_VERSION = 1;
+/** Product bound — not a user knob. The ring keeps the newest receipts. */
+export declare const MAX_RECEIPTS = 200;
+/**
+ * Every free-text string stored in a receipt is truncated to this bound
+ * before persisting (and re-truncated on read). Boundedness is the
+ * no-secrets invariant: prompts, error bodies, and credentials have no
+ * field to live in and no room to hide in.
+ */
+export declare const MAX_RECEIPT_TEXT = 128;
+export interface ReceiptMeta {
+    /** Decision timestamp (adapter clock, ms epoch). */
+    readonly at: number;
+    readonly sessionID: string;
+    readonly unitID?: string | undefined;
+    /** Required tier when routing named one (pins carry no tier). */
+    readonly tier?: TierName | undefined;
+}
+export interface ReceiptInput extends ReceiptMeta {
+    /** The decision exactly as the scheduler/mode wrapper produced it. */
+    readonly decision: Decision;
+}
+/**
+ * Unit outcome attached after termination. Structured vocabulary only —
+ * never the raw error text (ADP-030: no secrets, bounded records).
+ */
+export type ReceiptOutcome = {
+    readonly status: "succeeded";
+} | {
+    readonly status: "failed";
+    readonly category: FailureCategory;
+} | {
+    readonly status: "interrupted";
+    readonly reason: InterruptReason;
+};
+export interface Receipt extends ReceiptMeta {
+    /** Monotonic id assigned by the store; continues across restarts. */
+    readonly id: number;
+    readonly decision: Decision;
+    readonly outcome?: ReceiptOutcome;
+}
+export interface ReceiptsPayload {
+    readonly version: typeof RECEIPTS_VERSION;
+    readonly receipts: readonly Receipt[];
+}
+/** Storage seam — the adapter binds `RECEIPTS_KEY` to `ctx.storage`. */
+export interface ReceiptsStorage {
+    read(): Promise<unknown>;
+    write(payload: ReceiptsPayload): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/state/receipts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/state/receipts/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAA;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAA;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AAEvE,eAAO,MAAM,YAAY,4BAA4B,CAAA;AACrD,eAAO,MAAM,gBAAgB,IAAI,CAAA;AACjC,2EAA2E;AAC3E,eAAO,MAAM,YAAY,MAAM,CAAA;AAC/B;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAEnC,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,iEAAiE;IACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;CACrC;AAED,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;CAC5B;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAChC;IAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,GACjE;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;CAAE,CAAA;AAExE,MAAM,WAAW,OAAQ,SAAQ,WAAW;IAC1C,qEAAqE;IACrE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAA;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,gBAAgB,CAAA;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;CACtC;AAED,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IACxB,KAAK,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/C"}

package/dist/state/receipts/types.js

@@ -0,0 +1,12 @@
+export const RECEIPTS_KEY = "coool.adaptive/receipts";
+export const RECEIPTS_VERSION = 1;
+/** Product bound — not a user knob. The ring keeps the newest receipts. */
+export const MAX_RECEIPTS = 200;
+/**
+ * Every free-text string stored in a receipt is truncated to this bound
+ * before persisting (and re-truncated on read). Boundedness is the
+ * no-secrets invariant: prompts, error bodies, and credentials have no
+ * field to live in and no room to hide in.
+ */
+export const MAX_RECEIPT_TEXT = 128;
+//# sourceMappingURL=types.js.map

package/dist/state/receipts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/state/receipts/types.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,YAAY,GAAG,yBAAyB,CAAA;AACrD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAA;AACjC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAA;AAC/B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAA"}

package/dist/state/session-modes/index.d.ts

@@ -0,0 +1,5 @@
+export { parseSessionModesPayload, isValidSessionID } from "./parse.js";
+export { SessionModeStore } from "./store.js";
+export { SESSION_MODES_KEY, SESSION_MODES_VERSION, MAX_SESSION_MODE_RECORDS, MAX_SESSION_ID_LENGTH, } from "./types.js";
+export type { SessionModeRecord, SessionModesPayload, SessionModeSetResult, SessionModesStorage, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/state/session-modes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/state/session-modes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,YAAY,CAAA"}

package/dist/state/session-modes/index.js

@@ -0,0 +1,4 @@
+export { parseSessionModesPayload, isValidSessionID } from "./parse.js";
+export { SessionModeStore } from "./store.js";
+export { SESSION_MODES_KEY, SESSION_MODES_VERSION, MAX_SESSION_MODE_RECORDS, MAX_SESSION_ID_LENGTH, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/state/session-modes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/state/session-modes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAC7C,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,YAAY,CAAA"}

package/dist/state/session-modes/parse.d.ts

@@ -0,0 +1,9 @@
+import type { SessionModeRecord } from "./types.js";
+/**
+ * A non-empty bounded session identifier. Unlike the health parser's provider
+ * identifiers (truncated on read), an over-long sessionID is dropped: the id
+ * is a host identity, not a label, and no real session id exceeds the bound.
+ */
+export declare function isValidSessionID(raw: unknown): raw is string;
+export declare function parseSessionModesPayload(raw: unknown): SessionModeRecord[];
+//# sourceMappingURL=parse.d.ts.map

package/dist/state/session-modes/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/state/session-modes/parse.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAUnD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAE5D;AAoBD,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,EAAE,CAgB1E"}

package/dist/state/session-modes/parse.js

@@ -0,0 +1,62 @@
+/**
+ * Read-side parsing for persisted session-mode overrides. Total like every
+ * `state/` parser: it accepts `unknown` and returns typed records, dropping
+ * anything invalid — a corrupted file can never take the plugin down
+ * (ADP-031). A partially corrupted payload keeps its good entries.
+ */
+import { OPERATING_MODES } from "../../core/scheduler/types.js";
+import { MAX_SESSION_ID_LENGTH, SESSION_MODES_VERSION } from "./types.js";
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isFiniteNumber(raw) {
+    return typeof raw === "number" && Number.isFinite(raw);
+}
+/**
+ * A non-empty bounded session identifier. Unlike the health parser's provider
+ * identifiers (truncated on read), an over-long sessionID is dropped: the id
+ * is a host identity, not a label, and no real session id exceeds the bound.
+ */
+export function isValidSessionID(raw) {
+    return typeof raw === "string" && raw.length > 0 && raw.length <= MAX_SESSION_ID_LENGTH;
+}
+function parseSessionID(raw) {
+    return isValidSessionID(raw) ? raw : undefined;
+}
+function parseMode(raw) {
+    if (typeof raw !== "string")
+        return undefined;
+    return OPERATING_MODES.includes(raw) ? raw : undefined;
+}
+function parseRecord(raw) {
+    if (!isRecord(raw))
+        return undefined;
+    const sessionID = parseSessionID(raw["sessionID"]);
+    const mode = parseMode(raw["mode"]);
+    const updatedAt = raw["updatedAt"];
+    if (sessionID === undefined || mode === undefined || !isFiniteNumber(updatedAt))
+        return undefined;
+    return { sessionID, mode, updatedAt };
+}
+export function parseSessionModesPayload(raw) {
+    if (!isRecord(raw))
+        return [];
+    if (raw["version"] !== SESSION_MODES_VERSION)
+        return [];
+    const list = raw["records"];
+    if (!Array.isArray(list))
+        return [];
+    // A hostile or duplicated payload can carry the same session twice; the
+    // most recently updated record wins so `get` is not order-dependent.
+    const bySession = new Map();
+    for (const entry of list.slice(0, 512)) {
+        const record = parseRecord(entry);
+        if (record === undefined)
+            continue;
+        const kept = bySession.get(record.sessionID);
+        if (kept === undefined || record.updatedAt > kept.updatedAt)
+            bySession.set(record.sessionID, record);
+    }
+    return [...bySession.values()];
+}
+//# sourceMappingURL=parse.js.map

package/dist/state/session-modes/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../src/state/session-modes/parse.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAE/D,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAGzE,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AAC7E,CAAC;AAED,SAAS,cAAc,CAAC,GAAY;IAClC,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,qBAAqB,CAAA;AACzF,CAAC;AAED,SAAS,cAAc,CAAC,GAAY;IAClC,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAA;AAChD,CAAC;AAED,SAAS,SAAS,CAAC,GAAY;IAC7B,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAA;IAC7C,OAAQ,eAAqC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,GAAqB,CAAC,CAAC,CAAC,SAAS,CAAA;AAClG,CAAC;AAED,SAAS,WAAW,CAAC,GAAY;IAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAA;IACpC,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAA;IAClD,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IACnC,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,CAAC,CAAA;IAClC,IAAI,SAAS,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAA;IACjG,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAAY;IACnD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAA;IAC7B,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,qBAAqB;QAAE,OAAO,EAAE,CAAA;IACvD,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC,CAAA;IAC3B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAA;IACnC,wEAAwE;IACxE,qEAAqE;IACrE,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAA;IACtD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;QACjC,IAAI,MAAM,KAAK,SAAS;YAAE,SAAQ;QAClC,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAC5C,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS;YACzD,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IAC3C,CAAC;IACD,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,CAAA;AAChC,CAAC"}

package/dist/state/session-modes/store.d.ts

@@ -0,0 +1,21 @@
+import type { OperatingMode } from "../../core/scheduler/types.js";
+import type { SessionModeRecord, SessionModesStorage } from "./types.js";
+export declare class SessionModeStore {
+    #private;
+    private readonly storage;
+    private readonly clock;
+    constructor(storage: SessionModesStorage, clock: () => number);
+    /** Rebuild from storage (restart behavior). A read failure yields an empty store. */
+    load(): Promise<void>;
+    /** All retained records. */
+    snapshot(): readonly SessionModeRecord[];
+    /** The session's override, or `null` when it follows the global mode. */
+    get(sessionID: string): OperatingMode | null;
+    /**
+     * Set (or with `null`, remove) one session's override. The bound keeps the
+     * most recently updated records — overrides for long-gone sessions matter
+     * less than the ones being actively steered.
+     */
+    set(sessionID: string, mode: OperatingMode | null): Promise<void>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/state/session-modes/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/state/session-modes/store.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAuB,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAG7F,qBAAa,gBAAgB;;IAIzB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,OAAO,EAAE,mBAAmB,EAC5B,KAAK,EAAE,MAAM,MAAM;IAGtC,qFAAqF;IAC/E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,4BAA4B;IAC5B,QAAQ,IAAI,SAAS,iBAAiB,EAAE;IAIxC,yEAAyE;IACzE,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAI5C;;;;OAIG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAwBxE"}

package/dist/state/session-modes/store.js

@@ -0,0 +1,73 @@
+/**
+ * Bounded per-session operating-mode override store. Keeps the most recently
+ * updated records (bounded, least-recently-updated evicted) and persists on
+ * every change. As everywhere else in `state/`, memory is only advanced after
+ * a successful write, so memory and disk never diverge; write failures
+ * propagate to the caller — the wiring layer's fail-open wrapper decides how
+ * to degrade (ADP-031).
+ */
+import { parseSessionModesPayload, isValidSessionID } from "./parse.js";
+import { MAX_SESSION_ID_LENGTH, MAX_SESSION_MODE_RECORDS, SESSION_MODES_VERSION } from "./types.js";
+import { OPERATING_MODES } from "../../core/scheduler/types.js";
+export class SessionModeStore {
+    storage;
+    clock;
+    #records = [];
+    constructor(storage, clock) {
+        this.storage = storage;
+        this.clock = clock;
+    }
+    /** Rebuild from storage (restart behavior). A read failure yields an empty store. */
+    async load() {
+        let raw;
+        try {
+            raw = await this.storage.read();
+        }
+        catch {
+            this.#records = [];
+            return;
+        }
+        this.#records = parseSessionModesPayload(raw);
+    }
+    /** All retained records. */
+    snapshot() {
+        return this.#records;
+    }
+    /** The session's override, or `null` when it follows the global mode. */
+    get(sessionID) {
+        return this.#records.find((record) => record.sessionID === sessionID)?.mode ?? null;
+    }
+    /**
+     * Set (or with `null`, remove) one session's override. The bound keeps the
+     * most recently updated records — overrides for long-gone sessions matter
+     * less than the ones being actively steered.
+     */
+    async set(sessionID, mode) {
+        // Defensive re-validation at the persistence boundary: the RPC handler
+        // validates first and reports named errors; these guards keep malformed
+        // in-process callers from persisting junk.
+        if (!isValidSessionID(sessionID)) {
+            throw new Error(`sessionID must be a non-empty string of at most ${String(MAX_SESSION_ID_LENGTH)} characters`);
+        }
+        if (mode !== null && !OPERATING_MODES.includes(mode)) {
+            throw new Error(`mode must be one of ${OPERATING_MODES.join(", ")} or null`);
+        }
+        const updatedAt = this.clock();
+        const kept = this.#records.filter((record) => record.sessionID !== sessionID);
+        const next = mode === null
+            ? kept
+            : bound([...kept, { sessionID, mode, updatedAt }], MAX_SESSION_MODE_RECORDS);
+        // Persist BEFORE committing memory: a write failure must leave memory
+        // and disk consistent (the caller decides how to fail open).
+        const payload = { version: SESSION_MODES_VERSION, records: next };
+        await this.storage.write(payload);
+        this.#records = next;
+    }
+}
+/** Keep the newest records when over the cap. */
+function bound(records, max) {
+    if (records.length <= max)
+        return records;
+    return [...records].sort((left, right) => right.updatedAt - left.updatedAt).slice(0, max);
+}
+//# sourceMappingURL=store.js.map

package/dist/state/session-modes/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/state/session-modes/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AACvE,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAGnG,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAE/D,MAAM,OAAO,gBAAgB;IAIR;IACA;IAJnB,QAAQ,GAAwB,EAAE,CAAA;IAElC,YACmB,OAA4B,EAC5B,KAAmB;QADnB,YAAO,GAAP,OAAO,CAAqB;QAC5B,UAAK,GAAL,KAAK,CAAc;IACnC,CAAC;IAEJ,qFAAqF;IACrF,KAAK,CAAC,IAAI;QACR,IAAI,GAAY,CAAA;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAA;YAClB,OAAM;QACR,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAA;IAC/C,CAAC;IAED,4BAA4B;IAC5B,QAAQ;QACN,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED,yEAAyE;IACzE,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,EAAE,IAAI,IAAI,IAAI,CAAA;IACrF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG,CAAC,SAAiB,EAAE,IAA0B;QACrD,uEAAuE;QACvE,wEAAwE;QACxE,2CAA2C;QAC3C,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,mDAAmD,MAAM,CAAC,qBAAqB,CAAC,aAAa,CAC9F,CAAA;QACH,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,IAAI,CAAE,eAAqC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5E,MAAM,IAAI,KAAK,CAAC,uBAAuB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;QAC9E,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,CAAA;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAA;QAC7E,MAAM,IAAI,GACR,IAAI,KAAK,IAAI;YACX,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,wBAAwB,CAAC,CAAA;QAChF,sEAAsE;QACtE,6DAA6D;QAC7D,MAAM,OAAO,GAAwB,EAAE,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QACtF,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACjC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;IACtB,CAAC;CACF;AAED,iDAAiD;AACjD,SAAS,KAAK,CAAC,OAA4B,EAAE,GAAW;IACtD,IAAI,OAAO,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,OAAO,CAAA;IACzC,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AAC3F,CAAC"}

package/dist/state/session-modes/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Persisted per-session operating-mode overrides (ADP-054). The operating mode
+ * is otherwise a global setting, but supervision decisions are made per
+ * session — the override lets one session run under a different mode without
+ * touching the global default. Records persist through the storage seam like
+ * every other state: the host's TUI-mode plugin reconciliation can serve RPC
+ * from an instance whose event-pump hooks live on another instance, and a
+ * restart must not silently drop explicit user intent.
+ */
+import type { OperatingMode } from "../../core/scheduler/types.js";
+export declare const SESSION_MODES_KEY = "coool.adaptive/session-modes";
+export declare const SESSION_MODES_VERSION = 1;
+/** Product bound — not a user knob. Keeps the most recently updated records. */
+export declare const MAX_SESSION_MODE_RECORDS = 512;
+/** A session id beyond this bound is not a real host identifier. */
+export declare const MAX_SESSION_ID_LENGTH = 128;
+export interface SessionModeRecord {
+    readonly sessionID: string;
+    readonly mode: OperatingMode;
+    readonly updatedAt: number;
+}
+export interface SessionModesPayload {
+    readonly version: typeof SESSION_MODES_VERSION;
+    readonly records: readonly SessionModeRecord[];
+}
+/**
+ * A successful override write. Mirrors the settings patch-result convention:
+ * validation failures are per-field errors, internal failures throw (the
+ * RPC handler degrades them fail-open).
+ */
+export type SessionModeSetResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly errors: readonly string[];
+};
+/** Storage seam — the adapter binds `SESSION_MODES_KEY` to `ctx.storage`. */
+export interface SessionModesStorage {
+    read(): Promise<unknown>;
+    write(payload: SessionModesPayload): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/state/session-modes/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/state/session-modes/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAElE,eAAO,MAAM,iBAAiB,iCAAiC,CAAA;AAC/D,eAAO,MAAM,qBAAqB,IAAI,CAAA;AACtC,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,MAAM,CAAA;AAC3C,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,MAAM,CAAA;AAExC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,qBAAqB,CAAA;IAC9C,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAC/C;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAC9B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAA;AAEpF,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IACxB,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACnD"}

package/dist/state/session-modes/types.js

@@ -0,0 +1,7 @@
+export const SESSION_MODES_KEY = "coool.adaptive/session-modes";
+export const SESSION_MODES_VERSION = 1;
+/** Product bound — not a user knob. Keeps the most recently updated records. */
+export const MAX_SESSION_MODE_RECORDS = 512;
+/** A session id beyond this bound is not a real host identifier. */
+export const MAX_SESSION_ID_LENGTH = 128;
+//# sourceMappingURL=types.js.map

package/dist/state/session-modes/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/state/session-modes/types.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,iBAAiB,GAAG,8BAA8B,CAAA;AAC/D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAA;AACtC,gFAAgF;AAChF,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAA;AAC3C,oEAAoE;AACpE,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAA"}

package/dist/state/settings/index.d.ts

@@ -0,0 +1,5 @@
+export { defaultSettings, applyPatch, migrateSettings, parseAgentTiers, parseMode, parsePin, parseTierLists, } from "./parse.js";
+export { SettingsStore } from "./store.js";
+export { MAX_AGENT_TIERS, MAX_TIER_RESOURCES, SETTINGS_KEY, SETTINGS_VERSION } from "./types.js";
+export type { PatchResult, SettingsPatch, SettingsStorage, SettingsV1 } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/state/settings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/state/settings/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,UAAU,EACV,eAAe,EACf,eAAe,EACf,SAAS,EACT,QAAQ,EACR,cAAc,GACf,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAChG,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA"}

package/dist/state/settings/index.js

@@ -0,0 +1,4 @@
+export { defaultSettings, applyPatch, migrateSettings, parseAgentTiers, parseMode, parsePin, parseTierLists, } from "./parse.js";
+export { SettingsStore } from "./store.js";
+export { MAX_AGENT_TIERS, MAX_TIER_RESOURCES, SETTINGS_KEY, SETTINGS_VERSION } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/state/settings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/state/settings/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,UAAU,EACV,eAAe,EACf,eAAe,EACf,SAAS,EACT,QAAQ,EACR,cAAc,GACf,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA"}

package/dist/state/settings/parse.d.ts

@@ -0,0 +1,34 @@
+import type { OperatingMode } from "../../core/scheduler/types.js";
+import type { TierName } from "../../core/tier-policy/types.js";
+import type { ModelRef } from "../../core/work-unit/types.js";
+import type { SettingsV1 } from "./types.js";
+export declare function parseMode(raw: unknown): OperatingMode | undefined;
+export declare function parseTierLists(raw: unknown): Readonly<Record<TierName, readonly ModelRef[]>> | undefined;
+export declare function parseModelRef(raw: unknown): ModelRef | undefined;
+export declare function parsePin(raw: unknown): ModelRef | null | undefined;
+export declare function parseAgentTiers(raw: unknown): Readonly<Record<string, TierName>> | undefined;
+/** Settings with nothing configured: OBSERVE, empty tiers, no pin (ADP-029/032). */
+export declare function defaultSettings(): SettingsV1;
+/**
+ * Migration-on-read. `undefined`/absent record → defaults (first install);
+ * versionless (v0 draft) and v1 records are validated field-wise with
+ * defaults for unusable fields; a record written by a NEWER version is
+ * returned as defaults rather than guessed at (and is only re-persisted once
+ * the user changes something, which stamps the current version).
+ */
+export declare function migrateSettings(raw: unknown): SettingsV1;
+/**
+ * Validate a patch against current settings. The patch is WIRE input (unknown
+ * by contract — surfaces send untrusted JSON over RPC; the SettingsPatch type
+ * documents the expected shape, the field parsers enforce it). Invalid fields
+ * collect error strings (at most one per field, five fields); a valid patch
+ * produces a NEW settings object (inputs are never mutated).
+ */
+export declare function applyPatch(current: SettingsV1, patch: unknown): {
+    ok: true;
+    settings: SettingsV1;
+} | {
+    ok: false;
+    errors: string[];
+};
+//# sourceMappingURL=parse.d.ts.map

package/dist/state/settings/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/state/settings/parse.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAGlE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAA;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAyB5C,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAGjE;AAWD,wBAAgB,cAAc,CAC5B,GAAG,EAAE,OAAO,GACX,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,QAAQ,EAAE,CAAC,CAAC,GAAG,SAAS,CAO7D;AAWD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAYhE;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,GAAG,SAAS,CAGlE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,GAAG,SAAS,CAa5F;AAmED,oFAAoF;AACpF,wBAAgB,eAAe,IAAI,UAAU,CAS5C;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,CAOxD;AAWD;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,OAAO,GACb;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA+CtE"}