aec-agent 1.0.1 → 1.0.4

package/dist/components/channel-platform-hub/adapter-kit.d.ts

@@ -0,0 +1,51 @@
+export declare const ADAPTER_REQUEST_TIMEOUT_MS = 15000;
+export declare const ADAPTER_MAX_BACKOFF_MS = 30000;
+/** A 429 on a send is retried once when the platform asks for at most this long a wait. */
+export declare const MAX_RETRY_AFTER_S = 30;
+export declare function errorMessage(err: unknown): string;
+/** Resolves after `ms`, or early when `signal` aborts. */
+export declare function sleep(ms: number, signal: AbortSignal): Promise<void>;
+/** An error from a platform's HTTP API. `retryAfter` is in seconds. */
+export declare class PlatformApiError extends Error {
+    readonly status: number;
+    readonly retryAfter?: number | undefined;
+    /** The platform's own error code, e.g. Slack's "invalid_auth". */
+    readonly code?: string | undefined;
+    constructor(status: number, message: string, retryAfter?: number | undefined, 
+    /** The platform's own error code, e.g. Slack's "invalid_auth". */
+    code?: string | undefined);
+}
+/** Doubles from 1 s up to ADAPTER_MAX_BACKOFF_MS; reset() after a success. */
+export declare class Backoff {
+    private ms;
+    next(): number;
+    reset(): void;
+}
+/** The WebSocket constructor an adapter uses (the global one unless a test injects another). */
+export type WebSocketFactory = new (url: string) => WebSocket;
+export interface SocketHandlers {
+    message(data: string): void;
+    /** The socket closed (by either side). Not called after close() was called. */
+    closed(code: number, reason: string): void;
+}
+/**
+ * One WebSocket connection: open() resolves once connected (rejects when it
+ * cannot connect), text frames go to `handlers.message`, and a close the
+ * adapter did not ask for goes to `handlers.closed`.
+ */
+export declare class Socket {
+    private readonly factory;
+    private readonly handlers;
+    private ws?;
+    private closing;
+    constructor(factory: WebSocketFactory, handlers: SocketHandlers);
+    open(url: string, timeoutMs?: number): Promise<void>;
+    send(data: unknown): void;
+    /** Close without reporting it through handlers.closed. */
+    close(code?: number): void;
+    /** Close and report it like a close from the other side (to force a reconnect). */
+    drop(): void;
+}
+/** A Retry-After header (seconds), when present. */
+export declare function retryAfterHeader(res: Response): number | undefined;
+//# sourceMappingURL=adapter-kit.d.ts.map

package/dist/components/channel-platform-hub/adapter-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-kit.d.ts","sourceRoot":"","sources":["../../../src/components/channel-platform-hub/adapter-kit.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,0BAA0B,QAAS,CAAC;AACjD,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAC7C,2FAA2F;AAC3F,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAEjD;AAED,0DAA0D;AAC1D,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAWpE;AAED,uEAAuE;AACvE,qBAAa,gBAAiB,SAAQ,KAAK;IAEvC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAEvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;IALxB,YACW,MAAM,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EACN,UAAU,CAAC,EAAE,MAAM,YAAA;IAC5B,kEAAkE;IACzD,IAAI,CAAC,EAAE,MAAM,YAAA,EAIvB;CACF;AAED,8EAA8E;AAC9E,qBAAa,OAAO;IAClB,OAAO,CAAC,EAAE,CAAS;IACnB,IAAI,IAAI,MAAM,CAIb;IACD,KAAK,IAAI,IAAI,CAEZ;CACF;AAED,gGAAgG;AAChG,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,EAAE,MAAM,KAAK,SAAS,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,+EAA+E;IAC/E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C;AAED;;;;GAIG;AACH,qBAAa,MAAM;IAKf,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAL3B,OAAO,CAAC,EAAE,CAAC,CAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IAExB,YACmB,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,cAAc,EACvC;IAEJ,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CvE;IAED,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAExB;IAED,0DAA0D;IAC1D,KAAK,CAAC,IAAI,SAAO,GAAG,IAAI,CASvB;IAED,mFAAmF;IACnF,IAAI,IAAI,IAAI,CAOX;CACF;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAGlE"}

package/dist/components/channel-platform-hub/adapter-kit.js

@@ -0,0 +1,153 @@
+// ---------------------------------------------------------------------------
+// Small helpers shared by the chat-platform adapters (A-100 phase 3: Slack,
+// Discord, Microsoft Teams). No dependencies: HTTP is the global fetch and
+// sockets the global WebSocket (Node 22+); both can be swapped for tests.
+// ---------------------------------------------------------------------------
+export const ADAPTER_REQUEST_TIMEOUT_MS = 15_000;
+export const ADAPTER_MAX_BACKOFF_MS = 30_000;
+/** A 429 on a send is retried once when the platform asks for at most this long a wait. */
+export const MAX_RETRY_AFTER_S = 30;
+export function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/** Resolves after `ms`, or early when `signal` aborts. */
+export function sleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted)
+            return resolve();
+        const timer = setTimeout(done, ms);
+        function done() {
+            clearTimeout(timer);
+            signal.removeEventListener("abort", done);
+            resolve();
+        }
+        signal.addEventListener("abort", done, { once: true });
+    });
+}
+/** An error from a platform's HTTP API. `retryAfter` is in seconds. */
+export class PlatformApiError extends Error {
+    status;
+    retryAfter;
+    code;
+    constructor(status, message, retryAfter, 
+    /** The platform's own error code, e.g. Slack's "invalid_auth". */
+    code) {
+        super(message);
+        this.status = status;
+        this.retryAfter = retryAfter;
+        this.code = code;
+        this.name = "PlatformApiError";
+    }
+}
+/** Doubles from 1 s up to ADAPTER_MAX_BACKOFF_MS; reset() after a success. */
+export class Backoff {
+    ms = 1_000;
+    next() {
+        const ms = this.ms;
+        this.ms = Math.min(this.ms * 2, ADAPTER_MAX_BACKOFF_MS);
+        return ms;
+    }
+    reset() {
+        this.ms = 1_000;
+    }
+}
+/**
+ * One WebSocket connection: open() resolves once connected (rejects when it
+ * cannot connect), text frames go to `handlers.message`, and a close the
+ * adapter did not ask for goes to `handlers.closed`.
+ */
+export class Socket {
+    factory;
+    handlers;
+    ws;
+    closing = false;
+    constructor(factory, handlers) {
+        this.factory = factory;
+        this.handlers = handlers;
+    }
+    open(url, timeoutMs = ADAPTER_REQUEST_TIMEOUT_MS) {
+        this.closing = false;
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const ws = new this.factory(url);
+            this.ws = ws;
+            const timer = setTimeout(() => {
+                if (settled)
+                    return;
+                settled = true;
+                try {
+                    ws.close();
+                }
+                catch {
+                    // already closing
+                }
+                reject(new Error("The connection timed out"));
+            }, timeoutMs);
+            ws.addEventListener("open", () => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                resolve();
+            });
+            ws.addEventListener("message", (event) => {
+                if (this.ws !== ws)
+                    return;
+                const data = event.data;
+                if (typeof data === "string")
+                    this.handlers.message(data);
+                else if (data instanceof ArrayBuffer)
+                    this.handlers.message(new TextDecoder().decode(data));
+            });
+            ws.addEventListener("error", () => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                reject(new Error("Could not connect"));
+            });
+            ws.addEventListener("close", (event) => {
+                clearTimeout(timer);
+                if (!settled) {
+                    settled = true;
+                    reject(new Error(`The connection closed (${event.code}${event.reason ? `: ${event.reason}` : ""})`));
+                    return;
+                }
+                if (this.ws === ws && !this.closing)
+                    this.handlers.closed(event.code, event.reason);
+            });
+        });
+    }
+    send(data) {
+        if (this.ws?.readyState === 1)
+            this.ws.send(JSON.stringify(data));
+    }
+    /** Close without reporting it through handlers.closed. */
+    close(code = 1000) {
+        this.closing = true;
+        const ws = this.ws;
+        this.ws = undefined;
+        try {
+            ws?.close(code);
+        }
+        catch {
+            // already closed
+        }
+    }
+    /** Close and report it like a close from the other side (to force a reconnect). */
+    drop() {
+        const ws = this.ws;
+        try {
+            ws?.close(4000, "reconnect");
+        }
+        catch {
+            // already closed
+        }
+    }
+}
+/** A Retry-After header (seconds), when present. */
+export function retryAfterHeader(res) {
+    const value = Number(res.headers.get("retry-after"));
+    return Number.isFinite(value) && value > 0 ? value : undefined;
+}
+//# sourceMappingURL=adapter-kit.js.map

package/dist/components/channel-platform-hub/adapter-kit.js.map

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

package/dist/components/channel-platform-hub/channel-platform-hub.d.ts

@@ -0,0 +1,34 @@
+import type { Plugin } from "../../kernel/interfaces/plugin.js";
+import type { ChannelPlatform } from "./types.js";
+/**
+ * Global hub for channels (A-100) — like ToolHub / SandboxHub, AgentCore owns one.
+ *
+ *   ChannelPlatformHub (AgentCore.channelPlatformHub)
+ *     ├─ the chat platforms a host supports (Telegram, Slack, Discord, Teams, your own app...)
+ *     └─ which bot account each channel is connected as
+ *
+ * Platforms are registered once (AgentCore.useChannelPlatform) and shared by every
+ * agent of an AgentCore; each agent's ChannelManager builds adapters from them.
+ *
+ * It also records which bot account is connected where, so the same bot is
+ * never connected twice in one process (most platforms allow one listener per
+ * bot — Telegram answers a second poller with 409 Conflict).
+ */
+export declare class ChannelPlatformHub implements Plugin {
+    readonly name = "channel-platform-hub";
+    readonly version = "1.0.0";
+    private platforms;
+    /** "<platform>:<account id>" -> channel id holding it. */
+    private claims;
+    register(platform: ChannelPlatform): void;
+    get(name: string): ChannelPlatform | undefined;
+    list(): ChannelPlatform[];
+    /**
+     * Record that `channelId` is connected as the bot `accountId`. Returns the id of
+     * the channel already holding that bot, or undefined when the claim succeeded.
+     */
+    claim(platform: string, accountId: string, channelId: string): string | undefined;
+    /** Drop every claim held by `channelId`. */
+    release(channelId: string): void;
+}
+//# sourceMappingURL=channel-platform-hub.d.ts.map

package/dist/components/channel-platform-hub/channel-platform-hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-platform-hub.d.ts","sourceRoot":"","sources":["../../../src/components/channel-platform-hub/channel-platform-hub.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,YAAW,MAAM;IAC/C,QAAQ,CAAC,IAAI,0BAA0B;IACvC,QAAQ,CAAC,OAAO,WAAW;IAE3B,OAAO,CAAC,SAAS,CAAsC;IACvD,0DAA0D;IAC1D,OAAO,CAAC,MAAM,CAA6B;IAE3C,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAGxC;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE7C;IAED,IAAI,IAAI,eAAe,EAAE,CAExB;IAED;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMhF;IAED,4CAA4C;IAC5C,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAI/B;CACF"}

package/dist/components/channel-platform-hub/channel-platform-hub.js

@@ -0,0 +1,52 @@
+/**
+ * Global hub for channels (A-100) — like ToolHub / SandboxHub, AgentCore owns one.
+ *
+ *   ChannelPlatformHub (AgentCore.channelPlatformHub)
+ *     ├─ the chat platforms a host supports (Telegram, Slack, Discord, Teams, your own app...)
+ *     └─ which bot account each channel is connected as
+ *
+ * Platforms are registered once (AgentCore.useChannelPlatform) and shared by every
+ * agent of an AgentCore; each agent's ChannelManager builds adapters from them.
+ *
+ * It also records which bot account is connected where, so the same bot is
+ * never connected twice in one process (most platforms allow one listener per
+ * bot — Telegram answers a second poller with 409 Conflict).
+ */
+export class ChannelPlatformHub {
+    name = "channel-platform-hub";
+    version = "1.0.0";
+    platforms = new Map();
+    /** "<platform>:<account id>" -> channel id holding it. */
+    claims = new Map();
+    register(platform) {
+        if (!platform.name.trim())
+            throw new Error("A channel platform needs a name");
+        this.platforms.set(platform.name, platform);
+    }
+    get(name) {
+        return this.platforms.get(name);
+    }
+    list() {
+        return [...this.platforms.values()];
+    }
+    /**
+     * Record that `channelId` is connected as the bot `accountId`. Returns the id of
+     * the channel already holding that bot, or undefined when the claim succeeded.
+     */
+    claim(platform, accountId, channelId) {
+        const key = `${platform}:${accountId}`;
+        const holder = this.claims.get(key);
+        if (holder !== undefined && holder !== channelId)
+            return holder;
+        this.claims.set(key, channelId);
+        return undefined;
+    }
+    /** Drop every claim held by `channelId`. */
+    release(channelId) {
+        for (const [key, holder] of [...this.claims.entries()]) {
+            if (holder === channelId)
+                this.claims.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=channel-platform-hub.js.map

package/dist/components/channel-platform-hub/channel-platform-hub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-platform-hub.js","sourceRoot":"","sources":["../../../src/components/channel-platform-hub/channel-platform-hub.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,kBAAkB;IACpB,IAAI,GAAG,sBAAsB,CAAC;IAC9B,OAAO,GAAG,OAAO,CAAC;IAEnB,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IACvD,0DAA0D;IAClD,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE3C,QAAQ,CAAC,QAAyB;QAChC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QAC9E,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,QAAgB,EAAE,SAAiB,EAAE,SAAiB;QAC1D,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,SAAS,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QAChE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,4CAA4C;IAC5C,OAAO,CAAC,SAAiB;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YACvD,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;CACF"}

package/dist/components/channel-platform-hub/discord/discord-adapter.d.ts

@@ -0,0 +1,57 @@
+import type { WebSocketFactory } from "../adapter-kit.js";
+import type { ChannelAccountInfo, ChannelAdapter, ChannelCapabilities, ChannelMessageRef, ChannelPlatform, ChannelSink, ChannelTarget, OutboundMessage } from "../types.js";
+export interface DiscordAdapterOptions {
+    botToken: string;
+    /** Default https://discord.com/api/v10 — for tests. */
+    apiBaseUrl?: string;
+    /** Used when /gateway/bot does not answer one. */
+    gatewayUrl?: string;
+    fetch?: typeof fetch;
+    webSocket?: WebSocketFactory;
+}
+/** The Discord platform, for AgentCore.useChannelPlatform. A channel needs the "botToken" credential. */
+export declare function discordPlatform(options?: Omit<DiscordAdapterOptions, "botToken">): ChannelPlatform;
+export declare class DiscordAdapter implements ChannelAdapter {
+    private options;
+    readonly capabilities: ChannelCapabilities;
+    private readonly baseUrl;
+    private readonly fetchFn;
+    private readonly factory;
+    private controller;
+    private sink?;
+    private bot?;
+    private gatewayUrl;
+    private socket?;
+    private loop?;
+    private seq;
+    private sessionId?;
+    private resumeUrl?;
+    private heartbeat?;
+    private heartbeatAcked;
+    /** Settles the current connection: ready (or resumed), or closed with a code. */
+    private connection?;
+    constructor(options: DiscordAdapterOptions);
+    start(sink: ChannelSink): Promise<ChannelAccountInfo>;
+    stop(): Promise<void>;
+    send(target: ChannelTarget, message: OutboundMessage): Promise<ChannelMessageRef>;
+    edit(ref: ChannelMessageRef, message: OutboundMessage): Promise<void>;
+    sendTyping(target: ChannelTarget): Promise<void>;
+    /**
+     * Open one gateway connection and wait until it is ready (or resumed): `code` is
+     * undefined then, and `closed` resolves when it later closes. When it closes before
+     * that, `code` is the close code.
+     */
+    private session;
+    /** Reconnect (resuming when possible) whenever the connection closes, until stop(). */
+    private run;
+    private onFrame;
+    private onDispatch;
+    private onMessage;
+    private onInteraction;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private withRetry;
+    /** One REST call. The token is only in the Authorization header, never in an error message. */
+    private rest;
+}
+//# sourceMappingURL=discord-adapter.d.ts.map

package/dist/components/channel-platform-hub/discord/discord-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord-adapter.d.ts","sourceRoot":"","sources":["../../../../src/components/channel-platform-hub/discord/discord-adapter.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EAEd,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EAEf,WAAW,EACX,aAAa,EAEb,eAAe,EAChB,MAAM,aAAa,CAAC;AAmCrB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,SAAS,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,yGAAyG;AACzG,wBAAgB,eAAe,CAAC,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,UAAU,CAAM,GAAG,eAAe,CAOtG;AAED,qBAAa,cAAe,YAAW,cAAc;IAqBvC,OAAO,CAAC,OAAO;IApB3B,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAA2E;IAErH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,IAAI,CAAC,CAAc;IAC3B,OAAO,CAAC,GAAG,CAAC,CAAmC;IAC/C,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,IAAI,CAAC,CAAgB;IAE7B,OAAO,CAAC,GAAG,CAAuB;IAClC,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAiC;IACnD,OAAO,CAAC,cAAc,CAAQ;IAC9B,iFAAiF;IACjF,OAAO,CAAC,UAAU,CAAC,CAA+E;IAElG,YAAoB,OAAO,EAAE,qBAAqB,EAKjD;IAEK,KAAK,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA0B1D;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAM1B;IAEK,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAWtF;IAEK,IAAI,CAAC,GAAG,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAS1E;IAEK,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAErD;IAMD;;;;OAIG;YACW,OAAO;IAwCrB,uFAAuF;YACzE,GAAG;IAoCjB,OAAO,CAAC,OAAO;IAiDf,OAAO,CAAC,UAAU;IAuBlB,OAAO,CAAC,SAAS;YAkBH,aAAa;IAc3B,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,aAAa;YASP,SAAS;IAUvB,+FAA+F;YACjF,IAAI;CA+BnB"}