@spinabot/brigade 1.6.0 → 1.7.0

package/dist/agents/channels/discord/plugin.js

@@ -0,0 +1,372 @@
+/**
+ * Discord `ChannelPlugin` — the multi-ACCOUNT contract surface.
+ *
+ * Mirrors `slack/plugin.ts`: wraps `createDiscordAdapter()` (the per-connection
+ * implementation) with the lifecycle adapters the `ChannelPluginManager`
+ * consumes, so an operator can run MORE THAN ONE Discord bot at once via:
+ *
+ *   channels.discord = {
+ *     enabled: true,
+ *     accounts: [
+ *       { id: "main", botToken: "…AAA" },
+ *       { id: "labs", botToken: "…BBB" },
+ *     ],
+ *   }
+ *
+ *   - `config.listAccountIds` / `resolveAccount`  → multi-account discovery
+ *   - `gateway.startAccount` / `stopAccount`      → per-account bot lifecycle
+ *   - `outbound.sendText` / `sendMedia`           → routes by `target.accountId`
+ *   - per-account approval-dispatcher registration → an exec-gate prompt raised
+ *     by a turn on (discord, labs) replies on (discord, labs), not the default
+ *
+ * Per-account state lives in a `Map<accountId, AccountRuntime>` held in this
+ * closure — one Gateway connection per account, partitioned token resolution per
+ * `channels.discord.accounts[].botToken`. Inbound dispatch reuses the shared
+ * `runChannelInboundPipeline` so the multi-account path carries the identical
+ * ACL + debounce + abort + approval-reply + approval-callback surface as the
+ * legacy single-adapter manager.
+ *
+ * The legacy single-account `createDiscordAdapter` (started by the legacy
+ * `startChannels` manager) STEPS ASIDE when >1 account is configured — its
+ * `isConfigured` returns false for the default account in that case (mirrors
+ * Slack), so the two paths never double-start a bot.
+ *
+ * Discord has no events-mode HTTP route (the Gateway is the only inbound
+ * transport), so — unlike Slack's plugin — there is NO per-account webhook-sink
+ * registry to populate.
+ */
+// Channel SDK barrel — the SINGLE import surface for the multi-account
+// `ChannelPlugin` contract + every sub-adapter type + the shared inbound
+// pipeline + the approval router + the gateway boot args. A multi-account
+// channel authors entirely from here.
+import { buildBundledCommands, createInboundPipelineContext, createSubsystemLogger, registerChannelApprovalDispatcher, removeChannelApprovalDispatcher, runChannelInboundPipeline, DISCORD_CHANNEL_META, } from "../sdk.js";
+import { listDiscordAccountIds, resolveDiscordAccount, resolveDiscordBotToken, DISCORD_CHANNEL_ID, DISCORD_DEFAULT_ACCOUNT_ID, } from "./account-config.js";
+import { createDiscordAdapter, DISCORD_CAPABILITIES } from "./adapter.js";
+import { probeDiscord } from "./probe.js";
+import { auditDiscordChannelPermissions } from "./permission-audit.js";
+import { collectDiscordSecurityAuditFindings } from "./security-audit.js";
+import { collectDiscordStatusIssues } from "./status-issues.js";
+const log = createSubsystemLogger("channels/discord/plugin");
+// Single source of truth for the channel's user-facing metadata lives in the
+// import-light `bundled-channel-metas` module (re-exported via the SDK barrel),
+// so the registry / markdown gate can read it without loading this adapter.
+// `DISCORD_CHANNEL_META.id` is the same canonical `"discord"` string as
+// `DISCORD_CHANNEL_ID`.
+const DISCORD_META = DISCORD_CHANNEL_META;
+/**
+ * Collect the numeric guild channel ids configured under
+ * `channels.discord.guilds.<guildId>.channels.<channelId>` so the permission
+ * audit knows which channels to check. Non-numeric keys are passed through too —
+ * the audit reports them as unresolved. Returns [] when none are configured.
+ */
+export function collectConfiguredDiscordChannelIds(cfg) {
+    const slot = cfg.channels?.[DISCORD_CHANNEL_ID];
+    const guilds = slot && typeof slot === "object" ? slot.guilds : undefined;
+    if (!guilds || typeof guilds !== "object")
+        return [];
+    const ids = new Set();
+    for (const guildValue of Object.values(guilds)) {
+        if (!guildValue || typeof guildValue !== "object")
+            continue;
+        const channels = guildValue.channels;
+        if (!channels || typeof channels !== "object")
+            continue;
+        for (const channelKey of Object.keys(channels)) {
+            const key = channelKey.trim();
+            if (key)
+                ids.add(key);
+        }
+    }
+    return [...ids];
+}
+/** Build the per-account approval capability — the native component prompt + approver gate. */
+function buildApprovalCapability(adapter, accountId) {
+    return {
+        async sendApprovalPrompt(params) {
+            // Delegate to the adapter's own native prompt (component buttons). The
+            // adapter throws when the approval id can't be encoded, so the router
+            // falls back to its text prompt — mirror that here.
+            const cap = adapter.approvalCapability?.sendApprovalPrompt;
+            if (!cap)
+                throw new Error("discord adapter has no approval prompt");
+            await cap({ ...params, accountId });
+        },
+        authorizeApprover(p) {
+            const cap = adapter.approvalCapability?.authorizeApprover;
+            if (!cap)
+                return { authorized: true };
+            return cap(p);
+        },
+    };
+}
+/** Construct the plugin instance, capturing per-account runtime state in closure. */
+export function createDiscordPlugin(deps) {
+    const accountRuntimes = new Map();
+    const startAccount = async (ctx) => {
+        const accountId = ctx.accountId || DISCORD_DEFAULT_ACCOUNT_ID;
+        // Re-entrant start (the plugin-manager's restart loop) — stop the prior
+        // adapter, then build fresh.
+        const existing = accountRuntimes.get(accountId);
+        if (existing) {
+            try {
+                await existing.adapter.stop();
+            }
+            catch {
+                /* best-effort */
+            }
+            try {
+                existing.abort.abort("restart");
+            }
+            catch {
+                /* best-effort */
+            }
+            removeChannelApprovalDispatcher(DISCORD_CHANNEL_ID, accountId);
+            accountRuntimes.delete(accountId);
+        }
+        const cfg = deps.loadConfig();
+        const factory = deps.adapterFactory ?? defaultDiscordAdapterFactory;
+        const adapter = factory({ accountId });
+        // Per-account abort derived from the gateway's parent abort.
+        const accountAbort = new AbortController();
+        const parent = ctx.signal;
+        if (parent) {
+            if (parent.aborted)
+                accountAbort.abort();
+            else
+                parent.addEventListener("abort", () => accountAbort.abort(), { once: true });
+        }
+        const pipelineRunTurn = (turn) => deps.runTurn(turn);
+        // Bundled channel commands so `/help` etc. work on the multi-account path.
+        const commandMap = new Map();
+        for (const c of buildBundledCommands(adapter)) {
+            commandMap.set(c.name.toLowerCase(), c);
+        }
+        const pipeline = createInboundPipelineContext({
+            adapter,
+            config: cfg,
+            agentId: deps.defaultAgentId,
+            runTurn: pipelineRunTurn,
+            commandMap,
+            parentAbort: accountAbort.signal,
+        });
+        const startCtx = {
+            signal: accountAbort.signal,
+            log: (msg, meta) => log.info(`[${accountId}] ${msg}`, meta),
+            onInbound: async (msg) => {
+                // Re-read the active config per inbound so policy edits land without
+                // restarting the bot. Stamp the accountId so the shared pipeline keys
+                // ACL + approval-route per account.
+                pipeline.config = deps.loadConfig();
+                const stamped = msg.accountId ? msg : { ...msg, accountId };
+                await runChannelInboundPipeline(pipeline, stamped);
+            },
+        };
+        try {
+            await adapter.start(startCtx);
+            accountRuntimes.set(accountId, { adapter, pipeline, abort: accountAbort });
+            // Per-account approval dispatcher — native component prompt + per-account
+            // routing. Without this an exec-gate prompt from a turn on (discord, labs)
+            // would fall through to the channel default.
+            registerChannelApprovalDispatcher(DISCORD_CHANNEL_ID, accountId, {
+                sendText: (conversationId, text, opts) => adapter.sendText(conversationId, text, { ...(opts ?? {}), accountId }),
+                prettyName: "Discord",
+                approvalCapability: buildApprovalCapability(adapter, accountId),
+                getApprovalContext: () => ({ runtime: ctx.runtime, cfg: deps.loadConfig() }),
+            });
+            log.info("discord account started", { accountId });
+        }
+        catch (err) {
+            log.warn("discord account failed to start", {
+                accountId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            throw err;
+        }
+    };
+    const stopAccount = async (ctx) => {
+        const runtime = accountRuntimes.get(ctx.accountId);
+        if (!runtime)
+            return;
+        accountRuntimes.delete(ctx.accountId);
+        // Drop the per-account dispatcher BEFORE adapter.stop() so a late in-flight
+        // bridge can't ask a torn-down bot to act.
+        removeChannelApprovalDispatcher(DISCORD_CHANNEL_ID, ctx.accountId);
+        try {
+            runtime.abort.abort("stop-requested");
+        }
+        catch {
+            /* best-effort */
+        }
+        // Clear pending debounce slots so a flush can't fire after stop.
+        for (const slot of runtime.pipeline.pendingDispatches.values())
+            clearTimeout(slot.timer);
+        runtime.pipeline.pendingDispatches.clear();
+        try {
+            await runtime.adapter.stop();
+        }
+        catch (err) {
+            log.warn("discord account stop threw", {
+                accountId: ctx.accountId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    };
+    const logoutAccount = async (ctx) => {
+        try {
+            await stopAccount(ctx);
+            return { ok: true };
+        }
+        catch (err) {
+            return { ok: false, error: err instanceof Error ? err.message : String(err) };
+        }
+    };
+    return {
+        id: DISCORD_CHANNEL_ID,
+        meta: DISCORD_META,
+        capabilities: DISCORD_CAPABILITIES,
+        startedAccountIds: () => [...accountRuntimes.keys()],
+        getAdapter: (accountId) => accountRuntimes.get(accountId)?.adapter,
+        probeAccount: async (accountId, cfg) => {
+            const token = resolveDiscordBotToken(cfg, accountId);
+            const result = await probeDiscord({ token });
+            // Channel-permission audit over any configured guild channels (Phase 5).
+            // Best-effort: skipped when the token / probe failed (nothing to check
+            // against), or when no channels are configured.
+            let permissionAudit;
+            const channelIds = collectConfiguredDiscordChannelIds(cfg);
+            if (result.ok && token && channelIds.length > 0) {
+                try {
+                    permissionAudit = await auditDiscordChannelPermissions(token, channelIds);
+                }
+                catch {
+                    /* never fail the probe on the audit */
+                }
+            }
+            // Surface the started adapter's liveness signal alongside the /users/@me
+            // reachability check (observability only — never changes `ok`).
+            const live = accountRuntimes.get(accountId)?.adapter;
+            const lastEventAt = live && typeof live.lastEventAt === "function" ? live.lastEventAt() : undefined;
+            return {
+                ...result,
+                ...(lastEventAt !== undefined ? { lastEventAt } : {}),
+                ...(permissionAudit ? { permissionAudit } : {}),
+            };
+        },
+        config: {
+            listAccountIds: (cfg) => listDiscordAccountIds(cfg),
+            resolveAccount: (cfg, accountId) => resolveDiscordAccount(cfg, accountId ?? undefined),
+            defaultAccountId: () => DISCORD_DEFAULT_ACCOUNT_ID,
+            isEnabled: (account) => account.enabled,
+        },
+        gateway: {
+            startAccount,
+            stopAccount,
+            logoutAccount,
+        },
+        outbound: {
+            sendText: async (params) => {
+                const accountId = params.target.accountId || DISCORD_DEFAULT_ACCOUNT_ID;
+                const runtime = accountRuntimes.get(accountId);
+                if (!runtime) {
+                    return { ok: false, error: `discord account "${accountId}" is not running` };
+                }
+                try {
+                    const sent = await runtime.adapter.sendText(params.target.to, params.text, {
+                        accountId,
+                        ...(params.target.threadId !== undefined ? { threadId: params.target.threadId } : {}),
+                    });
+                    return {
+                        ok: true,
+                        ...(sent && typeof sent === "object" && sent.messageId !== undefined ? { messageId: sent.messageId } : {}),
+                    };
+                }
+                catch (err) {
+                    return { ok: false, error: err instanceof Error ? err.message : String(err) };
+                }
+            },
+            sendMedia: async (params) => {
+                const accountId = params.target.accountId || DISCORD_DEFAULT_ACCOUNT_ID;
+                const runtime = accountRuntimes.get(accountId);
+                if (!runtime || !runtime.adapter.sendMedia) {
+                    return { ok: false, error: `discord account "${accountId}" cannot send media right now` };
+                }
+                try {
+                    await runtime.adapter.sendMedia(params.target.to, {
+                        kind: params.mediaType ?? "document",
+                        path: params.mediaUrl,
+                        ...(params.caption !== undefined ? { caption: params.caption } : {}),
+                    });
+                    return { ok: true };
+                }
+                catch (err) {
+                    return { ok: false, error: err instanceof Error ? err.message : String(err) };
+                }
+            },
+            sendReaction: async (params) => {
+                const accountId = params.target.accountId || DISCORD_DEFAULT_ACCOUNT_ID;
+                const runtime = accountRuntimes.get(accountId);
+                if (!runtime || !runtime.adapter.react) {
+                    return { ok: false, error: `discord account "${accountId}" cannot react right now` };
+                }
+                try {
+                    await runtime.adapter.react(params.target.to, params.messageId, params.emoji);
+                    return { ok: true };
+                }
+                catch (err) {
+                    return { ok: false, error: err instanceof Error ? err.message : String(err) };
+                }
+            },
+        },
+        actions: {
+            handleAction: async (params) => {
+                const accountId = params.accountId || params.target.accountId || DISCORD_DEFAULT_ACCOUNT_ID;
+                const runtime = accountRuntimes.get(accountId);
+                if (!runtime || !runtime.adapter.handleAction) {
+                    return { ok: false, error: `discord account "${accountId}" cannot perform message actions` };
+                }
+                return runtime.adapter.handleAction({
+                    conversationId: params.target.to,
+                    action: params.action,
+                    accountId,
+                    ...(params.signal ? { signal: params.signal } : {}),
+                });
+            },
+        },
+        secrets: {
+            secretTargetRegistryEntries: [
+                { path: "channels.discord.botToken", description: "Discord bot token (single-account)" },
+                { path: "channels.discord.accounts.*.botToken", description: "Discord bot token (per account)" },
+            ],
+        },
+        // Supplementary security audit (Phase 5): warn on name-based (mutable)
+        // allow-list entries. Consumed by `brigade doctor` via the central
+        // `channel-security-registry.ts` collector.
+        security: {
+            collectAuditFindings: (ctx) => collectDiscordSecurityAuditFindings({ cfg: ctx.sourceConfig, accountId: ctx.accountId }),
+        },
+        // Structured status rollup (Phase 5): intent + permission issues. The
+        // central status surface stashes the probe/audit on each account snapshot
+        // (under `probe` / `audit`); this adapts those into Discord status issues.
+        status: {
+            collectStatusIssues: (accounts) => collectDiscordStatusIssues(accounts.map((snap) => {
+                const s = snap;
+                return {
+                    accountId: typeof s.accountId === "string" ? s.accountId : "",
+                    ...(s.probe ? { probe: s.probe } : {}),
+                    // The audit may ride on the probe (probeAccount attaches it) or be
+                    // stashed directly on the snapshot.
+                    ...(s.probe?.permissionAudit
+                        ? { audit: s.probe.permissionAudit }
+                        : s.audit
+                            ? { audit: s.audit }
+                            : {}),
+                };
+            })),
+        },
+    };
+}
+/** Default adapter factory — threads the per-account scope. */
+function defaultDiscordAdapterFactory(args) {
+    return createDiscordAdapter({ accountId: args.accountId });
+}
+//# sourceMappingURL=plugin.js.map

package/dist/agents/channels/discord/plugin.js.map

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

package/dist/agents/channels/discord/probe.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Discord status / doctor probe — a lightweight `GET /users/@me` reachability
+ * check.
+ *
+ * Discord is token-based and stateless on disk (the Gateway keeps no local creds
+ * the status command can stat), so "is this channel actually working?" can only
+ * be answered by asking Discord. This probe does the cheapest possible call — a
+ * single `GET /users/@me` over plain HTTPS (no `discord.js`, no gateway socket)
+ * with the `Authorization: Bot <token>` header — and reports the bot's identity
+ * so `brigade channels status` and `brigade doctor` can show real Discord health.
+ *
+ * It deliberately does NOT import `discord.js`: a status check must stay fast +
+ * dependency-light, and `/users/@me` is a trivial GET. The bot token is never
+ * logged; it rides in the `Authorization` header which is built locally and
+ * discarded.
+ *
+ * Returns a structured result the caller renders; never throws — a network
+ * failure / invalid token surfaces as `{ ok: false, error }` so the status
+ * command degrades gracefully instead of crashing. Discord mirror of
+ * `slack/probe.ts`.
+ */
+/** Decoded state of a privileged gateway intent. */
+export type MessageContentIntentState = "enabled" | "limited" | "disabled";
+/** Alias — every privileged intent decodes to the same tri-state. */
+export type PrivilegedIntentState = MessageContentIntentState;
+/** All three privileged intents decoded from the application flags. */
+export interface DiscordPrivilegedIntents {
+    messageContent: PrivilegedIntentState;
+    guildMembers: PrivilegedIntentState;
+    presence: PrivilegedIntentState;
+}
+/**
+ * Decode the MESSAGE CONTENT intent state from an application `flags` bitfield.
+ * `enabled` (full), `limited` (limited rollout — still reads content), or
+ * `disabled` (neither bit set). Returns `undefined` when `flags` isn't a number
+ * (the flags fetch was skipped / failed) so callers don't warn on missing data.
+ */
+export declare function decodeMessageContentIntent(flags: unknown): MessageContentIntentState | undefined;
+/**
+ * Decode ALL three privileged gateway intents (message content, guild members,
+ * presence) from an application `flags` bitfield. Returns `undefined` when
+ * `flags` isn't a finite number (the flags fetch was skipped / failed) so
+ * callers don't warn on missing data.
+ */
+export declare function decodePrivilegedIntents(flags: unknown): DiscordPrivilegedIntents | undefined;
+/** Operator-facing warning surfaced when the MESSAGE CONTENT intent is disabled. */
+export declare const MESSAGE_CONTENT_DISABLED_WARNING = "Enable the MESSAGE CONTENT intent in the Discord Developer Portal \u2014 the bot can't read channel messages without it.";
+/** Bot identity surfaced by the probe (from `/users/@me`). */
+export interface DiscordProbeBot {
+    /** Bot user id (snowflake). */
+    id?: string;
+    /** Bot username. */
+    name?: string;
+    /** Discriminator (legacy `#0001`) when present. */
+    discriminator?: string;
+}
+/** Structured probe result. `ok` true ⇒ token valid + Discord reachable. */
+export interface DiscordProbeResult {
+    ok: boolean;
+    /** HTTP status of the `/users/@me` call, when one came back. */
+    status?: number;
+    /** Operator-facing error line when `ok` is false. */
+    error?: string;
+    /** Round-trip time in ms. */
+    elapsedMs: number;
+    /** Bot identity (populated on success). */
+    bot?: DiscordProbeBot;
+    /**
+     * Epoch ms of the most recent inbound event seen by the STARTED adapter for
+     * this account, when one is running (liveness signal — `/users/@me` proves the
+     * token but not that the Gateway stream is flowing). `null` when no inbound has
+     * arrived yet; `undefined` when the probe couldn't consult a live adapter (a
+     * cold status check before the channel started). Observability only — a stale
+     * value never means "unhealthy" (a quiet channel is idle, not down).
+     */
+    lastEventAt?: number | null;
+    /**
+     * State of the privileged MESSAGE CONTENT intent, decoded from the bot's
+     * application flags. `"disabled"` is the #1 Discord footgun — the bot connects
+     * fine but silently can't read channel messages. `undefined` when the flags
+     * check was skipped or failed (best-effort; never fails the probe).
+     */
+    messageContentIntent?: MessageContentIntentState;
+    /**
+     * Operator-facing warning when {@link messageContentIntent} is `"disabled"`.
+     * `undefined` otherwise. The status surface renders it so the operator knows to
+     * flip the intent toggle.
+     */
+    messageContentWarning?: string;
+    /**
+     * Full decode of ALL three privileged gateway intents (message content, guild
+     * members, presence). `undefined` when the flags check was skipped / failed.
+     * `messageContentIntent` above is kept for back-compat; this carries the other
+     * two so diagnostics can flag a disabled GUILD MEMBERS / PRESENCE intent too.
+     */
+    privilegedIntents?: DiscordPrivilegedIntents;
+}
+export interface DiscordProbeArgs {
+    /** The resolved bot token. NEVER logged. */
+    token: string;
+    /** Injectable fetch (defaults to global fetch) — lets tests stub the call. */
+    fetchImpl?: typeof fetch;
+    /** Probe timeout in ms (default 8s). */
+    timeoutMs?: number;
+}
+/**
+ * Run a `GET /users/@me` probe. Resolves to a structured result describing
+ * whether the token is valid + Discord is reachable, plus the bot identity. On
+ * success it ALSO best-effort decodes the privileged MESSAGE CONTENT intent
+ * (`/oauth2/applications/@me` → `flags`) and surfaces a warning when it's
+ * disabled — without that intent the bot connects but can't read channel
+ * messages. Never rejects.
+ */
+export declare function probeDiscord(args: DiscordProbeArgs): Promise<DiscordProbeResult>;
+//# sourceMappingURL=probe.d.ts.map

package/dist/agents/channels/discord/probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../../../src/agents/channels/discord/probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AA8BH,oDAAoD;AACpD,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAC3E,qEAAqE;AACrE,MAAM,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAE9D,uEAAuE;AACvE,MAAM,WAAW,wBAAwB;IACxC,cAAc,EAAE,qBAAqB,CAAC;IACtC,YAAY,EAAE,qBAAqB,CAAC;IACpC,QAAQ,EAAE,qBAAqB,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,yBAAyB,GAAG,SAAS,CAKhG;AASD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,GAAG,SAAS,CAO5F;AAED,oFAAoF;AACpF,eAAO,MAAM,gCAAgC,6HACyE,CAAC;AAEvH,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC/B,+BAA+B;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,4EAA4E;AAC5E,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,yBAAyB,CAAC;IACjD;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;CAC7C;AAED,MAAM,WAAW,gBAAgB;IAChC,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AA2BD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA0EtF"}