@athenaintel/react 0.42.2 → 0.48.0

package/dist/composer/ComposerDropZone.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const jsxRuntime = require("react/jsx-runtime");
-const react = require("react");
+const require$$0 = require("react");
 const AttachmentContext = require("./AttachmentContext.cjs");
 const useAttachFiles = require("./useAttachFiles.cjs");
 const cnfast = require("cnfast");
@@ -11,23 +11,23 @@ const ComposerDropZone = ({
   onUpload,
   onDragActiveChange
 }) => {
-  const [isDragOver, setIsDragOver] = react.useState(false);
+  const [isDragOver, setIsDragOver] = require$$0.useState(false);
   const { attachFiles } = useAttachFiles.useAttachFiles();
   const { isUploading } = AttachmentContext.useAttachments();
-  const onDragActiveChangeRef = react.useRef(onDragActiveChange);
+  const onDragActiveChangeRef = require$$0.useRef(onDragActiveChange);
   onDragActiveChangeRef.current = onDragActiveChange;
-  react.useEffect(() => {
+  require$$0.useEffect(() => {
     var _a;
     (_a = onDragActiveChangeRef.current) == null ? void 0 : _a.call(onDragActiveChangeRef, isDragOver);
   }, [isDragOver]);
-  const handleDragOver = react.useCallback((e) => {
+  const handleDragOver = require$$0.useCallback((e) => {
     e.preventDefault();
     e.stopPropagation();
     if (e.dataTransfer.types.includes("Files")) {
       setIsDragOver(true);
     }
   }, []);
-  const handleDragLeave = react.useCallback((e) => {
+  const handleDragLeave = require$$0.useCallback((e) => {
     e.preventDefault();
     e.stopPropagation();
     const rect = e.currentTarget.getBoundingClientRect();
@@ -36,7 +36,7 @@ const ComposerDropZone = ({
       setIsDragOver(false);
     }
   }, []);
-  const handleDrop = react.useCallback(
+  const handleDrop = require$$0.useCallback(
     async (e) => {
       e.preventDefault();
       e.stopPropagation();

package/dist/composer/ComposerDropZone.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"ComposerDropZone.cjs","sources":["../../src/composer/ComposerDropZone.tsx"],"sourcesContent":["import {\n  useCallback,\n  useEffect,\n  useRef,\n  useState,\n  type DragEvent,\n  type FC,\n  type ReactNode,\n} from 'react';\nimport { useAttachments } from './AttachmentContext';\nimport { useAttachFiles } from './useAttachFiles';\nimport type { UploadedAsset } from './useFileUpload';\nimport { cn } from '../lib/utils';\n\nexport interface ComposerDropZoneProps {\n  children: ReactNode;\n  className?: string;\n  /** Called after files are uploaded via drag-and-drop. */\n  onUpload?: (assets: UploadedAsset[]) => void;\n  /**\n   * Reports whether files are being dragged over the zone, so the composer\n   * surface inside can tint itself (`ChatComposerDock dragActive`). Called\n   * with `false` on mount and again on every change.\n   */\n  onDragActiveChange?: (active: boolean) => void;\n}\n\n/**\n * Wraps the composer area with drag-and-drop file upload support.\n * Shows a visual drop indicator when files are dragged over.\n */\nexport const ComposerDropZone: FC<ComposerDropZoneProps> = ({\n  children,\n  className,\n  onUpload,\n  onDragActiveChange,\n}) => {\n  const [isDragOver, setIsDragOver] = useState(false);\n  const { attachFiles } = useAttachFiles();\n  const { isUploading } = useAttachments();\n\n  const onDragActiveChangeRef = useRef(onDragActiveChange);\n  onDragActiveChangeRef.current = onDragActiveChange;\n  useEffect(() => {\n    onDragActiveChangeRef.current?.(isDragOver);\n  }, [isDragOver]);\n\n  const handleDragOver = useCallback((e: DragEvent) => {\n    e.preventDefault();\n    e.stopPropagation();\n    if (e.dataTransfer.types.includes('Files')) {\n      setIsDragOver(true);\n    }\n  }, []);\n\n  const handleDragLeave = useCallback((e: DragEvent) => {\n    e.preventDefault();\n    e.stopPropagation();\n    const rect = (e.currentTarget as HTMLElement).getBoundingClientRect();\n    const { clientX, clientY } = e;\n    if (\n      clientX < rect.left ||\n      clientX > rect.right ||\n      clientY < rect.top ||\n      clientY > rect.bottom\n    ) {\n      setIsDragOver(false);\n    }\n  }, []);\n\n  const handleDrop = useCallback(\n    async (e: DragEvent) => {\n      e.preventDefault();\n      e.stopPropagation();\n      setIsDragOver(false);\n\n      const files = Array.from(e.dataTransfer.files);\n      if (files.length === 0) return;\n\n      const assets = await attachFiles(files, 'drop');\n      if (assets.length > 0) {\n        onUpload?.(assets);\n      }\n    },\n    [attachFiles, onUpload],\n  );\n\n  return (\n    <div\n      className={cn('relative', className)}\n      onDragOver={handleDragOver}\n      onDragLeave={handleDragLeave}\n      onDrop={handleDrop}\n    >\n      {children}\n      {isDragOver && !isUploading && (\n        <div className=\"aui-drop-overlay pointer-events-none absolute inset-0 z-20 flex items-center justify-center rounded-2xl border-2 border-dashed border-primary/50 bg-primary/5\">\n          <span className=\"text-sm font-medium text-primary\">Drop files to upload</span>\n        </div>\n      )}\n    </div>\n  );\n};\n"],"names":["useState","useAttachFiles","useAttachments","useRef","useEffect","useCallback","jsxs","cn","jsx"],"mappings":";;;;;;;AA+BO,MAAM,mBAA8C,CAAC;AAAA,EAC1D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAAM;AACJ,QAAM,CAAC,YAAY,aAAa,IAAIA,MAAAA,SAAS,KAAK;AAClD,QAAM,EAAE,YAAA,IAAgBC,8BAAA;AACxB,QAAM,EAAE,YAAA,IAAgBC,iCAAA;AAExB,QAAM,wBAAwBC,MAAAA,OAAO,kBAAkB;AACvD,wBAAsB,UAAU;AAChCC,QAAAA,UAAU,MAAM;;AACd,gCAAsB,YAAtB,+CAAgC;AAAA,EAClC,GAAG,CAAC,UAAU,CAAC;AAEf,QAAM,iBAAiBC,kBAAY,CAAC,MAAiB;AACnD,MAAE,eAAA;AACF,MAAE,gBAAA;AACF,QAAI,EAAE,aAAa,MAAM,SAAS,OAAO,GAAG;AAC1C,oBAAc,IAAI;AAAA,IACpB;AAAA,EACF,GAAG,CAAA,CAAE;AAEL,QAAM,kBAAkBA,kBAAY,CAAC,MAAiB;AACpD,MAAE,eAAA;AACF,MAAE,gBAAA;AACF,UAAM,OAAQ,EAAE,cAA8B,sBAAA;AAC9C,UAAM,EAAE,SAAS,QAAA,IAAY;AAC7B,QACE,UAAU,KAAK,QACf,UAAU,KAAK,SACf,UAAU,KAAK,OACf,UAAU,KAAK,QACf;AACA,oBAAc,KAAK;AAAA,IACrB;AAAA,EACF,GAAG,CAAA,CAAE;AAEL,QAAM,aAAaA,MAAAA;AAAAA,IACjB,OAAO,MAAiB;AACtB,QAAE,eAAA;AACF,QAAE,gBAAA;AACF,oBAAc,KAAK;AAEnB,YAAM,QAAQ,MAAM,KAAK,EAAE,aAAa,KAAK;AAC7C,UAAI,MAAM,WAAW,EAAG;AAExB,YAAM,SAAS,MAAM,YAAY,OAAO,MAAM;AAC9C,UAAI,OAAO,SAAS,GAAG;AACrB,6CAAW;AAAA,MACb;AAAA,IACF;AAAA,IACA,CAAC,aAAa,QAAQ;AAAA,EAAA;AAGxB,SACEC,2BAAAA;AAAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAWC,OAAAA,GAAG,YAAY,SAAS;AAAA,MACnC,YAAY;AAAA,MACZ,aAAa;AAAA,MACb,QAAQ;AAAA,MAEP,UAAA;AAAA,QAAA;AAAA,QACA,cAAc,CAAC,eACdC,2BAAAA,IAAC,OAAA,EAAI,WAAU,iKACb,UAAAA,2BAAAA,IAAC,QAAA,EAAK,WAAU,oCAAmC,UAAA,uBAAA,CAAoB,EAAA,CACzE;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAIR;;"}
+{"version":3,"file":"ComposerDropZone.cjs","sources":["../../src/composer/ComposerDropZone.tsx"],"sourcesContent":["import {\n  useCallback,\n  useEffect,\n  useRef,\n  useState,\n  type DragEvent,\n  type FC,\n  type ReactNode,\n} from 'react';\nimport { useAttachments } from './AttachmentContext';\nimport { useAttachFiles } from './useAttachFiles';\nimport type { UploadedAsset } from './useFileUpload';\nimport { cn } from '../lib/utils';\n\nexport interface ComposerDropZoneProps {\n  children: ReactNode;\n  className?: string;\n  /** Called after files are uploaded via drag-and-drop. */\n  onUpload?: (assets: UploadedAsset[]) => void;\n  /**\n   * Reports whether files are being dragged over the zone, so the composer\n   * surface inside can tint itself (`ChatComposerDock dragActive`). Called\n   * with `false` on mount and again on every change.\n   */\n  onDragActiveChange?: (active: boolean) => void;\n}\n\n/**\n * Wraps the composer area with drag-and-drop file upload support.\n * Shows a visual drop indicator when files are dragged over.\n */\nexport const ComposerDropZone: FC<ComposerDropZoneProps> = ({\n  children,\n  className,\n  onUpload,\n  onDragActiveChange,\n}) => {\n  const [isDragOver, setIsDragOver] = useState(false);\n  const { attachFiles } = useAttachFiles();\n  const { isUploading } = useAttachments();\n\n  const onDragActiveChangeRef = useRef(onDragActiveChange);\n  onDragActiveChangeRef.current = onDragActiveChange;\n  useEffect(() => {\n    onDragActiveChangeRef.current?.(isDragOver);\n  }, [isDragOver]);\n\n  const handleDragOver = useCallback((e: DragEvent) => {\n    e.preventDefault();\n    e.stopPropagation();\n    if (e.dataTransfer.types.includes('Files')) {\n      setIsDragOver(true);\n    }\n  }, []);\n\n  const handleDragLeave = useCallback((e: DragEvent) => {\n    e.preventDefault();\n    e.stopPropagation();\n    const rect = (e.currentTarget as HTMLElement).getBoundingClientRect();\n    const { clientX, clientY } = e;\n    if (\n      clientX < rect.left ||\n      clientX > rect.right ||\n      clientY < rect.top ||\n      clientY > rect.bottom\n    ) {\n      setIsDragOver(false);\n    }\n  }, []);\n\n  const handleDrop = useCallback(\n    async (e: DragEvent) => {\n      e.preventDefault();\n      e.stopPropagation();\n      setIsDragOver(false);\n\n      const files = Array.from(e.dataTransfer.files);\n      if (files.length === 0) return;\n\n      const assets = await attachFiles(files, 'drop');\n      if (assets.length > 0) {\n        onUpload?.(assets);\n      }\n    },\n    [attachFiles, onUpload],\n  );\n\n  return (\n    <div\n      className={cn('relative', className)}\n      onDragOver={handleDragOver}\n      onDragLeave={handleDragLeave}\n      onDrop={handleDrop}\n    >\n      {children}\n      {isDragOver && !isUploading && (\n        <div className=\"aui-drop-overlay pointer-events-none absolute inset-0 z-20 flex items-center justify-center rounded-2xl border-2 border-dashed border-primary/50 bg-primary/5\">\n          <span className=\"text-sm font-medium text-primary\">Drop files to upload</span>\n        </div>\n      )}\n    </div>\n  );\n};\n"],"names":["useState","useAttachFiles","useAttachments","useRef","useEffect","useCallback","jsxs","cn","jsx"],"mappings":";;;;;;;AA+BO,MAAM,mBAA8C,CAAC;AAAA,EAC1D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAAM;AACJ,QAAM,CAAC,YAAY,aAAa,IAAIA,WAAAA,SAAS,KAAK;AAClD,QAAM,EAAE,YAAA,IAAgBC,8BAAA;AACxB,QAAM,EAAE,YAAA,IAAgBC,iCAAA;AAExB,QAAM,wBAAwBC,WAAAA,OAAO,kBAAkB;AACvD,wBAAsB,UAAU;AAChCC,aAAAA,UAAU,MAAM;;AACd,gCAAsB,YAAtB,+CAAgC;AAAA,EAClC,GAAG,CAAC,UAAU,CAAC;AAEf,QAAM,iBAAiBC,uBAAY,CAAC,MAAiB;AACnD,MAAE,eAAA;AACF,MAAE,gBAAA;AACF,QAAI,EAAE,aAAa,MAAM,SAAS,OAAO,GAAG;AAC1C,oBAAc,IAAI;AAAA,IACpB;AAAA,EACF,GAAG,CAAA,CAAE;AAEL,QAAM,kBAAkBA,uBAAY,CAAC,MAAiB;AACpD,MAAE,eAAA;AACF,MAAE,gBAAA;AACF,UAAM,OAAQ,EAAE,cAA8B,sBAAA;AAC9C,UAAM,EAAE,SAAS,QAAA,IAAY;AAC7B,QACE,UAAU,KAAK,QACf,UAAU,KAAK,SACf,UAAU,KAAK,OACf,UAAU,KAAK,QACf;AACA,oBAAc,KAAK;AAAA,IACrB;AAAA,EACF,GAAG,CAAA,CAAE;AAEL,QAAM,aAAaA,WAAAA;AAAAA,IACjB,OAAO,MAAiB;AACtB,QAAE,eAAA;AACF,QAAE,gBAAA;AACF,oBAAc,KAAK;AAEnB,YAAM,QAAQ,MAAM,KAAK,EAAE,aAAa,KAAK;AAC7C,UAAI,MAAM,WAAW,EAAG;AAExB,YAAM,SAAS,MAAM,YAAY,OAAO,MAAM;AAC9C,UAAI,OAAO,SAAS,GAAG;AACrB,6CAAW;AAAA,MACb;AAAA,IACF;AAAA,IACA,CAAC,aAAa,QAAQ;AAAA,EAAA;AAGxB,SACEC,2BAAAA;AAAAA,IAAC;AAAA,IAAA;AAAA,MACC,WAAWC,OAAAA,GAAG,YAAY,SAAS;AAAA,MACnC,YAAY;AAAA,MACZ,aAAa;AAAA,MACb,QAAQ;AAAA,MAEP,UAAA;AAAA,QAAA;AAAA,QACA,cAAc,CAAC,eACdC,2BAAAA,IAAC,OAAA,EAAI,WAAU,iKACb,UAAAA,2BAAAA,IAAC,QAAA,EAAK,WAAU,oCAAmC,UAAA,uBAAA,CAAoB,EAAA,CACzE;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAIR;;"}

package/dist/composer/FileUploadButton.cjs

@@ -2,22 +2,26 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const jsxRuntime = require("react/jsx-runtime");
 const lucideReact = require("lucide-react");
-const react = require("react");
+const require$$0 = require("react");
 const useAttachFiles = require("./useAttachFiles.cjs");
+const tooltip = require("../ui/tooltip.cjs");
 const cnfast = require("cnfast");
 const FileUploadButton = ({
   className,
   onUpload,
-  accept
+  accept,
+  disabledReason = null
 }) => {
-  const inputRef = react.useRef(null);
+  const inputRef = require$$0.useRef(null);
   const { attachFiles, isUploading, error, clearError } = useAttachFiles.useAttachFiles();
-  const handleClick = react.useCallback(() => {
+  const unavailable = Boolean(disabledReason);
+  const handleClick = require$$0.useCallback(() => {
     var _a;
+    if (unavailable) return;
     clearError();
     (_a = inputRef.current) == null ? void 0 : _a.click();
-  }, [clearError]);
-  const handleFiles = react.useCallback(
+  }, [clearError, unavailable]);
+  const handleFiles = require$$0.useCallback(
     async (files) => {
       if (!files || files.length === 0) return;
       const assets = await attachFiles(Array.from(files), "paperclip");
@@ -30,6 +34,25 @@ const FileUploadButton = ({
     },
     [attachFiles, onUpload]
   );
+  const button = /* @__PURE__ */ jsxRuntime.jsx(
+    "button",
+    {
+      type: "button",
+      onClick: handleClick,
+      disabled: isUploading,
+      "aria-disabled": unavailable || void 0,
+      "data-unavailable": unavailable || void 0,
+      className: cnfast.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,
+        unavailable && "cursor-not-allowed opacity-30 hover:bg-transparent hover:text-muted-foreground"
+      ),
+      title: unavailable ? void 0 : error ?? (isUploading ? "Uploading..." : "Attach files"),
+      "aria-label": isUploading ? "Uploading files" : "Attach files",
+      children: isUploading ? /* @__PURE__ */ jsxRuntime.jsx(lucideReact.Loader2Icon, { className: "size-4 animate-spin" }) : error ? /* @__PURE__ */ jsxRuntime.jsx(lucideReact.AlertCircleIcon, { className: "size-4" }) : /* @__PURE__ */ jsxRuntime.jsx(lucideReact.PaperclipIcon, { className: "size-4" })
+    }
+  );
   return /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
     /* @__PURE__ */ jsxRuntime.jsx(
       "input",
@@ -43,22 +66,14 @@ const FileUploadButton = ({
         "aria-label": "Upload files"
       }
     ),
-    /* @__PURE__ */ jsxRuntime.jsx(
-      "button",
-      {
-        type: "button",
-        onClick: handleClick,
-        disabled: isUploading,
-        className: cnfast.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__ */ jsxRuntime.jsx(lucideReact.Loader2Icon, { className: "size-4 animate-spin" }) : error ? /* @__PURE__ */ jsxRuntime.jsx(lucideReact.AlertCircleIcon, { className: "size-4" }) : /* @__PURE__ */ jsxRuntime.jsx(lucideReact.PaperclipIcon, { className: "size-4" })
-      }
-    )
+    unavailable ? (
+      // The reason in the SDK's tooltip, which opens on keyboard focus as well as on hover (a
+      // native title shows only to a pointer).
+      /* @__PURE__ */ jsxRuntime.jsxs(tooltip.Tooltip, { children: [
+        /* @__PURE__ */ jsxRuntime.jsx(tooltip.TooltipTrigger, { asChild: true, children: button }),
+        /* @__PURE__ */ jsxRuntime.jsx(tooltip.TooltipContent, { side: "bottom", children: disabledReason })
+      ] })
+    ) : button
   ] });
 };
 exports.FileUploadButton = FileUploadButton;

package/dist/composer/FileUploadButton.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"FileUploadButton.cjs","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":["useRef","useAttachFiles","useCallback","jsxs","Fragment","jsx","cn","Loader2Icon","AlertCircleIcon","PaperclipIcon"],"mappings":";;;;;;;AAmBO,MAAM,mBAA8C,CAAC;AAAA,EAC1D;AAAA,EACA;AAAA,EACA;AACF,MAAM;AACJ,QAAM,WAAWA,MAAAA,OAAyB,IAAI;AAC9C,QAAM,EAAE,aAAa,aAAa,OAAO,WAAA,IAAeC,eAAAA,eAAA;AAExD,QAAM,cAAcC,MAAAA,YAAY,MAAM;;AACpC,eAAA;AACA,mBAAS,YAAT,mBAAkB;AAAA,EACpB,GAAG,CAAC,UAAU,CAAC;AAEf,QAAM,cAAcA,MAAAA;AAAAA,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,SACEC,2BAAAA,KAAAC,qBAAA,EACE,UAAA;AAAA,IAAAC,2BAAAA;AAAAA,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,IAEbA,2BAAAA;AAAAA,MAAC;AAAA,MAAA;AAAA,QACC,MAAK;AAAA,QACL,SAAS;AAAA,QACT,UAAU;AAAA,QACV,WAAWC,OAAAA;AAAAA,UACT;AAAA,UACA,SAAS;AAAA,UACT;AAAA,QAAA;AAAA,QAEF,OAAO,UAAU,cAAc,iBAAiB;AAAA,QAChD,cAAY,cAAc,oBAAoB;AAAA,QAE7C,UAAA,cACCD,2BAAAA,IAACE,YAAAA,aAAA,EAAY,WAAU,uBAAsB,IAC3C,QACFF,2BAAAA,IAACG,YAAAA,iBAAA,EAAgB,WAAU,UAAS,IAEpCH,2BAAAA,IAACI,2BAAA,EAAc,WAAU,SAAA,CAAS;AAAA,MAAA;AAAA,IAAA;AAAA,EAEtC,GACF;AAEJ;;"}
+{"version":3,"file":"FileUploadButton.cjs","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';\nimport { Tooltip, TooltipContent, TooltipTrigger } from '../ui/tooltip';\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   * Why attaching is off right now, e.g. \"Needs a connection…\" while the host knows Athena can't be\n   * reached: the button shows disabled with this in its tooltip and the file picker does not open.\n   * It stays focusable, and the tooltip opens on keyboard focus as on hover. `null` or absent: on.\n   */\n  disabledReason?: string | null;\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  disabledReason = null,\n}) => {\n  const inputRef = useRef<HTMLInputElement>(null);\n  const { attachFiles, isUploading, error, clearError } = useAttachFiles();\n  const unavailable = Boolean(disabledReason);\n\n  const handleClick = useCallback(() => {\n    if (unavailable) return;\n    clearError();\n    inputRef.current?.click();\n  }, [clearError, unavailable]);\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  const button = (\n    <button\n      type=\"button\"\n      onClick={handleClick}\n      disabled={isUploading}\n      // Off with a reason, it keeps its pointer and its focus: the reason has to be readable.\n      aria-disabled={unavailable || undefined}\n      data-unavailable={unavailable || undefined}\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        unavailable &&\n          'cursor-not-allowed opacity-30 hover:bg-transparent hover:text-muted-foreground',\n      )}\n      title={unavailable ? undefined : (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  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      {unavailable ? (\n        // The reason in the SDK's tooltip, which opens on keyboard focus as well as on hover (a\n        // native title shows only to a pointer).\n        <Tooltip>\n          <TooltipTrigger asChild>{button}</TooltipTrigger>\n          <TooltipContent side=\"bottom\">{disabledReason}</TooltipContent>\n        </Tooltip>\n      ) : (\n        button\n      )}\n    </>\n  );\n};\n"],"names":["useRef","useAttachFiles","useCallback","jsx","cn","Loader2Icon","AlertCircleIcon","PaperclipIcon","jsxs","Fragment","Tooltip","TooltipTrigger","TooltipContent"],"mappings":";;;;;;;;AA0BO,MAAM,mBAA8C,CAAC;AAAA,EAC1D;AAAA,EACA;AAAA,EACA;AAAA,EACA,iBAAiB;AACnB,MAAM;AACJ,QAAM,WAAWA,WAAAA,OAAyB,IAAI;AAC9C,QAAM,EAAE,aAAa,aAAa,OAAO,WAAA,IAAeC,eAAAA,eAAA;AACxD,QAAM,cAAc,QAAQ,cAAc;AAE1C,QAAM,cAAcC,WAAAA,YAAY,MAAM;;AACpC,QAAI,YAAa;AACjB,eAAA;AACA,mBAAS,YAAT,mBAAkB;AAAA,EACpB,GAAG,CAAC,YAAY,WAAW,CAAC;AAE5B,QAAM,cAAcA,WAAAA;AAAAA,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,QAAM,SACJC,2BAAAA;AAAAA,IAAC;AAAA,IAAA;AAAA,MACC,MAAK;AAAA,MACL,SAAS;AAAA,MACT,UAAU;AAAA,MAEV,iBAAe,eAAe;AAAA,MAC9B,oBAAkB,eAAe;AAAA,MACjC,WAAWC,OAAAA;AAAAA,QACT;AAAA,QACA,SAAS;AAAA,QACT;AAAA,QACA,eACE;AAAA,MAAA;AAAA,MAEJ,OAAO,cAAc,SAAa,UAAU,cAAc,iBAAiB;AAAA,MAC3E,cAAY,cAAc,oBAAoB;AAAA,MAE7C,UAAA,cACCD,2BAAAA,IAACE,YAAAA,aAAA,EAAY,WAAU,uBAAsB,IAC3C,QACFF,2BAAAA,IAACG,YAAAA,iBAAA,EAAgB,WAAU,UAAS,IAEpCH,2BAAAA,IAACI,2BAAA,EAAc,WAAU,SAAA,CAAS;AAAA,IAAA;AAAA,EAAA;AAKxC,SACEC,2BAAAA,KAAAC,qBAAA,EACE,UAAA;AAAA,IAAAN,2BAAAA;AAAAA,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,IAEZ;AAAA;AAAA;AAAA,sCAGEO,QAAAA,SAAA,EACC,UAAA;AAAA,QAAAP,2BAAAA,IAACQ,QAAAA,gBAAA,EAAe,SAAO,MAAE,UAAA,QAAO;AAAA,QAChCR,2BAAAA,IAACS,QAAAA,gBAAA,EAAe,MAAK,UAAU,UAAA,eAAA,CAAe;AAAA,MAAA,EAAA,CAChD;AAAA,QAEA;AAAA,EAAA,GAEJ;AAEJ;;"}

package/dist/composer/FileUploadButton.d.ts

@@ -6,6 +6,12 @@ export interface FileUploadButtonProps {
     onUpload?: (assets: UploadedAsset[]) => void;
     /** Accepted file types (MIME pattern). Defaults to all files. */
     accept?: string;
+    /**
+     * Why attaching is off right now, e.g. "Needs a connection…" while the host knows Athena can't be
+     * reached: the button shows disabled with this in its tooltip and the file picker does not open.
+     * It stays focusable, and the tooltip opens on keyboard focus as on hover. `null` or absent: on.
+     */
+    disabledReason?: string | null;
 }
 /**
  * Paperclip button that opens a file picker and uploads selected files to Athena.

package/dist/composer/FileUploadButton.js

@@ -1,20 +1,24 @@
-import { jsxs, Fragment, jsx } from "react/jsx-runtime";
+import { jsx, jsxs, Fragment } from "react/jsx-runtime";
 import { Loader2Icon, AlertCircleIcon, PaperclipIcon } from "lucide-react";
 import { useRef, useCallback } from "react";
 import { useAttachFiles } from "./useAttachFiles.js";
+import { Tooltip, TooltipTrigger, TooltipContent } from "../ui/tooltip.js";
 import { cn } from "cnfast";
 const FileUploadButton = ({
   className,
   onUpload,
-  accept
+  accept,
+  disabledReason = null
 }) => {
   const inputRef = useRef(null);
   const { attachFiles, isUploading, error, clearError } = useAttachFiles();
+  const unavailable = Boolean(disabledReason);
   const handleClick = useCallback(() => {
     var _a;
+    if (unavailable) return;
     clearError();
     (_a = inputRef.current) == null ? void 0 : _a.click();
-  }, [clearError]);
+  }, [clearError, unavailable]);
   const handleFiles = useCallback(
     async (files) => {
       if (!files || files.length === 0) return;
@@ -28,6 +32,25 @@ const FileUploadButton = ({
     },
     [attachFiles, onUpload]
   );
+  const button = /* @__PURE__ */ jsx(
+    "button",
+    {
+      type: "button",
+      onClick: handleClick,
+      disabled: isUploading,
+      "aria-disabled": unavailable || void 0,
+      "data-unavailable": unavailable || void 0,
+      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,
+        unavailable && "cursor-not-allowed opacity-30 hover:bg-transparent hover:text-muted-foreground"
+      ),
+      title: unavailable ? void 0 : 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" })
+    }
+  );
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsx(
       "input",
@@ -41,22 +64,14 @@ const FileUploadButton = ({
         "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" })
-      }
-    )
+    unavailable ? (
+      // The reason in the SDK's tooltip, which opens on keyboard focus as well as on hover (a
+      // native title shows only to a pointer).
+      /* @__PURE__ */ jsxs(Tooltip, { children: [
+        /* @__PURE__ */ jsx(TooltipTrigger, { asChild: true, children: button }),
+        /* @__PURE__ */ jsx(TooltipContent, { side: "bottom", children: disabledReason })
+      ] })
+    ) : button
   ] });
 };
 export {

package/dist/composer/FileUploadButton.js.map

@@ -1 +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;"}
+{"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';\nimport { Tooltip, TooltipContent, TooltipTrigger } from '../ui/tooltip';\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   * Why attaching is off right now, e.g. \"Needs a connection…\" while the host knows Athena can't be\n   * reached: the button shows disabled with this in its tooltip and the file picker does not open.\n   * It stays focusable, and the tooltip opens on keyboard focus as on hover. `null` or absent: on.\n   */\n  disabledReason?: string | null;\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  disabledReason = null,\n}) => {\n  const inputRef = useRef<HTMLInputElement>(null);\n  const { attachFiles, isUploading, error, clearError } = useAttachFiles();\n  const unavailable = Boolean(disabledReason);\n\n  const handleClick = useCallback(() => {\n    if (unavailable) return;\n    clearError();\n    inputRef.current?.click();\n  }, [clearError, unavailable]);\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  const button = (\n    <button\n      type=\"button\"\n      onClick={handleClick}\n      disabled={isUploading}\n      // Off with a reason, it keeps its pointer and its focus: the reason has to be readable.\n      aria-disabled={unavailable || undefined}\n      data-unavailable={unavailable || undefined}\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        unavailable &&\n          'cursor-not-allowed opacity-30 hover:bg-transparent hover:text-muted-foreground',\n      )}\n      title={unavailable ? undefined : (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  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      {unavailable ? (\n        // The reason in the SDK's tooltip, which opens on keyboard focus as well as on hover (a\n        // native title shows only to a pointer).\n        <Tooltip>\n          <TooltipTrigger asChild>{button}</TooltipTrigger>\n          <TooltipContent side=\"bottom\">{disabledReason}</TooltipContent>\n        </Tooltip>\n      ) : (\n        button\n      )}\n    </>\n  );\n};\n"],"names":[],"mappings":";;;;;;AA0BO,MAAM,mBAA8C,CAAC;AAAA,EAC1D;AAAA,EACA;AAAA,EACA;AAAA,EACA,iBAAiB;AACnB,MAAM;AACJ,QAAM,WAAW,OAAyB,IAAI;AAC9C,QAAM,EAAE,aAAa,aAAa,OAAO,WAAA,IAAe,eAAA;AACxD,QAAM,cAAc,QAAQ,cAAc;AAE1C,QAAM,cAAc,YAAY,MAAM;;AACpC,QAAI,YAAa;AACjB,eAAA;AACA,mBAAS,YAAT,mBAAkB;AAAA,EACpB,GAAG,CAAC,YAAY,WAAW,CAAC;AAE5B,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,QAAM,SACJ;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,MAAK;AAAA,MACL,SAAS;AAAA,MACT,UAAU;AAAA,MAEV,iBAAe,eAAe;AAAA,MAC9B,oBAAkB,eAAe;AAAA,MACjC,WAAW;AAAA,QACT;AAAA,QACA,SAAS;AAAA,QACT;AAAA,QACA,eACE;AAAA,MAAA;AAAA,MAEJ,OAAO,cAAc,SAAa,UAAU,cAAc,iBAAiB;AAAA,MAC3E,cAAY,cAAc,oBAAoB;AAAA,MAE7C,UAAA,cACC,oBAAC,aAAA,EAAY,WAAU,uBAAsB,IAC3C,QACF,oBAAC,iBAAA,EAAgB,WAAU,UAAS,IAEpC,oBAAC,eAAA,EAAc,WAAU,SAAA,CAAS;AAAA,IAAA;AAAA,EAAA;AAKxC,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,IAEZ;AAAA;AAAA;AAAA,2BAGE,SAAA,EACC,UAAA;AAAA,QAAA,oBAAC,gBAAA,EAAe,SAAO,MAAE,UAAA,QAAO;AAAA,QAChC,oBAAC,gBAAA,EAAe,MAAK,UAAU,UAAA,eAAA,CAAe;AAAA,MAAA,EAAA,CAChD;AAAA,QAEA;AAAA,EAAA,GAEJ;AAEJ;"}

package/dist/composer/QuoteContext.cjs

@@ -1,37 +1,37 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const jsxRuntime = require("react/jsx-runtime");
-const react = require("react");
+const require$$0 = require("react");
 const zustand = require("zustand");
 const vanilla = require("zustand/vanilla");
-const QuoteCtx = react.createContext(null);
+const QuoteCtx = require$$0.createContext(null);
 function createQuoteStore() {
   return vanilla.createStore(() => ({ quote: null }));
 }
 function QuoteProvider({ children, store }) {
-  const outer = react.useContext(QuoteCtx);
+  const outer = require$$0.useContext(QuoteCtx);
   if (store) return /* @__PURE__ */ jsxRuntime.jsx(StoreQuoteProvider, { store, children });
   if (outer) return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
   return /* @__PURE__ */ jsxRuntime.jsx(OwnQuoteProvider, { children });
 }
 function OwnQuoteProvider({ children }) {
-  const [store] = react.useState(createQuoteStore);
+  const [store] = require$$0.useState(createQuoteStore);
   return /* @__PURE__ */ jsxRuntime.jsx(StoreQuoteProvider, { store, children });
 }
 function StoreQuoteProvider({ children, store }) {
   const quote = zustand.useStore(store, (state) => state.quote);
-  const actions = react.useMemo(
+  const actions = require$$0.useMemo(
     () => ({
       setQuote: (next) => store.setState({ quote: next }),
       clearQuote: () => store.setState({ quote: null })
     }),
     [store]
   );
-  const value = react.useMemo(() => ({ quote, ...actions }), [quote, actions]);
+  const value = require$$0.useMemo(() => ({ quote, ...actions }), [quote, actions]);
   return /* @__PURE__ */ jsxRuntime.jsx(QuoteCtx.Provider, { value, children });
 }
 function useQuote() {
-  const ctx = react.useContext(QuoteCtx);
+  const ctx = require$$0.useContext(QuoteCtx);
   if (!ctx) {
     throw new Error("[AthenaSDK] useQuote must be used within <QuoteProvider>");
   }
@@ -56,7 +56,7 @@ function elementOf(node) {
 }
 function useQuoteFromPostMessage({ scope } = {}) {
   const { setQuote } = useQuote();
-  react.useEffect(() => {
+  require$$0.useEffect(() => {
     var _a;
     const doc = ((_a = scope == null ? void 0 : scope.current) == null ? void 0 : _a.ownerDocument) ?? document;
     const win = doc.defaultView ?? window;

package/dist/composer/QuoteContext.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"QuoteContext.cjs","sources":["../../src/composer/QuoteContext.tsx"],"sourcesContent":["import {\n  createContext,\n  type RefObject,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n  type ReactNode,\n} from 'react';\nimport { useStore } from 'zustand';\nimport { createStore, type StoreApi } from 'zustand/vanilla';\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\ninterface QuoteStoreState {\n  quote: QuoteData | null;\n}\n\n/**\n * A composer's pending quote, kept outside React (`createQuoteStore`), like\n * `AttachmentStore`: one per chat when a host shows several.\n */\nexport type QuoteStore = StoreApi<QuoteStoreState>;\n\n/** An empty `QuoteStore`, for `<QuoteProvider store>`. */\nexport function createQuoteStore(): QuoteStore {\n  return createStore<QuoteStoreState>(() => ({ quote: null }));\n}\n\n/**\n * The composer's pending quote. Like \\`AttachmentProvider\\`, a `store` makes\n * it that store's, and without one it reuses a provider already mounted\n * above, so a host can keep the quote across a remounting \\`AthenaChat\\`.\n */\nexport function QuoteProvider({ children, store }: { children: ReactNode; store?: QuoteStore }) {\n  const outer = useContext(QuoteCtx);\n  if (store) return <StoreQuoteProvider store={store}>{children}</StoreQuoteProvider>;\n  if (outer) return <>{children}</>;\n  return <OwnQuoteProvider>{children}</OwnQuoteProvider>;\n}\n\nfunction OwnQuoteProvider({ children }: { children: ReactNode }) {\n  const [store] = useState(createQuoteStore);\n  return <StoreQuoteProvider store={store}>{children}</StoreQuoteProvider>;\n}\n\nfunction StoreQuoteProvider({ children, store }: { children: ReactNode; store: QuoteStore }) {\n  const quote = useStore(store, (state) => state.quote);\n  const actions = useMemo(\n    () => ({\n      setQuote: (next: QuoteData | null) => store.setState({ quote: next }),\n      clearQuote: () => store.setState({ quote: null }),\n    }),\n    [store],\n  );\n  const value = useMemo(() => ({ quote, ...actions }), [quote, actions]);\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 * Whether a message came from a frame embedded directly in this window, for\n * any origin: the window of one of this document's iframes (an identity\n * comparison, safe cross-origin), or, for a frame inside a shadow root, a\n * window whose `parent` is this window (`parent` is readable on a\n * cross-origin window). A message port, a worker, this window itself, a\n * grandchild frame or an unrelated window is refused. `win` is the window the\n * message came to (default: this one), e.g. a popped-out chat's.\n */\nexport function isDirectChildFrame(\n  source: MessageEventSource | null,\n  win: Window = window,\n): boolean {\n  if (!source || source === win) return false;\n  for (const frame of win.document.querySelectorAll('iframe')) {\n    if (frame.contentWindow === source) return true;\n  }\n  try {\n    return Reflect.get(source, 'parent') === win;\n  } catch {\n    return false;\n  }\n}\n\n/** `AthenaChat`'s thread root: the chats `useQuoteFromPostMessage` tells apart. */\nconst CHAT_ROOT_SELECTOR = '.aui-thread-root';\n\n/**\n * The chat the person last focused in each window, which takes a quote that\n * names no chat (a selection outside every chat, an embedded frame's text)\n * when that window shows several. A focus, not data: no state of the chats\n * themselves.\n */\nconst lastFocusedChatRoots = new WeakMap<Document, Element>();\n\n/** The element a node is, or sits in; duck-typed, since a pop-out window's nodes are another realm's. */\nfunction elementOf(node: Node | null | undefined): Element | null {\n  if (!node) return null;\n  return node.nodeType === 1 ? (node as Element) : node.parentElement;\n}\n\nexport interface QuoteFromPostMessageOptions {\n  /**\n   * An element inside the chat this composer belongs to. With several chats in\n   * one window, a ⌘L selection goes to the chat it was made in, and one made\n   * outside every chat (or an embedded frame's text) to the chat the person\n   * last focused; the keys and an embedded frame's messages are heard in this\n   * element's own window, a pop-out included. Without it, every quote is this\n   * composer's, as before.\n   */\n  scope?: RefObject<Element | null>;\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`, only from a frame embedded directly\n *    in this window ({@link isDirectChildFrame}).\n *\n * Mount this once per composer inside AthenaProvider (`AthenaChat` does).\n */\nexport function useQuoteFromPostMessage({ scope }: QuoteFromPostMessageOptions = {}) {\n  const { setQuote } = useQuote();\n\n  useEffect(() => {\n    const doc = scope?.current?.ownerDocument ?? document;\n    const win = doc.defaultView ?? window;\n    const chatRoot = () => scope?.current?.closest(CHAT_ROOT_SELECTOR) ?? null;\n    // Whether this composer takes a quote made at `anchor` (null: one that names no chat).\n    const takes = (anchor: Node | null) => {\n      const mine = chatRoot();\n      if (!mine) return true;\n      const owner = elementOf(anchor)?.closest(CHAT_ROOT_SELECTOR) ?? null;\n      if (owner) return owner === mine;\n      const remembered = lastFocusedChatRoots.get(doc);\n      const focused = remembered?.isConnected ? remembered : doc.querySelector(CHAT_ROOT_SELECTOR);\n      return focused === mine;\n    };\n\n    const handleFocusIn = (event: FocusEvent) => {\n      const mine = chatRoot();\n      const target = event.target as Node | null;\n      if (mine && target && typeof target.nodeType === 'number' && mine.contains(target)) {\n        lastFocusedChatRoots.set(doc, mine);\n      }\n    };\n\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 = doc.getSelection();\n        const selection = sel?.toString()?.trim();\n\n        if (selection && selection.length > 0 && takes(sel?.anchorNode ?? null)) {\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 = elementOf(sel?.anchorNode);\n          while (node && node !== doc.body) {\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            node = node.parentElement;\n          }\n\n          setQuote({ text: selection, sourceRole: role, sourceMessageId: messageId });\n        }\n      }\n    };\n\n    // ── PostMessage handler (from iframes) ───────────────────────────\n    // Accepts messages from any origin, but only from a frame embedded\n    // directly in this window: the SDK consumer controls which iframes are\n    // embedded, and that is the trust boundary. A popup, an opener or another\n    // tab holding a reference to this window cannot stage composer text.\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        isDirectChildFrame(event.source, win) &&\n        takes(null)\n      ) {\n        setQuote({\n          text: data.text,\n          sourceTitle: data.sourceTitle,\n          sourceAssetId: data.sourceAssetId,\n        });\n      }\n    };\n\n    doc.addEventListener('keydown', handleKeydown, true); // capture phase to beat the browser\n    doc.addEventListener('focusin', handleFocusIn, true);\n    win.addEventListener('message', handleMessage);\n\n    return () => {\n      doc.removeEventListener('keydown', handleKeydown, true);\n      doc.removeEventListener('focusin', handleFocusIn, true);\n      win.removeEventListener('message', handleMessage);\n    };\n  }, [scope, setQuote]);\n}\n"],"names":["createContext","createStore","useContext","jsx","Fragment","useState","useStore","useMemo","useEffect","_a"],"mappings":"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"}
+{"version":3,"file":"QuoteContext.cjs","sources":["../../src/composer/QuoteContext.tsx"],"sourcesContent":["import {\n  createContext,\n  type RefObject,\n  useContext,\n  useEffect,\n  useMemo,\n  useState,\n  type ReactNode,\n} from 'react';\nimport { useStore } from 'zustand';\nimport { createStore, type StoreApi } from 'zustand/vanilla';\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\ninterface QuoteStoreState {\n  quote: QuoteData | null;\n}\n\n/**\n * A composer's pending quote, kept outside React (`createQuoteStore`), like\n * `AttachmentStore`: one per chat when a host shows several.\n */\nexport type QuoteStore = StoreApi<QuoteStoreState>;\n\n/** An empty `QuoteStore`, for `<QuoteProvider store>`. */\nexport function createQuoteStore(): QuoteStore {\n  return createStore<QuoteStoreState>(() => ({ quote: null }));\n}\n\n/**\n * The composer's pending quote. Like \\`AttachmentProvider\\`, a `store` makes\n * it that store's, and without one it reuses a provider already mounted\n * above, so a host can keep the quote across a remounting \\`AthenaChat\\`.\n */\nexport function QuoteProvider({ children, store }: { children: ReactNode; store?: QuoteStore }) {\n  const outer = useContext(QuoteCtx);\n  if (store) return <StoreQuoteProvider store={store}>{children}</StoreQuoteProvider>;\n  if (outer) return <>{children}</>;\n  return <OwnQuoteProvider>{children}</OwnQuoteProvider>;\n}\n\nfunction OwnQuoteProvider({ children }: { children: ReactNode }) {\n  const [store] = useState(createQuoteStore);\n  return <StoreQuoteProvider store={store}>{children}</StoreQuoteProvider>;\n}\n\nfunction StoreQuoteProvider({ children, store }: { children: ReactNode; store: QuoteStore }) {\n  const quote = useStore(store, (state) => state.quote);\n  const actions = useMemo(\n    () => ({\n      setQuote: (next: QuoteData | null) => store.setState({ quote: next }),\n      clearQuote: () => store.setState({ quote: null }),\n    }),\n    [store],\n  );\n  const value = useMemo(() => ({ quote, ...actions }), [quote, actions]);\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 * Whether a message came from a frame embedded directly in this window, for\n * any origin: the window of one of this document's iframes (an identity\n * comparison, safe cross-origin), or, for a frame inside a shadow root, a\n * window whose `parent` is this window (`parent` is readable on a\n * cross-origin window). A message port, a worker, this window itself, a\n * grandchild frame or an unrelated window is refused. `win` is the window the\n * message came to (default: this one), e.g. a popped-out chat's.\n */\nexport function isDirectChildFrame(\n  source: MessageEventSource | null,\n  win: Window = window,\n): boolean {\n  if (!source || source === win) return false;\n  for (const frame of win.document.querySelectorAll('iframe')) {\n    if (frame.contentWindow === source) return true;\n  }\n  try {\n    return Reflect.get(source, 'parent') === win;\n  } catch {\n    return false;\n  }\n}\n\n/** `AthenaChat`'s thread root: the chats `useQuoteFromPostMessage` tells apart. */\nconst CHAT_ROOT_SELECTOR = '.aui-thread-root';\n\n/**\n * The chat the person last focused in each window, which takes a quote that\n * names no chat (a selection outside every chat, an embedded frame's text)\n * when that window shows several. A focus, not data: no state of the chats\n * themselves.\n */\nconst lastFocusedChatRoots = new WeakMap<Document, Element>();\n\n/** The element a node is, or sits in; duck-typed, since a pop-out window's nodes are another realm's. */\nfunction elementOf(node: Node | null | undefined): Element | null {\n  if (!node) return null;\n  return node.nodeType === 1 ? (node as Element) : node.parentElement;\n}\n\nexport interface QuoteFromPostMessageOptions {\n  /**\n   * An element inside the chat this composer belongs to. With several chats in\n   * one window, a ⌘L selection goes to the chat it was made in, and one made\n   * outside every chat (or an embedded frame's text) to the chat the person\n   * last focused; the keys and an embedded frame's messages are heard in this\n   * element's own window, a pop-out included. Without it, every quote is this\n   * composer's, as before.\n   */\n  scope?: RefObject<Element | null>;\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`, only from a frame embedded directly\n *    in this window ({@link isDirectChildFrame}).\n *\n * Mount this once per composer inside AthenaProvider (`AthenaChat` does).\n */\nexport function useQuoteFromPostMessage({ scope }: QuoteFromPostMessageOptions = {}) {\n  const { setQuote } = useQuote();\n\n  useEffect(() => {\n    const doc = scope?.current?.ownerDocument ?? document;\n    const win = doc.defaultView ?? window;\n    const chatRoot = () => scope?.current?.closest(CHAT_ROOT_SELECTOR) ?? null;\n    // Whether this composer takes a quote made at `anchor` (null: one that names no chat).\n    const takes = (anchor: Node | null) => {\n      const mine = chatRoot();\n      if (!mine) return true;\n      const owner = elementOf(anchor)?.closest(CHAT_ROOT_SELECTOR) ?? null;\n      if (owner) return owner === mine;\n      const remembered = lastFocusedChatRoots.get(doc);\n      const focused = remembered?.isConnected ? remembered : doc.querySelector(CHAT_ROOT_SELECTOR);\n      return focused === mine;\n    };\n\n    const handleFocusIn = (event: FocusEvent) => {\n      const mine = chatRoot();\n      const target = event.target as Node | null;\n      if (mine && target && typeof target.nodeType === 'number' && mine.contains(target)) {\n        lastFocusedChatRoots.set(doc, mine);\n      }\n    };\n\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 = doc.getSelection();\n        const selection = sel?.toString()?.trim();\n\n        if (selection && selection.length > 0 && takes(sel?.anchorNode ?? null)) {\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 = elementOf(sel?.anchorNode);\n          while (node && node !== doc.body) {\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            node = node.parentElement;\n          }\n\n          setQuote({ text: selection, sourceRole: role, sourceMessageId: messageId });\n        }\n      }\n    };\n\n    // ── PostMessage handler (from iframes) ───────────────────────────\n    // Accepts messages from any origin, but only from a frame embedded\n    // directly in this window: the SDK consumer controls which iframes are\n    // embedded, and that is the trust boundary. A popup, an opener or another\n    // tab holding a reference to this window cannot stage composer text.\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        isDirectChildFrame(event.source, win) &&\n        takes(null)\n      ) {\n        setQuote({\n          text: data.text,\n          sourceTitle: data.sourceTitle,\n          sourceAssetId: data.sourceAssetId,\n        });\n      }\n    };\n\n    doc.addEventListener('keydown', handleKeydown, true); // capture phase to beat the browser\n    doc.addEventListener('focusin', handleFocusIn, true);\n    win.addEventListener('message', handleMessage);\n\n    return () => {\n      doc.removeEventListener('keydown', handleKeydown, true);\n      doc.removeEventListener('focusin', handleFocusIn, true);\n      win.removeEventListener('message', handleMessage);\n    };\n  }, [scope, setQuote]);\n}\n"],"names":["createContext","createStore","useContext","jsx","Fragment","useState","useStore","useMemo","useEffect","_a"],"mappings":"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"}

package/dist/composer/composer-handoff.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const react$1 = require("react");
+const require$$0 = require("react");
 const react = require("@assistant-ui/react");
 const athenaDiagnostics = require("../diagnostics/athena-diagnostics.cjs");
 const errors = require("../diagnostics/errors.cjs");
@@ -40,13 +40,13 @@ function takeRestoredAttachments({
   (_b = store == null ? void 0 : store.restoredAttachments) == null ? void 0 : _b.delete(threadId);
   return kept.filter((attachment) => assetIdsInDraft.has(attachment.assetId));
 }
-const ComposerHandoffContext = react$1.createContext(null);
+const ComposerHandoffContext = require$$0.createContext(null);
 function useComposerHandoffStore() {
-  return react$1.useContext(ComposerHandoffContext);
+  return require$$0.useContext(ComposerHandoffContext);
 }
 function useFocusComposer() {
   const store = useComposerHandoffStore();
-  return react$1.useCallback(() => {
+  return require$$0.useCallback(() => {
     if (store) focusComposer({ store });
   }, [store]);
 }

package/dist/composer/composer-handoff.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"composer-handoff.cjs","sources":["../../src/composer/composer-handoff.ts"],"sourcesContent":["/**\n * Composer handoff: writes to the chat composer from host UI that lives\n * outside `<AthenaChat>` (a sidebar, an agenda card, a workflow button).\n *\n * Two problems it solves for `useAppendToComposer` / `useSendMessage`:\n *\n * 1. A write before the chat is ready is lost. While the thread list is still\n *    resolving the active thread, or the thread's history is still loading,\n *    the composer the hooks write to belongs to a mount that is about to be\n *    replaced (thread-list mode keys the statewire subtree by thread), and\n *    the draft goes with it. The store below lives ABOVE that mount, so a\n *    write made too early waits here and the ready mount drains it.\n * 2. A prefilled draft should put the caret after the text so the user can\n *    keep typing or dictating. The Tiptap editor mirrors runtime text on a\n *    later tick; the `focusOnNextMirror` flag asks it to focus at the end\n *    right after that mirror lands, instead of the host guessing a delay.\n *\n * Every queued write is bound to the statewire thread it was made for and\n * drains only into that thread's mount; a thread switch, an identity change\n * or a provider unmount drops what waits with a `composer_write_dropped`\n * error, never into another user's or another thread's composer.\n */\nimport { createContext, useCallback, useContext } from 'react';\nimport { useAuiState } from '@assistant-ui/react';\nimport type { ChatOutboxAttachment } from '@athenaintel/agent-runtime';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport { AthenaSdkError } from '../diagnostics/errors';\nimport { useStatewireSessionLanePending } from '../runtime/statewire-session-lane';\nimport { useAthenaStatewireThreadList } from '../threads/statewire-thread-list';\n\n/** The slice of the assistant-ui client the handoff writes to. */\nexport interface ComposerTarget {\n  composer: {\n    getState: () => { text: string };\n    setText: (text: string) => void;\n    send: (options?: { steer?: boolean }) => unknown;\n  };\n}\n\nexport interface ComposerWrite {\n  text: string;\n  /** Replace the draft instead of appending on a new line. */\n  replace: boolean;\n  /** Submit right after writing. */\n  send: boolean;\n  /** Put the caret at the end of the draft once the editor shows it. */\n  focus: boolean;\n  /** The statewire thread the write was made for; it drains only into that thread's mount. */\n  threadId: string | null;\n  /** Settled once the write has been applied (and, for `send`, with the send's outcome). */\n  resolve?: (outcome: Promise<void> | void) => void;\n  /** Settled with `composer_write_dropped` when the write can no longer land. */\n  reject?: (error: AthenaSdkError) => void;\n}\n\nexport interface ComposerHandoffStore {\n  /** Writes waiting for a ready composer, oldest first. Adjacent plain appends fold together. */\n  pending: ComposerWrite[];\n  /** Set by a `focus` write; the editor consumes it after mirroring the draft. */\n  focusOnNextMirror: boolean;\n  /** Registered by the mounted editor: place the caret at the end of the draft. */\n  focusEnd: (() => void) | null;\n  /** Set by `useFocusComposer` before the editor mounted; the editor consumes it when it does. */\n  focusOnMount: boolean;\n  /**\n   * Per thread, the attachments of messages the chat outbox gave back to the composer (Cancel, or\n   * Edit on one that couldn't be sent): files already in Athena, back in the draft as mentions. A\n   * message held again from that draft names those still in it, so the outbox asks Athena about\n   * them again before it goes ({@link rememberRestoredAttachments}, {@link takeRestoredAttachments}).\n   */\n  restoredAttachments?: Map<string, ChatOutboxAttachment[]>;\n}\n\nexport function createComposerHandoffStore(): ComposerHandoffStore {\n  return {\n    pending: [],\n    focusOnNextMirror: false,\n    focusEnd: null,\n    focusOnMount: false,\n    restoredAttachments: new Map(),\n  };\n}\n\n/** A held message given back to `threadId`'s composer: remember the attachments it carried. */\nexport function rememberRestoredAttachments({\n  store,\n  threadId,\n  attachments,\n}: {\n  store: ComposerHandoffStore;\n  threadId: string;\n  attachments: readonly ChatOutboxAttachment[];\n}): void {\n  if (attachments.length === 0) return;\n  store.restoredAttachments ??= new Map();\n  const kept = store.restoredAttachments.get(threadId) ?? [];\n  const known = new Set(kept.map((attachment) => attachment.assetId));\n  store.restoredAttachments.set(threadId, [\n    ...kept,\n    ...attachments.filter((attachment) => !known.has(attachment.assetId)),\n  ]);\n}\n\n/**\n * The remembered attachments of `threadId`'s draft whose mentions it still holds, for the message\n * leaving it now; the composer forgets them all (sent, held again, or removed from the draft).\n */\nexport function takeRestoredAttachments({\n  store,\n  threadId,\n  assetIdsInDraft,\n}: {\n  store: ComposerHandoffStore | null;\n  threadId: string;\n  assetIdsInDraft: ReadonlySet<string>;\n}): ChatOutboxAttachment[] {\n  const kept = store?.restoredAttachments?.get(threadId);\n  if (!kept) return [];\n  store?.restoredAttachments?.delete(threadId);\n  return kept.filter((attachment) => assetIdsInDraft.has(attachment.assetId));\n}\n\nexport const ComposerHandoffContext = createContext<ComposerHandoffStore | null>(null);\n\n/** The provider's handoff store, or null outside `AthenaProvider`. */\nexport function useComposerHandoffStore(): ComposerHandoffStore | null {\n  return useContext(ComposerHandoffContext);\n}\n\n/**\n * Puts the caret at the end of the composer's draft and leaves the draft as it is; asked before the\n * editor has mounted, it focuses the editor as it mounts. For a host that shows the chat again and\n * wants typing to land in it (a launcher window a shortcut brings back).\n */\nexport function useFocusComposer(): () => void {\n  const store = useComposerHandoffStore();\n  return useCallback(() => {\n    if (store) focusComposer({ store });\n  }, [store]);\n}\n\n/** The caret to the end of the draft now, or, with no editor mounted yet, as one mounts. */\nexport function focusComposer({ store }: { store: ComposerHandoffStore }): void {\n  if (store.focusEnd) store.focusEnd();\n  else store.focusOnMount = true;\n}\n\n/**\n * Whether a composer write lands now: in thread-list mode the list has\n * resolved which thread is active, that thread's history has loaded, and the\n * chat's session lane is known (the sign-in provider above has resolved who is\n * signed in; see `StatewireSessionLane`). Until then the composer the hooks\n * write to is the one of a mount that is about to be replaced, and the draft\n * goes with it, or a send would go into a parked lane that refuses it unsent.\n *\n * Deliberately not the socket status: a never-started chat sits in\n * `standby` until its first send and must still take a prefill.\n */\nexport function useComposerReady(): boolean {\n  const list = useAthenaStatewireThreadList();\n  const threadLoading = useAuiState((s) => s.optional.thread?.isLoading ?? false);\n  const lanePending = useStatewireSessionLanePending();\n  return !(list?.isLoading ?? false) && !threadLoading && !lanePending;\n}\n\n/** The draft after `write`: `replace` (or an empty draft) takes the text as is. */\nexport function mergeComposerDraft({\n  current,\n  write,\n}: {\n  current: string;\n  write: Pick<ComposerWrite, 'text' | 'replace'>;\n}): string {\n  if (write.replace || !current) return write.text;\n  return `${current}\\n${write.text}`;\n}\n\n/**\n * Write into the live composer. Returns the send's outcome for a `send`\n * write so callers can await it.\n */\nexport function applyComposerWrite({\n  target,\n  store,\n  write,\n}: {\n  target: ComposerTarget;\n  store: ComposerHandoffStore | null;\n  write: ComposerWrite;\n}): Promise<void> | void {\n  const current = target.composer.getState().text ?? '';\n  const next = mergeComposerDraft({ current, write });\n  target.composer.setText(next);\n  if (write.focus && store) {\n    // An unchanged draft never re-mirrors, so focus at once; otherwise the\n    // editor focuses itself right after it has shown the new text.\n    if (next === current) store.focusEnd?.();\n    else store.focusOnNextMirror = true;\n  }\n  athenaDiagnostics.emit('composer.handoff', {\n    level: 'debug',\n    data: { phase: 'applied', send: write.send, focus: write.focus, chars: next.length },\n  });\n  if (write.send) {\n    return Promise.resolve(target.composer.send({ steer: false })).then(() => undefined);\n  }\n  return undefined;\n}\n\n/**\n * Hold a write until the composer is ready. Writes keep their order; a plain\n * append folds into a directly preceding plain append for the same thread\n * (one draft, not two), while a replace or a send is kept as its own step so\n * no message is lost and every send settles on its own.\n */\nexport function queueComposerWrite({\n  store,\n  write,\n}: {\n  store: ComposerHandoffStore;\n  write: ComposerWrite;\n}): void {\n  const last = store.pending[store.pending.length - 1];\n  const foldable =\n    last !== undefined &&\n    !last.send &&\n    !write.send &&\n    !write.replace &&\n    last.threadId === write.threadId &&\n    last.resolve === undefined &&\n    write.resolve === undefined;\n  if (foldable) {\n    last.text = mergeComposerDraft({ current: last.text, write });\n    last.focus = last.focus || write.focus;\n  } else {\n    store.pending.push(write);\n  }\n  athenaDiagnostics.emit('composer.handoff', {\n    level: 'debug',\n    data: { phase: 'deferred', send: write.send, focus: write.focus, queued: store.pending.length },\n  });\n}\n\nfunction dropWrite({ write, reason }: { write: ComposerWrite; reason: string }): void {\n  const error = new AthenaSdkError({\n    code: 'composer_write_dropped',\n    message: `A composer ${write.send ? 'send' : 'draft'} queued before the chat was ready was dropped: ${reason}.`,\n    hint: 'Make the write again from the chat that is active now.',\n    context: { threadId: write.threadId, send: write.send },\n  });\n  athenaDiagnostics.emit('composer.handoff', {\n    level: 'warn',\n    error,\n    data: { phase: 'dropped', send: write.send, reason, threadId: write.threadId },\n  });\n  write.reject?.(error);\n}\n\n/**\n * Deliver the pending writes, in order, into a now-ready composer. A write\n * made for another thread is dropped (rejected), never applied here.\n */\nexport function drainComposerHandoff({\n  store,\n  target,\n  threadId,\n}: {\n  store: ComposerHandoffStore;\n  target: ComposerTarget;\n  /** The statewire thread of the mount that is draining. */\n  threadId: string | null;\n}): void {\n  const writes = store.pending;\n  if (writes.length === 0) return;\n  store.pending = [];\n  for (const write of writes) {\n    if (write.threadId !== null && threadId !== null && write.threadId !== threadId) {\n      dropWrite({ write, reason: `it was made for thread ${write.threadId}, thread ${threadId} is active` });\n      continue;\n    }\n    const outcome = applyComposerWrite({ target, store, write });\n    write.resolve?.(outcome);\n  }\n}\n\n/** Drop every pending write (identity changed, provider unmounted). */\nexport function clearComposerHandoff({\n  store,\n  reason,\n}: {\n  store: ComposerHandoffStore;\n  reason: string;\n}): void {\n  // Another identity, or no provider: the attachments given back belong to drafts that are gone.\n  store.restoredAttachments?.clear();\n  const writes = store.pending;\n  if (writes.length === 0) return;\n  store.pending = [];\n  for (const write of writes) dropWrite({ write, reason });\n}\n"],"names":["createContext","useContext","useCallback","useAthenaStatewireThreadList","useAuiState","useStatewireSessionLanePending","athenaDiagnostics","AthenaSdkError"],"mappings":"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"}
+{"version":3,"file":"composer-handoff.cjs","sources":["../../src/composer/composer-handoff.ts"],"sourcesContent":["/**\n * Composer handoff: writes to the chat composer from host UI that lives\n * outside `<AthenaChat>` (a sidebar, an agenda card, a workflow button).\n *\n * Two problems it solves for `useAppendToComposer` / `useSendMessage`:\n *\n * 1. A write before the chat is ready is lost. While the thread list is still\n *    resolving the active thread, or the thread's history is still loading,\n *    the composer the hooks write to belongs to a mount that is about to be\n *    replaced (thread-list mode keys the statewire subtree by thread), and\n *    the draft goes with it. The store below lives ABOVE that mount, so a\n *    write made too early waits here and the ready mount drains it.\n * 2. A prefilled draft should put the caret after the text so the user can\n *    keep typing or dictating. The Tiptap editor mirrors runtime text on a\n *    later tick; the `focusOnNextMirror` flag asks it to focus at the end\n *    right after that mirror lands, instead of the host guessing a delay.\n *\n * Every queued write is bound to the statewire thread it was made for and\n * drains only into that thread's mount; a thread switch, an identity change\n * or a provider unmount drops what waits with a `composer_write_dropped`\n * error, never into another user's or another thread's composer.\n */\nimport { createContext, useCallback, useContext } from 'react';\nimport { useAuiState } from '@assistant-ui/react';\nimport type { ChatOutboxAttachment } from '@athenaintel/agent-runtime';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport { AthenaSdkError } from '../diagnostics/errors';\nimport { useStatewireSessionLanePending } from '../runtime/statewire-session-lane';\nimport { useAthenaStatewireThreadList } from '../threads/statewire-thread-list';\n\n/** The slice of the assistant-ui client the handoff writes to. */\nexport interface ComposerTarget {\n  composer: {\n    getState: () => { text: string };\n    setText: (text: string) => void;\n    send: (options?: { steer?: boolean }) => unknown;\n  };\n}\n\nexport interface ComposerWrite {\n  text: string;\n  /** Replace the draft instead of appending on a new line. */\n  replace: boolean;\n  /** Submit right after writing. */\n  send: boolean;\n  /** Put the caret at the end of the draft once the editor shows it. */\n  focus: boolean;\n  /** The statewire thread the write was made for; it drains only into that thread's mount. */\n  threadId: string | null;\n  /** Settled once the write has been applied (and, for `send`, with the send's outcome). */\n  resolve?: (outcome: Promise<void> | void) => void;\n  /** Settled with `composer_write_dropped` when the write can no longer land. */\n  reject?: (error: AthenaSdkError) => void;\n}\n\nexport interface ComposerHandoffStore {\n  /** Writes waiting for a ready composer, oldest first. Adjacent plain appends fold together. */\n  pending: ComposerWrite[];\n  /** Set by a `focus` write; the editor consumes it after mirroring the draft. */\n  focusOnNextMirror: boolean;\n  /** Registered by the mounted editor: place the caret at the end of the draft. */\n  focusEnd: (() => void) | null;\n  /** Set by `useFocusComposer` before the editor mounted; the editor consumes it when it does. */\n  focusOnMount: boolean;\n  /**\n   * Per thread, the attachments of messages the chat outbox gave back to the composer (Cancel, or\n   * Edit on one that couldn't be sent): files already in Athena, back in the draft as mentions. A\n   * message held again from that draft names those still in it, so the outbox asks Athena about\n   * them again before it goes ({@link rememberRestoredAttachments}, {@link takeRestoredAttachments}).\n   */\n  restoredAttachments?: Map<string, ChatOutboxAttachment[]>;\n}\n\nexport function createComposerHandoffStore(): ComposerHandoffStore {\n  return {\n    pending: [],\n    focusOnNextMirror: false,\n    focusEnd: null,\n    focusOnMount: false,\n    restoredAttachments: new Map(),\n  };\n}\n\n/** A held message given back to `threadId`'s composer: remember the attachments it carried. */\nexport function rememberRestoredAttachments({\n  store,\n  threadId,\n  attachments,\n}: {\n  store: ComposerHandoffStore;\n  threadId: string;\n  attachments: readonly ChatOutboxAttachment[];\n}): void {\n  if (attachments.length === 0) return;\n  store.restoredAttachments ??= new Map();\n  const kept = store.restoredAttachments.get(threadId) ?? [];\n  const known = new Set(kept.map((attachment) => attachment.assetId));\n  store.restoredAttachments.set(threadId, [\n    ...kept,\n    ...attachments.filter((attachment) => !known.has(attachment.assetId)),\n  ]);\n}\n\n/**\n * The remembered attachments of `threadId`'s draft whose mentions it still holds, for the message\n * leaving it now; the composer forgets them all (sent, held again, or removed from the draft).\n */\nexport function takeRestoredAttachments({\n  store,\n  threadId,\n  assetIdsInDraft,\n}: {\n  store: ComposerHandoffStore | null;\n  threadId: string;\n  assetIdsInDraft: ReadonlySet<string>;\n}): ChatOutboxAttachment[] {\n  const kept = store?.restoredAttachments?.get(threadId);\n  if (!kept) return [];\n  store?.restoredAttachments?.delete(threadId);\n  return kept.filter((attachment) => assetIdsInDraft.has(attachment.assetId));\n}\n\nexport const ComposerHandoffContext = createContext<ComposerHandoffStore | null>(null);\n\n/** The provider's handoff store, or null outside `AthenaProvider`. */\nexport function useComposerHandoffStore(): ComposerHandoffStore | null {\n  return useContext(ComposerHandoffContext);\n}\n\n/**\n * Puts the caret at the end of the composer's draft and leaves the draft as it is; asked before the\n * editor has mounted, it focuses the editor as it mounts. For a host that shows the chat again and\n * wants typing to land in it (a launcher window a shortcut brings back).\n */\nexport function useFocusComposer(): () => void {\n  const store = useComposerHandoffStore();\n  return useCallback(() => {\n    if (store) focusComposer({ store });\n  }, [store]);\n}\n\n/** The caret to the end of the draft now, or, with no editor mounted yet, as one mounts. */\nexport function focusComposer({ store }: { store: ComposerHandoffStore }): void {\n  if (store.focusEnd) store.focusEnd();\n  else store.focusOnMount = true;\n}\n\n/**\n * Whether a composer write lands now: in thread-list mode the list has\n * resolved which thread is active, that thread's history has loaded, and the\n * chat's session lane is known (the sign-in provider above has resolved who is\n * signed in; see `StatewireSessionLane`). Until then the composer the hooks\n * write to is the one of a mount that is about to be replaced, and the draft\n * goes with it, or a send would go into a parked lane that refuses it unsent.\n *\n * Deliberately not the socket status: a never-started chat sits in\n * `standby` until its first send and must still take a prefill.\n */\nexport function useComposerReady(): boolean {\n  const list = useAthenaStatewireThreadList();\n  const threadLoading = useAuiState((s) => s.optional.thread?.isLoading ?? false);\n  const lanePending = useStatewireSessionLanePending();\n  return !(list?.isLoading ?? false) && !threadLoading && !lanePending;\n}\n\n/** The draft after `write`: `replace` (or an empty draft) takes the text as is. */\nexport function mergeComposerDraft({\n  current,\n  write,\n}: {\n  current: string;\n  write: Pick<ComposerWrite, 'text' | 'replace'>;\n}): string {\n  if (write.replace || !current) return write.text;\n  return `${current}\\n${write.text}`;\n}\n\n/**\n * Write into the live composer. Returns the send's outcome for a `send`\n * write so callers can await it.\n */\nexport function applyComposerWrite({\n  target,\n  store,\n  write,\n}: {\n  target: ComposerTarget;\n  store: ComposerHandoffStore | null;\n  write: ComposerWrite;\n}): Promise<void> | void {\n  const current = target.composer.getState().text ?? '';\n  const next = mergeComposerDraft({ current, write });\n  target.composer.setText(next);\n  if (write.focus && store) {\n    // An unchanged draft never re-mirrors, so focus at once; otherwise the\n    // editor focuses itself right after it has shown the new text.\n    if (next === current) store.focusEnd?.();\n    else store.focusOnNextMirror = true;\n  }\n  athenaDiagnostics.emit('composer.handoff', {\n    level: 'debug',\n    data: { phase: 'applied', send: write.send, focus: write.focus, chars: next.length },\n  });\n  if (write.send) {\n    return Promise.resolve(target.composer.send({ steer: false })).then(() => undefined);\n  }\n  return undefined;\n}\n\n/**\n * Hold a write until the composer is ready. Writes keep their order; a plain\n * append folds into a directly preceding plain append for the same thread\n * (one draft, not two), while a replace or a send is kept as its own step so\n * no message is lost and every send settles on its own.\n */\nexport function queueComposerWrite({\n  store,\n  write,\n}: {\n  store: ComposerHandoffStore;\n  write: ComposerWrite;\n}): void {\n  const last = store.pending[store.pending.length - 1];\n  const foldable =\n    last !== undefined &&\n    !last.send &&\n    !write.send &&\n    !write.replace &&\n    last.threadId === write.threadId &&\n    last.resolve === undefined &&\n    write.resolve === undefined;\n  if (foldable) {\n    last.text = mergeComposerDraft({ current: last.text, write });\n    last.focus = last.focus || write.focus;\n  } else {\n    store.pending.push(write);\n  }\n  athenaDiagnostics.emit('composer.handoff', {\n    level: 'debug',\n    data: { phase: 'deferred', send: write.send, focus: write.focus, queued: store.pending.length },\n  });\n}\n\nfunction dropWrite({ write, reason }: { write: ComposerWrite; reason: string }): void {\n  const error = new AthenaSdkError({\n    code: 'composer_write_dropped',\n    message: `A composer ${write.send ? 'send' : 'draft'} queued before the chat was ready was dropped: ${reason}.`,\n    hint: 'Make the write again from the chat that is active now.',\n    context: { threadId: write.threadId, send: write.send },\n  });\n  athenaDiagnostics.emit('composer.handoff', {\n    level: 'warn',\n    error,\n    data: { phase: 'dropped', send: write.send, reason, threadId: write.threadId },\n  });\n  write.reject?.(error);\n}\n\n/**\n * Deliver the pending writes, in order, into a now-ready composer. A write\n * made for another thread is dropped (rejected), never applied here.\n */\nexport function drainComposerHandoff({\n  store,\n  target,\n  threadId,\n}: {\n  store: ComposerHandoffStore;\n  target: ComposerTarget;\n  /** The statewire thread of the mount that is draining. */\n  threadId: string | null;\n}): void {\n  const writes = store.pending;\n  if (writes.length === 0) return;\n  store.pending = [];\n  for (const write of writes) {\n    if (write.threadId !== null && threadId !== null && write.threadId !== threadId) {\n      dropWrite({ write, reason: `it was made for thread ${write.threadId}, thread ${threadId} is active` });\n      continue;\n    }\n    const outcome = applyComposerWrite({ target, store, write });\n    write.resolve?.(outcome);\n  }\n}\n\n/** Drop every pending write (identity changed, provider unmounted). */\nexport function clearComposerHandoff({\n  store,\n  reason,\n}: {\n  store: ComposerHandoffStore;\n  reason: string;\n}): void {\n  // Another identity, or no provider: the attachments given back belong to drafts that are gone.\n  store.restoredAttachments?.clear();\n  const writes = store.pending;\n  if (writes.length === 0) return;\n  store.pending = [];\n  for (const write of writes) dropWrite({ write, reason });\n}\n"],"names":["createContext","useContext","useCallback","useAthenaStatewireThreadList","useAuiState","useStatewireSessionLanePending","athenaDiagnostics","AthenaSdkError"],"mappings":"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"}

package/dist/composer/useAppendToComposer.cjs

@@ -1,17 +1,17 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const react$1 = require("react");
+const require$$0 = require("react");
 const react = require("@assistant-ui/react");
 const threadIdContext = require("../threads/thread-id-context.cjs");
 const composerHandoff = require("./composer-handoff.cjs");
 function useAppendToComposer() {
   const aui = react.useAui();
   const store = composerHandoff.useComposerHandoffStore();
-  const threadId = react$1.useContext(threadIdContext.AthenaStatewireThreadIdContext);
+  const threadId = require$$0.useContext(threadIdContext.AthenaStatewireThreadIdContext);
   const ready = composerHandoff.useComposerReady();
-  const readyRef = react$1.useRef(ready);
+  const readyRef = require$$0.useRef(ready);
   readyRef.current = ready;
-  return react$1.useCallback(
+  return require$$0.useCallback(
     (text, opts) => {
       const write = {
         text,

package/dist/composer/useAppendToComposer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useAppendToComposer.cjs","sources":["../../src/composer/useAppendToComposer.ts"],"sourcesContent":["import { useCallback, useContext, useRef } from 'react';\nimport { useAui } from '@assistant-ui/react';\nimport { AthenaStatewireThreadIdContext } from '../threads/thread-id-context';\nimport {\n  applyComposerWrite,\n  queueComposerWrite,\n  useComposerHandoffStore,\n  useComposerReady,\n  type ComposerWrite,\n} from './composer-handoff';\n\nexport interface AppendToComposerOptions {\n  /** Replace the current draft instead of appending on a new line. */\n  replace?: boolean;\n  /**\n   * Focus the composer with the caret after the text once the editor shows\n   * it — for a prefilled draft the user is meant to finish by typing or\n   * dictating. Defaults to false.\n   */\n  focus?: boolean;\n}\n\n/**\n * Hook to programmatically append text to the composer without sending it.\n *\n * Safe to call at any time: a write made before the chat is ready (the\n * thread list still resolving the active thread, or the thread's history\n * still loading) waits in the provider and lands once the composer is\n * ready, instead of being lost with the mount it was written into. A\n * never-started chat is ready without a live socket. The write is bound to\n * the thread it was made for: if the user switches threads first, it is\n * dropped (a `composer.handoff` diagnostic says so), never written into\n * another thread.\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 *   append(\"Here is what happened: \", { replace: true, focus: true }); // caret after the text\n */\nexport function useAppendToComposer() {\n  const aui = useAui();\n  const store = useComposerHandoffStore();\n  const threadId = useContext(AthenaStatewireThreadIdContext);\n  const ready = useComposerReady();\n  // The callback stays identity-stable across readiness changes.\n  const readyRef = useRef(ready);\n  readyRef.current = ready;\n\n  return useCallback(\n    (text: string, opts?: AppendToComposerOptions) => {\n      const write: ComposerWrite = {\n        text,\n        replace: opts?.replace ?? false,\n        send: false,\n        focus: opts?.focus ?? false,\n        threadId,\n      };\n      if (store && !readyRef.current) {\n        queueComposerWrite({ store, write });\n        return;\n      }\n      applyComposerWrite({ target: aui, store, write });\n    },\n    [aui, store, threadId],\n  );\n}\n"],"names":["useAui","useComposerHandoffStore","useContext","AthenaStatewireThreadIdContext","useComposerReady","useRef","useCallback","queueComposerWrite","applyComposerWrite"],"mappings":";;;;;;AA2CO,SAAS,sBAAsB;AACpC,QAAM,MAAMA,MAAAA,OAAA;AACZ,QAAM,QAAQC,gBAAAA,wBAAA;AACd,QAAM,WAAWC,QAAAA,WAAWC,8CAA8B;AAC1D,QAAM,QAAQC,gBAAAA,iBAAA;AAEd,QAAM,WAAWC,QAAAA,OAAO,KAAK;AAC7B,WAAS,UAAU;AAEnB,SAAOC,QAAAA;AAAAA,IACL,CAAC,MAAc,SAAmC;AAChD,YAAM,QAAuB;AAAA,QAC3B;AAAA,QACA,UAAS,6BAAM,YAAW;AAAA,QAC1B,MAAM;AAAA,QACN,QAAO,6BAAM,UAAS;AAAA,QACtB;AAAA,MAAA;AAEF,UAAI,SAAS,CAAC,SAAS,SAAS;AAC9BC,2CAAmB,EAAE,OAAO,OAAO;AACnC;AAAA,MACF;AACAC,sBAAAA,mBAAmB,EAAE,QAAQ,KAAK,OAAO,OAAO;AAAA,IAClD;AAAA,IACA,CAAC,KAAK,OAAO,QAAQ;AAAA,EAAA;AAEzB;;"}
+{"version":3,"file":"useAppendToComposer.cjs","sources":["../../src/composer/useAppendToComposer.ts"],"sourcesContent":["import { useCallback, useContext, useRef } from 'react';\nimport { useAui } from '@assistant-ui/react';\nimport { AthenaStatewireThreadIdContext } from '../threads/thread-id-context';\nimport {\n  applyComposerWrite,\n  queueComposerWrite,\n  useComposerHandoffStore,\n  useComposerReady,\n  type ComposerWrite,\n} from './composer-handoff';\n\nexport interface AppendToComposerOptions {\n  /** Replace the current draft instead of appending on a new line. */\n  replace?: boolean;\n  /**\n   * Focus the composer with the caret after the text once the editor shows\n   * it — for a prefilled draft the user is meant to finish by typing or\n   * dictating. Defaults to false.\n   */\n  focus?: boolean;\n}\n\n/**\n * Hook to programmatically append text to the composer without sending it.\n *\n * Safe to call at any time: a write made before the chat is ready (the\n * thread list still resolving the active thread, or the thread's history\n * still loading) waits in the provider and lands once the composer is\n * ready, instead of being lost with the mount it was written into. A\n * never-started chat is ready without a live socket. The write is bound to\n * the thread it was made for: if the user switches threads first, it is\n * dropped (a `composer.handoff` diagnostic says so), never written into\n * another thread.\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 *   append(\"Here is what happened: \", { replace: true, focus: true }); // caret after the text\n */\nexport function useAppendToComposer() {\n  const aui = useAui();\n  const store = useComposerHandoffStore();\n  const threadId = useContext(AthenaStatewireThreadIdContext);\n  const ready = useComposerReady();\n  // The callback stays identity-stable across readiness changes.\n  const readyRef = useRef(ready);\n  readyRef.current = ready;\n\n  return useCallback(\n    (text: string, opts?: AppendToComposerOptions) => {\n      const write: ComposerWrite = {\n        text,\n        replace: opts?.replace ?? false,\n        send: false,\n        focus: opts?.focus ?? false,\n        threadId,\n      };\n      if (store && !readyRef.current) {\n        queueComposerWrite({ store, write });\n        return;\n      }\n      applyComposerWrite({ target: aui, store, write });\n    },\n    [aui, store, threadId],\n  );\n}\n"],"names":["useAui","useComposerHandoffStore","useContext","AthenaStatewireThreadIdContext","useComposerReady","useRef","useCallback","queueComposerWrite","applyComposerWrite"],"mappings":";;;;;;AA2CO,SAAS,sBAAsB;AACpC,QAAM,MAAMA,MAAAA,OAAA;AACZ,QAAM,QAAQC,gBAAAA,wBAAA;AACd,QAAM,WAAWC,WAAAA,WAAWC,8CAA8B;AAC1D,QAAM,QAAQC,gBAAAA,iBAAA;AAEd,QAAM,WAAWC,WAAAA,OAAO,KAAK;AAC7B,WAAS,UAAU;AAEnB,SAAOC,WAAAA;AAAAA,IACL,CAAC,MAAc,SAAmC;AAChD,YAAM,QAAuB;AAAA,QAC3B;AAAA,QACA,UAAS,6BAAM,YAAW;AAAA,QAC1B,MAAM;AAAA,QACN,QAAO,6BAAM,UAAS;AAAA,QACtB;AAAA,MAAA;AAEF,UAAI,SAAS,CAAC,SAAS,SAAS;AAC9BC,2CAAmB,EAAE,OAAO,OAAO;AACnC;AAAA,MACF;AACAC,sBAAAA,mBAAmB,EAAE,QAAQ,KAAK,OAAO,OAAO;AAAA,IAClD;AAAA,IACA,CAAC,KAAK,OAAO,QAAQ;AAAA,EAAA;AAEzB;;"}