@athenaintel/react 0.19.0 → 0.20.0

package/dist/composer/FileUploadButton.js

@@ -0,0 +1,65 @@
+import { jsxs, Fragment, jsx } from "react/jsx-runtime";
+import { Loader2Icon, AlertCircleIcon, PaperclipIcon } from "lucide-react";
+import { useRef, useCallback } from "react";
+import { useAttachFiles } from "./useAttachFiles.js";
+import { cn } from "cnfast";
+const FileUploadButton = ({
+  className,
+  onUpload,
+  accept
+}) => {
+  const inputRef = useRef(null);
+  const { attachFiles, isUploading, error, clearError } = useAttachFiles();
+  const handleClick = useCallback(() => {
+    var _a;
+    clearError();
+    (_a = inputRef.current) == null ? void 0 : _a.click();
+  }, [clearError]);
+  const handleFiles = useCallback(
+    async (files) => {
+      if (!files || files.length === 0) return;
+      const assets = await attachFiles(Array.from(files), "paperclip");
+      if (assets.length > 0) {
+        onUpload == null ? void 0 : onUpload(assets);
+      }
+      if (inputRef.current) {
+        inputRef.current.value = "";
+      }
+    },
+    [attachFiles, onUpload]
+  );
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(
+      "input",
+      {
+        ref: inputRef,
+        type: "file",
+        multiple: true,
+        accept,
+        className: "hidden",
+        onChange: (e) => handleFiles(e.target.files),
+        "aria-label": "Upload files"
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        onClick: handleClick,
+        disabled: isUploading,
+        className: cn(
+          "aui-file-upload-btn flex items-center justify-center rounded-md p-1.5 text-muted-foreground transition-colors hover:bg-muted hover:text-foreground disabled:opacity-50 disabled:pointer-events-none",
+          error && "text-destructive",
+          className
+        ),
+        title: error ?? (isUploading ? "Uploading..." : "Attach files"),
+        "aria-label": isUploading ? "Uploading files" : "Attach files",
+        children: isUploading ? /* @__PURE__ */ jsx(Loader2Icon, { className: "size-4 animate-spin" }) : error ? /* @__PURE__ */ jsx(AlertCircleIcon, { className: "size-4" }) : /* @__PURE__ */ jsx(PaperclipIcon, { className: "size-4" })
+      }
+    )
+  ] });
+};
+export {
+  FileUploadButton
+};
+//# sourceMappingURL=FileUploadButton.js.map

package/dist/composer/FileUploadButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileUploadButton.js","sources":["../../src/composer/FileUploadButton.tsx"],"sourcesContent":["import { PaperclipIcon, Loader2Icon, AlertCircleIcon } from 'lucide-react';\nimport { useCallback, useRef, type FC } from 'react';\nimport { useAttachFiles } from './useAttachFiles';\nimport type { UploadedAsset } from './useFileUpload';\nimport { cn } from '../lib/utils';\n\nexport interface FileUploadButtonProps {\n  className?: string;\n  /** Called after files are uploaded successfully. Receives the created assets. */\n  onUpload?: (assets: UploadedAsset[]) => void;\n  /** Accepted file types (MIME pattern). Defaults to all files. */\n  accept?: string;\n}\n\n/**\n * Paperclip button that opens a file picker and uploads selected files to Athena.\n * After upload, adds files to the attachment context so they appear as pills\n * above the composer and get included when the message is sent.\n */\nexport const FileUploadButton: FC<FileUploadButtonProps> = ({\n  className,\n  onUpload,\n  accept,\n}) => {\n  const inputRef = useRef<HTMLInputElement>(null);\n  const { attachFiles, isUploading, error, clearError } = useAttachFiles();\n\n  const handleClick = useCallback(() => {\n    clearError();\n    inputRef.current?.click();\n  }, [clearError]);\n\n  const handleFiles = useCallback(\n    async (files: FileList | null) => {\n      if (!files || files.length === 0) return;\n\n      const assets = await attachFiles(Array.from(files), 'paperclip');\n      if (assets.length > 0) {\n        onUpload?.(assets);\n      }\n\n      // Reset input so the same file can be re-selected\n      if (inputRef.current) {\n        inputRef.current.value = '';\n      }\n    },\n    [attachFiles, onUpload],\n  );\n\n  return (\n    <>\n      <input\n        ref={inputRef}\n        type=\"file\"\n        multiple\n        accept={accept}\n        className=\"hidden\"\n        onChange={(e) => handleFiles(e.target.files)}\n        aria-label=\"Upload files\"\n      />\n      <button\n        type=\"button\"\n        onClick={handleClick}\n        disabled={isUploading}\n        className={cn(\n          'aui-file-upload-btn flex items-center justify-center rounded-md p-1.5 text-muted-foreground transition-colors hover:bg-muted hover:text-foreground disabled:opacity-50 disabled:pointer-events-none',\n          error && 'text-destructive',\n          className,\n        )}\n        title={error ?? (isUploading ? 'Uploading...' : 'Attach files')}\n        aria-label={isUploading ? 'Uploading files' : 'Attach files'}\n      >\n        {isUploading ? (\n          <Loader2Icon className=\"size-4 animate-spin\" />\n        ) : error ? (\n          <AlertCircleIcon className=\"size-4\" />\n        ) : (\n          <PaperclipIcon className=\"size-4\" />\n        )}\n      </button>\n    </>\n  );\n};\n"],"names":[],"mappings":";;;;;AAmBO,MAAM,mBAA8C,CAAC;AAAA,EAC1D;AAAA,EACA;AAAA,EACA;AACF,MAAM;AACJ,QAAM,WAAW,OAAyB,IAAI;AAC9C,QAAM,EAAE,aAAa,aAAa,OAAO,WAAA,IAAe,eAAA;AAExD,QAAM,cAAc,YAAY,MAAM;;AACpC,eAAA;AACA,mBAAS,YAAT,mBAAkB;AAAA,EACpB,GAAG,CAAC,UAAU,CAAC;AAEf,QAAM,cAAc;AAAA,IAClB,OAAO,UAA2B;AAChC,UAAI,CAAC,SAAS,MAAM,WAAW,EAAG;AAElC,YAAM,SAAS,MAAM,YAAY,MAAM,KAAK,KAAK,GAAG,WAAW;AAC/D,UAAI,OAAO,SAAS,GAAG;AACrB,6CAAW;AAAA,MACb;AAGA,UAAI,SAAS,SAAS;AACpB,iBAAS,QAAQ,QAAQ;AAAA,MAC3B;AAAA,IACF;AAAA,IACA,CAAC,aAAa,QAAQ;AAAA,EAAA;AAGxB,SACE,qBAAA,UAAA,EACE,UAAA;AAAA,IAAA;AAAA,MAAC;AAAA,MAAA;AAAA,QACC,KAAK;AAAA,QACL,MAAK;AAAA,QACL,UAAQ;AAAA,QACR;AAAA,QACA,WAAU;AAAA,QACV,UAAU,CAAC,MAAM,YAAY,EAAE,OAAO,KAAK;AAAA,QAC3C,cAAW;AAAA,MAAA;AAAA,IAAA;AAAA,IAEb;AAAA,MAAC;AAAA,MAAA;AAAA,QACC,MAAK;AAAA,QACL,SAAS;AAAA,QACT,UAAU;AAAA,QACV,WAAW;AAAA,UACT;AAAA,UACA,SAAS;AAAA,UACT;AAAA,QAAA;AAAA,QAEF,OAAO,UAAU,cAAc,iBAAiB;AAAA,QAChD,cAAY,cAAc,oBAAoB;AAAA,QAE7C,UAAA,cACC,oBAAC,aAAA,EAAY,WAAU,uBAAsB,IAC3C,QACF,oBAAC,iBAAA,EAAgB,WAAU,UAAS,IAEpC,oBAAC,eAAA,EAAc,WAAU,SAAA,CAAS;AAAA,MAAA;AAAA,IAAA;AAAA,EAEtC,GACF;AAEJ;"}

package/dist/composer/QuoteContext.cjs

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const jsxRuntime = require("react/jsx-runtime");
+const react = require("react");
+const QuoteCtx = react.createContext(null);
+function QuoteProvider({ children }) {
+  const [quote, setQuote] = react.useState(null);
+  const clearQuote = react.useCallback(() => setQuote(null), []);
+  const value = react.useMemo(() => ({ quote, setQuote, clearQuote }), [quote, setQuote, clearQuote]);
+  return /* @__PURE__ */ jsxRuntime.jsx(QuoteCtx.Provider, { value, children });
+}
+function useQuote() {
+  const ctx = react.useContext(QuoteCtx);
+  if (!ctx) {
+    throw new Error("[AthenaSDK] useQuote must be used within <QuoteProvider>");
+  }
+  return ctx;
+}
+function useQuoteFromPostMessage() {
+  const { setQuote } = useQuote();
+  react.useEffect(() => {
+    const handleKeydown = (e) => {
+      var _a;
+      if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === "l") {
+        const sel = window.getSelection();
+        const selection = (_a = sel == null ? void 0 : sel.toString()) == null ? void 0 : _a.trim();
+        if (selection && selection.length > 0) {
+          e.preventDefault();
+          let messageId;
+          let role;
+          let node = sel == null ? void 0 : sel.anchorNode;
+          while (node && node !== document.body) {
+            if (node instanceof HTMLElement) {
+              const dataRole = node.getAttribute("data-role");
+              if (dataRole === "assistant" || dataRole === "user") {
+                role = dataRole;
+                messageId = node.getAttribute("data-message-id") ?? void 0;
+                break;
+              }
+            }
+            node = node.parentElement;
+          }
+          setQuote({ text: selection, sourceRole: role, sourceMessageId: messageId });
+        }
+      }
+    };
+    const handleMessage = (event) => {
+      const data = event.data;
+      if (data && typeof data === "object" && data.type === "athena-add-to-composer" && typeof data.text === "string" && data.text.trim().length > 0) {
+        setQuote({
+          text: data.text,
+          sourceTitle: data.sourceTitle,
+          sourceAssetId: data.sourceAssetId
+        });
+      }
+    };
+    document.addEventListener("keydown", handleKeydown, true);
+    window.addEventListener("message", handleMessage);
+    return () => {
+      document.removeEventListener("keydown", handleKeydown, true);
+      window.removeEventListener("message", handleMessage);
+    };
+  }, [setQuote]);
+}
+exports.QuoteProvider = QuoteProvider;
+exports.useQuote = useQuote;
+exports.useQuoteFromPostMessage = useQuoteFromPostMessage;
+//# sourceMappingURL=QuoteContext.cjs.map

package/dist/composer/QuoteContext.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"QuoteContext.cjs","sources":["../../src/composer/QuoteContext.tsx"],"sourcesContent":["import { createContext, useCallback, useContext, useEffect, useMemo, useState, type ReactNode } from 'react';\n\nexport interface QuoteData {\n  /** The selected/quoted text. */\n  text: string;\n  /** Title of the source (e.g., asset title, document name). */\n  sourceTitle?: string;\n  /** Asset ID of the source (for attribution). */\n  sourceAssetId?: string;\n  /** Message ID of the source message (when quoting from chat). */\n  sourceMessageId?: string;\n  /** Role of the source message ('assistant' | 'user'). */\n  sourceRole?: string;\n}\n\ninterface QuoteContextValue {\n  quote: QuoteData | null;\n  setQuote: (quote: QuoteData | null) => void;\n  clearQuote: () => void;\n}\n\nconst QuoteCtx = createContext<QuoteContextValue | null>(null);\n\nexport function QuoteProvider({ children }: { children: ReactNode }) {\n  const [quote, setQuote] = useState<QuoteData | null>(null);\n  const clearQuote = useCallback(() => setQuote(null), []);\n\n  const value = useMemo(() => ({ quote, setQuote, clearQuote }), [quote, setQuote, clearQuote]);\n\n  return (\n    <QuoteCtx.Provider value={value}>\n      {children}\n    </QuoteCtx.Provider>\n  );\n}\n\nexport function useQuote(): QuoteContextValue {\n  const ctx = useContext(QuoteCtx);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useQuote must be used within <QuoteProvider>');\n  }\n  return ctx;\n}\n\n/**\n * Listens for:\n * 1. Cmd+L / Ctrl+L keydown — grabs the current text selection and sets it as a quote.\n *    `preventDefault` stops the browser from focusing the URL bar.\n * 2. PostMessage events from child iframes (asset panels, embedded content)\n *    with type `athena-add-to-composer`.\n *\n * Mount this once inside AthenaProvider.\n */\nexport function useQuoteFromPostMessage() {\n  const { setQuote } = useQuote();\n\n  useEffect(() => {\n    // ── Cmd+L / Ctrl+L keyboard handler ──────────────────────────────\n    const handleKeydown = (e: KeyboardEvent) => {\n      if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === 'l') {\n        const sel = window.getSelection();\n        const selection = sel?.toString()?.trim();\n\n        if (selection && selection.length > 0) {\n          e.preventDefault();\n\n          // Walk up from the selection anchor to find the message container.\n          // assistant-ui message roots have data-role=\"assistant\" or data-role=\"user\".\n          let messageId: string | undefined;\n          let role: string | undefined;\n          let node = sel?.anchorNode as HTMLElement | null;\n          while (node && node !== document.body) {\n            if (node instanceof HTMLElement) {\n              const dataRole = node.getAttribute('data-role');\n              if (dataRole === 'assistant' || dataRole === 'user') {\n                role = dataRole;\n                // assistant-ui sets data-message-id on message roots\n                messageId = node.getAttribute('data-message-id') ?? undefined;\n                break;\n              }\n            }\n            node = node.parentElement;\n          }\n\n          setQuote({ text: selection, sourceRole: role, sourceMessageId: messageId });\n        }\n      }\n    };\n\n    // ── PostMessage handler (from iframes) ───────────────────────────\n    // NOTE: Accepts messages from any origin by design. The SDK consumer\n    // controls which iframes are embedded, defining the trust boundary.\n    // A future `allowedOrigins` config could restrict this if needed.\n    const handleMessage = (event: MessageEvent) => {\n      const data = event.data;\n      if (\n        data &&\n        typeof data === 'object' &&\n        data.type === 'athena-add-to-composer' &&\n        typeof data.text === 'string' &&\n        data.text.trim().length > 0\n      ) {\n        setQuote({\n          text: data.text,\n          sourceTitle: data.sourceTitle,\n          sourceAssetId: data.sourceAssetId,\n        });\n      }\n    };\n\n    document.addEventListener('keydown', handleKeydown, true); // capture phase to beat the browser\n    window.addEventListener('message', handleMessage);\n\n    return () => {\n      document.removeEventListener('keydown', handleKeydown, true);\n      window.removeEventListener('message', handleMessage);\n    };\n  }, [setQuote]);\n}\n"],"names":["createContext","useState","useCallback","useMemo","jsx","useContext","useEffect"],"mappings":";;;;AAqBA,MAAM,WAAWA,MAAAA,cAAwC,IAAI;AAEtD,SAAS,cAAc,EAAE,YAAqC;AACnE,QAAM,CAAC,OAAO,QAAQ,IAAIC,MAAAA,SAA2B,IAAI;AACzD,QAAM,aAAaC,MAAAA,YAAY,MAAM,SAAS,IAAI,GAAG,CAAA,CAAE;AAEvD,QAAM,QAAQC,MAAAA,QAAQ,OAAO,EAAE,OAAO,UAAU,WAAA,IAAe,CAAC,OAAO,UAAU,UAAU,CAAC;AAE5F,SACEC,2BAAAA,IAAC,SAAS,UAAT,EAAkB,OAChB,SAAA,CACH;AAEJ;AAEO,SAAS,WAA8B;AAC5C,QAAM,MAAMC,MAAAA,WAAW,QAAQ;AAC/B,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,0DAA0D;AAAA,EAC5E;AACA,SAAO;AACT;AAWO,SAAS,0BAA0B;AACxC,QAAM,EAAE,SAAA,IAAa,SAAA;AAErBC,QAAAA,UAAU,MAAM;AAEd,UAAM,gBAAgB,CAAC,MAAqB;;AAC1C,WAAK,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,YAAA,MAAkB,KAAK;AAC3D,cAAM,MAAM,OAAO,aAAA;AACnB,cAAM,aAAY,gCAAK,eAAL,mBAAiB;AAEnC,YAAI,aAAa,UAAU,SAAS,GAAG;AACrC,YAAE,eAAA;AAIF,cAAI;AACJ,cAAI;AACJ,cAAI,OAAO,2BAAK;AAChB,iBAAO,QAAQ,SAAS,SAAS,MAAM;AACrC,gBAAI,gBAAgB,aAAa;AAC/B,oBAAM,WAAW,KAAK,aAAa,WAAW;AAC9C,kBAAI,aAAa,eAAe,aAAa,QAAQ;AACnD,uBAAO;AAEP,4BAAY,KAAK,aAAa,iBAAiB,KAAK;AACpD;AAAA,cACF;AAAA,YACF;AACA,mBAAO,KAAK;AAAA,UACd;AAEA,mBAAS,EAAE,MAAM,WAAW,YAAY,MAAM,iBAAiB,WAAW;AAAA,QAC5E;AAAA,MACF;AAAA,IACF;AAMA,UAAM,gBAAgB,CAAC,UAAwB;AAC7C,YAAM,OAAO,MAAM;AACnB,UACE,QACA,OAAO,SAAS,YAChB,KAAK,SAAS,4BACd,OAAO,KAAK,SAAS,YACrB,KAAK,KAAK,KAAA,EAAO,SAAS,GAC1B;AACA,iBAAS;AAAA,UACP,MAAM,KAAK;AAAA,UACX,aAAa,KAAK;AAAA,UAClB,eAAe,KAAK;AAAA,QAAA,CACrB;AAAA,MACH;AAAA,IACF;AAEA,aAAS,iBAAiB,WAAW,eAAe,IAAI;AACxD,WAAO,iBAAiB,WAAW,aAAa;AAEhD,WAAO,MAAM;AACX,eAAS,oBAAoB,WAAW,eAAe,IAAI;AAC3D,aAAO,oBAAoB,WAAW,aAAa;AAAA,IACrD;AAAA,EACF,GAAG,CAAC,QAAQ,CAAC;AACf;;;;"}

package/dist/composer/QuoteContext.js

@@ -0,0 +1,68 @@
+import { jsx } from "react/jsx-runtime";
+import { useContext, useState, useCallback, useMemo, createContext, useEffect } from "react";
+const QuoteCtx = createContext(null);
+function QuoteProvider({ children }) {
+  const [quote, setQuote] = useState(null);
+  const clearQuote = useCallback(() => setQuote(null), []);
+  const value = useMemo(() => ({ quote, setQuote, clearQuote }), [quote, setQuote, clearQuote]);
+  return /* @__PURE__ */ jsx(QuoteCtx.Provider, { value, children });
+}
+function useQuote() {
+  const ctx = useContext(QuoteCtx);
+  if (!ctx) {
+    throw new Error("[AthenaSDK] useQuote must be used within <QuoteProvider>");
+  }
+  return ctx;
+}
+function useQuoteFromPostMessage() {
+  const { setQuote } = useQuote();
+  useEffect(() => {
+    const handleKeydown = (e) => {
+      var _a;
+      if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === "l") {
+        const sel = window.getSelection();
+        const selection = (_a = sel == null ? void 0 : sel.toString()) == null ? void 0 : _a.trim();
+        if (selection && selection.length > 0) {
+          e.preventDefault();
+          let messageId;
+          let role;
+          let node = sel == null ? void 0 : sel.anchorNode;
+          while (node && node !== document.body) {
+            if (node instanceof HTMLElement) {
+              const dataRole = node.getAttribute("data-role");
+              if (dataRole === "assistant" || dataRole === "user") {
+                role = dataRole;
+                messageId = node.getAttribute("data-message-id") ?? void 0;
+                break;
+              }
+            }
+            node = node.parentElement;
+          }
+          setQuote({ text: selection, sourceRole: role, sourceMessageId: messageId });
+        }
+      }
+    };
+    const handleMessage = (event) => {
+      const data = event.data;
+      if (data && typeof data === "object" && data.type === "athena-add-to-composer" && typeof data.text === "string" && data.text.trim().length > 0) {
+        setQuote({
+          text: data.text,
+          sourceTitle: data.sourceTitle,
+          sourceAssetId: data.sourceAssetId
+        });
+      }
+    };
+    document.addEventListener("keydown", handleKeydown, true);
+    window.addEventListener("message", handleMessage);
+    return () => {
+      document.removeEventListener("keydown", handleKeydown, true);
+      window.removeEventListener("message", handleMessage);
+    };
+  }, [setQuote]);
+}
+export {
+  QuoteProvider,
+  useQuote,
+  useQuoteFromPostMessage
+};
+//# sourceMappingURL=QuoteContext.js.map

package/dist/composer/QuoteContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QuoteContext.js","sources":["../../src/composer/QuoteContext.tsx"],"sourcesContent":["import { createContext, useCallback, useContext, useEffect, useMemo, useState, type ReactNode } from 'react';\n\nexport interface QuoteData {\n  /** The selected/quoted text. */\n  text: string;\n  /** Title of the source (e.g., asset title, document name). */\n  sourceTitle?: string;\n  /** Asset ID of the source (for attribution). */\n  sourceAssetId?: string;\n  /** Message ID of the source message (when quoting from chat). */\n  sourceMessageId?: string;\n  /** Role of the source message ('assistant' | 'user'). */\n  sourceRole?: string;\n}\n\ninterface QuoteContextValue {\n  quote: QuoteData | null;\n  setQuote: (quote: QuoteData | null) => void;\n  clearQuote: () => void;\n}\n\nconst QuoteCtx = createContext<QuoteContextValue | null>(null);\n\nexport function QuoteProvider({ children }: { children: ReactNode }) {\n  const [quote, setQuote] = useState<QuoteData | null>(null);\n  const clearQuote = useCallback(() => setQuote(null), []);\n\n  const value = useMemo(() => ({ quote, setQuote, clearQuote }), [quote, setQuote, clearQuote]);\n\n  return (\n    <QuoteCtx.Provider value={value}>\n      {children}\n    </QuoteCtx.Provider>\n  );\n}\n\nexport function useQuote(): QuoteContextValue {\n  const ctx = useContext(QuoteCtx);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useQuote must be used within <QuoteProvider>');\n  }\n  return ctx;\n}\n\n/**\n * Listens for:\n * 1. Cmd+L / Ctrl+L keydown — grabs the current text selection and sets it as a quote.\n *    `preventDefault` stops the browser from focusing the URL bar.\n * 2. PostMessage events from child iframes (asset panels, embedded content)\n *    with type `athena-add-to-composer`.\n *\n * Mount this once inside AthenaProvider.\n */\nexport function useQuoteFromPostMessage() {\n  const { setQuote } = useQuote();\n\n  useEffect(() => {\n    // ── Cmd+L / Ctrl+L keyboard handler ──────────────────────────────\n    const handleKeydown = (e: KeyboardEvent) => {\n      if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === 'l') {\n        const sel = window.getSelection();\n        const selection = sel?.toString()?.trim();\n\n        if (selection && selection.length > 0) {\n          e.preventDefault();\n\n          // Walk up from the selection anchor to find the message container.\n          // assistant-ui message roots have data-role=\"assistant\" or data-role=\"user\".\n          let messageId: string | undefined;\n          let role: string | undefined;\n          let node = sel?.anchorNode as HTMLElement | null;\n          while (node && node !== document.body) {\n            if (node instanceof HTMLElement) {\n              const dataRole = node.getAttribute('data-role');\n              if (dataRole === 'assistant' || dataRole === 'user') {\n                role = dataRole;\n                // assistant-ui sets data-message-id on message roots\n                messageId = node.getAttribute('data-message-id') ?? undefined;\n                break;\n              }\n            }\n            node = node.parentElement;\n          }\n\n          setQuote({ text: selection, sourceRole: role, sourceMessageId: messageId });\n        }\n      }\n    };\n\n    // ── PostMessage handler (from iframes) ───────────────────────────\n    // NOTE: Accepts messages from any origin by design. The SDK consumer\n    // controls which iframes are embedded, defining the trust boundary.\n    // A future `allowedOrigins` config could restrict this if needed.\n    const handleMessage = (event: MessageEvent) => {\n      const data = event.data;\n      if (\n        data &&\n        typeof data === 'object' &&\n        data.type === 'athena-add-to-composer' &&\n        typeof data.text === 'string' &&\n        data.text.trim().length > 0\n      ) {\n        setQuote({\n          text: data.text,\n          sourceTitle: data.sourceTitle,\n          sourceAssetId: data.sourceAssetId,\n        });\n      }\n    };\n\n    document.addEventListener('keydown', handleKeydown, true); // capture phase to beat the browser\n    window.addEventListener('message', handleMessage);\n\n    return () => {\n      document.removeEventListener('keydown', handleKeydown, true);\n      window.removeEventListener('message', handleMessage);\n    };\n  }, [setQuote]);\n}\n"],"names":[],"mappings":";;AAqBA,MAAM,WAAW,cAAwC,IAAI;AAEtD,SAAS,cAAc,EAAE,YAAqC;AACnE,QAAM,CAAC,OAAO,QAAQ,IAAI,SAA2B,IAAI;AACzD,QAAM,aAAa,YAAY,MAAM,SAAS,IAAI,GAAG,CAAA,CAAE;AAEvD,QAAM,QAAQ,QAAQ,OAAO,EAAE,OAAO,UAAU,WAAA,IAAe,CAAC,OAAO,UAAU,UAAU,CAAC;AAE5F,SACE,oBAAC,SAAS,UAAT,EAAkB,OAChB,SAAA,CACH;AAEJ;AAEO,SAAS,WAA8B;AAC5C,QAAM,MAAM,WAAW,QAAQ;AAC/B,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,0DAA0D;AAAA,EAC5E;AACA,SAAO;AACT;AAWO,SAAS,0BAA0B;AACxC,QAAM,EAAE,SAAA,IAAa,SAAA;AAErB,YAAU,MAAM;AAEd,UAAM,gBAAgB,CAAC,MAAqB;;AAC1C,WAAK,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,YAAA,MAAkB,KAAK;AAC3D,cAAM,MAAM,OAAO,aAAA;AACnB,cAAM,aAAY,gCAAK,eAAL,mBAAiB;AAEnC,YAAI,aAAa,UAAU,SAAS,GAAG;AACrC,YAAE,eAAA;AAIF,cAAI;AACJ,cAAI;AACJ,cAAI,OAAO,2BAAK;AAChB,iBAAO,QAAQ,SAAS,SAAS,MAAM;AACrC,gBAAI,gBAAgB,aAAa;AAC/B,oBAAM,WAAW,KAAK,aAAa,WAAW;AAC9C,kBAAI,aAAa,eAAe,aAAa,QAAQ;AACnD,uBAAO;AAEP,4BAAY,KAAK,aAAa,iBAAiB,KAAK;AACpD;AAAA,cACF;AAAA,YACF;AACA,mBAAO,KAAK;AAAA,UACd;AAEA,mBAAS,EAAE,MAAM,WAAW,YAAY,MAAM,iBAAiB,WAAW;AAAA,QAC5E;AAAA,MACF;AAAA,IACF;AAMA,UAAM,gBAAgB,CAAC,UAAwB;AAC7C,YAAM,OAAO,MAAM;AACnB,UACE,QACA,OAAO,SAAS,YAChB,KAAK,SAAS,4BACd,OAAO,KAAK,SAAS,YACrB,KAAK,KAAK,KAAA,EAAO,SAAS,GAC1B;AACA,iBAAS;AAAA,UACP,MAAM,KAAK;AAAA,UACX,aAAa,KAAK;AAAA,UAClB,eAAe,KAAK;AAAA,QAAA,CACrB;AAAA,MACH;AAAA,IACF;AAEA,aAAS,iBAAiB,WAAW,eAAe,IAAI;AACxD,WAAO,iBAAiB,WAAW,aAAa;AAEhD,WAAO,MAAM;AACX,eAAS,oBAAoB,WAAW,eAAe,IAAI;AAC3D,aAAO,oBAAoB,WAAW,aAAa;AAAA,IACrD;AAAA,EACF,GAAG,CAAC,QAAQ,CAAC;AACf;"}

package/dist/composer/build-composed-message.cjs

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const AttachmentContext = require("./AttachmentContext.cjs");
+function buildComposedMessage(opts) {
+  var _a;
+  const parts = [];
+  if (opts.attachments && opts.attachments.length > 0) {
+    const attachmentMd = AttachmentContext.buildAttachmentMarkdownWithAppUrl({
+      attachments: opts.attachments,
+      appUrl: opts.appUrl
+    });
+    if (attachmentMd) parts.push(attachmentMd);
+  }
+  if (opts.quote) {
+    const quotedLines = opts.quote.text.split("\n").map((l) => `> ${l}`).join("\n");
+    const sourceLabel = opts.quote.sourceTitle ? `From "${opts.quote.sourceTitle}"` : opts.quote.sourceRole === "assistant" ? "Quoting assistant" : "Quoting";
+    parts.push(`${sourceLabel}:
+${quotedLines}`);
+  }
+  const trimmed = (_a = opts.userText) == null ? void 0 : _a.trim();
+  if (trimmed) parts.push(trimmed);
+  return parts.join("\n\n");
+}
+exports.buildComposedMessage = buildComposedMessage;
+//# sourceMappingURL=build-composed-message.cjs.map

package/dist/composer/build-composed-message.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-composed-message.cjs","sources":["../../src/composer/build-composed-message.ts"],"sourcesContent":["import type { UploadedAsset } from './useFileUpload';\nimport type { QuoteData } from './QuoteContext';\nimport { buildAttachmentMarkdownWithAppUrl } from './AttachmentContext';\n\n/**\n * Assembles a composed message from attachments, a quote, and user text.\n * Used by both the TipTap Enter-key submit and the send-button click handler\n * to avoid duplicating the message-assembly logic.\n *\n * Returns an empty string if all inputs are empty.\n */\nexport function buildComposedMessage(opts: {\n  attachments?: UploadedAsset[];\n  quote?: QuoteData | null;\n  userText?: string;\n  appUrl?: string;\n}): string {\n  const parts: string[] = [];\n\n  if (opts.attachments && opts.attachments.length > 0) {\n    const attachmentMd = buildAttachmentMarkdownWithAppUrl({\n      attachments: opts.attachments,\n      appUrl: opts.appUrl,\n    });\n    if (attachmentMd) parts.push(attachmentMd);\n  }\n\n  if (opts.quote) {\n    const quotedLines = opts.quote.text.split('\\n').map((l) => `> ${l}`).join('\\n');\n    const sourceLabel = opts.quote.sourceTitle\n      ? `From \"${opts.quote.sourceTitle}\"`\n      : opts.quote.sourceRole === 'assistant'\n        ? 'Quoting assistant'\n        : 'Quoting';\n    parts.push(`${sourceLabel}:\\n${quotedLines}`);\n  }\n\n  const trimmed = opts.userText?.trim();\n  if (trimmed) parts.push(trimmed);\n\n  return parts.join('\\n\\n');\n}\n"],"names":["buildAttachmentMarkdownWithAppUrl"],"mappings":";;;AAWO,SAAS,qBAAqB,MAK1B;;AACT,QAAM,QAAkB,CAAA;AAExB,MAAI,KAAK,eAAe,KAAK,YAAY,SAAS,GAAG;AACnD,UAAM,eAAeA,kBAAAA,kCAAkC;AAAA,MACrD,aAAa,KAAK;AAAA,MAClB,QAAQ,KAAK;AAAA,IAAA,CACd;AACD,QAAI,aAAc,OAAM,KAAK,YAAY;AAAA,EAC3C;AAEA,MAAI,KAAK,OAAO;AACd,UAAM,cAAc,KAAK,MAAM,KAAK,MAAM,IAAI,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,EAAE,KAAK,IAAI;AAC9E,UAAM,cAAc,KAAK,MAAM,cAC3B,SAAS,KAAK,MAAM,WAAW,MAC/B,KAAK,MAAM,eAAe,cACxB,sBACA;AACN,UAAM,KAAK,GAAG,WAAW;AAAA,EAAM,WAAW,EAAE;AAAA,EAC9C;AAEA,QAAM,WAAU,UAAK,aAAL,mBAAe;AAC/B,MAAI,QAAS,OAAM,KAAK,OAAO;AAE/B,SAAO,MAAM,KAAK,MAAM;AAC1B;;"}

package/dist/composer/build-composed-message.js

@@ -0,0 +1,25 @@
+import { buildAttachmentMarkdownWithAppUrl } from "./AttachmentContext.js";
+function buildComposedMessage(opts) {
+  var _a;
+  const parts = [];
+  if (opts.attachments && opts.attachments.length > 0) {
+    const attachmentMd = buildAttachmentMarkdownWithAppUrl({
+      attachments: opts.attachments,
+      appUrl: opts.appUrl
+    });
+    if (attachmentMd) parts.push(attachmentMd);
+  }
+  if (opts.quote) {
+    const quotedLines = opts.quote.text.split("\n").map((l) => `> ${l}`).join("\n");
+    const sourceLabel = opts.quote.sourceTitle ? `From "${opts.quote.sourceTitle}"` : opts.quote.sourceRole === "assistant" ? "Quoting assistant" : "Quoting";
+    parts.push(`${sourceLabel}:
+${quotedLines}`);
+  }
+  const trimmed = (_a = opts.userText) == null ? void 0 : _a.trim();
+  if (trimmed) parts.push(trimmed);
+  return parts.join("\n\n");
+}
+export {
+  buildComposedMessage
+};
+//# sourceMappingURL=build-composed-message.js.map

package/dist/composer/build-composed-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-composed-message.js","sources":["../../src/composer/build-composed-message.ts"],"sourcesContent":["import type { UploadedAsset } from './useFileUpload';\nimport type { QuoteData } from './QuoteContext';\nimport { buildAttachmentMarkdownWithAppUrl } from './AttachmentContext';\n\n/**\n * Assembles a composed message from attachments, a quote, and user text.\n * Used by both the TipTap Enter-key submit and the send-button click handler\n * to avoid duplicating the message-assembly logic.\n *\n * Returns an empty string if all inputs are empty.\n */\nexport function buildComposedMessage(opts: {\n  attachments?: UploadedAsset[];\n  quote?: QuoteData | null;\n  userText?: string;\n  appUrl?: string;\n}): string {\n  const parts: string[] = [];\n\n  if (opts.attachments && opts.attachments.length > 0) {\n    const attachmentMd = buildAttachmentMarkdownWithAppUrl({\n      attachments: opts.attachments,\n      appUrl: opts.appUrl,\n    });\n    if (attachmentMd) parts.push(attachmentMd);\n  }\n\n  if (opts.quote) {\n    const quotedLines = opts.quote.text.split('\\n').map((l) => `> ${l}`).join('\\n');\n    const sourceLabel = opts.quote.sourceTitle\n      ? `From \"${opts.quote.sourceTitle}\"`\n      : opts.quote.sourceRole === 'assistant'\n        ? 'Quoting assistant'\n        : 'Quoting';\n    parts.push(`${sourceLabel}:\\n${quotedLines}`);\n  }\n\n  const trimmed = opts.userText?.trim();\n  if (trimmed) parts.push(trimmed);\n\n  return parts.join('\\n\\n');\n}\n"],"names":[],"mappings":";AAWO,SAAS,qBAAqB,MAK1B;;AACT,QAAM,QAAkB,CAAA;AAExB,MAAI,KAAK,eAAe,KAAK,YAAY,SAAS,GAAG;AACnD,UAAM,eAAe,kCAAkC;AAAA,MACrD,aAAa,KAAK;AAAA,MAClB,QAAQ,KAAK;AAAA,IAAA,CACd;AACD,QAAI,aAAc,OAAM,KAAK,YAAY;AAAA,EAC3C;AAEA,MAAI,KAAK,OAAO;AACd,UAAM,cAAc,KAAK,MAAM,KAAK,MAAM,IAAI,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,EAAE,KAAK,IAAI;AAC9E,UAAM,cAAc,KAAK,MAAM,cAC3B,SAAS,KAAK,MAAM,WAAW,MAC/B,KAAK,MAAM,eAAe,cACxB,sBACA;AACN,UAAM,KAAK,GAAG,WAAW;AAAA,EAAM,WAAW,EAAE;AAAA,EAC9C;AAEA,QAAM,WAAU,UAAK,aAAL,mBAAe;AAC/B,MAAI,QAAS,OAAM,KAAK,OAAO;AAE/B,SAAO,MAAM,KAAK,MAAM;AAC1B;"}

package/dist/composer/clipboard.cjs

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const IMAGE_EXTENSION_BY_MIME_TYPE = {
+  "image/avif": "avif",
+  "image/bmp": "bmp",
+  "image/gif": "gif",
+  "image/heic": "heic",
+  "image/jpeg": "jpg",
+  "image/png": "png",
+  "image/svg+xml": "svg",
+  "image/tiff": "tiff",
+  "image/webp": "webp"
+};
+const IMAGE_FILE_NAME = /^[^\s\\/]+\.(?:png|jpe?g|gif|webp|svg|bmp|tiff?|heic|avif)$/i;
+function clipboardHasMeaningfulText({
+  clipboardData,
+  pastedFileNames = []
+}) {
+  const types = Array.from(clipboardData.types ?? []);
+  if (typeof clipboardData.getData !== "function") return false;
+  if (types.includes("text/plain")) {
+    const plainText = clipboardData.getData("text/plain").trim();
+    const isFileName = pastedFileNames.includes(plainText) || IMAGE_FILE_NAME.test(plainText);
+    if (plainText.length > 0 && !isFileName) {
+      return true;
+    }
+  }
+  if (types.includes("text/html")) {
+    const html = clipboardData.getData("text/html");
+    const textContent = html.replace(/<[^>]*>/g, "").trim();
+    if (textContent.length > 0) {
+      return true;
+    }
+  }
+  return false;
+}
+function extractPastedImages({
+  clipboardData
+}) {
+  const stamp = Date.now();
+  const images = [];
+  for (const item of Array.from(clipboardData.items ?? [])) {
+    if (!item.type.startsWith("image/")) continue;
+    const blob = item.getAsFile();
+    if (!blob) continue;
+    const originalName = blob.name || "";
+    const ordinal = images.length === 0 ? "" : `-${images.length + 1}`;
+    const extension = IMAGE_EXTENSION_BY_MIME_TYPE[item.type] ?? item.type.slice("image/".length).replace(/[^a-z0-9]/gi, "");
+    images.push({
+      file: new File(
+        [blob, new Blob([])],
+        `pasted-image-${stamp}${ordinal}.${extension || "png"}`,
+        { type: item.type }
+      ),
+      originalName
+    });
+  }
+  return images;
+}
+exports.clipboardHasMeaningfulText = clipboardHasMeaningfulText;
+exports.extractPastedImages = extractPastedImages;
+//# sourceMappingURL=clipboard.cjs.map

package/dist/composer/clipboard.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.cjs","sources":["../../src/composer/clipboard.ts"],"sourcesContent":["const IMAGE_EXTENSION_BY_MIME_TYPE: Record<string, string> = {\n  'image/avif': 'avif',\n  'image/bmp': 'bmp',\n  'image/gif': 'gif',\n  'image/heic': 'heic',\n  'image/jpeg': 'jpg',\n  'image/png': 'png',\n  'image/svg+xml': 'svg',\n  'image/tiff': 'tiff',\n  'image/webp': 'webp',\n};\n\n/** A lone image file name — what Finder and Explorer put in `text/plain` beside a copied image file. */\nconst IMAGE_FILE_NAME = /^[^\\s\\\\/]+\\.(?:png|jpe?g|gif|webp|svg|bmp|tiff?|heic|avif)$/i;\n\n/**\n * Whether a clipboard carries text the user meant to paste: non-blank\n * `text/plain`, or `text/html` with text content once tags are stripped. An\n * Excel, Sheets or Word copy puts the cells' text beside a bitmap of them —\n * the text is the payload and the image is incidental; a copied web image\n * carries only an `<img>` tag, which has no text content; a copied image\n * *file* carries its own name in `text/plain` (Finder, Explorer), which is\n * not content either — pass the pasted files' names so it is recognized.\n * Tolerates the partial `DataTransfer` shapes test environments hand out.\n */\nexport function clipboardHasMeaningfulText({\n  clipboardData,\n  pastedFileNames = [],\n}: {\n  clipboardData: DataTransfer;\n  pastedFileNames?: readonly string[];\n}): boolean {\n  const types = Array.from(clipboardData.types ?? []);\n  if (typeof clipboardData.getData !== 'function') return false;\n\n  if (types.includes('text/plain')) {\n    const plainText = clipboardData.getData('text/plain').trim();\n    const isFileName =\n      pastedFileNames.includes(plainText) || IMAGE_FILE_NAME.test(plainText);\n    if (plainText.length > 0 && !isFileName) {\n      return true;\n    }\n  }\n\n  if (types.includes('text/html')) {\n    const html = clipboardData.getData('text/html');\n    const textContent = html.replace(/<[^>]*>/g, '').trim();\n    if (textContent.length > 0) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nexport interface PastedImage {\n  /** The file as the composer attaches it: renamed so the asset gets a useful, unique title. */\n  file: File;\n  /** The name the clipboard carried — a copied file's own name, or the browser's bitmap default. */\n  originalName: string;\n}\n\n/**\n * The image files of a paste, from the clipboard's items. Each is renamed\n * `pasted-image-<stamp>.<ext>` (the second and later of one paste get a\n * `-2`, `-3`, … suffix) with the extension taken from the MIME type, so a\n * pasted bitmap becomes an asset titled by the paste rather than the\n * browser's `image.png` default.\n */\nexport function extractPastedImages({\n  clipboardData,\n}: {\n  clipboardData: DataTransfer;\n}): PastedImage[] {\n  const stamp = Date.now();\n  const images: PastedImage[] = [];\n  for (const item of Array.from(clipboardData.items ?? [])) {\n    if (!item.type.startsWith('image/')) continue;\n    const blob = item.getAsFile();\n    if (!blob) continue;\n    const originalName = blob.name || '';\n    const ordinal = images.length === 0 ? '' : `-${images.length + 1}`;\n    const extension =\n      IMAGE_EXTENSION_BY_MIME_TYPE[item.type] ??\n      item.type.slice('image/'.length).replace(/[^a-z0-9]/gi, '');\n    // Two parts on purpose: a File built from a single File part shares that\n    // part's name handle in some runtimes (Bun 1.3), so the rename would\n    // either be lost or applied to the clipboard's file as well.\n    images.push({\n      file: new File(\n        [blob, new Blob([])],\n        `pasted-image-${stamp}${ordinal}.${extension || 'png'}`,\n        { type: item.type },\n      ),\n      originalName,\n    });\n  }\n  return images;\n}\n"],"names":[],"mappings":";;AAAA,MAAM,+BAAuD;AAAA,EAC3D,cAAc;AAAA,EACd,aAAa;AAAA,EACb,aAAa;AAAA,EACb,cAAc;AAAA,EACd,cAAc;AAAA,EACd,aAAa;AAAA,EACb,iBAAiB;AAAA,EACjB,cAAc;AAAA,EACd,cAAc;AAChB;AAGA,MAAM,kBAAkB;AAYjB,SAAS,2BAA2B;AAAA,EACzC;AAAA,EACA,kBAAkB,CAAA;AACpB,GAGY;AACV,QAAM,QAAQ,MAAM,KAAK,cAAc,SAAS,CAAA,CAAE;AAClD,MAAI,OAAO,cAAc,YAAY,WAAY,QAAO;AAExD,MAAI,MAAM,SAAS,YAAY,GAAG;AAChC,UAAM,YAAY,cAAc,QAAQ,YAAY,EAAE,KAAA;AACtD,UAAM,aACJ,gBAAgB,SAAS,SAAS,KAAK,gBAAgB,KAAK,SAAS;AACvE,QAAI,UAAU,SAAS,KAAK,CAAC,YAAY;AACvC,aAAO;AAAA,IACT;AAAA,EACF;AAEA,MAAI,MAAM,SAAS,WAAW,GAAG;AAC/B,UAAM,OAAO,cAAc,QAAQ,WAAW;AAC9C,UAAM,cAAc,KAAK,QAAQ,YAAY,EAAE,EAAE,KAAA;AACjD,QAAI,YAAY,SAAS,GAAG;AAC1B,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAgBO,SAAS,oBAAoB;AAAA,EAClC;AACF,GAEkB;AAChB,QAAM,QAAQ,KAAK,IAAA;AACnB,QAAM,SAAwB,CAAA;AAC9B,aAAW,QAAQ,MAAM,KAAK,cAAc,SAAS,CAAA,CAAE,GAAG;AACxD,QAAI,CAAC,KAAK,KAAK,WAAW,QAAQ,EAAG;AACrC,UAAM,OAAO,KAAK,UAAA;AAClB,QAAI,CAAC,KAAM;AACX,UAAM,eAAe,KAAK,QAAQ;AAClC,UAAM,UAAU,OAAO,WAAW,IAAI,KAAK,IAAI,OAAO,SAAS,CAAC;AAChE,UAAM,YACJ,6BAA6B,KAAK,IAAI,KACtC,KAAK,KAAK,MAAM,SAAS,MAAM,EAAE,QAAQ,eAAe,EAAE;AAI5D,WAAO,KAAK;AAAA,MACV,MAAM,IAAI;AAAA,QACR,CAAC,MAAM,IAAI,KAAK,CAAA,CAAE,CAAC;AAAA,QACnB,gBAAgB,KAAK,GAAG,OAAO,IAAI,aAAa,KAAK;AAAA,QACrD,EAAE,MAAM,KAAK,KAAA;AAAA,MAAK;AAAA,MAEpB;AAAA,IAAA,CACD;AAAA,EACH;AACA,SAAO;AACT;;;"}

package/dist/composer/clipboard.d.ts

@@ -1,6 +1,30 @@
-export declare function shouldPrioritizeTextOverImage({ clipboardData, }: {
+/**
+ * Whether a clipboard carries text the user meant to paste: non-blank
+ * `text/plain`, or `text/html` with text content once tags are stripped. An
+ * Excel, Sheets or Word copy puts the cells' text beside a bitmap of them —
+ * the text is the payload and the image is incidental; a copied web image
+ * carries only an `<img>` tag, which has no text content; a copied image
+ * *file* carries its own name in `text/plain` (Finder, Explorer), which is
+ * not content either — pass the pasted files' names so it is recognized.
+ * Tolerates the partial `DataTransfer` shapes test environments hand out.
+ */
+export declare function clipboardHasMeaningfulText({ clipboardData, pastedFileNames, }: {
     clipboardData: DataTransfer;
+    pastedFileNames?: readonly string[];
 }): boolean;
-export declare function getClipboardImageFiles({ clipboardData, }: {
+export interface PastedImage {
+    /** The file as the composer attaches it: renamed so the asset gets a useful, unique title. */
+    file: File;
+    /** The name the clipboard carried — a copied file's own name, or the browser's bitmap default. */
+    originalName: string;
+}
+/**
+ * The image files of a paste, from the clipboard's items. Each is renamed
+ * `pasted-image-<stamp>.<ext>` (the second and later of one paste get a
+ * `-2`, `-3`, … suffix) with the extension taken from the MIME type, so a
+ * pasted bitmap becomes an asset titled by the paste rather than the
+ * browser's `image.png` default.
+ */
+export declare function extractPastedImages({ clipboardData, }: {
     clipboardData: DataTransfer;
-}): File[];
+}): PastedImage[];

package/dist/composer/clipboard.js

@@ -0,0 +1,62 @@
+const IMAGE_EXTENSION_BY_MIME_TYPE = {
+  "image/avif": "avif",
+  "image/bmp": "bmp",
+  "image/gif": "gif",
+  "image/heic": "heic",
+  "image/jpeg": "jpg",
+  "image/png": "png",
+  "image/svg+xml": "svg",
+  "image/tiff": "tiff",
+  "image/webp": "webp"
+};
+const IMAGE_FILE_NAME = /^[^\s\\/]+\.(?:png|jpe?g|gif|webp|svg|bmp|tiff?|heic|avif)$/i;
+function clipboardHasMeaningfulText({
+  clipboardData,
+  pastedFileNames = []
+}) {
+  const types = Array.from(clipboardData.types ?? []);
+  if (typeof clipboardData.getData !== "function") return false;
+  if (types.includes("text/plain")) {
+    const plainText = clipboardData.getData("text/plain").trim();
+    const isFileName = pastedFileNames.includes(plainText) || IMAGE_FILE_NAME.test(plainText);
+    if (plainText.length > 0 && !isFileName) {
+      return true;
+    }
+  }
+  if (types.includes("text/html")) {
+    const html = clipboardData.getData("text/html");
+    const textContent = html.replace(/<[^>]*>/g, "").trim();
+    if (textContent.length > 0) {
+      return true;
+    }
+  }
+  return false;
+}
+function extractPastedImages({
+  clipboardData
+}) {
+  const stamp = Date.now();
+  const images = [];
+  for (const item of Array.from(clipboardData.items ?? [])) {
+    if (!item.type.startsWith("image/")) continue;
+    const blob = item.getAsFile();
+    if (!blob) continue;
+    const originalName = blob.name || "";
+    const ordinal = images.length === 0 ? "" : `-${images.length + 1}`;
+    const extension = IMAGE_EXTENSION_BY_MIME_TYPE[item.type] ?? item.type.slice("image/".length).replace(/[^a-z0-9]/gi, "");
+    images.push({
+      file: new File(
+        [blob, new Blob([])],
+        `pasted-image-${stamp}${ordinal}.${extension || "png"}`,
+        { type: item.type }
+      ),
+      originalName
+    });
+  }
+  return images;
+}
+export {
+  clipboardHasMeaningfulText,
+  extractPastedImages
+};
+//# sourceMappingURL=clipboard.js.map

package/dist/composer/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","sources":["../../src/composer/clipboard.ts"],"sourcesContent":["const IMAGE_EXTENSION_BY_MIME_TYPE: Record<string, string> = {\n  'image/avif': 'avif',\n  'image/bmp': 'bmp',\n  'image/gif': 'gif',\n  'image/heic': 'heic',\n  'image/jpeg': 'jpg',\n  'image/png': 'png',\n  'image/svg+xml': 'svg',\n  'image/tiff': 'tiff',\n  'image/webp': 'webp',\n};\n\n/** A lone image file name — what Finder and Explorer put in `text/plain` beside a copied image file. */\nconst IMAGE_FILE_NAME = /^[^\\s\\\\/]+\\.(?:png|jpe?g|gif|webp|svg|bmp|tiff?|heic|avif)$/i;\n\n/**\n * Whether a clipboard carries text the user meant to paste: non-blank\n * `text/plain`, or `text/html` with text content once tags are stripped. An\n * Excel, Sheets or Word copy puts the cells' text beside a bitmap of them —\n * the text is the payload and the image is incidental; a copied web image\n * carries only an `<img>` tag, which has no text content; a copied image\n * *file* carries its own name in `text/plain` (Finder, Explorer), which is\n * not content either — pass the pasted files' names so it is recognized.\n * Tolerates the partial `DataTransfer` shapes test environments hand out.\n */\nexport function clipboardHasMeaningfulText({\n  clipboardData,\n  pastedFileNames = [],\n}: {\n  clipboardData: DataTransfer;\n  pastedFileNames?: readonly string[];\n}): boolean {\n  const types = Array.from(clipboardData.types ?? []);\n  if (typeof clipboardData.getData !== 'function') return false;\n\n  if (types.includes('text/plain')) {\n    const plainText = clipboardData.getData('text/plain').trim();\n    const isFileName =\n      pastedFileNames.includes(plainText) || IMAGE_FILE_NAME.test(plainText);\n    if (plainText.length > 0 && !isFileName) {\n      return true;\n    }\n  }\n\n  if (types.includes('text/html')) {\n    const html = clipboardData.getData('text/html');\n    const textContent = html.replace(/<[^>]*>/g, '').trim();\n    if (textContent.length > 0) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nexport interface PastedImage {\n  /** The file as the composer attaches it: renamed so the asset gets a useful, unique title. */\n  file: File;\n  /** The name the clipboard carried — a copied file's own name, or the browser's bitmap default. */\n  originalName: string;\n}\n\n/**\n * The image files of a paste, from the clipboard's items. Each is renamed\n * `pasted-image-<stamp>.<ext>` (the second and later of one paste get a\n * `-2`, `-3`, … suffix) with the extension taken from the MIME type, so a\n * pasted bitmap becomes an asset titled by the paste rather than the\n * browser's `image.png` default.\n */\nexport function extractPastedImages({\n  clipboardData,\n}: {\n  clipboardData: DataTransfer;\n}): PastedImage[] {\n  const stamp = Date.now();\n  const images: PastedImage[] = [];\n  for (const item of Array.from(clipboardData.items ?? [])) {\n    if (!item.type.startsWith('image/')) continue;\n    const blob = item.getAsFile();\n    if (!blob) continue;\n    const originalName = blob.name || '';\n    const ordinal = images.length === 0 ? '' : `-${images.length + 1}`;\n    const extension =\n      IMAGE_EXTENSION_BY_MIME_TYPE[item.type] ??\n      item.type.slice('image/'.length).replace(/[^a-z0-9]/gi, '');\n    // Two parts on purpose: a File built from a single File part shares that\n    // part's name handle in some runtimes (Bun 1.3), so the rename would\n    // either be lost or applied to the clipboard's file as well.\n    images.push({\n      file: new File(\n        [blob, new Blob([])],\n        `pasted-image-${stamp}${ordinal}.${extension || 'png'}`,\n        { type: item.type },\n      ),\n      originalName,\n    });\n  }\n  return images;\n}\n"],"names":[],"mappings":"AAAA,MAAM,+BAAuD;AAAA,EAC3D,cAAc;AAAA,EACd,aAAa;AAAA,EACb,aAAa;AAAA,EACb,cAAc;AAAA,EACd,cAAc;AAAA,EACd,aAAa;AAAA,EACb,iBAAiB;AAAA,EACjB,cAAc;AAAA,EACd,cAAc;AAChB;AAGA,MAAM,kBAAkB;AAYjB,SAAS,2BAA2B;AAAA,EACzC;AAAA,EACA,kBAAkB,CAAA;AACpB,GAGY;AACV,QAAM,QAAQ,MAAM,KAAK,cAAc,SAAS,CAAA,CAAE;AAClD,MAAI,OAAO,cAAc,YAAY,WAAY,QAAO;AAExD,MAAI,MAAM,SAAS,YAAY,GAAG;AAChC,UAAM,YAAY,cAAc,QAAQ,YAAY,EAAE,KAAA;AACtD,UAAM,aACJ,gBAAgB,SAAS,SAAS,KAAK,gBAAgB,KAAK,SAAS;AACvE,QAAI,UAAU,SAAS,KAAK,CAAC,YAAY;AACvC,aAAO;AAAA,IACT;AAAA,EACF;AAEA,MAAI,MAAM,SAAS,WAAW,GAAG;AAC/B,UAAM,OAAO,cAAc,QAAQ,WAAW;AAC9C,UAAM,cAAc,KAAK,QAAQ,YAAY,EAAE,EAAE,KAAA;AACjD,QAAI,YAAY,SAAS,GAAG;AAC1B,aAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AACT;AAgBO,SAAS,oBAAoB;AAAA,EAClC;AACF,GAEkB;AAChB,QAAM,QAAQ,KAAK,IAAA;AACnB,QAAM,SAAwB,CAAA;AAC9B,aAAW,QAAQ,MAAM,KAAK,cAAc,SAAS,CAAA,CAAE,GAAG;AACxD,QAAI,CAAC,KAAK,KAAK,WAAW,QAAQ,EAAG;AACrC,UAAM,OAAO,KAAK,UAAA;AAClB,QAAI,CAAC,KAAM;AACX,UAAM,eAAe,KAAK,QAAQ;AAClC,UAAM,UAAU,OAAO,WAAW,IAAI,KAAK,IAAI,OAAO,SAAS,CAAC;AAChE,UAAM,YACJ,6BAA6B,KAAK,IAAI,KACtC,KAAK,KAAK,MAAM,SAAS,MAAM,EAAE,QAAQ,eAAe,EAAE;AAI5D,WAAO,KAAK;AAAA,MACV,MAAM,IAAI;AAAA,QACR,CAAC,MAAM,IAAI,KAAK,CAAA,CAAE,CAAC;AAAA,QACnB,gBAAgB,KAAK,GAAG,OAAO,IAAI,aAAa,KAAK;AAAA,QACrD,EAAE,MAAM,KAAK,KAAA;AAAA,MAAK;AAAA,MAEpB;AAAA,IAAA,CACD;AAAA,EACH;AACA,SAAO;AACT;"}

package/dist/composer/useAppendToComposer.cjs

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react$1 = require("react");
+const react = require("@assistant-ui/react");
+function useAppendToComposer() {
+  const aui = react.useAui();
+  return react$1.useCallback(
+    (text, opts) => {
+      if (opts == null ? void 0 : opts.replace) {
+        aui.composer.setText(text);
+      } else {
+        const current = aui.composer.getState().text;
+        aui.composer.setText(current ? `${current}
+${text}` : text);
+      }
+    },
+    [aui]
+  );
+}
+exports.useAppendToComposer = useAppendToComposer;
+//# sourceMappingURL=useAppendToComposer.cjs.map

package/dist/composer/useAppendToComposer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAppendToComposer.cjs","sources":["../../src/composer/useAppendToComposer.ts"],"sourcesContent":["import { useCallback } from 'react';\nimport { useAui } from '@assistant-ui/react';\n\n/**\n * Hook to programmatically append text to the composer without sending it.\n *\n * Use `useSendMessage()` for workflow shortcuts or other UI that should\n * immediately submit a prompt.\n *\n * Usage:\n *   const append = useAppendToComposer();\n *   append(\"some text to add\");\n *   append(\"quoted text\", { replace: true }); // replaces existing text\n */\nexport function useAppendToComposer() {\n  const aui = useAui();\n\n  return useCallback(\n    (text: string, opts?: { replace?: boolean }) => {\n      if (opts?.replace) {\n        aui.composer.setText(text);\n      } else {\n        const current = aui.composer.getState().text;\n        aui.composer.setText(current ? `${current}\\n${text}` : text);\n      }\n    },\n    [aui],\n  );\n}\n"],"names":["useAui","useCallback"],"mappings":";;;;AAcO,SAAS,sBAAsB;AACpC,QAAM,MAAMA,MAAAA,OAAA;AAEZ,SAAOC,QAAAA;AAAAA,IACL,CAAC,MAAc,SAAiC;AAC9C,UAAI,6BAAM,SAAS;AACjB,YAAI,SAAS,QAAQ,IAAI;AAAA,MAC3B,OAAO;AACL,cAAM,UAAU,IAAI,SAAS,SAAA,EAAW;AACxC,YAAI,SAAS,QAAQ,UAAU,GAAG,OAAO;AAAA,EAAK,IAAI,KAAK,IAAI;AAAA,MAC7D;AAAA,IACF;AAAA,IACA,CAAC,GAAG;AAAA,EAAA;AAER;;"}

package/dist/composer/useAppendToComposer.js

@@ -0,0 +1,21 @@
+import { useCallback } from "react";
+import { useAui } from "@assistant-ui/react";
+function useAppendToComposer() {
+  const aui = useAui();
+  return useCallback(
+    (text, opts) => {
+      if (opts == null ? void 0 : opts.replace) {
+        aui.composer.setText(text);
+      } else {
+        const current = aui.composer.getState().text;
+        aui.composer.setText(current ? `${current}
+${text}` : text);
+      }
+    },
+    [aui]
+  );
+}
+export {
+  useAppendToComposer
+};
+//# sourceMappingURL=useAppendToComposer.js.map

package/dist/composer/useAppendToComposer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAppendToComposer.js","sources":["../../src/composer/useAppendToComposer.ts"],"sourcesContent":["import { useCallback } from 'react';\nimport { useAui } from '@assistant-ui/react';\n\n/**\n * Hook to programmatically append text to the composer without sending it.\n *\n * Use `useSendMessage()` for workflow shortcuts or other UI that should\n * immediately submit a prompt.\n *\n * Usage:\n *   const append = useAppendToComposer();\n *   append(\"some text to add\");\n *   append(\"quoted text\", { replace: true }); // replaces existing text\n */\nexport function useAppendToComposer() {\n  const aui = useAui();\n\n  return useCallback(\n    (text: string, opts?: { replace?: boolean }) => {\n      if (opts?.replace) {\n        aui.composer.setText(text);\n      } else {\n        const current = aui.composer.getState().text;\n        aui.composer.setText(current ? `${current}\\n${text}` : text);\n      }\n    },\n    [aui],\n  );\n}\n"],"names":[],"mappings":";;AAcO,SAAS,sBAAsB;AACpC,QAAM,MAAM,OAAA;AAEZ,SAAO;AAAA,IACL,CAAC,MAAc,SAAiC;AAC9C,UAAI,6BAAM,SAAS;AACjB,YAAI,SAAS,QAAQ,IAAI;AAAA,MAC3B,OAAO;AACL,cAAM,UAAU,IAAI,SAAS,SAAA,EAAW;AACxC,YAAI,SAAS,QAAQ,UAAU,GAAG,OAAO;AAAA,EAAK,IAAI,KAAK,IAAI;AAAA,MAC7D;AAAA,IACF;AAAA,IACA,CAAC,GAAG;AAAA,EAAA;AAER;"}

package/dist/composer/useAttachFiles.cjs

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const athenaDiagnostics = require("../diagnostics/athena-diagnostics.cjs");
+const AttachmentContext = require("./AttachmentContext.cjs");
+const useFileUpload = require("./useFileUpload.cjs");
+const ATTACH_FAILURE_MESSAGE = {
+  paperclip: "Failed to attach the selected files",
+  drop: "Failed to attach the dropped files",
+  paste: "Failed to attach the pasted images"
+};
+function useAttachFiles() {
+  const { upload, isUploading, error, clearError } = useFileUpload.useFileUpload();
+  const { addAttachments, setIsUploading } = AttachmentContext.useAttachments();
+  const attachFiles = react.useCallback(
+    async (files, source) => {
+      if (files.length === 0) return [];
+      setIsUploading(true);
+      try {
+        const assets = await upload([...files]);
+        if (assets.length > 0) addAttachments(assets);
+        return assets;
+      } catch (error2) {
+        athenaDiagnostics.athenaDiagnostics.error(
+          "composer.attachment.error",
+          error2,
+          { code: "attachment_failed", message: ATTACH_FAILURE_MESSAGE[source] },
+          { source, count: files.length }
+        );
+        return [];
+      } finally {
+        setIsUploading(false);
+      }
+    },
+    [addAttachments, setIsUploading, upload]
+  );
+  return { attachFiles, isUploading, error, clearError };
+}
+exports.useAttachFiles = useAttachFiles;
+//# sourceMappingURL=useAttachFiles.cjs.map

package/dist/composer/useAttachFiles.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAttachFiles.cjs","sources":["../../src/composer/useAttachFiles.ts"],"sourcesContent":["import { useCallback } from 'react';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport { useAttachments } from './AttachmentContext';\nimport { useFileUpload, type UploadedAsset } from './useFileUpload';\n\n/** Which intake the files came through — carried on the diagnostics event. */\nexport type AttachFilesSource = 'paperclip' | 'drop' | 'paste';\n\nconst ATTACH_FAILURE_MESSAGE: Record<AttachFilesSource, string> = {\n  paperclip: 'Failed to attach the selected files',\n  drop: 'Failed to attach the dropped files',\n  paste: 'Failed to attach the pasted images',\n};\n\nexport interface UseAttachFilesReturn {\n  /**\n   * Upload files as Athena assets and add them to the attachment pills.\n   * Resolves to the assets attached; a failed upload resolves to `[]` after\n   * recording `composer.attachment.error` on the diagnostics bus (and in\n   * `error`).\n   */\n  attachFiles: (files: readonly File[], source: AttachFilesSource) => Promise<UploadedAsset[]>;\n  /** This intake's own upload in flight. */\n  isUploading: boolean;\n  /** Last failure of this intake, for its own affordance. */\n  error: string | null;\n  clearError: () => void;\n}\n\n/**\n * The one intake path for the attachment pills: the paperclip, the drop zone\n * and the composer's paste all upload through here, so a failure reaches the\n * diagnostics bus the same way and the shared `isUploading` flag — which\n * parks every submit path — is set for exactly the upload's duration.\n */\nexport function useAttachFiles(): UseAttachFilesReturn {\n  const { upload, isUploading, error, clearError } = useFileUpload();\n  const { addAttachments, setIsUploading } = useAttachments();\n\n  const attachFiles = useCallback(\n    async (files: readonly File[], source: AttachFilesSource): Promise<UploadedAsset[]> => {\n      if (files.length === 0) return [];\n      setIsUploading(true);\n      try {\n        const assets = await upload([...files]);\n        if (assets.length > 0) addAttachments(assets);\n        return assets;\n      } catch (error) {\n        athenaDiagnostics.error(\n          'composer.attachment.error',\n          error,\n          { code: 'attachment_failed', message: ATTACH_FAILURE_MESSAGE[source] },\n          { source, count: files.length },\n        );\n        return [];\n      } finally {\n        setIsUploading(false);\n      }\n    },\n    [addAttachments, setIsUploading, upload],\n  );\n\n  return { attachFiles, isUploading, error, clearError };\n}\n"],"names":["useFileUpload","useAttachments","useCallback","error","athenaDiagnostics"],"mappings":";;;;;;AAQA,MAAM,yBAA4D;AAAA,EAChE,WAAW;AAAA,EACX,MAAM;AAAA,EACN,OAAO;AACT;AAuBO,SAAS,iBAAuC;AACrD,QAAM,EAAE,QAAQ,aAAa,OAAO,WAAA,IAAeA,cAAAA,cAAA;AACnD,QAAM,EAAE,gBAAgB,eAAA,IAAmBC,iCAAA;AAE3C,QAAM,cAAcC,MAAAA;AAAAA,IAClB,OAAO,OAAwB,WAAwD;AACrF,UAAI,MAAM,WAAW,EAAG,QAAO,CAAA;AAC/B,qBAAe,IAAI;AACnB,UAAI;AACF,cAAM,SAAS,MAAM,OAAO,CAAC,GAAG,KAAK,CAAC;AACtC,YAAI,OAAO,SAAS,EAAG,gBAAe,MAAM;AAC5C,eAAO;AAAA,MACT,SAASC,QAAO;AACdC,0BAAAA,kBAAkB;AAAA,UAChB;AAAA,UACAD;AAAAA,UACA,EAAE,MAAM,qBAAqB,SAAS,uBAAuB,MAAM,EAAA;AAAA,UACnE,EAAE,QAAQ,OAAO,MAAM,OAAA;AAAA,QAAO;AAEhC,eAAO,CAAA;AAAA,MACT,UAAA;AACE,uBAAe,KAAK;AAAA,MACtB;AAAA,IACF;AAAA,IACA,CAAC,gBAAgB,gBAAgB,MAAM;AAAA,EAAA;AAGzC,SAAO,EAAE,aAAa,aAAa,OAAO,WAAA;AAC5C;;"}

package/dist/composer/useAttachFiles.d.ts

@@ -0,0 +1,24 @@
+import { type UploadedAsset } from './useFileUpload';
+/** Which intake the files came through — carried on the diagnostics event. */
+export type AttachFilesSource = 'paperclip' | 'drop' | 'paste';
+export interface UseAttachFilesReturn {
+    /**
+     * Upload files as Athena assets and add them to the attachment pills.
+     * Resolves to the assets attached; a failed upload resolves to `[]` after
+     * recording `composer.attachment.error` on the diagnostics bus (and in
+     * `error`).
+     */
+    attachFiles: (files: readonly File[], source: AttachFilesSource) => Promise<UploadedAsset[]>;
+    /** This intake's own upload in flight. */
+    isUploading: boolean;
+    /** Last failure of this intake, for its own affordance. */
+    error: string | null;
+    clearError: () => void;
+}
+/**
+ * The one intake path for the attachment pills: the paperclip, the drop zone
+ * and the composer's paste all upload through here, so a failure reaches the
+ * diagnostics bus the same way and the shared `isUploading` flag — which
+ * parks every submit path — is set for exactly the upload's duration.
+ */
+export declare function useAttachFiles(): UseAttachFilesReturn;