charness 0.0.0-stage → 3.1.0

package/dist/accessControl.d.ts

@@ -0,0 +1,71 @@
+import type { PlatformMember } from './platform/inbound';
+/**
+ * @description Access control for the bot: who may talk to the agent.
+ *
+ * The authority is fully runtime — the members of the served space who hold
+ * elevated rights there, read live from the platform. There is no static
+ * allow-list env and no `/grant` command: promoting/demoting someone on the
+ * platform is the only knob. To avoid an API round-trip on every message the
+ * admin set is cached ({@link AdminCache}) with a long TTL and refreshed lazily
+ * once it goes stale.
+ *
+ * Platform-neutral on purpose: the policy speaks {@link PlatformMember}, and
+ * the connector decides which of ITS membership statuses count as elevated.
+ * Ids are strings for the same reason `SessionKey` fields are — only Telegram's
+ * happen to be numeric.
+ */
+/** Admin set cache lifetime. A demotion/promotion takes effect within this window. */
+export declare const ADMIN_CACHE_TTL_MS = 3600000;
+/**
+ * After a failed `getChatAdministrators` we keep serving the last-known set and
+ * suppress further fetches for this long, so a Telegram outage doesn't turn into
+ * a per-message API hammer.
+ */
+export declare const ADMIN_CACHE_FAILURE_RETRY_MS = 60000;
+/**
+ * @description Reduce a membership listing to the ids of the humans who hold
+ * elevated rights. Bots are dropped — an automation holding admin rights is
+ * never an authorised human operator.
+ */
+export declare function getElevatedMemberIds(members: PlatformMember[]): string[];
+export interface AdminCacheDeps {
+    /**
+     * Fetches the ids currently holding elevated rights in the served space —
+     * the connector's `listMembersWithElevatedRights`, which is the SINGLE
+     * membership path. Passing already-reduced ids (rather than members) keeps
+     * the platform's status vocabulary out of the policy entirely.
+     */
+    fetchElevatedMemberIds: () => Promise<string[]>;
+    /** Cache lifetime; defaults to {@link ADMIN_CACHE_TTL_MS}. */
+    ttlMs?: number;
+    /** Backoff after a failed fetch; defaults to {@link ADMIN_CACHE_FAILURE_RETRY_MS}. */
+    failureRetryMs?: number;
+    /** Clock injection point for tests; defaults to `Date.now`. */
+    now?: () => number;
+}
+/**
+ * @description Lazily-refreshed cache of the served group's admin user ids.
+ *
+ * `getAdminIds()` returns the cached set while it's fresh (age < ttl); once
+ * stale it re-fetches, replaces the set, and decides against the fresh data.
+ * Concurrent callers during a fetch share one in-flight request. A fetch failure
+ * keeps the last-known set (never locks everyone out) and starts a short backoff.
+ */
+export declare class AdminCache {
+    private readonly fetchElevatedMemberIds;
+    private readonly ttlMs;
+    private readonly failureRetryMs;
+    private readonly now;
+    private ids;
+    /** Timestamp of the last SUCCESSFUL fetch, or `null` if never fetched. */
+    private fetchedAt;
+    /** Timestamp of the last FAILED fetch, or `null`. */
+    private lastFailAt;
+    private inFlight;
+    constructor(deps: AdminCacheDeps);
+    getAdminIds(): Promise<Set<string>>;
+    /** Drop freshness so the next {@link getAdminIds} re-fetches (used on re-pair). */
+    invalidate(): void;
+    private refresh;
+}
+//# sourceMappingURL=accessControl.d.ts.map

package/dist/accessControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessControl.d.ts","sourceRoot":"","sources":["../src/accessControl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;;;;;;;;;;;GAcG;AAEH,sFAAsF;AACtF,eAAO,MAAM,kBAAkB,UAAY,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE,CAQxE;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,sBAAsB,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAA0B;IACjE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IAEnC,OAAO,CAAC,GAAG,CAAqB;IAChC,0EAA0E;IAC1E,OAAO,CAAC,SAAS,CAAuB;IACxC,qDAAqD;IACrD,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,QAAQ,CAAqC;gBAEzC,IAAI,EAAE,cAAc;IAO1B,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAkBzC,mFAAmF;IACnF,UAAU,IAAI,IAAI;YAKJ,OAAO;CAetB"}

package/dist/accessControl.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminCache = exports.ADMIN_CACHE_FAILURE_RETRY_MS = exports.ADMIN_CACHE_TTL_MS = void 0;
+exports.getElevatedMemberIds = getElevatedMemberIds;
+/**
+ * @description Access control for the bot: who may talk to the agent.
+ *
+ * The authority is fully runtime — the members of the served space who hold
+ * elevated rights there, read live from the platform. There is no static
+ * allow-list env and no `/grant` command: promoting/demoting someone on the
+ * platform is the only knob. To avoid an API round-trip on every message the
+ * admin set is cached ({@link AdminCache}) with a long TTL and refreshed lazily
+ * once it goes stale.
+ *
+ * Platform-neutral on purpose: the policy speaks {@link PlatformMember}, and
+ * the connector decides which of ITS membership statuses count as elevated.
+ * Ids are strings for the same reason `SessionKey` fields are — only Telegram's
+ * happen to be numeric.
+ */
+/** Admin set cache lifetime. A demotion/promotion takes effect within this window. */
+exports.ADMIN_CACHE_TTL_MS = 3_600_000; // 1 hour
+/**
+ * After a failed `getChatAdministrators` we keep serving the last-known set and
+ * suppress further fetches for this long, so a Telegram outage doesn't turn into
+ * a per-message API hammer.
+ */
+exports.ADMIN_CACHE_FAILURE_RETRY_MS = 60_000;
+/**
+ * @description Reduce a membership listing to the ids of the humans who hold
+ * elevated rights. Bots are dropped — an automation holding admin rights is
+ * never an authorised human operator.
+ */
+function getElevatedMemberIds(members) {
+    const ids = [];
+    for (const member of members) {
+        if (!member.hasElevatedRights)
+            continue;
+        if (member.isBot)
+            continue;
+        ids.push(member.id);
+    }
+    return ids;
+}
+/**
+ * @description Lazily-refreshed cache of the served group's admin user ids.
+ *
+ * `getAdminIds()` returns the cached set while it's fresh (age < ttl); once
+ * stale it re-fetches, replaces the set, and decides against the fresh data.
+ * Concurrent callers during a fetch share one in-flight request. A fetch failure
+ * keeps the last-known set (never locks everyone out) and starts a short backoff.
+ */
+class AdminCache {
+    fetchElevatedMemberIds;
+    ttlMs;
+    failureRetryMs;
+    now;
+    ids = new Set();
+    /** Timestamp of the last SUCCESSFUL fetch, or `null` if never fetched. */
+    fetchedAt = null;
+    /** Timestamp of the last FAILED fetch, or `null`. */
+    lastFailAt = null;
+    inFlight = null;
+    constructor(deps) {
+        this.fetchElevatedMemberIds = deps.fetchElevatedMemberIds;
+        this.ttlMs = deps.ttlMs ?? exports.ADMIN_CACHE_TTL_MS;
+        this.failureRetryMs = deps.failureRetryMs ?? exports.ADMIN_CACHE_FAILURE_RETRY_MS;
+        this.now = deps.now ?? Date.now;
+    }
+    async getAdminIds() {
+        const now = this.now();
+        if (this.fetchedAt !== null && now - this.fetchedAt < this.ttlMs) {
+            return this.ids;
+        }
+        if (this.inFlight)
+            return this.inFlight;
+        // A recent failure → serve last-known without re-hitting the API yet.
+        if (this.lastFailAt !== null && now - this.lastFailAt < this.failureRetryMs) {
+            return this.ids;
+        }
+        this.inFlight = this.refresh();
+        try {
+            return await this.inFlight;
+        }
+        finally {
+            this.inFlight = null;
+        }
+    }
+    /** Drop freshness so the next {@link getAdminIds} re-fetches (used on re-pair). */
+    invalidate() {
+        this.fetchedAt = null;
+        this.lastFailAt = null;
+    }
+    async refresh() {
+        try {
+            this.ids = new Set(await this.fetchElevatedMemberIds());
+            this.fetchedAt = this.now();
+            this.lastFailAt = null;
+            return this.ids;
+        }
+        catch (e) {
+            this.lastFailAt = this.now();
+            console.warn('[access] membership lookup failed; keeping last-known admin set:', e instanceof Error ? e.message : e);
+            return this.ids;
+        }
+    }
+}
+exports.AdminCache = AdminCache;
+//# sourceMappingURL=accessControl.js.map

package/dist/accessControl.js.map

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

package/dist/adapters/adapterEventRouting.d.ts

@@ -0,0 +1,51 @@
+import type { SessionKey } from '../sessionKey';
+/**
+ * @description The ONE gate where adapter events meet a conversation of another
+ * platform (Jira connector plan J2b, R2). Every handler the bot wires is a
+ * Telegram one — it renders, pins, edits and reads the chat's rate limit, all of
+ * which throw for a foreign key, often inside a promise nobody awaits (that
+ * crash ends the process). A Telegram key gets every handler; a foreign key gets
+ * only what its REQUEST needs: the turn tracking the wake-ups read, the
+ * usage-limit handling, and the teardown of request-side state.
+ */
+/** Every event an agent adapter emits (`createAdapter.ts` wires each). */
+export declare const adapterEventNames: readonly ["output", "status", "question", "thinking", "toolResult", "subagentStatus", "apiError", "noResponse", "questionGone", "closed", "started", "stopped", "suspended", "turnEnded", "contextCompacted", "error"];
+export type AdapterEventName = (typeof adapterEventNames)[number];
+/**
+ * @name ForeignKeyEventRoute
+ * @description What a foreign key's event runs:
+ *  - `none` — Telegram display only (status frames, thinking, tool results,
+ *    sub-agent status, native questions);
+ *  - `requestSide` — a dedicated request-side handler instead of the Telegram one;
+ *  - `all` — the shared handler, whose Telegram parts the primitives refuse.
+ */
+export type ForeignKeyEventRoute = 'none' | 'requestSide' | 'all';
+export declare const foreignKeyEventRoutes: {
+    readonly output: "requestSide";
+    readonly status: "none";
+    readonly question: "none";
+    readonly thinking: "none";
+    readonly toolResult: "none";
+    readonly subagentStatus: "none";
+    readonly apiError: "all";
+    readonly noResponse: "all";
+    readonly questionGone: "none";
+    readonly closed: "requestSide";
+    readonly stopped: "requestSide";
+    readonly suspended: "none";
+    readonly turnEnded: "all";
+    readonly contextCompacted: "all";
+    readonly started: "none";
+    readonly error: "requestSide";
+};
+/** The events whose foreign-key route is a dedicated request-side handler. */
+type RequestSideEventName = {
+    [E in AdapterEventName]: (typeof foreignKeyEventRoutes)[E] extends 'requestSide' ? E : never;
+}[AdapterEventName];
+/**
+ * @description Run an adapter event's handler for its conversation's platform:
+ * `onAll` for a Telegram key, else what {@link foreignKeyEventRoutes} says.
+ */
+export declare function dispatchAdapterEvent<E extends AdapterEventName>(key: SessionKey, eventName: E, onAll: () => void, ...onRequestSide: E extends RequestSideEventName ? [onRequestSide: () => void] : []): void;
+export {};
+//# sourceMappingURL=adapterEventRouting.d.ts.map

package/dist/adapters/adapterEventRouting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterEventRouting.d.ts","sourceRoot":"","sources":["../../src/adapters/adapterEventRouting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD;;;;;;;;GAQG;AAEH,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,wNAiBpB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,aAAa,GAAG,KAAK,CAAC;AAElE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;CAyB2C,CAAC;AAE9E,8EAA8E;AAC9E,KAAK,oBAAoB,GAAG;KACzB,CAAC,IAAI,gBAAgB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,CAAC,CAAC,SAAS,aAAa,GAAG,CAAC,GAAG,KAAK;CAC7F,CAAC,gBAAgB,CAAC,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,gBAAgB,EAC7D,GAAG,EAAE,UAAU,EACf,SAAS,EAAE,CAAC,EACZ,KAAK,EAAE,MAAM,IAAI,EAGjB,GAAG,aAAa,EAAE,CAAC,SAAS,oBAAoB,GAAG,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC,GAAG,EAAE,GAClF,IAAI,CAIN"}

package/dist/adapters/adapterEventRouting.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.foreignKeyEventRoutes = exports.adapterEventNames = void 0;
+exports.dispatchAdapterEvent = dispatchAdapterEvent;
+const sessionKeyCodec_1 = require("../connectors/telegram/sessionKeyCodec");
+/**
+ * @description The ONE gate where adapter events meet a conversation of another
+ * platform (Jira connector plan J2b, R2). Every handler the bot wires is a
+ * Telegram one — it renders, pins, edits and reads the chat's rate limit, all of
+ * which throw for a foreign key, often inside a promise nobody awaits (that
+ * crash ends the process). A Telegram key gets every handler; a foreign key gets
+ * only what its REQUEST needs: the turn tracking the wake-ups read, the
+ * usage-limit handling, and the teardown of request-side state.
+ */
+/** Every event an agent adapter emits (`createAdapter.ts` wires each). */
+exports.adapterEventNames = [
+    'output',
+    'status',
+    'question',
+    'thinking',
+    'toolResult',
+    'subagentStatus',
+    'apiError',
+    'noResponse',
+    'questionGone',
+    'closed',
+    'started',
+    'stopped',
+    'suspended',
+    'turnEnded',
+    'contextCompacted',
+    'error',
+];
+exports.foreignKeyEventRoutes = {
+    // Output marks a turn under way (the wake-ups' busy-onset); the stream itself is display.
+    output: 'requestSide',
+    status: 'none',
+    question: 'none',
+    thinking: 'none',
+    toolResult: 'none',
+    subagentStatus: 'none',
+    // A usage limit answers the request and its retry resumes the work.
+    apiError: 'all',
+    // A wedged turn's recovery replays the request's prompt.
+    noResponse: 'all',
+    questionGone: 'none',
+    // Drop the retry, compaction and preamble state a gone session leaves behind.
+    closed: 'requestSide',
+    stopped: 'requestSide',
+    // An idle stop keeps the session, its retry and its compaction state: only Telegram frames to clean up.
+    suspended: 'none',
+    // The per-turn stop (L5) applies to an issue's conversation as to a topic's; the handler posts nothing.
+    turnEnded: 'all',
+    // A completed compaction resets what the conversation was told: its connector sends the whole issue next (C6).
+    contextCompacted: 'all',
+    started: 'none',
+    // Logged; there is no topic to post it to.
+    error: 'requestSide',
+};
+/**
+ * @description Run an adapter event's handler for its conversation's platform:
+ * `onAll` for a Telegram key, else what {@link foreignKeyEventRoutes} says.
+ */
+function dispatchAdapterEvent(key, eventName, onAll, 
+// Required for exactly the `requestSide` events: a route without its handler,
+// or a handler its route never runs, is a compile error, not a silent drop.
+...onRequestSide) {
+    const route = (0, sessionKeyCodec_1.checkIsTelegramKey)(key) ? 'all' : exports.foreignKeyEventRoutes[eventName];
+    if (route === 'all')
+        onAll();
+    else if (route === 'requestSide')
+        onRequestSide[0]?.();
+}
+//# sourceMappingURL=adapterEventRouting.js.map

package/dist/adapters/adapterEventRouting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterEventRouting.js","sourceRoot":"","sources":["../../src/adapters/adapterEventRouting.ts"],"names":[],"mappings":";;;AAiFA,oDAWC;AA3FD,4EAA4E;AAE5E;;;;;;;;GAQG;AAEH,0EAA0E;AAC7D,QAAA,iBAAiB,GAAG;IAC/B,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,UAAU;IACV,YAAY;IACZ,gBAAgB;IAChB,UAAU;IACV,YAAY;IACZ,cAAc;IACd,QAAQ;IACR,SAAS;IACT,SAAS;IACT,WAAW;IACX,WAAW;IACX,kBAAkB;IAClB,OAAO;CACC,CAAC;AAcE,QAAA,qBAAqB,GAAG;IACnC,0FAA0F;IAC1F,MAAM,EAAE,aAAa;IACrB,MAAM,EAAE,MAAM;IACd,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,UAAU,EAAE,MAAM;IAClB,cAAc,EAAE,MAAM;IACtB,oEAAoE;IACpE,QAAQ,EAAE,KAAK;IACf,yDAAyD;IACzD,UAAU,EAAE,KAAK;IACjB,YAAY,EAAE,MAAM;IACpB,8EAA8E;IAC9E,MAAM,EAAE,aAAa;IACrB,OAAO,EAAE,aAAa;IACtB,wGAAwG;IACxG,SAAS,EAAE,MAAM;IACjB,wGAAwG;IACxG,SAAS,EAAE,KAAK;IAChB,+GAA+G;IAC/G,gBAAgB,EAAE,KAAK;IACvB,OAAO,EAAE,MAAM;IACf,2CAA2C;IAC3C,KAAK,EAAE,aAAa;CACuD,CAAC;AAO9E;;;GAGG;AACH,SAAgB,oBAAoB,CAClC,GAAe,EACf,SAAY,EACZ,KAAiB;AACjB,8EAA8E;AAC9E,4EAA4E;AAC5E,GAAG,aAAgF;IAEnF,MAAM,KAAK,GAAyB,IAAA,oCAAkB,EAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,6BAAqB,CAAC,SAAS,CAAC,CAAC;IACvG,IAAI,KAAK,KAAK,KAAK;QAAE,KAAK,EAAE,CAAC;SACxB,IAAI,KAAK,KAAK,aAAa;QAAE,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACzD,CAAC"}

package/dist/adapters/adapterNames.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @description Adapter names (the `state.agents[key].name` value + factory key)
+ * that code outside the adapters compares against. Kept apart from the adapter
+ * modules so a reader of the name (the Jira config, say) does not load a whole
+ * backend.
+ */
+/** The Claude Code backend driven over `--input-format/--output-format stream-json`. */
+export declare const claudeJsonStreamAdapterName = "claude-json-stream";
+/** The OpenCode backend (a local HTTP server). */
+export declare const openCodeAdapterName = "opencode";
+/**
+ * The json-stream host stopped after EVERY turn (lifecycle plan L5, L-D3): the
+ * same adapter class as {@link claudeJsonStreamAdapterName} with the per-turn
+ * lifecycle, the same tmux session name and host dir per conversation.
+ */
+export declare const claudePerTurnAdapterName = "claude-per-turn";
+/** Both backends that run the json-stream host (one process per conversation at a time). */
+export declare function checkIsJsonStreamBackend(name: string): boolean;
+//# sourceMappingURL=adapterNames.d.ts.map

package/dist/adapters/adapterNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterNames.d.ts","sourceRoot":"","sources":["../../src/adapters/adapterNames.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wFAAwF;AACxF,eAAO,MAAM,2BAA2B,uBAAuB,CAAC;AAEhE,kDAAkD;AAClD,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,oBAAoB,CAAC;AAE1D,4FAA4F;AAC5F,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D"}

package/dist/adapters/adapterNames.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * @description Adapter names (the `state.agents[key].name` value + factory key)
+ * that code outside the adapters compares against. Kept apart from the adapter
+ * modules so a reader of the name (the Jira config, say) does not load a whole
+ * backend.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.claudePerTurnAdapterName = exports.openCodeAdapterName = exports.claudeJsonStreamAdapterName = void 0;
+exports.checkIsJsonStreamBackend = checkIsJsonStreamBackend;
+/** The Claude Code backend driven over `--input-format/--output-format stream-json`. */
+exports.claudeJsonStreamAdapterName = 'claude-json-stream';
+/** The OpenCode backend (a local HTTP server). */
+exports.openCodeAdapterName = 'opencode';
+/**
+ * The json-stream host stopped after EVERY turn (lifecycle plan L5, L-D3): the
+ * same adapter class as {@link claudeJsonStreamAdapterName} with the per-turn
+ * lifecycle, the same tmux session name and host dir per conversation.
+ */
+exports.claudePerTurnAdapterName = 'claude-per-turn';
+/** Both backends that run the json-stream host (one process per conversation at a time). */
+function checkIsJsonStreamBackend(name) {
+    return name === exports.claudeJsonStreamAdapterName || name === exports.claudePerTurnAdapterName;
+}
+//# sourceMappingURL=adapterNames.js.map

package/dist/adapters/adapterNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterNames.js","sourceRoot":"","sources":["../../src/adapters/adapterNames.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAgBH,4DAEC;AAhBD,wFAAwF;AAC3E,QAAA,2BAA2B,GAAG,oBAAoB,CAAC;AAEhE,kDAAkD;AACrC,QAAA,mBAAmB,GAAG,UAAU,CAAC;AAE9C;;;;GAIG;AACU,QAAA,wBAAwB,GAAG,iBAAiB,CAAC;AAE1D,4FAA4F;AAC5F,SAAgB,wBAAwB,CAAC,IAAY;IACnD,OAAO,IAAI,KAAK,mCAA2B,IAAI,IAAI,KAAK,gCAAwB,CAAC;AACnF,CAAC"}