@moda-labs/bobi-events-core 0.1.0

package/dist/channels.js

@@ -0,0 +1,499 @@
+/**
+ * Channel adapters - outbound contract for the channel gateway (#190 Phase 2).
+ *
+ * Each chat channel is one adapter implementing this contract, registered in
+ * CHANNEL_ADAPTERS. The generic /channels/* handlers in core.ts parse a
+ * conversation reference, resolve the sending credential, and delegate here;
+ * they never learn platform semantics. Capability degradation is the
+ * gateway's job: an `update` on a channel without edit support becomes a
+ * follow-up post, `typing` on a channel without indicators is a silent no-op.
+ *
+ * The Slack adapter is built on the Chat SDK's api module
+ * (@chat-adapter/slack/api) - the same package whose webhook parser serves
+ * inbound (adapters/chat-sdk-slack.ts). Outbound text arrives as markdown and
+ * is delivered natively via Slack's `markdown_text`, so callers never convert
+ * client-side.
+ */
+import { postSlackMessage, updateSlackMessage, uploadSlackFiles, fetchSlackThreadReplies, callSlackApi, SlackApiError, } from "@chat-adapter/slack/api";
+// Slack Web API base. Overridable so integration tests can stub the Slack
+// API with a local server (local.ts wires BOBI_ES_SLACK_API_URL); production
+// always uses the default. Must end with "/" - the SDK resolves method names
+// relative to it.
+const DEFAULT_SLACK_API_URL = "https://slack.com/api/";
+let slackApiUrlOverride;
+export function setSlackApiUrl(url) {
+    slackApiUrlOverride = url ? (url.endsWith("/") ? url : `${url}/`) : undefined;
+}
+export function slackApiUrl() {
+    return slackApiUrlOverride ?? DEFAULT_SLACK_API_URL;
+}
+// Meta Graph API base for WhatsApp Cloud API calls. Overridable so tests can
+// stub the Graph API with a local server (local.ts wires
+// BOBI_ES_WHATSAPP_API_URL); production always uses the default.
+const DEFAULT_WHATSAPP_API_URL = "https://graph.facebook.com/v23.0/";
+let whatsappApiUrlOverride;
+export function setWhatsAppApiUrl(url) {
+    whatsappApiUrlOverride = url ? (url.endsWith("/") ? url : `${url}/`) : undefined;
+}
+export function whatsappApiUrl() {
+    return whatsappApiUrlOverride ?? DEFAULT_WHATSAPP_API_URL;
+}
+/**
+ * Outbound budget enforcement (#651). Terminal sends (post / final) go out
+ * whole as natural-boundary chunks via chunkForChannel; streaming updates
+ * rewrite one message in place, so they stay on truncateForChannel - chunking
+ * a rewrite would post a new message on every tick.
+ */
+const TRUNCATION_MARKER = "\n_(truncated)_";
+/** Runaway guard: past this many chunks the tail is truncated with the marker. */
+const MAX_CHUNKS = 8;
+/** Appended to a chunk that splits inside a code fence, so it renders closed. */
+const FENCE_CLOSE = "\n```";
+/** Length of `s` in the channel's declared unit. */
+function unitLength(s, caps) {
+    if (caps.lengthUnit === "utf16")
+        return s.length;
+    let n = 0;
+    for (const _ch of s)
+        n++;
+    return n;
+}
+/**
+ * UTF-16 index covering at most `units` of `s` in the channel's unit, never
+ * splitting a surrogate pair.
+ */
+function unitIndex(s, units, caps) {
+    if (units <= 0)
+        return 0;
+    let idx;
+    if (caps.lengthUnit === "utf16") {
+        idx = Math.min(units, s.length);
+    }
+    else {
+        idx = 0;
+        let counted = 0;
+        for (const ch of s) {
+            if (counted >= units)
+                break;
+            idx += ch.length;
+            counted++;
+        }
+    }
+    // Never split a surrogate pair: if the boundary lands between a high and
+    // low surrogate, step back one unit.
+    if (idx > 0 && idx < s.length) {
+        const cc = s.charCodeAt(idx - 1);
+        if (cc >= 0xd800 && cc <= 0xdbff)
+            idx--;
+    }
+    return idx;
+}
+export function truncateForChannel(text, caps) {
+    if (unitLength(text, caps) <= caps.maxLength)
+        return text;
+    // The marker must fit INSIDE the budget - maxLength is the channel's hard
+    // limit, and overshooting it fails the whole send (msg_too_long).
+    const keep = unitIndex(text, caps.maxLength - TRUNCATION_MARKER.length, caps);
+    return text.slice(0, keep) + TRUNCATION_MARKER;
+}
+/**
+ * Fence state after scanning `s`. `open` is "" outside a fence, else the
+ * fence header to reopen with (e.g. "```python"). Fence lines toggle; an
+ * opening line's info string is preserved for reopening. The info string may
+ * not contain backticks (per CommonMark), which keeps a line-leading inline
+ * span like ```cmd``` from reading as an opener; an implausibly long "info
+ * string" (a one-line blob that happens to start with backticks) reopens as
+ * a bare fence so the carried prefix can never blow the chunk budget.
+ */
+const MAX_FENCE_HEADER = 24;
+function fenceStateAfter(s, open) {
+    for (const line of s.split("\n")) {
+        const m = line.match(/^\s*(`{3,})([^`]*)$/);
+        if (!m)
+            continue;
+        if (open) {
+            open = "";
+        }
+        else {
+            const info = m[2].trim();
+            open = info.length > MAX_FENCE_HEADER ? m[1] : m[1] + info;
+        }
+    }
+    return open;
+}
+/**
+ * Split over-budget text into channel-sized chunks at natural boundaries:
+ * paragraph break, then line break, then a hard (surrogate-safe) cut. A split
+ * inside a code fence closes the fence at the chunk end and reopens it (with
+ * its info string) at the start of the next chunk, so every chunk renders.
+ * Within-budget text comes back as a single chunk, byte-identical.
+ */
+export function chunkForChannel(text, caps) {
+    if (unitLength(text, caps) <= caps.maxLength)
+        return [text];
+    const chunks = [];
+    let remaining = text;
+    let reopen = ""; // fence header carried into the next chunk
+    while (chunks.length < MAX_CHUNKS - 1) {
+        const prefix = reopen ? reopen + "\n" : "";
+        if (unitLength(prefix, caps) + unitLength(remaining, caps) <= caps.maxLength) {
+            chunks.push(prefix + remaining);
+            return chunks;
+        }
+        // Reserve room for the prefix and a possible fence close so the chunk
+        // never overshoots the hard limit (over-reserving costs a few chars).
+        const avail = Math.max(1, caps.maxLength - unitLength(prefix, caps) - unitLength(FENCE_CLOSE, caps));
+        const windowEnd = unitIndex(remaining, avail, caps);
+        const window = remaining.slice(0, windowEnd);
+        // Natural boundaries, but never a blank chunk: a cut that leaves only
+        // whitespace (e.g. leading newlines) would fail the whole send.
+        let cut = window.lastIndexOf("\n\n");
+        if (cut <= 0 || !window.slice(0, cut).trim())
+            cut = window.lastIndexOf("\n");
+        if (cut <= 0 || !window.slice(0, cut).trim())
+            cut = windowEnd; // hard split, surrogate-safe
+        const head = remaining.slice(0, cut);
+        remaining = remaining.slice(cut).replace(/^\n+/, "");
+        reopen = fenceStateAfter(head, reopen);
+        let chunk = prefix + head;
+        if (reopen)
+            chunk += FENCE_CLOSE;
+        chunks.push(chunk);
+    }
+    // Chunk-count guard hit: truncate the tail instead of posting unbounded
+    // follow-ups for pathological input, keeping any open fence closed so the
+    // final chunk still renders.
+    const prefix = reopen ? reopen + "\n" : "";
+    let tail = truncateForChannel(prefix + remaining, caps);
+    if (fenceStateAfter(tail, "")) {
+        tail = truncateForChannel(prefix + remaining, { ...caps, maxLength: caps.maxLength - unitLength(FENCE_CLOSE, caps) }) + FENCE_CLOSE;
+    }
+    chunks.push(tail);
+    return chunks;
+}
+function slackError(err) {
+    if (err instanceof SlackApiError) {
+        return err.response?.error || err.message;
+    }
+    return String(err);
+}
+function toConversationMessage(raw) {
+    const entry = {
+        user: raw.user || "",
+        text: raw.text || "",
+        ts: raw.ts || "",
+    };
+    const rawFiles = raw.files;
+    if (Array.isArray(rawFiles) && rawFiles.length > 0) {
+        entry.files = rawFiles.map((f) => ({
+            id: String(f.id ?? ""),
+            name: String(f.name ?? ""),
+            mimetype: String(f.mimetype ?? ""),
+            url_private: String(f.url_private ?? ""),
+        }));
+    }
+    return entry;
+}
+// Message body for a Slack post/update. Raw markdown goes out as Slack's
+// native `markdown_text` (AST-rendered by Slack, 12k budget).
+function slackContent(text) {
+    return { markdownText: text };
+}
+const slackAdapter = {
+    descriptor: {
+        name: "slack",
+        topicShape: "slack:<team_id>[:app:<app_id>][:<channel>]",
+        transport: "webhook",
+        capabilities: {
+            edit: true,
+            typing: true,
+            streaming: "native",
+            threads: true,
+            files: true,
+            // Slack's markdown_text limit; plain text allows ~40k but the
+            // gateway sends markdown, so the stricter budget applies. The
+            // budget has always been enforced in UTF-16 units (JS .length);
+            // declare that unit so chunking keeps the proven behavior.
+            maxLength: 12000,
+            lengthUnit: "utf16",
+        },
+        credentials: [
+            { env: "SLACK_BOT_TOKEN", secret: true, label: "Bot User OAuth Token" },
+            { env: "SLACK_SIGNING_SECRET", secret: true, label: "App Signing Secret" },
+        ],
+        promptHint: "Slack renders standard markdown. Keep replies concise; use "
+            + "triple-backtick blocks for multi-line code.",
+        setupSkill: "skills/slack-setup.md",
+    },
+    async send(token, conv, text) {
+        try {
+            const posted = await postSlackMessage({
+                apiUrl: slackApiUrl(),
+                token,
+                channel: conv.chatId,
+                ...(conv.threadId ? { threadTs: conv.threadId } : {}),
+                ...slackContent(text),
+            });
+            return { ok: true, ts: posted.id };
+        }
+        catch (err) {
+            return { ok: false, error: slackError(err) };
+        }
+    },
+    async update(token, conv, messageId, text) {
+        try {
+            const posted = await updateSlackMessage({
+                apiUrl: slackApiUrl(),
+                token,
+                channel: conv.chatId,
+                ts: messageId,
+                ...slackContent(text),
+            });
+            return { ok: true, ts: posted.id };
+        }
+        catch (err) {
+            return { ok: false, error: slackError(err) };
+        }
+    },
+    // Slack's "typing" is the assistant thread status ("is thinking..."),
+    // which only exists in thread context and expires after ~2 minutes -
+    // callers refresh while work runs. Best-effort: only DM threads support
+    // it, so failures are swallowed.
+    async typing(token, conv, on) {
+        if (!conv.threadId)
+            return;
+        try {
+            await callSlackApi("assistant.threads.setStatus", {
+                channel_id: conv.chatId,
+                thread_ts: conv.threadId,
+                status: on ? "is thinking…" : "",
+            }, { apiUrl: slackApiUrl(), token });
+        }
+        catch {
+            // non-fatal
+        }
+    },
+    async fetchConversation(token, conv, limit = 100) {
+        // A ref without a thread anchor reads the channel/DM history instead
+        // of thread replies (e.g. a proactive conversation with no thread).
+        if (!conv.threadId) {
+            const raw = await callSlackApi("conversations.history", {
+                channel: conv.chatId,
+                limit: Math.min(limit, 200),
+            }, { apiUrl: slackApiUrl(), token });
+            const rows = raw.messages ?? [];
+            // conversations.history returns newest-first; deliver oldest-first
+            // to match the thread-replies ordering.
+            return rows.map(toConversationMessage).reverse().slice(0, limit);
+        }
+        const messages = [];
+        let cursor;
+        while (messages.length < limit) {
+            const page = await fetchSlackThreadReplies({
+                apiUrl: slackApiUrl(),
+                token,
+                channel: conv.chatId,
+                ts: conv.threadId,
+                limit: Math.min(limit - messages.length, 200),
+                ...(cursor ? { cursor } : {}),
+            });
+            for (const raw of page.messages) {
+                messages.push(toConversationMessage(raw));
+            }
+            cursor = page.nextCursor;
+            if (!cursor)
+                break;
+        }
+        return messages.slice(0, limit);
+    },
+    async uploadFiles(token, conv, files, comment) {
+        try {
+            const result = await uploadSlackFiles(files.map((f) => ({
+                data: f.data,
+                filename: f.name,
+                ...(f.title ? { title: f.title } : {}),
+            })), {
+                apiUrl: slackApiUrl(),
+                token,
+                channelId: conv.chatId,
+                ...(conv.threadId ? { threadTs: conv.threadId } : {}),
+                ...(comment ? { initialComment: comment } : {}),
+            });
+            return { ok: true, ts: result.fileIds[0] };
+        }
+        catch (err) {
+            return { ok: false, error: slackError(err) };
+        }
+    },
+};
+// --- WhatsApp (Meta Cloud API) - #656, epic #190 Phase 3 ---
+// One Graph API call. Returns the parsed JSON body; throws on transport
+// errors; a Graph error body ({error: {message}}) is surfaced by callers.
+export async function whatsappApi(token, path, init) {
+    const headers = { Authorization: `Bearer ${token}` };
+    // Structural (not BodyInit): only these two shapes are ever built, and
+    // the name resolves under every lib variant this file compiles against
+    // (dom for the published dist, @types/node for the in-repo build).
+    let body;
+    if (init.json !== undefined) {
+        headers["Content-Type"] = "application/json";
+        body = JSON.stringify(init.json);
+    }
+    else if (init.form) {
+        body = init.form; // fetch sets the multipart boundary itself
+    }
+    const resp = await fetch(`${whatsappApiUrl()}${path}`, {
+        method: init.method ?? "POST",
+        headers,
+        ...(body !== undefined ? { body } : {}),
+    });
+    return (await resp.json());
+}
+// Meta's cap for media/document captions, distinct from the 4096 text limit.
+const WHATSAPP_CAPTION_LIMIT = 1024;
+function whatsappError(data) {
+    const err = data.error;
+    return err?.message || "whatsapp api error";
+}
+const whatsappAdapter = {
+    descriptor: {
+        name: "whatsapp",
+        topicShape: "whatsapp:<phone_number_id>",
+        transport: "webhook",
+        capabilities: {
+            // No message editing on WhatsApp - the gateway degrades placeholder
+            // edits to follow-up posts. No typing indicator, no threads, no
+            // native streaming: reactive-only replies (epic #190 Phase 3).
+            edit: false,
+            typing: false,
+            streaming: "none",
+            threads: false,
+            files: true,
+            // Cloud API text body limit, counted in characters (code points) -
+            // the unit-aware budget #651 wired in.
+            maxLength: 4096,
+            lengthUnit: "chars",
+            // Meta's customer-service window: replies are free-form for 24h
+            // after the user's last inbound message; outside it only template
+            // messages send (template support is a follow-up - the gateway
+            // returns a typed error so the agent can report the situation).
+            messageWindow: { hours: 24, outsideWindow: "template" },
+        },
+        credentials: [
+            { env: "WHATSAPP_ACCESS_TOKEN", secret: true, label: "Cloud API access token" },
+            { env: "WHATSAPP_PHONE_NUMBER_ID", secret: false, label: "Phone number ID" },
+            { env: "WHATSAPP_APP_SECRET", secret: true, label: "Meta app secret (webhook signatures)" },
+            { env: "WHATSAPP_VERIFY_TOKEN", secret: true, label: "Webhook verify token (your choice)" },
+        ],
+        promptHint: "WhatsApp renders its own light formatting (*bold*, _italic_, "
+            + "```monospace```), not full markdown. Keep replies short and "
+            + "conversational; avoid headers and tables.",
+        setupSkill: "skills/whatsapp-setup.md",
+    },
+    async send(token, conv, text) {
+        try {
+            const data = await whatsappApi(token, `${conv.scope}/messages`, {
+                json: {
+                    messaging_product: "whatsapp",
+                    to: conv.chatId,
+                    type: "text",
+                    text: { body: text },
+                },
+            });
+            const id = data.messages?.[0]?.id;
+            if (!id)
+                return { ok: false, error: whatsappError(data) };
+            return { ok: true, ts: id };
+        }
+        catch (err) {
+            return { ok: false, error: String(err) };
+        }
+    },
+    // Two-step Cloud API upload: POST the bytes to /{pnid}/media, then send a
+    // document message referencing the media id. Sent as `document` for any
+    // mime type - it preserves the filename and works for all content. The
+    // media endpoint validates the declared MIME, so it is inferred from the
+    // filename (octet-stream is not on Meta's supported list).
+    async uploadFiles(token, conv, files, comment) {
+        let delivered = 0;
+        try {
+            let lastId = "";
+            for (const [i, f] of files.entries()) {
+                const mime = mimeForFilename(f.name);
+                const form = new FormData();
+                form.append("messaging_product", "whatsapp");
+                form.append("type", mime);
+                form.append("file", new Blob([f.data], { type: mime }), f.name);
+                const uploaded = await whatsappApi(token, `${conv.scope}/media`, { form });
+                const mediaId = uploaded.id;
+                if (!mediaId)
+                    return { ok: false, error: partialUploadError(whatsappError(uploaded), i, files.length) };
+                // Media captions have their own Cloud API limit (1024 chars),
+                // well below the 4096 text-body cap the gateway budget uses.
+                const caption = (i === 0 ? comment || f.title || "" : f.title || "")
+                    .slice(0, WHATSAPP_CAPTION_LIMIT);
+                const sent = await whatsappApi(token, `${conv.scope}/messages`, {
+                    json: {
+                        messaging_product: "whatsapp",
+                        to: conv.chatId,
+                        type: "document",
+                        document: {
+                            id: mediaId,
+                            filename: f.name,
+                            ...(caption ? { caption } : {}),
+                        },
+                    },
+                });
+                const id = sent.messages?.[0]?.id;
+                if (!id)
+                    return { ok: false, error: partialUploadError(whatsappError(sent), i, files.length) };
+                lastId = id;
+                delivered = i + 1;
+            }
+            return { ok: true, ts: lastId };
+        }
+        catch (err) {
+            return { ok: false, error: partialUploadError(String(err), delivered, files.length) };
+        }
+    },
+};
+// Mirror the chunk path's partial-delivery contract: once any file reached
+// the user, the error must tell the caller not to blind-retry the batch.
+function partialUploadError(error, delivered, total) {
+    if (delivered === 0)
+        return error;
+    return `file ${delivered + 1}/${total} failed after partial delivery `
+        + `(do not resend; ${delivered} file(s) are already visible): ${error}`;
+}
+// Minimal extension map for the document types agents actually send. Meta's
+// media endpoint rejects MIME types outside its supported list
+// (application/octet-stream is not on it), so unknowns go out as text/plain.
+const MIME_BY_EXT = {
+    pdf: "application/pdf",
+    txt: "text/plain",
+    md: "text/plain",
+    csv: "text/csv",
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    webp: "image/webp",
+    mp4: "video/mp4",
+    doc: "application/msword",
+    docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    xls: "application/vnd.ms-excel",
+    xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    zip: "application/zip",
+};
+function mimeForFilename(name) {
+    const ext = name.toLowerCase().split(".").pop() || "";
+    return MIME_BY_EXT[ext] || "text/plain";
+}
+const CHANNEL_ADAPTERS = {
+    slack: slackAdapter,
+    whatsapp: whatsappAdapter,
+};
+export function getChannelAdapter(source) {
+    return CHANNEL_ADAPTERS[source];
+}
+//# sourceMappingURL=channels.js.map

package/dist/channels.js.map

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

package/dist/circuit-breaker.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Delivery-path circuit breaker (#299, split from #215 loop-safety).
+ *
+ * Keying decision: the breaker keys on `(deployment_id, conversation)` where
+ * conversation is derived from external channel identity:
+ *   - Slack: thread_ts (or ts if no thread)
+ *   - GitHub: repo + issue/PR number
+ *   - Other: event type (coarse — acceptable because custom events rarely loop)
+ *
+ * EXEMPTIONS: `inbox/*` and `reply/*` topics are legitimate internal
+ * agent↔agent comms and are NEVER counted toward the breaker. They flow
+ * through a separate routing namespace (`agent/*` topics) that does not
+ * represent external conversation depth.
+ *
+ * Trip condition: ≥ THRESHOLD non-human-authored deliveries in one key within
+ * WINDOW_MS with zero human events → pause delivery for that key (buffered,
+ * not dropped). Emit `system.loop_detected`. Auto-resume after COOLDOWN_MS or
+ * on the next human-authored event in the same key.
+ */
+import type { NormalizedEvent } from "./core.js";
+export declare const BREAKER_THRESHOLD = 5;
+export declare const BREAKER_WINDOW_MS = 60000;
+export declare const BREAKER_COOLDOWN_MS = 300000;
+export interface BreakerState {
+    /** Timestamps of non-human deliveries within the current window */
+    timestamps: number[];
+    /** Whether the breaker is currently tripped */
+    tripped: boolean;
+    /** When the breaker was tripped (epoch ms), undefined if not tripped */
+    trippedAt?: number;
+    /** Events paused while tripped — delivered on resume */
+    paused: NormalizedEvent[];
+}
+export interface BreakerVerdict {
+    /** Whether delivery should proceed */
+    allow: boolean;
+    /** Whether this delivery tripped the breaker (first trip) */
+    justTripped: boolean;
+}
+/**
+ * Returns true if this event's type is exempt from breaker counting.
+ * inbox/* and reply/* are internal agent↔agent comms, not external
+ * conversation depth.
+ */
+export declare function isExemptFromBreaker(event: NormalizedEvent): boolean;
+/**
+ * Extract the conversation key from an event. Returns null if no meaningful
+ * conversation can be identified (breaker won't apply).
+ */
+export declare function conversationKey(event: NormalizedEvent): string | null;
+/**
+ * Determine whether an event is authored by a bot (non-human).
+ * Human-authored events reset the breaker window.
+ */
+export declare function isBotAuthored(event: NormalizedEvent): boolean;
+/**
+ * Record a delivery attempt and return a verdict.
+ *
+ * Call this BEFORE actually delivering the event. If `allow` is false,
+ * the caller must buffer the event (it is already added to state.paused).
+ */
+export declare function recordDelivery(deploymentId: string, event: NormalizedEvent): BreakerVerdict;
+/**
+ * Drain paused events for a deployment+conversation. Returns the events
+ * that were buffered and clears the pause buffer. The caller is responsible
+ * for delivering them.
+ */
+export declare function drainPaused(deploymentId: string, event: NormalizedEvent): NormalizedEvent[];
+/**
+ * Check whether a breaker is currently tripped for a deployment+conversation.
+ * Used after cooldown to decide whether to flush paused events.
+ */
+export declare function isBreakerTripped(deploymentId: string, convKey: string): boolean;
+/**
+ * Build the system.loop_detected event to be published.
+ */
+export declare function buildLoopDetectedEvent(deploymentId: string, convKey: string, triggerEvent: NormalizedEvent): NormalizedEvent;
+export declare function resetAllBreakers(): void;
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../src/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAMjD,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,iBAAiB,QAAS,CAAC;AACxC,eAAO,MAAM,mBAAmB,SAAU,CAAC;AAM3C,MAAM,WAAW,YAAY;IAC5B,mEAAmE;IACnE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,MAAM,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC9B,sCAAsC;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,6DAA6D;IAC7D,WAAW,EAAE,OAAO,CAAC;CACrB;AAaD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAanE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAmDrE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CA4B7D;AAkCD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC7B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,eAAe,GACpB,cAAc,CAsChB;AAaD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,eAAe,EAAE,CAQ3F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAS/E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACrC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,eAAe,GAC3B,eAAe,CAyBjB;AAMD,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}