@agent-native/toolkit 0.5.1 → 0.6.0

package/dist/composer/pasted-text.js

@@ -0,0 +1,130 @@
+// Page-sized pastes turn into a `Pasted text` attachment chip instead of being
+// dumped into the editor. Short paragraphs and everyday lists should stay
+// inline so the composer still feels like a normal text field.
+const PASTED_TEXT_MIN_CHARS = 3200;
+const PASTED_TEXT_MIN_LINES = 24;
+const PASTED_TEXT_FILENAME_PREFIX = "pasted-text-";
+// A copied HTML document/source is recognizable from its markup: a closing tag
+// (`</div>`), a doctype, or a common structural/element tag. We key off the
+// *content* the user actually pasted, not the clipboard's `text/html` flavor —
+// editors (VS Code) and rich-text apps (Google Docs) populate `text/html` with
+// syntax-highlight spans or formatting wrappers even when the real content is
+// plain code/prose, so trusting `text/html` blindly would mangle those pastes.
+const HTML_SOURCE_SIGNAL = /<!doctype\s+html|<html[\s>]|<\/[a-z][a-z0-9-]*\s*>|<(?:body|head|div|span|section|main|header|footer|nav|article|aside|ul|ol|li|table|thead|tbody|tr|td|th|h[1-6]|p|a|img|button|input|textarea|select|form|label|script|style|link|meta|svg|canvas|template)\b/i;
+// A real HTML *document* announces itself with a doctype / html / head / body.
+// When one of these is present we keep the HTML classification even if an inline
+// <script> contains JS keywords — it's a genuine page.
+const HTML_DOCUMENT_SIGNAL = /<!doctype\s+html|<html[\s>]|<head[\s>]|<body[\s>]/i;
+// JSX/TSX source contains the same `</div>`/`<span>` tags as an HTML document,
+// so the HTML tag signal alone misfiles a pasted React/TS component (even a bare
+// function component) as an `.html` artifact — the agent then mishandles it as a
+// hostable document instead of source. These markers appear in JS/TS/JSX source
+// but not in a plain HTML *fragment*: `className=` (JSX uses it; HTML uses
+// `class=`), ES module import/export, arrow functions, TS type/React annotations,
+// React hooks, and the basic JS declaration/return keywords that make up a
+// component body.
+const CODE_SOURCE_SIGNAL = /\bclassName=|\bimport\b|\bexport\b|=>|:\s*React\.|\buse[A-Z]\w*\(|\b(?:function|const|let|var|return|class|interface|type|enum)\b/;
+function looksLikeHtml(value) {
+    if (!value || !HTML_SOURCE_SIGNAL.test(value))
+        return false;
+    // A self-announcing HTML document stays HTML even if it embeds a <script>.
+    if (HTML_DOCUMENT_SIGNAL.test(value))
+        return true;
+    // Otherwise it's a bare fragment — if it carries JS/TS/JSX code signals,
+    // treat it as source code, not an HTML attachment.
+    if (CODE_SOURCE_SIGNAL.test(value))
+        return false;
+    return true;
+}
+/** Read the relevant clipboard flavors from a paste/drop DataTransfer. */
+export function readClipboardPaste(data) {
+    const text = data?.getData("text/plain") ?? "";
+    const html = data?.getData("text/html") ?? "";
+    return { text, html: html.trim() ? html : undefined };
+}
+// Decide what to actually store for a paste. Preserving HTML markup means a
+// pasted HTML document behaves exactly like uploading that .html file: the agent
+// recognizes it as a hostable artifact and reads it verbatim via
+// `contentFromAttachment` instead of retyping it inline (which cuts off
+// mid-stream on large files and triggers a continuation loop / "spin").
+function selectPasteBody(paste) {
+    const plain = paste.text ?? "";
+    const html = paste.html ?? "";
+    // 1) The pasted text is itself HTML source (copied from an editor, a file, or
+    //    view-source). The plain text *is* the markup, so keep it as .html.
+    if (plain.trim() && looksLikeHtml(plain)) {
+        return { body: plain, ext: "html", type: "text/html" };
+    }
+    // 2) No usable plain text, but a real HTML flavor exists (some apps only
+    //    expose text/html). Fall back to the markup so nothing is dropped.
+    if (!plain.trim() && looksLikeHtml(html)) {
+        return { body: html, ext: "html", type: "text/html" };
+    }
+    // 3) Default: keep the clean plain text. Avoids the syntax-highlight /
+    //    rich-text noise that lives in text/html when the plain text is already
+    //    the real content (code from an editor, prose from a doc).
+    return { body: plain, ext: "txt", type: "text/plain" };
+}
+export function shouldConvertPasteToAttachment(text) {
+    if (!text)
+        return false;
+    if (text.length >= PASTED_TEXT_MIN_CHARS)
+        return true;
+    let lines = 1;
+    for (let i = 0; i < text.length; i++) {
+        if (text.charCodeAt(i) === 10) {
+            lines++;
+            if (lines >= PASTED_TEXT_MIN_LINES)
+                return true;
+        }
+    }
+    return false;
+}
+/**
+ * Whether a clipboard paste is large enough to become a `Pasted text`
+ * attachment chip. Mirrors `shouldConvertPasteToAttachment` but evaluates the
+ * representation we'd actually store, so an HTML-only paste (empty text/plain)
+ * still converts on the strength of its markup.
+ */
+export function shouldConvertClipboardToAttachment(paste) {
+    return shouldConvertPasteToAttachment(selectPasteBody(paste).body);
+}
+function pastedAttachmentName(ext) {
+    return `${PASTED_TEXT_FILENAME_PREFIX}${Date.now()}-${Math.random()
+        .toString(36)
+        .slice(2, 8)}.${ext}`;
+}
+/**
+ * Build the attachment File for a page-sized paste, preserving HTML markup when
+ * the pasted content is an HTML document so it travels the same rail as an
+ * uploaded .html file.
+ */
+export function createPastedAttachmentFile(paste) {
+    const { body, ext, type } = selectPasteBody(paste);
+    return new File([body], pastedAttachmentName(ext), { type });
+}
+/** Back-compat helper for callers that only have plain text. */
+export function createPastedTextFile(text) {
+    return createPastedAttachmentFile({ text });
+}
+export function isPastedTextAttachmentName(name) {
+    return !!name && name.startsWith(PASTED_TEXT_FILENAME_PREFIX);
+}
+// Strips the `<attachment name=...>\n` / `\n</attachment>` envelope that
+// SimpleTextAttachmentAdapter wraps the file body in when sending. Returns the
+// raw body for previewing.
+export function unwrapAttachmentEnvelope(text) {
+    const match = text.match(/^<attachment\b[^>]*>\n([\s\S]*)\n<\/attachment>$/);
+    return match ? match[1] : text;
+}
+export function countLines(text) {
+    if (!text)
+        return 0;
+    let lines = 1;
+    for (let i = 0; i < text.length; i++) {
+        if (text.charCodeAt(i) === 10)
+            lines++;
+    }
+    return lines;
+}
+//# sourceMappingURL=pasted-text.js.map

package/dist/composer/pasted-text.js.map

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

package/dist/composer/pasted-text.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pasted-text.spec.d.ts.map

package/dist/composer/pasted-text.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pasted-text.spec.d.ts","sourceRoot":"","sources":["../../src/composer/pasted-text.spec.ts"],"names":[],"mappings":""}

package/dist/composer/pasted-text.spec.js

@@ -0,0 +1,107 @@
+import { describe, expect, it } from "vitest";
+import { createPastedAttachmentFile, isPastedTextAttachmentName, readClipboardPaste, shouldConvertClipboardToAttachment, shouldConvertPasteToAttachment, unwrapAttachmentEnvelope, } from "./pasted-text.js";
+function clipboard(flavors) {
+    return { getData: (type) => flavors[type] ?? "" };
+}
+describe("shouldConvertPasteToAttachment", () => {
+    it("keeps a paragraph or two inline", () => {
+        const twoParagraphs = [
+            "This is a normal paragraph pasted into the composer. ".repeat(16),
+            "This is a second paragraph with enough words to feel real, but it is nowhere near a page of text. ".repeat(10),
+        ].join("\n\n");
+        expect(shouldConvertPasteToAttachment(twoParagraphs)).toBe(false);
+    });
+    it("keeps a basic bulleted list inline", () => {
+        const list = [
+            "- Confirm project scope",
+            "- Review current designs",
+            "- Check the edge cases",
+            "- Share implementation notes",
+            "- Follow up with QA",
+            "- Update release notes",
+            "- Coordinate rollout",
+            "- Watch for support reports",
+        ].join("\n");
+        expect(shouldConvertPasteToAttachment(list)).toBe(false);
+    });
+    it("converts roughly page-sized prose to an attachment", () => {
+        const pageOfText = "This is source material for the agent to review. ".repeat(72);
+        expect(shouldConvertPasteToAttachment(pageOfText)).toBe(true);
+    });
+    it("converts page-length line-oriented text to an attachment", () => {
+        const pageOfLines = Array.from({ length: 24 }, (_, index) => `${index + 1}. A full-page outline item with supporting detail.`).join("\n");
+        expect(shouldConvertPasteToAttachment(pageOfLines)).toBe(true);
+    });
+    it("unwraps assistant-ui text attachment envelopes with attributes", () => {
+        expect(unwrapAttachmentEnvelope('<attachment name="notes.txt" contentType="text/plain">\nLine one\nLine two\n</attachment>')).toBe("Line one\nLine two");
+    });
+});
+describe("readClipboardPaste", () => {
+    it("returns both flavors when present", () => {
+        const paste = readClipboardPaste(clipboard({ "text/plain": "hello", "text/html": "<p>hello</p>" }));
+        expect(paste.text).toBe("hello");
+        expect(paste.html).toBe("<p>hello</p>");
+    });
+    it("omits an empty html flavor", () => {
+        const paste = readClipboardPaste(clipboard({ "text/plain": "hello", "text/html": "   " }));
+        expect(paste.html).toBeUndefined();
+    });
+    it("tolerates a missing DataTransfer", () => {
+        const paste = readClipboardPaste(null);
+        expect(paste.text).toBe("");
+        expect(paste.html).toBeUndefined();
+    });
+});
+const pageOfHtml = `<!doctype html>\n<html><body>${"<div>Product narrative section.</div>\n".repeat(80)}</body></html>`;
+describe("createPastedAttachmentFile", () => {
+    it("stores pasted HTML source as a real .html attachment", () => {
+        const paste = { text: pageOfHtml };
+        const file = createPastedAttachmentFile(paste);
+        expect(file.name).toMatch(/^pasted-text-.*\.html$/);
+        expect(file.type).toBe("text/html");
+        expect(isPastedTextAttachmentName(file.name)).toBe(true);
+    });
+    it("keeps plain prose as a .txt attachment (no html flavor)", () => {
+        const file = createPastedAttachmentFile({
+            text: "This is just a long block of plain prose. ".repeat(80),
+        });
+        expect(file.name).toMatch(/^pasted-text-.*\.txt$/);
+        expect(file.type).toBe("text/plain");
+    });
+    it("does NOT promote code to html just because text/html carries highlight markup", () => {
+        // VS Code / editors put syntax-highlight <span> markup in text/html even
+        // though the real content (text/plain) is plain code. Keep it as .txt.
+        const code = "const x: number = 1;\n".repeat(200);
+        const highlightHtml = `<div style="color:#abb2bf">${"<span>const</span> <span>x</span>\n".repeat(200)}</div>`;
+        const file = createPastedAttachmentFile({
+            text: code,
+            html: highlightHtml,
+        });
+        expect(file.name).toMatch(/\.txt$/);
+        expect(file.type).toBe("text/plain");
+    });
+    it("falls back to the html flavor when there is no usable plain text", () => {
+        const file = createPastedAttachmentFile({ text: "   ", html: pageOfHtml });
+        expect(file.name).toMatch(/\.html$/);
+        expect(file.type).toBe("text/html");
+    });
+    it("preserves the markup verbatim in the file body", async () => {
+        const file = createPastedAttachmentFile({ text: pageOfHtml });
+        expect(await file.text()).toBe(pageOfHtml);
+    });
+});
+describe("shouldConvertClipboardToAttachment", () => {
+    it("converts a page-sized HTML source paste", () => {
+        expect(shouldConvertClipboardToAttachment({ text: pageOfHtml })).toBe(true);
+    });
+    it("converts an html-only paste with an empty plain flavor", () => {
+        expect(shouldConvertClipboardToAttachment({ text: "", html: pageOfHtml })).toBe(true);
+    });
+    it("keeps a short paste inline even if it carries rich html", () => {
+        expect(shouldConvertClipboardToAttachment({
+            text: "two words",
+            html: "<b>two</b> <i>words</i>",
+        })).toBe(false);
+    });
+});
+//# sourceMappingURL=pasted-text.spec.js.map

package/dist/composer/pasted-text.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pasted-text.spec.js","sourceRoot":"","sources":["../../src/composer/pasted-text.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,EAC1B,kBAAkB,EAClB,kCAAkC,EAClC,8BAA8B,EAC9B,wBAAwB,GAEzB,MAAM,kBAAkB,CAAC;AAE1B,SAAS,SAAS,CAAC,OAA+B;IAGhD,OAAO,EAAE,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;AAC5D,CAAC;AAED,QAAQ,CAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,aAAa,GAAG;YACpB,uDAAuD,CAAC,MAAM,CAAC,EAAE,CAAC;YAClE,oGAAoG,CAAC,MAAM,CACzG,EAAE,CACH;SACF,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEf,MAAM,CAAC,8BAA8B,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,IAAI,GAAG;YACX,yBAAyB;YACzB,0BAA0B;YAC1B,wBAAwB;YACxB,8BAA8B;YAC9B,qBAAqB;YACrB,wBAAwB;YACxB,sBAAsB;YACtB,6BAA6B;SAC9B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,CAAC,8BAA8B,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,UAAU,GACd,mDAAmD,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAEjE,MAAM,CAAC,8BAA8B,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAC5B,EAAE,MAAM,EAAE,EAAE,EAAE,EACd,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CACX,GAAG,KAAK,GAAG,CAAC,oDAAoD,CACnE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,MAAM,CAAC,8BAA8B,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,CACJ,wBAAwB,CACtB,2FAA2F,CAC5F,CACF,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,KAAK,GAAG,kBAAkB,CAC9B,SAAS,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC,CAClE,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,KAAK,GAAG,kBAAkB,CAC9B,SAAS,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CACzD,CAAC;QACF,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,gCAAgC,yCAAyC,CAAC,MAAM,CACjG,EAAE,CACH,gBAAgB,CAAC;AAElB,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IAC1C,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,KAAK,GAAmB,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpC,MAAM,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,IAAI,GAAG,0BAA0B,CAAC;YACtC,IAAI,EAAE,4CAA4C,CAAC,MAAM,CAAC,EAAE,CAAC;SAC9D,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+EAA+E,EAAE,GAAG,EAAE;QACvF,yEAAyE;QACzE,uEAAuE;QACvE,MAAM,IAAI,GAAG,wBAAwB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,aAAa,GAAG,8BAA8B,qCAAqC,CAAC,MAAM,CAC9F,GAAG,CACJ,QAAQ,CAAC;QACV,MAAM,IAAI,GAAG,0BAA0B,CAAC;YACtC,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,aAAa;SACpB,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,IAAI,GAAG,0BAA0B,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAC3E,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,IAAI,GAAG,0BAA0B,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;IAClD,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,kCAAkC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,CACJ,kCAAkC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CACnE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CACJ,kCAAkC,CAAC;YACjC,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,yBAAyB;SAChC,CAAC,CACH,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/composer/prompt-attachments.d.ts

@@ -0,0 +1,18 @@
+export interface AgentPromptAttachment {
+    name: string;
+    type?: string;
+    size?: number;
+    text?: string;
+    dataUrl?: string;
+}
+export declare function escapePromptAttachmentAttribute(value: string): string;
+export declare function formatPromptWithAttachments(prompt: string, attachments: readonly AgentPromptAttachment[]): string;
+export declare const AGENT_PROMPT_MAX_INLINE_TEXT_CHARS = 60000;
+export declare const AGENT_PROMPT_MAX_INLINE_IMAGE_BYTES: number;
+export interface ReadAgentPromptAttachmentOptions {
+    maxInlineTextChars?: number;
+    maxInlineImageBytes?: number;
+}
+export declare function readAgentPromptAttachment(file: File, options?: ReadAgentPromptAttachmentOptions): Promise<AgentPromptAttachment>;
+export declare function isInlineableAgentPromptFile(file: File): boolean;
+//# sourceMappingURL=prompt-attachments.d.ts.map

package/dist/composer/prompt-attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-attachments.d.ts","sourceRoot":"","sources":["../../src/composer/prompt-attachments.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,SAAS,qBAAqB,EAAE,GAC5C,MAAM,CAkBR;AAED,eAAO,MAAM,kCAAkC,QAAS,CAAC;AACzD,eAAO,MAAM,mCAAmC,QAAkB,CAAC;AAEnE,MAAM,WAAW,gCAAgC;IAC/C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,gCAAqC,GAC7C,OAAO,CAAC,qBAAqB,CAAC,CA6BhC;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAK/D"}

package/dist/composer/prompt-attachments.js

@@ -0,0 +1,65 @@
+export function escapePromptAttachmentAttribute(value) {
+    return value.replace(/&/g, "&").replace(/"/g, """);
+}
+export function formatPromptWithAttachments(prompt, attachments) {
+    if (attachments.length === 0)
+        return prompt;
+    const attachmentText = attachments
+        .map((attachment) => {
+        const size = attachment.size ? ` size="${attachment.size}"` : "";
+        const type = attachment.type
+            ? ` type="${escapePromptAttachmentAttribute(attachment.type)}"`
+            : "";
+        if (attachment.dataUrl) {
+            return `<attached-image name="${escapePromptAttachmentAttribute(attachment.name)}"${type}${size}>\n${attachment.dataUrl}\n</attached-image>`;
+        }
+        const body = attachment.text?.trim() ||
+            "Selected in the UI. If this file is needed, inspect it from the workspace or ask for a readable copy.";
+        return `<attached-file name="${escapePromptAttachmentAttribute(attachment.name)}"${type}${size}>\n${body}\n</attached-file>`;
+    })
+        .join("\n\n");
+    return `${prompt.trimEnd()}\n\nAttached context:\n${attachmentText}`;
+}
+export const AGENT_PROMPT_MAX_INLINE_TEXT_CHARS = 60_000;
+export const AGENT_PROMPT_MAX_INLINE_IMAGE_BYTES = 2 * 1024 * 1024;
+export async function readAgentPromptAttachment(file, options = {}) {
+    const maxInlineTextChars = options.maxInlineTextChars ?? AGENT_PROMPT_MAX_INLINE_TEXT_CHARS;
+    const maxInlineImageBytes = options.maxInlineImageBytes ?? AGENT_PROMPT_MAX_INLINE_IMAGE_BYTES;
+    const attachment = {
+        name: file.name,
+        type: file.type || undefined,
+        size: file.size,
+    };
+    if (isInlineableAgentPromptFile(file) && file.size <= maxInlineTextChars) {
+        try {
+            attachment.text = await file.text();
+        }
+        catch {
+            // Keep the filename-only attachment if the browser cannot read it.
+        }
+    }
+    else if (file.type.startsWith("image/") &&
+        file.size <= maxInlineImageBytes) {
+        try {
+            attachment.dataUrl = await readFileAsDataUrl(file);
+        }
+        catch {
+            // Keep the filename-only attachment if the browser cannot read it.
+        }
+    }
+    return attachment;
+}
+export function isInlineableAgentPromptFile(file) {
+    if (file.type.startsWith("text/"))
+        return true;
+    return /\.(cjs|css|csv|html|js|json|jsx|md|mdx|mjs|sql|tsx?|txt|xml|yaml|yml)$/i.test(file.name);
+}
+function readFileAsDataUrl(file) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => resolve(String(reader.result ?? ""));
+        reader.onerror = () => reject(reader.error ?? new Error("Could not read file"));
+        reader.readAsDataURL(file);
+    });
+}
+//# sourceMappingURL=prompt-attachments.js.map

package/dist/composer/prompt-attachments.js.map

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

package/dist/composer/prompt-attachments.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=prompt-attachments.spec.d.ts.map

package/dist/composer/prompt-attachments.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-attachments.spec.d.ts","sourceRoot":"","sources":["../../src/composer/prompt-attachments.spec.ts"],"names":[],"mappings":""}

package/dist/composer/prompt-attachments.spec.js

@@ -0,0 +1,63 @@
+// @vitest-environment happy-dom
+import { describe, expect, it } from "vitest";
+import { escapePromptAttachmentAttribute, formatPromptWithAttachments, isInlineableAgentPromptFile, readAgentPromptAttachment, } from "./prompt-attachments.js";
+describe("prompt attachment helpers", () => {
+    it("inlines readable text files up to the configured limit", async () => {
+        const file = new File(["hello"], "notes.md", {
+            type: "text/markdown",
+        });
+        const attachment = await readAgentPromptAttachment(file);
+        expect(isInlineableAgentPromptFile(file)).toBe(true);
+        expect(attachment).toEqual({
+            name: "notes.md",
+            type: "text/markdown",
+            size: 5,
+            text: "hello",
+        });
+    });
+    it("falls back to filename metadata for oversized text files", async () => {
+        const file = new File(["hello"], "notes.md", {
+            type: "text/markdown",
+        });
+        const attachment = await readAgentPromptAttachment(file, {
+            maxInlineTextChars: 2,
+        });
+        expect(attachment).toEqual({
+            name: "notes.md",
+            type: "text/markdown",
+            size: 5,
+        });
+    });
+    it("inlines small image files as data URLs", async () => {
+        const file = new File(["fake image"], "screenshot.png", {
+            type: "image/png",
+        });
+        const attachment = await readAgentPromptAttachment(file);
+        expect(attachment.name).toBe("screenshot.png");
+        expect(attachment.type).toBe("image/png");
+        expect(attachment.dataUrl).toContain("data:image/png;base64,");
+    });
+    it("formats attachments with escaped XML attributes", () => {
+        const formatted = formatPromptWithAttachments("Review this", [
+            {
+                name: 'bad"name&.ts',
+                type: "text/plain",
+                size: 12,
+                text: "const x = 1;",
+            },
+            {
+                name: "shot.png",
+                type: "image/png",
+                size: 3,
+                dataUrl: "data:image/png;base64,abc",
+            },
+        ]);
+        expect(escapePromptAttachmentAttribute('a&"b')).toBe("a&"b");
+        expect(formatted).toContain("Attached context:");
+        expect(formatted).toContain('name="bad"name&.ts"');
+        expect(formatted).toContain("<attached-file");
+        expect(formatted).toContain("<attached-image");
+        expect(formatted).toContain("data:image/png;base64,abc");
+    });
+});
+//# sourceMappingURL=prompt-attachments.spec.js.map

package/dist/composer/prompt-attachments.spec.js.map

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

package/dist/composer/realtime-voice-audio-level.d.ts

@@ -0,0 +1,14 @@
+export interface RealtimeVoiceAudioLevels {
+    input: number;
+    output: number;
+}
+export interface RealtimeVoiceAudioLevelStore {
+    getSnapshot: () => RealtimeVoiceAudioLevels;
+    subscribe: (listener: () => void) => () => void;
+    set: (levels: RealtimeVoiceAudioLevels) => void;
+    reset: () => void;
+}
+export declare function normalizeRealtimeVoiceRms(samples: Uint8Array): number;
+export declare function smoothRealtimeVoiceLevel(previous: number, next: number): number;
+export declare function createRealtimeVoiceAudioLevelStore(): RealtimeVoiceAudioLevelStore;
+//# sourceMappingURL=realtime-voice-audio-level.d.ts.map

package/dist/composer/realtime-voice-audio-level.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-voice-audio-level.d.ts","sourceRoot":"","sources":["../../src/composer/realtime-voice-audio-level.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,EAAE,MAAM,wBAAwB,CAAC;IAC5C,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAChD,GAAG,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,CAAC;IAChD,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AASD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CASrE;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,MAAM,CAIR;AAED,wBAAgB,kCAAkC,IAAI,4BAA4B,CAwBjF"}

package/dist/composer/realtime-voice-audio-level.js

@@ -0,0 +1,47 @@
+const SILENT_LEVELS = { input: 0, output: 0 };
+function clampLevel(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.max(0, Math.min(1, value));
+}
+export function normalizeRealtimeVoiceRms(samples) {
+    if (samples.length === 0)
+        return 0;
+    let sumSquares = 0;
+    for (const sample of samples) {
+        const normalized = (sample - 128) / 128;
+        sumSquares += normalized * normalized;
+    }
+    const rms = Math.sqrt(sumSquares / samples.length);
+    return clampLevel(Math.max(0, rms - 0.012) * 3.2);
+}
+export function smoothRealtimeVoiceLevel(previous, next) {
+    const target = clampLevel(next);
+    const factor = target > previous ? 0.55 : 0.2;
+    return clampLevel(previous + (target - previous) * factor);
+}
+export function createRealtimeVoiceAudioLevelStore() {
+    let snapshot = SILENT_LEVELS;
+    const listeners = new Set();
+    const set = (levels) => {
+        const next = {
+            input: clampLevel(levels.input),
+            output: clampLevel(levels.output),
+        };
+        if (next.input === snapshot.input && next.output === snapshot.output)
+            return;
+        snapshot = next;
+        for (const listener of listeners)
+            listener();
+    };
+    return {
+        getSnapshot: () => snapshot,
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => listeners.delete(listener);
+        },
+        set,
+        reset: () => set(SILENT_LEVELS),
+    };
+}
+//# sourceMappingURL=realtime-voice-audio-level.js.map

package/dist/composer/realtime-voice-audio-level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-voice-audio-level.js","sourceRoot":"","sources":["../../src/composer/realtime-voice-audio-level.ts"],"names":[],"mappings":"AAYA,MAAM,aAAa,GAA6B,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAExE,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAAmB;IAC3D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACnC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QACxC,UAAU,IAAI,UAAU,GAAG,UAAU,CAAC;IACxC,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,QAAgB,EAChB,IAAY;IAEZ,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IAC9C,OAAO,UAAU,CAAC,QAAQ,GAAG,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,kCAAkC;IAChD,IAAI,QAAQ,GAAG,aAAa,CAAC;IAC7B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;IAExC,MAAM,GAAG,GAAG,CAAC,MAAgC,EAAE,EAAE;QAC/C,MAAM,IAAI,GAAG;YACX,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC;YAC/B,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC;SAClC,CAAC;QACF,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;YAClE,OAAO;QACT,QAAQ,GAAG,IAAI,CAAC;QAChB,KAAK,MAAM,QAAQ,IAAI,SAAS;YAAE,QAAQ,EAAE,CAAC;IAC/C,CAAC,CAAC;IAEF,OAAO;QACL,WAAW,EAAE,GAAG,EAAE,CAAC,QAAQ;QAC3B,SAAS,CAAC,QAAQ;YAChB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;QACD,GAAG;QACH,KAAK,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/composer/realtime-voice-audio-level.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=realtime-voice-audio-level.spec.d.ts.map

package/dist/composer/realtime-voice-audio-level.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-voice-audio-level.spec.d.ts","sourceRoot":"","sources":["../../src/composer/realtime-voice-audio-level.spec.ts"],"names":[],"mappings":""}

package/dist/composer/realtime-voice-audio-level.spec.js

@@ -0,0 +1,25 @@
+import { describe, expect, it, vi } from "vitest";
+import { createRealtimeVoiceAudioLevelStore, normalizeRealtimeVoiceRms, smoothRealtimeVoiceLevel, } from "./realtime-voice-audio-level.js";
+describe("realtime voice audio levels", () => {
+    it("normalizes silence and clamps loud audio", () => {
+        expect(normalizeRealtimeVoiceRms(new Uint8Array(32).fill(128))).toBe(0);
+        expect(normalizeRealtimeVoiceRms(new Uint8Array(32).fill(255))).toBe(1);
+    });
+    it("attacks faster than it decays", () => {
+        expect(smoothRealtimeVoiceLevel(0, 1)).toBe(0.55);
+        expect(smoothRealtimeVoiceLevel(1, 0)).toBe(0.8);
+    });
+    it("notifies only on changes and resets both channels", () => {
+        const store = createRealtimeVoiceAudioLevelStore();
+        const listener = vi.fn();
+        store.subscribe(listener);
+        store.set({ input: 0.5, output: 0.25 });
+        store.set({ input: 0.5, output: 0.25 });
+        expect(listener).toHaveBeenCalledOnce();
+        expect(store.getSnapshot()).toEqual({ input: 0.5, output: 0.25 });
+        store.reset();
+        expect(store.getSnapshot()).toEqual({ input: 0, output: 0 });
+        expect(listener).toHaveBeenCalledTimes(2);
+    });
+});
+//# sourceMappingURL=realtime-voice-audio-level.spec.js.map

package/dist/composer/realtime-voice-audio-level.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-voice-audio-level.spec.js","sourceRoot":"","sources":["../../src/composer/realtime-voice-audio-level.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EACL,kCAAkC,EAClC,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AAEzC,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,yBAAyB,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxE,MAAM,CAAC,yBAAyB,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,KAAK,GAAG,kCAAkC,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACzB,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC1B,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,EAAE,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7D,MAAM,CAAC,QAAQ,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/composer/realtime-voice-transcript.d.ts

@@ -0,0 +1,26 @@
+export type RealtimeVoiceTranscriptRole = "user" | "assistant";
+export interface RealtimeVoiceTranscriptMessage {
+    id: string;
+    threadId: string;
+    role: RealtimeVoiceTranscriptRole;
+    text: string;
+    createdAt: string;
+}
+export interface RealtimeVoiceTranscriptSink {
+    threadId: string;
+    active: boolean;
+    append: (message: RealtimeVoiceTranscriptMessage) => boolean;
+}
+export interface RealtimeVoiceTranscriptRegistry {
+    activeThreadId: () => string | undefined;
+    publish: (message: RealtimeVoiceTranscriptMessage) => void;
+    register: (sink: RealtimeVoiceTranscriptSink) => () => void;
+    pendingCount: () => number;
+}
+export declare function appendRealtimeVoiceTranscriptToRepository(value: unknown, transcript: RealtimeVoiceTranscriptMessage): {
+    appended: boolean;
+    repository: Record<string, unknown>;
+};
+export declare function createRealtimeVoiceTranscriptRegistry(): RealtimeVoiceTranscriptRegistry;
+export declare const realtimeVoiceTranscriptRegistry: RealtimeVoiceTranscriptRegistry;
+//# sourceMappingURL=realtime-voice-transcript.d.ts.map

package/dist/composer/realtime-voice-transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime-voice-transcript.d.ts","sourceRoot":"","sources":["../../src/composer/realtime-voice-transcript.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/D,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,2BAA2B,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,CAAC,OAAO,EAAE,8BAA8B,KAAK,OAAO,CAAC;CAC9D;AAED,MAAM,WAAW,+BAA+B;IAC9C,cAAc,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACzC,OAAO,EAAE,CAAC,OAAO,EAAE,8BAA8B,KAAK,IAAI,CAAC;IAC3D,QAAQ,EAAE,CAAC,IAAI,EAAE,2BAA2B,KAAK,MAAM,IAAI,CAAC;IAC5D,YAAY,EAAE,MAAM,MAAM,CAAC;CAC5B;AAED,wBAAgB,yCAAyC,CACvD,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,8BAA8B,GACzC;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CA6C5D;AAED,wBAAgB,qCAAqC,IAAI,+BAA+B,CAyDvF;AAED,eAAO,MAAM,+BAA+B,iCACH,CAAC"}