@athenaintel/react 0.28.1 → 0.32.0

package/dist/composer/QuoteContext.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"QuoteContext.cjs","sources":["../../src/composer/QuoteContext.tsx"],"sourcesContent":["import { createContext, useCallback, useContext, useEffect, useMemo, useState, type ReactNode } from 'react';\n\nexport interface QuoteData {\n  /** The selected/quoted text. */\n  text: string;\n  /** Title of the source (e.g., asset title, document name). */\n  sourceTitle?: string;\n  /** Asset ID of the source (for attribution). */\n  sourceAssetId?: string;\n  /** Message ID of the source message (when quoting from chat). */\n  sourceMessageId?: string;\n  /** Role of the source message ('assistant' | 'user'). */\n  sourceRole?: string;\n}\n\ninterface QuoteContextValue {\n  quote: QuoteData | null;\n  setQuote: (quote: QuoteData | null) => void;\n  clearQuote: () => void;\n}\n\nconst QuoteCtx = createContext<QuoteContextValue | null>(null);\n\nexport function QuoteProvider({ children }: { children: ReactNode }) {\n  const [quote, setQuote] = useState<QuoteData | null>(null);\n  const clearQuote = useCallback(() => setQuote(null), []);\n\n  const value = useMemo(() => ({ quote, setQuote, clearQuote }), [quote, setQuote, clearQuote]);\n\n  return (\n    <QuoteCtx.Provider value={value}>\n      {children}\n    </QuoteCtx.Provider>\n  );\n}\n\nexport function useQuote(): QuoteContextValue {\n  const ctx = useContext(QuoteCtx);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useQuote must be used within <QuoteProvider>');\n  }\n  return ctx;\n}\n\n/**\n * 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.\n */\nexport function isDirectChildFrame(source: MessageEventSource | null): boolean {\n  if (!source || source === window) return false;\n  for (const frame of document.querySelectorAll('iframe')) {\n    if (frame.contentWindow === source) return true;\n  }\n  try {\n    return Reflect.get(source, 'parent') === window;\n  } catch {\n    return false;\n  }\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 inside AthenaProvider.\n */\nexport function useQuoteFromPostMessage() {\n  const { setQuote } = useQuote();\n\n  useEffect(() => {\n    // ── Cmd+L / Ctrl+L keyboard handler ──────────────────────────────\n    const handleKeydown = (e: KeyboardEvent) => {\n      if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === 'l') {\n        const sel = window.getSelection();\n        const selection = sel?.toString()?.trim();\n\n        if (selection && selection.length > 0) {\n          e.preventDefault();\n\n          // Walk up from the selection anchor to find the message container.\n          // assistant-ui message roots have data-role=\"assistant\" or data-role=\"user\".\n          let messageId: string | undefined;\n          let role: string | undefined;\n          let node = sel?.anchorNode as HTMLElement | null;\n          while (node && node !== document.body) {\n            if (node instanceof HTMLElement) {\n              const dataRole = node.getAttribute('data-role');\n              if (dataRole === 'assistant' || dataRole === 'user') {\n                role = dataRole;\n                // assistant-ui sets data-message-id on message roots\n                messageId = node.getAttribute('data-message-id') ?? undefined;\n                break;\n              }\n            }\n            node = node.parentElement;\n          }\n\n          setQuote({ text: selection, sourceRole: role, sourceMessageId: messageId });\n        }\n      }\n    };\n\n    // ── PostMessage handler (from iframes) ───────────────────────────\n    // 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)\n      ) {\n        setQuote({\n          text: data.text,\n          sourceTitle: data.sourceTitle,\n          sourceAssetId: data.sourceAssetId,\n        });\n      }\n    };\n\n    document.addEventListener('keydown', handleKeydown, true); // capture phase to beat the browser\n    window.addEventListener('message', handleMessage);\n\n    return () => {\n      document.removeEventListener('keydown', handleKeydown, true);\n      window.removeEventListener('message', handleMessage);\n    };\n  }, [setQuote]);\n}\n"],"names":["createContext","useState","useCallback","useMemo","jsx","useContext","useEffect"],"mappings":";;;;AAqBA,MAAM,WAAWA,MAAAA,cAAwC,IAAI;AAEtD,SAAS,cAAc,EAAE,YAAqC;AACnE,QAAM,CAAC,OAAO,QAAQ,IAAIC,MAAAA,SAA2B,IAAI;AACzD,QAAM,aAAaC,MAAAA,YAAY,MAAM,SAAS,IAAI,GAAG,CAAA,CAAE;AAEvD,QAAM,QAAQC,MAAAA,QAAQ,OAAO,EAAE,OAAO,UAAU,WAAA,IAAe,CAAC,OAAO,UAAU,UAAU,CAAC;AAE5F,SACEC,2BAAAA,IAAC,SAAS,UAAT,EAAkB,OAChB,SAAA,CACH;AAEJ;AAEO,SAAS,WAA8B;AAC5C,QAAM,MAAMC,MAAAA,WAAW,QAAQ;AAC/B,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,0DAA0D;AAAA,EAC5E;AACA,SAAO;AACT;AAUO,SAAS,mBAAmB,QAA4C;AAC7E,MAAI,CAAC,UAAU,WAAW,OAAQ,QAAO;AACzC,aAAW,SAAS,SAAS,iBAAiB,QAAQ,GAAG;AACvD,QAAI,MAAM,kBAAkB,OAAQ,QAAO;AAAA,EAC7C;AACA,MAAI;AACF,WAAO,QAAQ,IAAI,QAAQ,QAAQ,MAAM;AAAA,EAC3C,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAYO,SAAS,0BAA0B;AACxC,QAAM,EAAE,SAAA,IAAa,SAAA;AAErBC,QAAAA,UAAU,MAAM;AAEd,UAAM,gBAAgB,CAAC,MAAqB;;AAC1C,WAAK,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,YAAA,MAAkB,KAAK;AAC3D,cAAM,MAAM,OAAO,aAAA;AACnB,cAAM,aAAY,gCAAK,eAAL,mBAAiB;AAEnC,YAAI,aAAa,UAAU,SAAS,GAAG;AACrC,YAAE,eAAA;AAIF,cAAI;AACJ,cAAI;AACJ,cAAI,OAAO,2BAAK;AAChB,iBAAO,QAAQ,SAAS,SAAS,MAAM;AACrC,gBAAI,gBAAgB,aAAa;AAC/B,oBAAM,WAAW,KAAK,aAAa,WAAW;AAC9C,kBAAI,aAAa,eAAe,aAAa,QAAQ;AACnD,uBAAO;AAEP,4BAAY,KAAK,aAAa,iBAAiB,KAAK;AACpD;AAAA,cACF;AAAA,YACF;AACA,mBAAO,KAAK;AAAA,UACd;AAEA,mBAAS,EAAE,MAAM,WAAW,YAAY,MAAM,iBAAiB,WAAW;AAAA,QAC5E;AAAA,MACF;AAAA,IACF;AAOA,UAAM,gBAAgB,CAAC,UAAwB;AAC7C,YAAM,OAAO,MAAM;AACnB,UACE,QACA,OAAO,SAAS,YAChB,KAAK,SAAS,4BACd,OAAO,KAAK,SAAS,YACrB,KAAK,KAAK,OAAO,SAAS,KAC1B,mBAAmB,MAAM,MAAM,GAC/B;AACA,iBAAS;AAAA,UACP,MAAM,KAAK;AAAA,UACX,aAAa,KAAK;AAAA,UAClB,eAAe,KAAK;AAAA,QAAA,CACrB;AAAA,MACH;AAAA,IACF;AAEA,aAAS,iBAAiB,WAAW,eAAe,IAAI;AACxD,WAAO,iBAAiB,WAAW,aAAa;AAEhD,WAAO,MAAM;AACX,eAAS,oBAAoB,WAAW,eAAe,IAAI;AAC3D,aAAO,oBAAoB,WAAW,aAAa;AAAA,IACrD;AAAA,EACF,GAAG,CAAC,QAAQ,CAAC;AACf;;;;;"}
+{"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/QuoteContext.d.ts

@@ -1,4 +1,5 @@
-import { type ReactNode } from 'react';
+import { type RefObject, type ReactNode } from 'react';
+import { type StoreApi } from 'zustand/vanilla';
 export interface QuoteData {
     /** The selected/quoted text. */
     text: string;
@@ -16,8 +17,24 @@ interface QuoteContextValue {
     setQuote: (quote: QuoteData | null) => void;
     clearQuote: () => void;
 }
-export declare function QuoteProvider({ children }: {
+interface QuoteStoreState {
+    quote: QuoteData | null;
+}
+/**
+ * A composer's pending quote, kept outside React (`createQuoteStore`), like
+ * `AttachmentStore`: one per chat when a host shows several.
+ */
+export type QuoteStore = StoreApi<QuoteStoreState>;
+/** An empty `QuoteStore`, for `<QuoteProvider store>`. */
+export declare function createQuoteStore(): QuoteStore;
+/**
+ * The composer's pending quote. Like \`AttachmentProvider\`, a `store` makes
+ * it that store's, and without one it reuses a provider already mounted
+ * above, so a host can keep the quote across a remounting \`AthenaChat\`.
+ */
+export declare function QuoteProvider({ children, store }: {
     children: ReactNode;
+    store?: QuoteStore;
 }): import("react").JSX.Element;
 export declare function useQuote(): QuoteContextValue;
 /**
@@ -26,9 +43,21 @@ export declare function useQuote(): QuoteContextValue;
  * comparison, safe cross-origin), or, for a frame inside a shadow root, a
  * window whose `parent` is this window (`parent` is readable on a
  * cross-origin window). A message port, a worker, this window itself, a
- * grandchild frame or an unrelated window is refused.
+ * grandchild frame or an unrelated window is refused. `win` is the window the
+ * message came to (default: this one), e.g. a popped-out chat's.
  */
-export declare function isDirectChildFrame(source: MessageEventSource | null): boolean;
+export declare function isDirectChildFrame(source: MessageEventSource | null, win?: Window): boolean;
+export interface QuoteFromPostMessageOptions {
+    /**
+     * An element inside the chat this composer belongs to. With several chats in
+     * one window, a ⌘L selection goes to the chat it was made in, and one made
+     * outside every chat (or an embedded frame's text) to the chat the person
+     * last focused; the keys and an embedded frame's messages are heard in this
+     * element's own window, a pop-out included. Without it, every quote is this
+     * composer's, as before.
+     */
+    scope?: RefObject<Element | null>;
+}
 /**
  * Listens for:
  * 1. Cmd+L / Ctrl+L keydown — grabs the current text selection and sets it as a quote.
@@ -37,7 +66,7 @@ export declare function isDirectChildFrame(source: MessageEventSource | null): b
  *    with type `athena-add-to-composer`, only from a frame embedded directly
  *    in this window ({@link isDirectChildFrame}).
  *
- * Mount this once inside AthenaProvider.
+ * Mount this once per composer inside AthenaProvider (`AthenaChat` does).
  */
-export declare function useQuoteFromPostMessage(): void;
+export declare function useQuoteFromPostMessage({ scope }?: QuoteFromPostMessageOptions): void;
 export {};

package/dist/composer/QuoteContext.js

@@ -1,10 +1,31 @@
-import { jsx } from "react/jsx-runtime";
-import { useContext, useState, useCallback, useMemo, createContext, useEffect } from "react";
+import { jsx, Fragment } from "react/jsx-runtime";
+import { useContext, createContext, useMemo, useState, useEffect } from "react";
+import { useStore } from "zustand";
+import { createStore } from "zustand/vanilla";
 const QuoteCtx = createContext(null);
-function QuoteProvider({ children }) {
-  const [quote, setQuote] = useState(null);
-  const clearQuote = useCallback(() => setQuote(null), []);
-  const value = useMemo(() => ({ quote, setQuote, clearQuote }), [quote, setQuote, clearQuote]);
+function createQuoteStore() {
+  return createStore(() => ({ quote: null }));
+}
+function QuoteProvider({ children, store }) {
+  const outer = useContext(QuoteCtx);
+  if (store) return /* @__PURE__ */ jsx(StoreQuoteProvider, { store, children });
+  if (outer) return /* @__PURE__ */ jsx(Fragment, { children });
+  return /* @__PURE__ */ jsx(OwnQuoteProvider, { children });
+}
+function OwnQuoteProvider({ children }) {
+  const [store] = useState(createQuoteStore);
+  return /* @__PURE__ */ jsx(StoreQuoteProvider, { store, children });
+}
+function StoreQuoteProvider({ children, store }) {
+  const quote = useStore(store, (state) => state.quote);
+  const actions = useMemo(
+    () => ({
+      setQuote: (next) => store.setState({ quote: next }),
+      clearQuote: () => store.setState({ quote: null })
+    }),
+    [store]
+  );
+  const value = useMemo(() => ({ quote, ...actions }), [quote, actions]);
   return /* @__PURE__ */ jsx(QuoteCtx.Provider, { value, children });
 }
 function useQuote() {
@@ -14,38 +35,66 @@ function useQuote() {
   }
   return ctx;
 }
-function isDirectChildFrame(source) {
-  if (!source || source === window) return false;
-  for (const frame of document.querySelectorAll("iframe")) {
+function isDirectChildFrame(source, win = window) {
+  if (!source || source === win) return false;
+  for (const frame of win.document.querySelectorAll("iframe")) {
     if (frame.contentWindow === source) return true;
   }
   try {
-    return Reflect.get(source, "parent") === window;
+    return Reflect.get(source, "parent") === win;
   } catch {
     return false;
   }
 }
-function useQuoteFromPostMessage() {
+const CHAT_ROOT_SELECTOR = ".aui-thread-root";
+const lastFocusedChatRoots = /* @__PURE__ */ new WeakMap();
+function elementOf(node) {
+  if (!node) return null;
+  return node.nodeType === 1 ? node : node.parentElement;
+}
+function useQuoteFromPostMessage({ scope } = {}) {
   const { setQuote } = useQuote();
   useEffect(() => {
+    var _a;
+    const doc = ((_a = scope == null ? void 0 : scope.current) == null ? void 0 : _a.ownerDocument) ?? document;
+    const win = doc.defaultView ?? window;
+    const chatRoot = () => {
+      var _a2;
+      return ((_a2 = scope == null ? void 0 : scope.current) == null ? void 0 : _a2.closest(CHAT_ROOT_SELECTOR)) ?? null;
+    };
+    const takes = (anchor) => {
+      var _a2;
+      const mine = chatRoot();
+      if (!mine) return true;
+      const owner = ((_a2 = elementOf(anchor)) == null ? void 0 : _a2.closest(CHAT_ROOT_SELECTOR)) ?? null;
+      if (owner) return owner === mine;
+      const remembered = lastFocusedChatRoots.get(doc);
+      const focused = (remembered == null ? void 0 : remembered.isConnected) ? remembered : doc.querySelector(CHAT_ROOT_SELECTOR);
+      return focused === mine;
+    };
+    const handleFocusIn = (event) => {
+      const mine = chatRoot();
+      const target = event.target;
+      if (mine && target && typeof target.nodeType === "number" && mine.contains(target)) {
+        lastFocusedChatRoots.set(doc, mine);
+      }
+    };
     const handleKeydown = (e) => {
-      var _a;
+      var _a2;
       if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === "l") {
-        const sel = window.getSelection();
-        const selection = (_a = sel == null ? void 0 : sel.toString()) == null ? void 0 : _a.trim();
-        if (selection && selection.length > 0) {
+        const sel = doc.getSelection();
+        const selection = (_a2 = sel == null ? void 0 : sel.toString()) == null ? void 0 : _a2.trim();
+        if (selection && selection.length > 0 && takes((sel == null ? void 0 : sel.anchorNode) ?? null)) {
           e.preventDefault();
           let messageId;
           let role;
-          let node = sel == null ? void 0 : sel.anchorNode;
-          while (node && node !== document.body) {
-            if (node instanceof HTMLElement) {
-              const dataRole = node.getAttribute("data-role");
-              if (dataRole === "assistant" || dataRole === "user") {
-                role = dataRole;
-                messageId = node.getAttribute("data-message-id") ?? void 0;
-                break;
-              }
+          let node = elementOf(sel == null ? void 0 : sel.anchorNode);
+          while (node && node !== doc.body) {
+            const dataRole = node.getAttribute("data-role");
+            if (dataRole === "assistant" || dataRole === "user") {
+              role = dataRole;
+              messageId = node.getAttribute("data-message-id") ?? void 0;
+              break;
             }
             node = node.parentElement;
           }
@@ -55,7 +104,7 @@ function useQuoteFromPostMessage() {
     };
     const handleMessage = (event) => {
       const data = event.data;
-      if (data && typeof data === "object" && data.type === "athena-add-to-composer" && typeof data.text === "string" && data.text.trim().length > 0 && isDirectChildFrame(event.source)) {
+      if (data && typeof data === "object" && data.type === "athena-add-to-composer" && typeof data.text === "string" && data.text.trim().length > 0 && isDirectChildFrame(event.source, win) && takes(null)) {
         setQuote({
           text: data.text,
           sourceTitle: data.sourceTitle,
@@ -63,16 +112,19 @@ function useQuoteFromPostMessage() {
         });
       }
     };
-    document.addEventListener("keydown", handleKeydown, true);
-    window.addEventListener("message", handleMessage);
+    doc.addEventListener("keydown", handleKeydown, true);
+    doc.addEventListener("focusin", handleFocusIn, true);
+    win.addEventListener("message", handleMessage);
     return () => {
-      document.removeEventListener("keydown", handleKeydown, true);
-      window.removeEventListener("message", handleMessage);
+      doc.removeEventListener("keydown", handleKeydown, true);
+      doc.removeEventListener("focusin", handleFocusIn, true);
+      win.removeEventListener("message", handleMessage);
     };
-  }, [setQuote]);
+  }, [scope, setQuote]);
 }
 export {
   QuoteProvider,
+  createQuoteStore,
   isDirectChildFrame,
   useQuote,
   useQuoteFromPostMessage

package/dist/composer/QuoteContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"QuoteContext.js","sources":["../../src/composer/QuoteContext.tsx"],"sourcesContent":["import { createContext, useCallback, useContext, useEffect, useMemo, useState, type ReactNode } from 'react';\n\nexport interface QuoteData {\n  /** The selected/quoted text. */\n  text: string;\n  /** Title of the source (e.g., asset title, document name). */\n  sourceTitle?: string;\n  /** Asset ID of the source (for attribution). */\n  sourceAssetId?: string;\n  /** Message ID of the source message (when quoting from chat). */\n  sourceMessageId?: string;\n  /** Role of the source message ('assistant' | 'user'). */\n  sourceRole?: string;\n}\n\ninterface QuoteContextValue {\n  quote: QuoteData | null;\n  setQuote: (quote: QuoteData | null) => void;\n  clearQuote: () => void;\n}\n\nconst QuoteCtx = createContext<QuoteContextValue | null>(null);\n\nexport function QuoteProvider({ children }: { children: ReactNode }) {\n  const [quote, setQuote] = useState<QuoteData | null>(null);\n  const clearQuote = useCallback(() => setQuote(null), []);\n\n  const value = useMemo(() => ({ quote, setQuote, clearQuote }), [quote, setQuote, clearQuote]);\n\n  return (\n    <QuoteCtx.Provider value={value}>\n      {children}\n    </QuoteCtx.Provider>\n  );\n}\n\nexport function useQuote(): QuoteContextValue {\n  const ctx = useContext(QuoteCtx);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useQuote must be used within <QuoteProvider>');\n  }\n  return ctx;\n}\n\n/**\n * 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.\n */\nexport function isDirectChildFrame(source: MessageEventSource | null): boolean {\n  if (!source || source === window) return false;\n  for (const frame of document.querySelectorAll('iframe')) {\n    if (frame.contentWindow === source) return true;\n  }\n  try {\n    return Reflect.get(source, 'parent') === window;\n  } catch {\n    return false;\n  }\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 inside AthenaProvider.\n */\nexport function useQuoteFromPostMessage() {\n  const { setQuote } = useQuote();\n\n  useEffect(() => {\n    // ── Cmd+L / Ctrl+L keyboard handler ──────────────────────────────\n    const handleKeydown = (e: KeyboardEvent) => {\n      if ((e.metaKey || e.ctrlKey) && e.key.toLowerCase() === 'l') {\n        const sel = window.getSelection();\n        const selection = sel?.toString()?.trim();\n\n        if (selection && selection.length > 0) {\n          e.preventDefault();\n\n          // Walk up from the selection anchor to find the message container.\n          // assistant-ui message roots have data-role=\"assistant\" or data-role=\"user\".\n          let messageId: string | undefined;\n          let role: string | undefined;\n          let node = sel?.anchorNode as HTMLElement | null;\n          while (node && node !== document.body) {\n            if (node instanceof HTMLElement) {\n              const dataRole = node.getAttribute('data-role');\n              if (dataRole === 'assistant' || dataRole === 'user') {\n                role = dataRole;\n                // assistant-ui sets data-message-id on message roots\n                messageId = node.getAttribute('data-message-id') ?? undefined;\n                break;\n              }\n            }\n            node = node.parentElement;\n          }\n\n          setQuote({ text: selection, sourceRole: role, sourceMessageId: messageId });\n        }\n      }\n    };\n\n    // ── PostMessage handler (from iframes) ───────────────────────────\n    // 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)\n      ) {\n        setQuote({\n          text: data.text,\n          sourceTitle: data.sourceTitle,\n          sourceAssetId: data.sourceAssetId,\n        });\n      }\n    };\n\n    document.addEventListener('keydown', handleKeydown, true); // capture phase to beat the browser\n    window.addEventListener('message', handleMessage);\n\n    return () => {\n      document.removeEventListener('keydown', handleKeydown, true);\n      window.removeEventListener('message', handleMessage);\n    };\n  }, [setQuote]);\n}\n"],"names":[],"mappings":";;AAqBA,MAAM,WAAW,cAAwC,IAAI;AAEtD,SAAS,cAAc,EAAE,YAAqC;AACnE,QAAM,CAAC,OAAO,QAAQ,IAAI,SAA2B,IAAI;AACzD,QAAM,aAAa,YAAY,MAAM,SAAS,IAAI,GAAG,CAAA,CAAE;AAEvD,QAAM,QAAQ,QAAQ,OAAO,EAAE,OAAO,UAAU,WAAA,IAAe,CAAC,OAAO,UAAU,UAAU,CAAC;AAE5F,SACE,oBAAC,SAAS,UAAT,EAAkB,OAChB,SAAA,CACH;AAEJ;AAEO,SAAS,WAA8B;AAC5C,QAAM,MAAM,WAAW,QAAQ;AAC/B,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,0DAA0D;AAAA,EAC5E;AACA,SAAO;AACT;AAUO,SAAS,mBAAmB,QAA4C;AAC7E,MAAI,CAAC,UAAU,WAAW,OAAQ,QAAO;AACzC,aAAW,SAAS,SAAS,iBAAiB,QAAQ,GAAG;AACvD,QAAI,MAAM,kBAAkB,OAAQ,QAAO;AAAA,EAC7C;AACA,MAAI;AACF,WAAO,QAAQ,IAAI,QAAQ,QAAQ,MAAM;AAAA,EAC3C,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAYO,SAAS,0BAA0B;AACxC,QAAM,EAAE,SAAA,IAAa,SAAA;AAErB,YAAU,MAAM;AAEd,UAAM,gBAAgB,CAAC,MAAqB;;AAC1C,WAAK,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,YAAA,MAAkB,KAAK;AAC3D,cAAM,MAAM,OAAO,aAAA;AACnB,cAAM,aAAY,gCAAK,eAAL,mBAAiB;AAEnC,YAAI,aAAa,UAAU,SAAS,GAAG;AACrC,YAAE,eAAA;AAIF,cAAI;AACJ,cAAI;AACJ,cAAI,OAAO,2BAAK;AAChB,iBAAO,QAAQ,SAAS,SAAS,MAAM;AACrC,gBAAI,gBAAgB,aAAa;AAC/B,oBAAM,WAAW,KAAK,aAAa,WAAW;AAC9C,kBAAI,aAAa,eAAe,aAAa,QAAQ;AACnD,uBAAO;AAEP,4BAAY,KAAK,aAAa,iBAAiB,KAAK;AACpD;AAAA,cACF;AAAA,YACF;AACA,mBAAO,KAAK;AAAA,UACd;AAEA,mBAAS,EAAE,MAAM,WAAW,YAAY,MAAM,iBAAiB,WAAW;AAAA,QAC5E;AAAA,MACF;AAAA,IACF;AAOA,UAAM,gBAAgB,CAAC,UAAwB;AAC7C,YAAM,OAAO,MAAM;AACnB,UACE,QACA,OAAO,SAAS,YAChB,KAAK,SAAS,4BACd,OAAO,KAAK,SAAS,YACrB,KAAK,KAAK,OAAO,SAAS,KAC1B,mBAAmB,MAAM,MAAM,GAC/B;AACA,iBAAS;AAAA,UACP,MAAM,KAAK;AAAA,UACX,aAAa,KAAK;AAAA,UAClB,eAAe,KAAK;AAAA,QAAA,CACrB;AAAA,MACH;AAAA,IACF;AAEA,aAAS,iBAAiB,WAAW,eAAe,IAAI;AACxD,WAAO,iBAAiB,WAAW,aAAa;AAEhD,WAAO,MAAM;AACX,eAAS,oBAAoB,WAAW,eAAe,IAAI;AAC3D,aAAO,oBAAoB,WAAW,aAAa;AAAA,IACrD;AAAA,EACF,GAAG,CAAC,QAAQ,CAAC;AACf;"}
+{"version":3,"file":"QuoteContext.js","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":["_a"],"mappings":"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"}

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const AttachmentContext = require("./AttachmentContext.cjs");
+const composerMessage = require("../chat-ui/composer/composer-message.cjs");
 function buildComposedMessage(opts) {
   var _a;
   const parts = [];
@@ -21,5 +22,31 @@ ${quotedLines}`);
   if (trimmed) parts.push(trimmed);
   return parts.join("\n\n");
 }
+function buildComposedSend({
+  attachments,
+  quote,
+  send,
+  appUrl
+}) {
+  const text = buildComposedMessage({ attachments, quote, userText: send.text, appUrl });
+  if (!text) return null;
+  const draftMarkdown = buildComposedMessage({
+    attachments: attachments == null ? void 0 : attachments.map((attachment) => ({
+      ...attachment,
+      title: composerMessage.escapeCharacterReferences(attachment.title)
+    })),
+    quote: quote && {
+      ...quote,
+      text: composerMessage.escapeCharacterReferences(quote.text),
+      ...quote.sourceTitle !== void 0 && {
+        sourceTitle: composerMessage.escapeCharacterReferences(quote.sourceTitle)
+      }
+    },
+    userText: send.draftMarkdown,
+    appUrl
+  });
+  return { text, draftMarkdown };
+}
 exports.buildComposedMessage = buildComposedMessage;
+exports.buildComposedSend = buildComposedSend;
 //# sourceMappingURL=build-composed-message.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"build-composed-message.cjs","sources":["../../src/composer/build-composed-message.ts"],"sourcesContent":["import type { UploadedAsset } from './useFileUpload';\nimport type { QuoteData } from './QuoteContext';\nimport { buildAttachmentMarkdownWithAppUrl } from './AttachmentContext';\n\n/**\n * Assembles a composed message from attachments, a quote, and user text.\n * Used by both the TipTap Enter-key submit and the send-button click handler\n * to avoid duplicating the message-assembly logic.\n *\n * Returns an empty string if all inputs are empty.\n */\nexport function buildComposedMessage(opts: {\n  attachments?: UploadedAsset[];\n  quote?: QuoteData | null;\n  userText?: string;\n  appUrl?: string;\n}): string {\n  const parts: string[] = [];\n\n  if (opts.attachments && opts.attachments.length > 0) {\n    const attachmentMd = buildAttachmentMarkdownWithAppUrl({\n      attachments: opts.attachments,\n      appUrl: opts.appUrl,\n    });\n    if (attachmentMd) parts.push(attachmentMd);\n  }\n\n  if (opts.quote) {\n    const quotedLines = opts.quote.text.split('\\n').map((l) => `> ${l}`).join('\\n');\n    const sourceLabel = opts.quote.sourceTitle\n      ? `From \"${opts.quote.sourceTitle}\"`\n      : opts.quote.sourceRole === 'assistant'\n        ? 'Quoting assistant'\n        : 'Quoting';\n    parts.push(`${sourceLabel}:\\n${quotedLines}`);\n  }\n\n  const trimmed = opts.userText?.trim();\n  if (trimmed) parts.push(trimmed);\n\n  return parts.join('\\n\\n');\n}\n"],"names":["buildAttachmentMarkdownWithAppUrl"],"mappings":";;;AAWO,SAAS,qBAAqB,MAK1B;;AACT,QAAM,QAAkB,CAAA;AAExB,MAAI,KAAK,eAAe,KAAK,YAAY,SAAS,GAAG;AACnD,UAAM,eAAeA,kBAAAA,kCAAkC;AAAA,MACrD,aAAa,KAAK;AAAA,MAClB,QAAQ,KAAK;AAAA,IAAA,CACd;AACD,QAAI,aAAc,OAAM,KAAK,YAAY;AAAA,EAC3C;AAEA,MAAI,KAAK,OAAO;AACd,UAAM,cAAc,KAAK,MAAM,KAAK,MAAM,IAAI,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,EAAE,KAAK,IAAI;AAC9E,UAAM,cAAc,KAAK,MAAM,cAC3B,SAAS,KAAK,MAAM,WAAW,MAC/B,KAAK,MAAM,eAAe,cACxB,sBACA;AACN,UAAM,KAAK,GAAG,WAAW;AAAA,EAAM,WAAW,EAAE;AAAA,EAC9C;AAEA,QAAM,WAAU,UAAK,aAAL,mBAAe;AAC/B,MAAI,QAAS,OAAM,KAAK,OAAO;AAE/B,SAAO,MAAM,KAAK,MAAM;AAC1B;;"}
+{"version":3,"file":"build-composed-message.cjs","sources":["../../src/composer/build-composed-message.ts"],"sourcesContent":["import type { UploadedAsset } from './useFileUpload';\nimport type { QuoteData } from './QuoteContext';\nimport { buildAttachmentMarkdownWithAppUrl } from './AttachmentContext';\nimport {\n  type ComposerSend,\n  escapeCharacterReferences,\n} from '../chat-ui/composer/composer-message';\n\n/**\n * Assembles a composed message from attachments, a quote, and user text.\n * Used by both the TipTap Enter-key submit and the send-button click handler\n * to avoid duplicating the message-assembly logic.\n *\n * Returns an empty string if all inputs are empty.\n */\nexport function buildComposedMessage(opts: {\n  attachments?: UploadedAsset[];\n  quote?: QuoteData | null;\n  userText?: string;\n  appUrl?: string;\n}): string {\n  const parts: string[] = [];\n\n  if (opts.attachments && opts.attachments.length > 0) {\n    const attachmentMd = buildAttachmentMarkdownWithAppUrl({\n      attachments: opts.attachments,\n      appUrl: opts.appUrl,\n    });\n    if (attachmentMd) parts.push(attachmentMd);\n  }\n\n  if (opts.quote) {\n    const quotedLines = opts.quote.text.split('\\n').map((l) => `> ${l}`).join('\\n');\n    const sourceLabel = opts.quote.sourceTitle\n      ? `From \"${opts.quote.sourceTitle}\"`\n      : opts.quote.sourceRole === 'assistant'\n        ? 'Quoting assistant'\n        : 'Quoting';\n    parts.push(`${sourceLabel}:\\n${quotedLines}`);\n  }\n\n  const trimmed = opts.userText?.trim();\n  if (trimmed) parts.push(trimmed);\n\n  return parts.join('\\n\\n');\n}\n\n/**\n * The composed message a send delivers and the draft it came from: the same\n * attachments and quote around the editor's text as typed in one, and around\n * the editor's draft in the other (`ComposerSend`). `null` when there is\n * nothing to send.\n *\n * The quote and the attachment titles are text the person did not type in\n * the editor, and the message carries them as they are. The draft writes an\n * `&` in them that starts a character reference as `&amp;`, as the composer's\n * draft does for typed text, so it reads back as the message and stays a draft\n * of the message's own text (`isComposerMarkdownOfText`, which agora applies\n * too): a quoted `&lt;` would otherwise read as `<` in the draft and the\n * message would lose its composer markdown.\n */\nexport function buildComposedSend({\n  attachments,\n  quote,\n  send,\n  appUrl,\n}: {\n  attachments?: UploadedAsset[];\n  quote?: QuoteData | null;\n  send: ComposerSend;\n  appUrl?: string;\n}): ComposerSend | null {\n  const text = buildComposedMessage({ attachments, quote, userText: send.text, appUrl });\n  if (!text) return null;\n  const draftMarkdown = buildComposedMessage({\n    attachments: attachments?.map((attachment) => ({\n      ...attachment,\n      title: escapeCharacterReferences(attachment.title),\n    })),\n    quote: quote && {\n      ...quote,\n      text: escapeCharacterReferences(quote.text),\n      ...(quote.sourceTitle !== undefined && {\n        sourceTitle: escapeCharacterReferences(quote.sourceTitle),\n      }),\n    },\n    userText: send.draftMarkdown,\n    appUrl,\n  });\n  return { text, draftMarkdown };\n}\n"],"names":["buildAttachmentMarkdownWithAppUrl","escapeCharacterReferences"],"mappings":";;;;AAeO,SAAS,qBAAqB,MAK1B;;AACT,QAAM,QAAkB,CAAA;AAExB,MAAI,KAAK,eAAe,KAAK,YAAY,SAAS,GAAG;AACnD,UAAM,eAAeA,kBAAAA,kCAAkC;AAAA,MACrD,aAAa,KAAK;AAAA,MAClB,QAAQ,KAAK;AAAA,IAAA,CACd;AACD,QAAI,aAAc,OAAM,KAAK,YAAY;AAAA,EAC3C;AAEA,MAAI,KAAK,OAAO;AACd,UAAM,cAAc,KAAK,MAAM,KAAK,MAAM,IAAI,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,EAAE,KAAK,IAAI;AAC9E,UAAM,cAAc,KAAK,MAAM,cAC3B,SAAS,KAAK,MAAM,WAAW,MAC/B,KAAK,MAAM,eAAe,cACxB,sBACA;AACN,UAAM,KAAK,GAAG,WAAW;AAAA,EAAM,WAAW,EAAE;AAAA,EAC9C;AAEA,QAAM,WAAU,UAAK,aAAL,mBAAe;AAC/B,MAAI,QAAS,OAAM,KAAK,OAAO;AAE/B,SAAO,MAAM,KAAK,MAAM;AAC1B;AAgBO,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAKwB;AACtB,QAAM,OAAO,qBAAqB,EAAE,aAAa,OAAO,UAAU,KAAK,MAAM,QAAQ;AACrF,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,gBAAgB,qBAAqB;AAAA,IACzC,aAAa,2CAAa,IAAI,CAAC,gBAAgB;AAAA,MAC7C,GAAG;AAAA,MACH,OAAOC,gBAAAA,0BAA0B,WAAW,KAAK;AAAA,IAAA;AAAA,IAEnD,OAAO,SAAS;AAAA,MACd,GAAG;AAAA,MACH,MAAMA,gBAAAA,0BAA0B,MAAM,IAAI;AAAA,MAC1C,GAAI,MAAM,gBAAgB,UAAa;AAAA,QACrC,aAAaA,gBAAAA,0BAA0B,MAAM,WAAW;AAAA,MAAA;AAAA,IAC1D;AAAA,IAEF,UAAU,KAAK;AAAA,IACf;AAAA,EAAA,CACD;AACD,SAAO,EAAE,MAAM,cAAA;AACjB;;;"}

package/dist/composer/build-composed-message.d.ts

@@ -1,5 +1,6 @@
 import type { UploadedAsset } from './useFileUpload';
 import type { QuoteData } from './QuoteContext';
+import { type ComposerSend } from '../chat-ui/composer/composer-message';
 /**
  * Assembles a composed message from attachments, a quote, and user text.
  * Used by both the TipTap Enter-key submit and the send-button click handler
@@ -13,3 +14,23 @@ export declare function buildComposedMessage(opts: {
     userText?: string;
     appUrl?: string;
 }): string;
+/**
+ * The composed message a send delivers and the draft it came from: the same
+ * attachments and quote around the editor's text as typed in one, and around
+ * the editor's draft in the other (`ComposerSend`). `null` when there is
+ * nothing to send.
+ *
+ * The quote and the attachment titles are text the person did not type in
+ * the editor, and the message carries them as they are. The draft writes an
+ * `&` in them that starts a character reference as `&`, as the composer's
+ * draft does for typed text, so it reads back as the message and stays a draft
+ * of the message's own text (`isComposerMarkdownOfText`, which agora applies
+ * too): a quoted `&lt;` would otherwise read as `<` in the draft and the
+ * message would lose its composer markdown.
+ */
+export declare function buildComposedSend({ attachments, quote, send, appUrl, }: {
+    attachments?: UploadedAsset[];
+    quote?: QuoteData | null;
+    send: ComposerSend;
+    appUrl?: string;
+}): ComposerSend | null;

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

@@ -1,4 +1,5 @@
 import { buildAttachmentMarkdownWithAppUrl } from "./AttachmentContext.js";
+import { escapeCharacterReferences } from "../chat-ui/composer/composer-message.js";
 function buildComposedMessage(opts) {
   var _a;
   const parts = [];
@@ -19,7 +20,33 @@ ${quotedLines}`);
   if (trimmed) parts.push(trimmed);
   return parts.join("\n\n");
 }
+function buildComposedSend({
+  attachments,
+  quote,
+  send,
+  appUrl
+}) {
+  const text = buildComposedMessage({ attachments, quote, userText: send.text, appUrl });
+  if (!text) return null;
+  const draftMarkdown = buildComposedMessage({
+    attachments: attachments == null ? void 0 : attachments.map((attachment) => ({
+      ...attachment,
+      title: escapeCharacterReferences(attachment.title)
+    })),
+    quote: quote && {
+      ...quote,
+      text: escapeCharacterReferences(quote.text),
+      ...quote.sourceTitle !== void 0 && {
+        sourceTitle: escapeCharacterReferences(quote.sourceTitle)
+      }
+    },
+    userText: send.draftMarkdown,
+    appUrl
+  });
+  return { text, draftMarkdown };
+}
 export {
-  buildComposedMessage
+  buildComposedMessage,
+  buildComposedSend
 };
 //# sourceMappingURL=build-composed-message.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"build-composed-message.js","sources":["../../src/composer/build-composed-message.ts"],"sourcesContent":["import type { UploadedAsset } from './useFileUpload';\nimport type { QuoteData } from './QuoteContext';\nimport { buildAttachmentMarkdownWithAppUrl } from './AttachmentContext';\n\n/**\n * Assembles a composed message from attachments, a quote, and user text.\n * Used by both the TipTap Enter-key submit and the send-button click handler\n * to avoid duplicating the message-assembly logic.\n *\n * Returns an empty string if all inputs are empty.\n */\nexport function buildComposedMessage(opts: {\n  attachments?: UploadedAsset[];\n  quote?: QuoteData | null;\n  userText?: string;\n  appUrl?: string;\n}): string {\n  const parts: string[] = [];\n\n  if (opts.attachments && opts.attachments.length > 0) {\n    const attachmentMd = buildAttachmentMarkdownWithAppUrl({\n      attachments: opts.attachments,\n      appUrl: opts.appUrl,\n    });\n    if (attachmentMd) parts.push(attachmentMd);\n  }\n\n  if (opts.quote) {\n    const quotedLines = opts.quote.text.split('\\n').map((l) => `> ${l}`).join('\\n');\n    const sourceLabel = opts.quote.sourceTitle\n      ? `From \"${opts.quote.sourceTitle}\"`\n      : opts.quote.sourceRole === 'assistant'\n        ? 'Quoting assistant'\n        : 'Quoting';\n    parts.push(`${sourceLabel}:\\n${quotedLines}`);\n  }\n\n  const trimmed = opts.userText?.trim();\n  if (trimmed) parts.push(trimmed);\n\n  return parts.join('\\n\\n');\n}\n"],"names":[],"mappings":";AAWO,SAAS,qBAAqB,MAK1B;;AACT,QAAM,QAAkB,CAAA;AAExB,MAAI,KAAK,eAAe,KAAK,YAAY,SAAS,GAAG;AACnD,UAAM,eAAe,kCAAkC;AAAA,MACrD,aAAa,KAAK;AAAA,MAClB,QAAQ,KAAK;AAAA,IAAA,CACd;AACD,QAAI,aAAc,OAAM,KAAK,YAAY;AAAA,EAC3C;AAEA,MAAI,KAAK,OAAO;AACd,UAAM,cAAc,KAAK,MAAM,KAAK,MAAM,IAAI,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,EAAE,KAAK,IAAI;AAC9E,UAAM,cAAc,KAAK,MAAM,cAC3B,SAAS,KAAK,MAAM,WAAW,MAC/B,KAAK,MAAM,eAAe,cACxB,sBACA;AACN,UAAM,KAAK,GAAG,WAAW;AAAA,EAAM,WAAW,EAAE;AAAA,EAC9C;AAEA,QAAM,WAAU,UAAK,aAAL,mBAAe;AAC/B,MAAI,QAAS,OAAM,KAAK,OAAO;AAE/B,SAAO,MAAM,KAAK,MAAM;AAC1B;"}
+{"version":3,"file":"build-composed-message.js","sources":["../../src/composer/build-composed-message.ts"],"sourcesContent":["import type { UploadedAsset } from './useFileUpload';\nimport type { QuoteData } from './QuoteContext';\nimport { buildAttachmentMarkdownWithAppUrl } from './AttachmentContext';\nimport {\n  type ComposerSend,\n  escapeCharacterReferences,\n} from '../chat-ui/composer/composer-message';\n\n/**\n * Assembles a composed message from attachments, a quote, and user text.\n * Used by both the TipTap Enter-key submit and the send-button click handler\n * to avoid duplicating the message-assembly logic.\n *\n * Returns an empty string if all inputs are empty.\n */\nexport function buildComposedMessage(opts: {\n  attachments?: UploadedAsset[];\n  quote?: QuoteData | null;\n  userText?: string;\n  appUrl?: string;\n}): string {\n  const parts: string[] = [];\n\n  if (opts.attachments && opts.attachments.length > 0) {\n    const attachmentMd = buildAttachmentMarkdownWithAppUrl({\n      attachments: opts.attachments,\n      appUrl: opts.appUrl,\n    });\n    if (attachmentMd) parts.push(attachmentMd);\n  }\n\n  if (opts.quote) {\n    const quotedLines = opts.quote.text.split('\\n').map((l) => `> ${l}`).join('\\n');\n    const sourceLabel = opts.quote.sourceTitle\n      ? `From \"${opts.quote.sourceTitle}\"`\n      : opts.quote.sourceRole === 'assistant'\n        ? 'Quoting assistant'\n        : 'Quoting';\n    parts.push(`${sourceLabel}:\\n${quotedLines}`);\n  }\n\n  const trimmed = opts.userText?.trim();\n  if (trimmed) parts.push(trimmed);\n\n  return parts.join('\\n\\n');\n}\n\n/**\n * The composed message a send delivers and the draft it came from: the same\n * attachments and quote around the editor's text as typed in one, and around\n * the editor's draft in the other (`ComposerSend`). `null` when there is\n * nothing to send.\n *\n * The quote and the attachment titles are text the person did not type in\n * the editor, and the message carries them as they are. The draft writes an\n * `&` in them that starts a character reference as `&amp;`, as the composer's\n * draft does for typed text, so it reads back as the message and stays a draft\n * of the message's own text (`isComposerMarkdownOfText`, which agora applies\n * too): a quoted `&lt;` would otherwise read as `<` in the draft and the\n * message would lose its composer markdown.\n */\nexport function buildComposedSend({\n  attachments,\n  quote,\n  send,\n  appUrl,\n}: {\n  attachments?: UploadedAsset[];\n  quote?: QuoteData | null;\n  send: ComposerSend;\n  appUrl?: string;\n}): ComposerSend | null {\n  const text = buildComposedMessage({ attachments, quote, userText: send.text, appUrl });\n  if (!text) return null;\n  const draftMarkdown = buildComposedMessage({\n    attachments: attachments?.map((attachment) => ({\n      ...attachment,\n      title: escapeCharacterReferences(attachment.title),\n    })),\n    quote: quote && {\n      ...quote,\n      text: escapeCharacterReferences(quote.text),\n      ...(quote.sourceTitle !== undefined && {\n        sourceTitle: escapeCharacterReferences(quote.sourceTitle),\n      }),\n    },\n    userText: send.draftMarkdown,\n    appUrl,\n  });\n  return { text, draftMarkdown };\n}\n"],"names":[],"mappings":";;AAeO,SAAS,qBAAqB,MAK1B;;AACT,QAAM,QAAkB,CAAA;AAExB,MAAI,KAAK,eAAe,KAAK,YAAY,SAAS,GAAG;AACnD,UAAM,eAAe,kCAAkC;AAAA,MACrD,aAAa,KAAK;AAAA,MAClB,QAAQ,KAAK;AAAA,IAAA,CACd;AACD,QAAI,aAAc,OAAM,KAAK,YAAY;AAAA,EAC3C;AAEA,MAAI,KAAK,OAAO;AACd,UAAM,cAAc,KAAK,MAAM,KAAK,MAAM,IAAI,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,EAAE,KAAK,IAAI;AAC9E,UAAM,cAAc,KAAK,MAAM,cAC3B,SAAS,KAAK,MAAM,WAAW,MAC/B,KAAK,MAAM,eAAe,cACxB,sBACA;AACN,UAAM,KAAK,GAAG,WAAW;AAAA,EAAM,WAAW,EAAE;AAAA,EAC9C;AAEA,QAAM,WAAU,UAAK,aAAL,mBAAe;AAC/B,MAAI,QAAS,OAAM,KAAK,OAAO;AAE/B,SAAO,MAAM,KAAK,MAAM;AAC1B;AAgBO,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAKwB;AACtB,QAAM,OAAO,qBAAqB,EAAE,aAAa,OAAO,UAAU,KAAK,MAAM,QAAQ;AACrF,MAAI,CAAC,KAAM,QAAO;AAClB,QAAM,gBAAgB,qBAAqB;AAAA,IACzC,aAAa,2CAAa,IAAI,CAAC,gBAAgB;AAAA,MAC7C,GAAG;AAAA,MACH,OAAO,0BAA0B,WAAW,KAAK;AAAA,IAAA;AAAA,IAEnD,OAAO,SAAS;AAAA,MACd,GAAG;AAAA,MACH,MAAM,0BAA0B,MAAM,IAAI;AAAA,MAC1C,GAAI,MAAM,gBAAgB,UAAa;AAAA,QACrC,aAAa,0BAA0B,MAAM,WAAW;AAAA,MAAA;AAAA,IAC1D;AAAA,IAEF,UAAU,KAAK;AAAA,IACf;AAAA,EAAA,CACD;AACD,SAAO,EAAE,MAAM,cAAA;AACjB;"}

package/dist/composer/composer-handoff.cjs

@@ -6,12 +6,22 @@ const athenaDiagnostics = require("../diagnostics/athena-diagnostics.cjs");
 const errors = require("../diagnostics/errors.cjs");
 const statewireThreadList = require("../threads/statewire-thread-list.cjs");
 function createComposerHandoffStore() {
-  return { pending: [], focusOnNextMirror: false, focusEnd: null };
+  return { pending: [], focusOnNextMirror: false, focusEnd: null, focusOnMount: false };
 }
 const ComposerHandoffContext = react$1.createContext(null);
 function useComposerHandoffStore() {
   return react$1.useContext(ComposerHandoffContext);
 }
+function useFocusComposer() {
+  const store = useComposerHandoffStore();
+  return react$1.useCallback(() => {
+    if (store) focusComposer({ store });
+  }, [store]);
+}
+function focusComposer({ store }) {
+  if (store.focusEnd) store.focusEnd();
+  else store.focusOnMount = true;
+}
 function useComposerReady() {
   const list = statewireThreadList.useAthenaStatewireThreadList();
   const threadLoading = react.useAuiState((s) => {
@@ -114,8 +124,10 @@ exports.applyComposerWrite = applyComposerWrite;
 exports.clearComposerHandoff = clearComposerHandoff;
 exports.createComposerHandoffStore = createComposerHandoffStore;
 exports.drainComposerHandoff = drainComposerHandoff;
+exports.focusComposer = focusComposer;
 exports.mergeComposerDraft = mergeComposerDraft;
 exports.queueComposerWrite = queueComposerWrite;
 exports.useComposerHandoffStore = useComposerHandoffStore;
 exports.useComposerReady = useComposerReady;
+exports.useFocusComposer = useFocusComposer;
 //# sourceMappingURL=composer-handoff.cjs.map

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, useContext } from 'react';\nimport { useAuiState } from '@assistant-ui/react';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport { AthenaSdkError } from '../diagnostics/errors';\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}\n\nexport function createComposerHandoffStore(): ComposerHandoffStore {\n  return { pending: [], focusOnNextMirror: false, focusEnd: null };\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 * Whether a composer write lands now: in thread-list mode the list has\n * resolved which thread is active, and that thread's history has loaded.\n * Until then the composer the hooks write to is the one of a mount that is\n * about to be replaced, and the draft goes with it.\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  return !(list?.isLoading ?? false) && !threadLoading;\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  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","useAthenaStatewireThreadList","useAuiState","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 { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport { AthenaSdkError } from '../diagnostics/errors';\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\nexport function createComposerHandoffStore(): ComposerHandoffStore {\n  return { pending: [], focusOnNextMirror: false, focusEnd: null, focusOnMount: false };\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, and that thread's history has loaded.\n * Until then the composer the hooks write to is the one of a mount that is\n * about to be replaced, and the draft goes with it.\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  return !(list?.isLoading ?? false) && !threadLoading;\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  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","athenaDiagnostics","AthenaSdkError"],"mappings":";;;;;;;AAgEO,SAAS,6BAAmD;AACjE,SAAO,EAAE,SAAS,CAAA,GAAI,mBAAmB,OAAO,UAAU,MAAM,cAAc,MAAA;AAChF;AAEO,MAAM,yBAAyBA,QAAAA,cAA2C,IAAI;AAG9E,SAAS,0BAAuD;AACrE,SAAOC,QAAAA,WAAW,sBAAsB;AAC1C;AAOO,SAAS,mBAA+B;AAC7C,QAAM,QAAQ,wBAAA;AACd,SAAOC,QAAAA,YAAY,MAAM;AACvB,QAAI,MAAO,eAAc,EAAE,OAAO;AAAA,EACpC,GAAG,CAAC,KAAK,CAAC;AACZ;AAGO,SAAS,cAAc,EAAE,SAAgD;AAC9E,MAAI,MAAM,SAAU,OAAM,SAAA;AAAA,aACf,eAAe;AAC5B;AAWO,SAAS,mBAA4B;AAC1C,QAAM,OAAOC,oBAAAA,6BAAA;AACb,QAAM,gBAAgBC,MAAAA,YAAY,CAAC,MAAA;;AAAM,oBAAE,SAAS,WAAX,mBAAmB,cAAa;AAAA,GAAK;AAC9E,SAAO,GAAE,6BAAM,cAAa,UAAU,CAAC;AACzC;AAGO,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AACF,GAGW;AACT,MAAI,MAAM,WAAW,CAAC,gBAAgB,MAAM;AAC5C,SAAO,GAAG,OAAO;AAAA,EAAK,MAAM,IAAI;AAClC;AAMO,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AACF,GAIyB;;AACvB,QAAM,UAAU,OAAO,SAAS,SAAA,EAAW,QAAQ;AACnD,QAAM,OAAO,mBAAmB,EAAE,SAAS,OAAO;AAClD,SAAO,SAAS,QAAQ,IAAI;AAC5B,MAAI,MAAM,SAAS,OAAO;AAGxB,QAAI,SAAS,QAAS,aAAM,aAAN;AAAA,eACX,oBAAoB;AAAA,EACjC;AACAC,oBAAAA,kBAAkB,KAAK,oBAAoB;AAAA,IACzC,OAAO;AAAA,IACP,MAAM,EAAE,OAAO,WAAW,MAAM,MAAM,MAAM,OAAO,MAAM,OAAO,OAAO,KAAK,OAAA;AAAA,EAAO,CACpF;AACD,MAAI,MAAM,MAAM;AACd,WAAO,QAAQ,QAAQ,OAAO,SAAS,KAAK,EAAE,OAAO,MAAA,CAAO,CAAC,EAAE,KAAK,MAAM,MAAS;AAAA,EACrF;AACA,SAAO;AACT;AAQO,SAAS,mBAAmB;AAAA,EACjC;AAAA,EACA;AACF,GAGS;AACP,QAAM,OAAO,MAAM,QAAQ,MAAM,QAAQ,SAAS,CAAC;AACnD,QAAM,WACJ,SAAS,UACT,CAAC,KAAK,QACN,CAAC,MAAM,QACP,CAAC,MAAM,WACP,KAAK,aAAa,MAAM,YACxB,KAAK,YAAY,UACjB,MAAM,YAAY;AACpB,MAAI,UAAU;AACZ,SAAK,OAAO,mBAAmB,EAAE,SAAS,KAAK,MAAM,OAAO;AAC5D,SAAK,QAAQ,KAAK,SAAS,MAAM;AAAA,EACnC,OAAO;AACL,UAAM,QAAQ,KAAK,KAAK;AAAA,EAC1B;AACAA,oBAAAA,kBAAkB,KAAK,oBAAoB;AAAA,IACzC,OAAO;AAAA,IACP,MAAM,EAAE,OAAO,YAAY,MAAM,MAAM,MAAM,OAAO,MAAM,OAAO,QAAQ,MAAM,QAAQ,OAAA;AAAA,EAAO,CAC/F;AACH;AAEA,SAAS,UAAU,EAAE,OAAO,UAA0D;;AACpF,QAAM,QAAQ,IAAIC,sBAAe;AAAA,IAC/B,MAAM;AAAA,IACN,SAAS,cAAc,MAAM,OAAO,SAAS,OAAO,kDAAkD,MAAM;AAAA,IAC5G,MAAM;AAAA,IACN,SAAS,EAAE,UAAU,MAAM,UAAU,MAAM,MAAM,KAAA;AAAA,EAAK,CACvD;AACDD,oBAAAA,kBAAkB,KAAK,oBAAoB;AAAA,IACzC,OAAO;AAAA,IACP;AAAA,IACA,MAAM,EAAE,OAAO,WAAW,MAAM,MAAM,MAAM,QAAQ,UAAU,MAAM,SAAA;AAAA,EAAS,CAC9E;AACD,cAAM,WAAN,+BAAe;AACjB;AAMO,SAAS,qBAAqB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AACF,GAKS;;AACP,QAAM,SAAS,MAAM;AACrB,MAAI,OAAO,WAAW,EAAG;AACzB,QAAM,UAAU,CAAA;AAChB,aAAW,SAAS,QAAQ;AAC1B,QAAI,MAAM,aAAa,QAAQ,aAAa,QAAQ,MAAM,aAAa,UAAU;AAC/E,gBAAU,EAAE,OAAO,QAAQ,0BAA0B,MAAM,QAAQ,YAAY,QAAQ,aAAA,CAAc;AACrG;AAAA,IACF;AACA,UAAM,UAAU,mBAAmB,EAAE,QAAQ,OAAO,OAAO;AAC3D,gBAAM,YAAN,+BAAgB;AAAA,EAClB;AACF;AAGO,SAAS,qBAAqB;AAAA,EACnC;AAAA,EACA;AACF,GAGS;AACP,QAAM,SAAS,MAAM;AACrB,MAAI,OAAO,WAAW,EAAG;AACzB,QAAM,UAAU,CAAA;AAChB,aAAW,SAAS,OAAQ,WAAU,EAAE,OAAO,QAAQ;AACzD;;;;;;;;;;;;"}

package/dist/composer/composer-handoff.d.ts

@@ -33,11 +33,23 @@ export interface ComposerHandoffStore {
     focusOnNextMirror: boolean;
     /** Registered by the mounted editor: place the caret at the end of the draft. */
     focusEnd: (() => void) | null;
+    /** Set by `useFocusComposer` before the editor mounted; the editor consumes it when it does. */
+    focusOnMount: boolean;
 }
 export declare function createComposerHandoffStore(): ComposerHandoffStore;
 export declare const ComposerHandoffContext: import("react").Context<ComposerHandoffStore | null>;
 /** The provider's handoff store, or null outside `AthenaProvider`. */
 export declare function useComposerHandoffStore(): ComposerHandoffStore | null;
+/**
+ * Puts the caret at the end of the composer's draft and leaves the draft as it is; asked before the
+ * editor has mounted, it focuses the editor as it mounts. For a host that shows the chat again and
+ * wants typing to land in it (a launcher window a shortcut brings back).
+ */
+export declare function useFocusComposer(): () => void;
+/** The caret to the end of the draft now, or, with no editor mounted yet, as one mounts. */
+export declare function focusComposer({ store }: {
+    store: ComposerHandoffStore;
+}): void;
 /**
  * Whether a composer write lands now: in thread-list mode the list has
  * resolved which thread is active, and that thread's history has loaded.