@komaa/standin-sdk 0.1.0

package/dist/chat.js

@@ -0,0 +1,574 @@
+// Copyright (c) 2026 Komaa DigiTech
+// SPDX-License-Identifier: MIT
+/**
+ * The messages lane: Microsoft Teams chat, without a bot credential.
+ *
+ * Managed connections only. StandIn owns the Microsoft Teams bot, authenticates the
+ * activity, resolves it to your connection and strips the bot @mention. Your
+ * handler returns text and StandIn performs the Microsoft Teams send, so your agent never
+ * holds a Bot Framework credential.
+ *
+ * Same shape as the call lane: the worker dials OUT and StandIn pushes messages
+ * down that socket, so there is no listener, no port to expose and no tunnel.
+ *
+ *     Microsoft Teams message
+ *          |
+ *          v
+ *     StandIn gateway        (authenticates, normalizes, signs)
+ *          |   pushed down the worker's outbound socket
+ *          v
+ *     ChatChannel            (this class)
+ *          |   your async handler returns reply text
+ *          v
+ *     back up the same socket; StandIn sends it to Microsoft Teams
+ *
+ * The twin of the Python SDK's `standin/sdk/chat.py`, method for method, with
+ * this language's casing. The shared conformance vectors assert both parse and
+ * build identical wire payloads.
+ */
+import { WebSocket } from "ws";
+import { StandInError } from "./errors.js";
+import { SIGNATURE_HEADER, TIMESTAMP_HEADER, nowMs, signHandshake, } from "./hmac.js";
+import { logger } from "./log.js";
+/**
+ * chat-schema.yaml SCHEMA_VERSION. A MAJOR version: additive evolution does not
+ * bump it, because the schema already requires receivers to ignore unknown
+ * fields. An integer above ours therefore means incompatible semantics.
+ */
+export const SCHEMA_VERSION = 1;
+export const DEFAULT_CHAT_URL = "wss://teams.standin.komaa.com/api/chat/channel";
+/**
+ * What may be rendered inline in a reply. Raster only, and the decoded bytes
+ * must actually carry the type's signature.
+ *
+ * `image/svg+xml` is deliberately absent and is not a gap to fill later. SVG is
+ * scriptable XML, which is precisely what "an image" must not be.
+ */
+export const OUTBOUND_IMAGE_CONTENT_TYPES = [
+    "image/png",
+    "image/jpeg",
+    "image/gif",
+    "image/webp",
+];
+/** What an inline image may weigh, decoded. */
+export const OUTBOUND_IMAGE_MAX_BYTES = 1024 * 1024;
+/**
+ * The first bytes each allowed type must begin with. A declared type is a claim;
+ * this is the check. Without it an HTML page or an SVG labelled image/png is
+ * posted under this bot's name.
+ */
+const IMAGE_MAGIC = {
+    "image/png": [Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a])],
+    "image/jpeg": [Buffer.from([0xff, 0xd8, 0xff])],
+    "image/gif": [Buffer.from("GIF87a"), Buffer.from("GIF89a")],
+    "image/webp": [Buffer.from("RIFF")],
+};
+/** A filename reaches a chat as a download. One path-free segment, bounded. */
+const MAX_IMAGE_NAME_CHARS = 200;
+/**
+ * One path-free segment, bounded, or undefined.
+ *
+ * A filename reaches a chat as a download under this bot's identity, and the
+ * model that chose it is being steered by whoever is in the conversation.
+ */
+export function sanitizeImageName(name) {
+    if (!name)
+        return undefined;
+    let segment = name.replace(/\\/g, "/").split("/").pop() ?? "";
+    segment = [...segment]
+        .filter((ch) => ch >= " " && !'<>:"|?*'.includes(ch))
+        .join("")
+        .trim();
+    if (segment === "" || segment === "." || segment === "..")
+        return undefined;
+    if (segment.length > MAX_IMAGE_NAME_CHARS) {
+        const dot = segment.lastIndexOf(".");
+        const extension = dot > 0 ? segment.slice(dot + 1) : "";
+        const keep = MAX_IMAGE_NAME_CHARS - extension.length - 1;
+        segment =
+            extension !== "" && keep > 0
+                ? `${segment.slice(0, keep)}.${extension}`
+                : segment.slice(0, MAX_IMAGE_NAME_CHARS);
+    }
+    return segment;
+}
+/** What these bytes actually are, or undefined. */
+export function sniffImageType(data) {
+    for (const [contentType, signatures] of Object.entries(IMAGE_MAGIC)) {
+        if (!signatures.some((sig) => data.subarray(0, sig.length).equals(sig)))
+            continue;
+        // A RIFF container is only a webp when it says so.
+        if (contentType === "image/webp" &&
+            data.subarray(8, 12).toString("ascii") !== "WEBP")
+            continue;
+        return contentType;
+    }
+    return undefined;
+}
+/**
+ * Check a picture and build the wire form. Throws on anything it will not send.
+ *
+ * Three checks, and the second is the one that matters. A declared type is a
+ * claim made by whatever produced the bytes; the signature is what they are.
+ * Without it an HTML document or an SVG labelled `image/png` is posted into
+ * somebody's chat under this bot's name.
+ */
+export function outboundImage(data, contentType, name) {
+    const raw = typeof data === "string" ? Buffer.from(data, "base64") : data;
+    let declared = contentType.trim().toLowerCase();
+    // A common spelling that is not a media type.
+    if (declared === "image/jpg")
+        declared = "image/jpeg";
+    if (!OUTBOUND_IMAGE_CONTENT_TYPES.includes(declared)) {
+        throw new Error(`${JSON.stringify(contentType)} cannot be sent inline; it must be one of ` +
+            OUTBOUND_IMAGE_CONTENT_TYPES.join(", "));
+    }
+    if (raw.length > OUTBOUND_IMAGE_MAX_BYTES) {
+        throw new Error(`that image is ${raw.length} bytes, over the ${OUTBOUND_IMAGE_MAX_BYTES} limit`);
+    }
+    const actual = sniffImageType(raw);
+    if (actual !== declared) {
+        throw new Error(`those bytes are not ${declared}: they look like ${actual ?? "something else"}`);
+    }
+    const safe = sanitizeImageName(name);
+    return {
+        contentType: declared,
+        contentBase64: raw.toString("base64"),
+        ...(safe === undefined ? {} : { name: safe }),
+    };
+}
+function imageToWire(image) {
+    const wire = {
+        contentType: image.contentType,
+        contentBase64: image.contentBase64,
+    };
+    if (image.name)
+        wire.name = image.name;
+    return wire;
+}
+/** How long one turn may run before it is abandoned. Serialization means a hung
+ * turn would wedge its conversation forever, so every turn is bounded. Generous:
+ * agent turns legitimately run long. */
+const TURN_TIMEOUT_MS = 300_000;
+/** 2 MB bounds a single inbound message, matching the call lane. */
+const MAX_PAYLOAD_BYTES = 2 * 1024 * 1024;
+/** True when the message came from a 1:1 chat rather than a group or channel. */
+export function isPersonal(message) {
+    return message.scope === "personal";
+}
+/**
+ * How long a remembered 1:1 chat stays usable as a delivery target: 12 hours.
+ *
+ * Long enough to cover a working day, short enough that a conversation from
+ * last week is not treated as evidence of who is on the phone today.
+ */
+export const CHAT_FALLBACK_WINDOW_MS = 12 * 60 * 60 * 1000;
+/** How many people are remembered at once, oldest first out. */
+const MAX_REMEMBERED_CHATS = 512;
+/**
+ * The 1:1 chats this bot has been messaged in, so a call can be answered in one.
+ *
+ * A 1:1 CALL carries no thread id and no conversation to post into, so the only
+ * honest source of the caller's own chat is a message they sent the bot from
+ * it. Feed this from the chat lane and read it from the call lane:
+ *
+ * ```ts
+ * const chats = new PersonalChats();
+ * const channel = new ChatChannel({ respond, chats });
+ * // later, on a call:
+ * const mine = chats.forCaller({ callerAadId, tenantId });
+ * ```
+ *
+ * Both lanes have to be in one process for that to work, or the memory has to
+ * be shared some other way. Until it is, a 1:1 recap can only be delivered to
+ * somebody who has messaged this bot inside {@link CHAT_FALLBACK_WINDOW_MS}.
+ *
+ * Nothing is remembered from a group or a channel. That is decided by the
+ * message's SCOPE and by nothing else: an @mention in a team channel would
+ * otherwise make that channel the caller's "chat" and put a private escalation
+ * in front of their whole team.
+ */
+export class PersonalChats {
+    /** Keyed by tenant and person, in order of last seen, and bounded. */
+    #chats = new Map();
+    #windowMs;
+    constructor(windowMs = CHAT_FALLBACK_WINDOW_MS) {
+        this.#windowMs = windowMs;
+    }
+    /**
+     * Record a 1:1 chat. Anything else is ignored, including a message whose
+     * conversation id merely looks personal.
+     */
+    remember(message, atMs = nowMs()) {
+        // Scope, and only scope. A bot's personal chat is addressed "a:1..." while
+        // "19:..." is precisely the group and channel shape this excludes, so an
+        // id-prefix test rejects every real personal chat and admits nothing.
+        if (!isPersonal(message))
+            return;
+        const conversationId = (message.conversationId ?? "").trim();
+        const tenantId = (message.tenantId ?? "").trim();
+        if (conversationId === "" || tenantId === "")
+            return;
+        const aadId = (message.senderAadId ?? "").trim();
+        const key = chatKey(tenantId, aadId);
+        // Re-inserted rather than overwritten: a Map keeps insertion order, and
+        // that order is what decides who is forgotten first.
+        this.#chats.delete(key);
+        this.#chats.set(key, {
+            conversationId,
+            tenantId,
+            aadId,
+            displayName: message.senderName ?? "",
+            atMs,
+        });
+        if (this.#chats.size > MAX_REMEMBERED_CHATS) {
+            const oldest = this.#chats.keys().next();
+            if (!oldest.done)
+                this.#chats.delete(oldest.value);
+        }
+    }
+    /**
+     * The chat a call may be answered in, or undefined when there is not one.
+     *
+     * Four things have to hold, and posting call content into the wrong
+     * conversation is the failure all four exist to prevent: the chat was a 1:1
+     * chat, it is in this tenant, it was seen inside
+     * {@link CHAT_FALLBACK_WINDOW_MS}, and the call names a caller whose AAD id
+     * is the one that sent it. Without that last rule every anonymous caller
+     * collapses onto whoever chatted last.
+     */
+    forCaller(options) {
+        const tenantId = (options.tenantId ?? "").trim();
+        if (tenantId === "")
+            return undefined;
+        const now = options.nowMs ?? nowMs();
+        const callerAadId = (options.callerAadId ?? "").trim();
+        if (callerAadId !== "") {
+            const chat = this.#chats.get(chatKey(tenantId, callerAadId));
+            return chat !== undefined && this.#fresh(chat, now) ? chat : undefined;
+        }
+        if (options.allowUnidentified !== true)
+            return undefined;
+        logger.warn("standin: allowUnidentified is on, so this call is being matched to whoever " +
+            "last messaged this bot in the tenant rather than to an identified caller");
+        let best;
+        for (const chat of this.#chats.values()) {
+            if (chat.tenantId !== tenantId || !this.#fresh(chat, now))
+                continue;
+            if (best === undefined || chat.atMs >= best.atMs)
+                best = chat;
+        }
+        return best;
+    }
+    #fresh(chat, now) {
+        return now - chat.atMs <= this.#windowMs;
+    }
+}
+/** A tenant and a person. The space cannot appear in either half. */
+function chatKey(tenantId, aadId) {
+    return `${tenantId} ${aadId}`;
+}
+/**
+ * Parse and validate an inbound message. Throws naming the problem; the caller
+ * maps that to HTTP 400.
+ */
+export function parseInbound(body) {
+    let raw;
+    try {
+        raw = JSON.parse(body);
+    }
+    catch {
+        throw new StandInError("malformed json");
+    }
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+        throw new StandInError("body must be an object");
+    }
+    const rec = raw;
+    for (const key of ["tenantId", "conversationId", "activityId"]) {
+        if (typeof rec[key] !== "string" || rec[key] === "") {
+            throw new StandInError(`${key} is required`);
+        }
+    }
+    const version = rec.schemaVersion ?? SCHEMA_VERSION;
+    if (typeof version === "number" &&
+        Number.isInteger(version) &&
+        version > SCHEMA_VERSION) {
+        throw new StandInError(`unsupported schemaVersion ${version} (this plugin speaks ${SCHEMA_VERSION})`);
+    }
+    const rawSender = rec.sender;
+    const sender = typeof rawSender === "object" && rawSender !== null
+        ? rawSender
+        : {};
+    const scope = rec.scope;
+    const str = (v) => typeof v === "string" ? v : undefined;
+    return {
+        tenantId: rec.tenantId,
+        conversationId: rec.conversationId,
+        activityId: rec.activityId,
+        // ChatScope is an OPEN enum: an unknown value relays as a group chat rather
+        // than being rejected.
+        scope: typeof scope === "string" && scope ? scope : "personal",
+        text: typeof rec.text === "string" ? rec.text : "",
+        senderName: str(sender.displayName),
+        senderAadId: str(sender.aadObjectId),
+        senderIsGuest: Boolean(sender.isGuest ?? false),
+        senderIsLinkedOwner: Boolean(sender.isLinkedOwner ?? false),
+        attachments: Array.isArray(rec.attachments)
+            ? rec.attachments
+            : [],
+        mentions: Array.isArray(rec.mentions) ? rec.mentions : [],
+        locale: str(rec.locale),
+        cardAction: typeof rec.cardAction === "object" &&
+            rec.cardAction !== null &&
+            !Array.isArray(rec.cardAction)
+            ? rec.cardAction
+            : undefined,
+        bindingId: str(rec.bindingId),
+    };
+}
+/**
+ * The gateway-bound reply. tenantId and conversationId echo the inbound
+ * EXACTLY: the gateway rejects a mismatch, and that check is the cross-tenant
+ * leak guard the whole relay rests on.
+ */
+export function buildReply(message, text, kind = "message", image) {
+    const reply = {
+        schemaVersion: SCHEMA_VERSION,
+        tenantId: message.tenantId,
+        conversationId: message.conversationId,
+        replyToId: message.activityId,
+        kind,
+        idempotencyKey: `${message.activityId}:${kind}`,
+    };
+    if (message.bindingId) {
+        // Which connection this reply is FROM. One tenant can have several, so the
+        // tenant alone no longer identifies the sender.
+        reply.bindingId = message.bindingId;
+    }
+    if (kind !== "typing") {
+        reply.text = text;
+        // A typing indicator carries neither: it is a state, not a message.
+        if (image !== undefined)
+            reply.image = imageToWire(image);
+    }
+    return reply;
+}
+/**
+ * At-least-once dedupe on the schema's activityId idempotency key. Bounded LRU:
+ * an aged-out redelivery running again is acceptable at-least-once behaviour, a
+ * fresh double-run is not.
+ */
+class Seen {
+    #capacity;
+    #seen = new Set();
+    constructor(capacity = 2048) {
+        this.#capacity = capacity;
+    }
+    markFirst(key) {
+        if (this.#seen.has(key))
+            return false;
+        this.#seen.add(key);
+        if (this.#seen.size > this.#capacity) {
+            // Set preserves insertion order, so the first entry is the oldest.
+            const oldest = this.#seen.values().next();
+            if (!oldest.done)
+                this.#seen.delete(oldest.value);
+        }
+        return true;
+    }
+}
+/**
+ * Answer Microsoft Teams messages with your agent.
+ *
+ * Dialed out from the worker, like the call lane, so nothing listens and there
+ * is nothing to expose. Managed connections only, and that needs no flag: the
+ * socket authenticates with your connection secret, so if it opens at all you
+ * are managed.
+ *
+ * ```ts
+ * const chat = new ChatChannel({
+ *   respond: async (msg) => `You said: ${msg.text}`,
+ * });
+ * await chat.start();
+ * ```
+ */
+export class ChatChannel {
+    #respond;
+    #secret;
+    #url;
+    #seen = new Seen();
+    #chats;
+    #ws;
+    #closed = false;
+    /**
+     * Per-conversation chains. The schema promises per-conversation ORDERING;
+     * independent tasks would let replies overtake each other.
+     */
+    #chains = new Map();
+    constructor(options) {
+        this.#secret =
+            options.secret ??
+                process.env.STANDIN_CHAT_SECRET ??
+                process.env.STANDIN_SECRET ??
+                "";
+        if (!this.#secret) {
+            throw new StandInError("a StandIn connection secret is required: pass secret or set STANDIN_SECRET");
+        }
+        this.#respond = options.respond;
+        this.#url = options.url ?? process.env.STANDIN_CHAT_URL ?? DEFAULT_CHAT_URL;
+        this.#chats = options.chats;
+    }
+    /** Dial StandIn and begin taking messages. */
+    async start() {
+        const timestamp = nowMs();
+        const ws = new WebSocket(this.#url, {
+            headers: {
+                [TIMESTAMP_HEADER]: String(timestamp),
+                // The channel NAME is what the handshake signs here, not the body. The
+                // POST relay lane signs the body instead; the two are different lanes
+                // and both are correct. Do not "fix" one into the other.
+                [SIGNATURE_HEADER]: signHandshake(this.#secret, timestamp, "chat"),
+            },
+            maxPayload: MAX_PAYLOAD_BYTES,
+        });
+        try {
+            await new Promise((resolve, reject) => {
+                ws.once("open", () => resolve());
+                ws.once("error", reject);
+            });
+        }
+        catch (err) {
+            ws.terminate();
+            throw err;
+        }
+        this.#ws = ws;
+        ws.on("message", (data, isBinary) => {
+            if (isBinary)
+                return;
+            this.#onMessage(data.toString("utf8"));
+        });
+        ws.on("error", (err) => {
+            logger.error(`standin: chat channel failed: ${String(err)}`);
+        });
+        logger.info("standin: chat channel open");
+    }
+    /** Stop taking messages and close the socket. */
+    async aclose() {
+        this.#closed = true;
+        // Let in-flight turns settle so a reply already handed to the agent is not
+        // silently dropped on shutdown.
+        await Promise.allSettled([...this.#chains.values()]);
+        this.#chains.clear();
+        const ws = this.#ws;
+        this.#ws = undefined;
+        if (ws !== undefined && ws.readyState === WebSocket.OPEN) {
+            try {
+                ws.close();
+            }
+            catch {
+                ws.terminate();
+            }
+        }
+    }
+    #onMessage(body) {
+        if (this.#closed)
+            return;
+        let inbound;
+        try {
+            inbound = parseInbound(body);
+        }
+        catch (err) {
+            logger.warn(`standin: dropping malformed chat message: ${String(err)}`);
+            return;
+        }
+        // Before the dedupe: a redelivery is still evidence that this person has a
+        // chat with this bot, and remembering it twice changes nothing.
+        this.#chats?.remember(inbound);
+        // The turn, though, runs once: StandIn is at-least-once, and a redelivery
+        // must not start a second turn for the same activity.
+        const key = `${inbound.tenantId}:${inbound.conversationId}:${inbound.activityId}`;
+        if (this.#seen.markFirst(key))
+            this.#enqueue(inbound);
+    }
+    #enqueue(message) {
+        const chainKey = `${message.tenantId}:${message.conversationId}`;
+        const previous = this.#chains.get(chainKey) ?? Promise.resolve();
+        // A failed turn must not dam the chain, so the previous rejection is
+        // swallowed HERE rather than propagated into this turn.
+        const next = previous
+            .catch(() => undefined)
+            .then(() => this.#process(message));
+        this.#chains.set(chainKey, next);
+        void next.finally(() => {
+            if (this.#chains.get(chainKey) === next)
+                this.#chains.delete(chainKey);
+        });
+    }
+    async #process(message) {
+        // Typing is a courtesy, so it must not sit in FRONT of the turn. Send it and
+        // let the agent think; the indicator still lands first.
+        this.#send(buildReply(message, "", "typing"));
+        try {
+            const text = await withTimeout(this.#respond(message), TURN_TIMEOUT_MS);
+            if (text && text.trim()) {
+                this.#send(buildReply(message, text));
+            }
+            else {
+                // After a typing indicator, silence looks exactly like a hang.
+                logger.warn("standin: chat handler returned an empty answer");
+                this.#send(buildReply(message, "I couldn't come up with an answer to that - try rephrasing, or ask something else.", "error"));
+            }
+        }
+        catch (err) {
+            logger.error(`standin: chat turn failed: ${String(err)}`);
+            this.#send(buildReply(message, "Something went wrong answering that - please try again.", "error"));
+        }
+    }
+    /**
+     * Post into a Microsoft Teams conversation with no inbound message to answer.
+     *
+     * Useful from inside a call. Best-effort: returns false rather than throwing,
+     * because a failed post must never break a live call.
+     */
+    async send(options) {
+        const payload = {
+            schemaVersion: SCHEMA_VERSION,
+            tenantId: options.tenantId,
+            conversationId: options.conversationId,
+            kind: "message",
+            text: options.text,
+        };
+        if (options.image !== undefined)
+            payload.image = imageToWire(options.image);
+        if (options.bindingId)
+            payload.bindingId = options.bindingId;
+        if (options.idempotencyKey)
+            payload.idempotencyKey = options.idempotencyKey;
+        return this.#send(payload);
+    }
+    #send(reply) {
+        const ws = this.#ws;
+        if (ws === undefined || ws.readyState !== WebSocket.OPEN) {
+            logger.warn("standin: chat channel is not open; dropping a reply");
+            return false;
+        }
+        try {
+            ws.send(JSON.stringify(reply));
+            return true;
+        }
+        catch (err) {
+            logger.warn(`standin: chat reply failed: ${String(err)}`);
+            return false;
+        }
+    }
+}
+/** Reject after `ms`, so one hung turn cannot wedge its conversation forever. */
+function withTimeout(promise, ms) {
+    let timer;
+    const expiry = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new StandInError("chat turn timed out")), ms);
+        timer.unref?.();
+    });
+    return Promise.race([promise, expiry]).finally(() => clearTimeout(timer));
+}
+//# sourceMappingURL=chat.js.map

package/dist/chat.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Read a variable that must be set, or throw naming it.
+ *
+ * `purpose` completes the sentence "X is required to ...", so write it as a verb
+ * phrase: `"answer calls with ElevenLabs"`.
+ */
+export declare function required(name: string, purpose?: string): string;
+/** Read a variable that may be set. Blank reads as absent. */
+export declare function optional(name: string, fallback?: string): string | undefined;
+/**
+ * Read a boolean. Only `true` is true, so a typo is off rather than on.
+ *
+ * Deliberately strict. A setting that turns a guard OFF must not be turned off
+ * by `TRUE`, `1` or `yes` landing in a config file by accident.
+ */
+export declare function flag(name: string, fallback?: boolean): boolean;
+/**
+ * Read a host and refuse one that is not the vendor's.
+ *
+ * Your API key travels to this host. A mistyped or injected value is credential
+ * exfiltration rather than a failed call, which is why this throws instead of
+ * warning.
+ */
+export declare function vendorHost(name: string, fallback: string, suffix: string): string;
+/**
+ * Read a JSON object of strings, or throw saying it must be one.
+ *
+ * Used for header maps, which carry YOUR credentials to somebody else's
+ * endpoint, so the value is never logged on the failure path.
+ */
+export declare function jsonObject(name: string): Record<string, string>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAoBA;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAK,GAAG,MAAM,CAO3D;AAED,8DAA8D;AAC9D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE5E;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAI5D;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,CAOR;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkB/D"}