@athenaintel/react 0.43.0 → 0.48.0

package/dist/agent-runtime/src/use-deep-agent-window-sync.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const store = require("@assistant-ui/store");
-const react = require("react");
+const require$$0 = require("react");
 const runconfigContract = require("./generated/runconfig-contract.cjs");
 const messageWindow = require("./message-window.cjs");
 const threadExtras = require("./thread-extras.cjs");
@@ -19,12 +19,12 @@ const useStatewireExtras = () => store.useAuiState((s) => {
 });
 function useDeepAgentMessageWindow() {
   const documents = useStatewireExtras().documents;
-  const mounted = react.useSyncExternalStore(
+  const mounted = require$$0.useSyncExternalStore(
     (documents == null ? void 0 : documents.subscribe) ?? noopSubscribe,
     () => documents == null ? void 0 : documents.list(),
     () => documents == null ? void 0 : documents.list()
   );
-  return react.useMemo(() => messageWindow.readDeepAgentMessageWindow(mounted), [mounted]);
+  return require$$0.useMemo(() => messageWindow.readDeepAgentMessageWindow(mounted), [mounted]);
 }
 function pageShowedEarlierMessage(from, messages) {
   if (from.secondId !== void 0) {
@@ -61,33 +61,33 @@ function useDeepAgentWindowSync({
 }) {
   const { sendCommand, invoke, connection } = useStatewireExtras();
   const window = useDeepAgentMessageWindow();
-  const [loading, setLoading] = react.useState(false);
-  const [requests, setRequests] = react.useState(0);
-  const servedRequestsRef = react.useRef(0);
-  const inflightRef = react.useRef(false);
-  const chainRef = react.useRef({ epoch: 0, loads: 0, unseen: 0, requested: false });
-  const openingFillRef = react.useRef(0);
-  const pageFromRef = react.useRef(null);
-  const aliveRef = react.useRef(true);
-  const statedRef = react.useRef(null);
-  const restatedConnectionRef = react.useRef(null);
-  const answeredRef = react.useRef(/* @__PURE__ */ new Map());
-  const toolOutputsInFlightRef = react.useRef(0);
-  const toolOutputsWaitingRef = react.useRef(false);
-  const [toolOutputSettles, setToolOutputSettles] = react.useState(0);
-  const onHistoryLoadRef = react.useRef(onHistoryLoad);
+  const [loading, setLoading] = require$$0.useState(false);
+  const [requests, setRequests] = require$$0.useState(0);
+  const servedRequestsRef = require$$0.useRef(0);
+  const inflightRef = require$$0.useRef(false);
+  const chainRef = require$$0.useRef({ epoch: 0, loads: 0, unseen: 0, requested: false });
+  const openingFillRef = require$$0.useRef(0);
+  const pageFromRef = require$$0.useRef(null);
+  const aliveRef = require$$0.useRef(true);
+  const statedRef = require$$0.useRef(null);
+  const restatedConnectionRef = require$$0.useRef(null);
+  const answeredRef = require$$0.useRef(/* @__PURE__ */ new Map());
+  const toolOutputsInFlightRef = require$$0.useRef(0);
+  const toolOutputsWaitingRef = require$$0.useRef(false);
+  const [toolOutputSettles, setToolOutputSettles] = require$$0.useState(0);
+  const onHistoryLoadRef = require$$0.useRef(onHistoryLoad);
   onHistoryLoadRef.current = onHistoryLoad;
-  const onErrorRef = react.useRef(onError);
+  const onErrorRef = require$$0.useRef(onError);
   onErrorRef.current = onError;
-  const nowRef = react.useRef(now);
+  const nowRef = require$$0.useRef(now);
   nowRef.current = now;
-  react.useEffect(() => {
+  require$$0.useEffect(() => {
     aliveRef.current = true;
     return () => {
       aliveRef.current = false;
     };
   }, []);
-  react.useEffect(() => {
+  require$$0.useEffect(() => {
     if (connection.status !== "connected" || restatedConnectionRef.current === connection) return;
     if (window === null) return;
     restatedConnectionRef.current = connection;
@@ -98,7 +98,7 @@ function useDeepAgentWindowSync({
       (_a = onErrorRef.current) == null ? void 0 : _a.call(onErrorRef, error, "athena/interest");
     });
   }, [connection, invoke, window]);
-  react.useEffect(() => {
+  require$$0.useEffect(() => {
     var _a;
     if (window === null || inflightRef.current) return;
     const from = pageFromRef.current;
@@ -165,7 +165,7 @@ function useDeepAgentWindowSync({
     maxUnseenLoads,
     pageSize
   ]);
-  react.useEffect(() => {
+  require$$0.useEffect(() => {
     var _a;
     if (window === null || toolOutputs === void 0) return;
     toolOutputsWaitingRef.current = false;
@@ -214,10 +214,10 @@ function useDeepAgentWindowSync({
     maxConcurrentToolOutputs,
     toolOutputSettles
   ]);
-  const loadOlder = react.useCallback(() => {
+  const loadOlder = require$$0.useCallback(() => {
     setRequests((count) => count + 1);
   }, []);
-  const canLoadOlder = react.useMemo(
+  const canLoadOlder = require$$0.useMemo(
     () => window !== null && messageWindow.pageInterestRequests(window, pageSize) !== null,
     [window, pageSize]
   );

package/dist/agent-runtime/src/use-deep-agent-window-sync.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-deep-agent-window-sync.cjs","sources":["../../../../agent-runtime/src/use-deep-agent-window-sync.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useAuiState } from '@assistant-ui/store';\nimport { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { DEEP_AGENT_INTEREST_PROTOCOL } from './generated/runconfig-contract';\nimport {\n  buildToolOutputCommand,\n  type DeepAgentInterestRequest,\n  type DeepAgentMessageWindow,\n  interestsCovered,\n  pageInterestRequests,\n  readDeepAgentMessageWindow,\n  readToolOutputResult,\n  readTruncatedToolOutputArtifact,\n} from './message-window';\nimport { hasStatewireThreadExtras } from './thread-extras';\nimport type { DeepAgentToolOutputStore } from './tool-outputs';\n\n/**\n * Pages of older history chained per approach to the top. A renderer lowers\n * its near-top level once prepended content has pushed the first message out\n * of its band; this bounds the case where it cannot (no viewport to scroll,\n * a list too short to overflow) so a 2,000-message thread never streams whole.\n */\nexport const DEEP_AGENT_MAX_CHAINED_HISTORY_LOADS = 3;\n\n/**\n * Pages of older history that add no converted message — every message on\n * them folds into the first loaded turn, such as one agent run's hundreds of\n * tool steps — loaded on top of a request (or an approach's chain) before it\n * stops. Such a page changes nothing the user can see, so it neither answers\n * an ask nor counts against the per-approach chain.\n */\nexport const DEEP_AGENT_MAX_UNSEEN_HISTORY_LOADS = 25;\n\n/** The converted thread messages the tool-output half scans (web and native `ThreadMessage` both satisfy it). */\nexport interface DeepAgentWindowSyncMessage {\n  readonly id: string;\n  /** The converted role; lets the opening fill tell a turn's prompt from its reply. */\n  readonly role?: string;\n  readonly content: readonly { readonly type: string; readonly artifact?: unknown }[];\n}\n\n/** One page interest round trip, for the host's telemetry. */\nexport interface DeepAgentHistoryLoadEvent {\n  /** The page's ordinal (`1` extends the head). */\n  page: number;\n  request: DeepAgentInterestRequest;\n  durationMs: number;\n}\n\nexport interface UseDeepAgentWindowSyncOptions {\n  /**\n   * The converted thread messages — read by the host through its platform\n   * `useAuiState((s) => s.thread.messages)`, so this hook imports neither\n   * `@assistant-ui/react` nor `@assistant-ui/react-native`.\n   */\n  messages: readonly DeepAgentWindowSyncMessage[];\n  /** Messages per page; the thread's window size by default. */\n  pageSize?: number;\n  /**\n   * Full tool outputs fetched back for cut tool messages; the same store the\n   * thread converts with (`useDeepAgentThread({ toolOutputs })`). Omitted, the\n   * tool-output half is inert (a surface that never shows a cut output whole).\n   */\n  toolOutputs?: DeepAgentToolOutputStore | undefined;\n  /**\n   * The renderer's report that the top of the LOADED history is near — a\n   * level, not an edge: while it holds and older messages exist, pages load\n   * one after another (bounded by `maxChainedLoads` per approach). Omitted for\n   * hosts with only a manual affordance (`loadOlder`).\n   */\n  nearTop?: boolean;\n  /** Bumped on every rise of `nearTop` (and every explicit request), so the chain bound is per approach. */\n  nearTopEpoch?: number;\n  /**\n   * Whether a message's content is mounted right now, so lazy fetches (cut\n   * tool outputs) target what the user can see rather than the whole loaded\n   * history. Omitted: every message counts as mounted (the flat renderers).\n   */\n  isMessageMounted?: ((messageId: string) => boolean) | undefined;\n  /**\n   * Cut tool outputs this mount reads at once; the rest wait for one to\n   * settle. One mounted message can hold a whole agent run — a hundred tool\n   * steps — and the host rate-limits a client's frames, so a reader that sends\n   * them all together gets refusals back for most of them. Omitted: every\n   * mounted output is asked for together (renderers whose mounted set is\n   * already small).\n   */\n  maxConcurrentToolOutputs?: number;\n  maxChainedLoads?: number;\n  /** Pages adding no converted message loaded per request before it stops; see {@link DEEP_AGENT_MAX_UNSEEN_HISTORY_LOADS}. */\n  maxUnseenLoads?: number;\n  /** A page interest resolved (telemetry). */\n  onHistoryLoad?: ((event: DeepAgentHistoryLoadEvent) => void) | undefined;\n  /** A read failed; the sync itself recovers (the pending marks are released). */\n  onError?: ((error: unknown, command: 'athena/interest' | 'history/tool_output') => void) | undefined;\n  now?: () => number;\n}\n\nexport interface DeepAgentWindowSyncState {\n  /** The joined window, or `null` while the head interest has not resolved (both halves are inert). */\n  window: DeepAgentMessageWindow | null;\n  /** Whether the host holds messages older than the loaded window. */\n  hasOlder: boolean;\n  /**\n   * Whether the next page can be asked for: older messages exist and the\n   * host's interest cap has room for them. `hasOlder && !canLoadOlder` is the\n   * depth limit (`MAX_INTERESTS × MAX_MESSAGE_WINDOW` messages loaded in one\n   * connection) — an edge row says so instead of offering a dead button.\n   */\n  canLoadOlder: boolean;\n  /** A page of older history is in flight. */\n  loading: boolean;\n  /** Ask for the next page of older history now (an edge row's button, a keypress). A no-op before the head resolved or at the beginning. */\n  loadOlder: () => void;\n}\n\nconst everyMessageMounted = (): boolean => true;\nconst defaultNow = (): number => Date.now();\nconst noopSubscribe = () => () => {};\n\n/** The statewire extras of the nearest aui thread; throws on a non-statewire thread like the library's own hooks. */\nconst useStatewireExtras = (): StatewireThread.Extras =>\n  useAuiState((s) => {\n    if (!hasStatewireThreadExtras(s.thread.extras)) {\n      throw new Error('useDeepAgentWindowSync requires a statewire thread');\n    }\n    return s.thread.extras as StatewireThread.Extras;\n  });\n\n/** The joined interest window of the nearest statewire thread. */\nexport function useDeepAgentMessageWindow(): DeepAgentMessageWindow | null {\n  const documents = useStatewireExtras().documents;\n  const mounted = useSyncExternalStore(\n    documents?.subscribe ?? noopSubscribe,\n    () => documents?.list(),\n    () => documents?.list()\n  );\n  return useMemo(() => readDeepAgentMessageWindow(mounted), [mounted]);\n}\n\n/**\n * The client half of the interest window, shared by every surface — mounted\n * once per runtime, inside its aui provider.\n *\n * - **Older history.** While the host renderer reports the top of the loaded\n *   history near (`nearTop`) and the window says older messages exist, this\n *   re-states the interests with one more page (anchored at the window's\n *   first message) — the host mounts its documents for this client alone —\n *   chaining at most `maxChainedLoads` pages per approach; `loadOlder` asks\n *   for one page on demand (an edge row's button). Never two loads in flight.\n *   A reconnect whose hello does not carry the interests this mount last\n *   stated (the host remembers a client id's view across its attaches; a new\n *   host instance does not) re-states them.\n * - **Cut tool outputs.** Tool cards whose output the wire carried cut\n *   (`artifact._athena_content_truncated`) get it fetched whole through\n *   `history/tool_output` once their message is mounted, at most\n *   `maxConcurrentToolOutputs` at a time; the converter puts it back\n *   (`toolOutputs`), so the card re-renders complete. An output the host\n *   replaced since (the marker's `chars` changed) is fetched again.\n */\n/**\n * Whether an older page put a new converted message ahead of the thread's\n * first one. Older history only ever merges into or lands before the first\n * converted message, so the second one is a stable landmark: it moved down iff\n * the page showed something. A new tail message does not move it. Without a\n * second message (or once it is gone) the converted count decides.\n */\nfunction pageShowedEarlierMessage(\n  from: { count: number; secondId: string | undefined },\n  messages: readonly DeepAgentWindowSyncMessage[]\n): boolean {\n  if (from.secondId !== undefined) {\n    const index = messages.findIndex((message) => message.id === from.secondId);\n    if (index !== -1) return index > 1;\n  }\n  return messages.length > from.count;\n}\n\n/**\n * Whether the loaded thread still opens without context: it should open on a\n * prompt and hold at least one earlier turn, so the newest turn shows with the\n * one before it (a turn is a prompt followed by its reply). Queued and live\n * prompts land at the tail with no reply yet, so they never count; prompts\n * alone need nothing. Without roles, a lone converted message stands in for it.\n */\nfunction opensMidTurn(messages: readonly DeepAgentWindowSyncMessage[]): boolean {\n  const first = messages[0];\n  if (first === undefined) return false;\n  if (messages.every((message) => message.role === undefined)) return messages.length < 2;\n  if (first.role !== 'user') return true;\n  if (messages.every((message) => message.role === 'user')) return false;\n  let turns = 0;\n  for (let index = 1; index < messages.length; index += 1) {\n    if (messages[index - 1]!.role === 'user' && messages[index]!.role !== 'user') turns += 1;\n  }\n  return turns < 2;\n}\n\nexport function useDeepAgentWindowSync({\n  messages,\n  pageSize,\n  toolOutputs,\n  nearTop = false,\n  nearTopEpoch = 0,\n  isMessageMounted = everyMessageMounted,\n  maxConcurrentToolOutputs = Number.POSITIVE_INFINITY,\n  maxChainedLoads = DEEP_AGENT_MAX_CHAINED_HISTORY_LOADS,\n  maxUnseenLoads = DEEP_AGENT_MAX_UNSEEN_HISTORY_LOADS,\n  onHistoryLoad,\n  onError,\n  now = defaultNow,\n}: UseDeepAgentWindowSyncOptions): DeepAgentWindowSyncState {\n  const { sendCommand, invoke, connection } = useStatewireExtras();\n  const window = useDeepAgentMessageWindow();\n  const [loading, setLoading] = useState(false);\n  const [requests, setRequests] = useState(0);\n  const servedRequestsRef = useRef(0);\n  const inflightRef = useRef(false);\n  const chainRef = useRef({ epoch: 0, loads: 0, unseen: 0, requested: false });\n  // Pages loaded to show the opening turn's prompt; `null` once it shows, the\n  // user took over, or a page failed — never re-armed for this mount.\n  const openingFillRef = useRef<number | null>(0);\n  // The converted thread when the in-flight page was stated; `null` once its\n  // settle was judged (or it failed).\n  const pageFromRef = useRef<{ count: number; secondId: string | undefined } | null>(null);\n  const aliveRef = useRef(true);\n  // The interests this mount last stated, re-stated on the next connected\n  // session (a hello resets the documents) so a reconnect keeps the loaded history.\n  const statedRef = useRef<DeepAgentInterestRequest[] | null>(null);\n  const restatedConnectionRef = useRef<unknown>(null);\n  // Outputs already asked for and answered by this mount — fetched, refused,\n  // or failed — by the `chars` they were asked for. The converter re-runs on\n  // every wire change, and the store is a bounded LRU: without this memory a\n  // refused read would leave on every pass, and once a transcript holds more\n  // cut outputs than the store retains, each fetch would evict a still-loaded\n  // output and the next pass would fetch it again, forever. An evicted output\n  // renders its cut text (the REST display limit) rather than re-entering the\n  // loop; a marker whose `chars` moved (the host replaced the output) is asked\n  // for again.\n  const answeredRef = useRef(new Map<string, number>());\n  // Reads this mount has in flight, and whether a pass left outputs waiting\n  // for one to settle (`maxConcurrentToolOutputs`): only then does a settle\n  // re-run the pass, so an unbounded mount renders no more than before.\n  const toolOutputsInFlightRef = useRef(0);\n  const toolOutputsWaitingRef = useRef(false);\n  const [toolOutputSettles, setToolOutputSettles] = useState(0);\n  const onHistoryLoadRef = useRef(onHistoryLoad);\n  onHistoryLoadRef.current = onHistoryLoad;\n  const onErrorRef = useRef(onError);\n  onErrorRef.current = onError;\n  const nowRef = useRef(now);\n  nowRef.current = now;\n  useEffect(() => {\n    aliveRef.current = true;\n    return () => {\n      aliveRef.current = false;\n    };\n  }, []);\n\n  useEffect(() => {\n    if (connection.status !== 'connected' || restatedConnectionRef.current === connection) return;\n    // Decided once per connected session, on the hello's interest document.\n    if (window === null) return;\n    restatedConnectionRef.current = connection;\n    const stated = statedRef.current;\n    if (stated === null || interestsCovered(window.requests, stated)) return;\n    invoke(DEEP_AGENT_INTEREST_PROTOCOL, 'set', [stated]).catch((error: unknown) => {\n      onErrorRef.current?.(error, 'athena/interest');\n    });\n  }, [connection, invoke, window]);\n\n  useEffect(() => {\n    if (window === null || inflightRef.current) return;\n    const from = pageFromRef.current;\n    pageFromRef.current = null;\n    const lastPageUnseen =\n      from !== null && from.count > 0 && !pageShowedEarlierMessage(from, messages);\n    const pageRequests = pageInterestRequests(window, pageSize);\n    if (pageRequests === null) return;\n    const requested = requests !== servedRequestsRef.current;\n    const chain = chainRef.current;\n    let fillPage = false;\n    if (\n      openingFillRef.current !== null &&\n      (requested || nearTop || (messages.length > 0 && !opensMidTurn(messages)))\n    ) {\n      openingFillRef.current = null;\n    }\n    if (requested) {\n      // An explicit ask re-arms the chain for this approach.\n      servedRequestsRef.current = requests;\n      chainRef.current = { epoch: nearTopEpoch, loads: 1, unseen: 0, requested: true };\n    } else if (lastPageUnseen && (chain.requested || (nearTop && chain.epoch === nearTopEpoch))) {\n      // The page landed inside the first loaded turn: keep going until one shows.\n      if (chain.unseen >= maxUnseenLoads) return;\n      chain.unseen += 1;\n    } else if (openingFillRef.current !== null && opensMidTurn(messages)) {\n      if (openingFillRef.current >= maxUnseenLoads) return;\n      openingFillRef.current += 1;\n      fillPage = true;\n    } else {\n      if (!nearTop) return;\n      if (chain.epoch !== nearTopEpoch) {\n        chainRef.current = { epoch: nearTopEpoch, loads: 0, unseen: 0, requested: false };\n      }\n      if (chainRef.current.loads >= maxChainedLoads) return;\n      chainRef.current.loads += 1;\n    }\n    pageFromRef.current = { count: messages.length, secondId: messages[1]?.id };\n    const page = window.pages + 1;\n    const request = pageRequests[pageRequests.length - 1] as DeepAgentInterestRequest;\n    inflightRef.current = true;\n    setLoading(true);\n    const startedAt = nowRef.current();\n    invoke(DEEP_AGENT_INTEREST_PROTOCOL, 'set', [pageRequests])\n      .then(() => {\n        statedRef.current = pageRequests;\n        onHistoryLoadRef.current?.({\n          page,\n          request,\n          durationMs: Math.max(0, Math.round(nowRef.current() - startedAt)),\n        });\n      })\n      .catch((error: unknown) => {\n        pageFromRef.current = null;\n        if (fillPage) openingFillRef.current = null;\n        onErrorRef.current?.(error, 'athena/interest');\n      })\n      .finally(() => {\n        inflightRef.current = false;\n        if (aliveRef.current) setLoading(false);\n      });\n    // `loading` re-arms the chain once a page settled after its documents moved the window.\n  }, [\n    nearTop,\n    nearTopEpoch,\n    requests,\n    window,\n    loading,\n    messages,\n    invoke,\n    maxChainedLoads,\n    maxUnseenLoads,\n    pageSize,\n  ]);\n\n  useEffect(() => {\n    if (window === null || toolOutputs === undefined) return;\n    toolOutputsWaitingRef.current = false;\n    for (const message of messages) {\n      if (!isMessageMounted(message.id)) continue;\n      for (const part of message.content) {\n        if (part.type !== 'tool-call') continue;\n        const marker = readTruncatedToolOutputArtifact(part.artifact);\n        if (marker === null || toolOutputs.isPending(marker.messageId)) continue;\n        // Fetched for this very length already; a different length means the\n        // host replaced the output under the same id since.\n        if (toolOutputs.entry(marker.messageId)?.chars === marker.chars) continue;\n        if (answeredRef.current.get(marker.messageId) === marker.chars) continue;\n        if (toolOutputsInFlightRef.current >= maxConcurrentToolOutputs) {\n          toolOutputsWaitingRef.current = true;\n          return;\n        }\n        const { messageId, chars } = marker;\n        toolOutputsInFlightRef.current += 1;\n        toolOutputs.markPending(messageId);\n        Promise.resolve(sendCommand(buildToolOutputCommand({ messageId })))\n          .then((payload) => {\n            answeredRef.current.set(messageId, chars);\n            const result = readToolOutputResult(payload);\n            if (result === null) {\n              toolOutputs.clearPending(messageId);\n              return;\n            }\n            toolOutputs.set(result.messageId, { content: result.content, chars });\n          })\n          .catch((error: unknown) => {\n            answeredRef.current.set(messageId, chars);\n            toolOutputs.clearPending(messageId);\n            onErrorRef.current?.(error, 'history/tool_output');\n          })\n          .finally(() => {\n            toolOutputsInFlightRef.current -= 1;\n            if (toolOutputsWaitingRef.current && aliveRef.current) {\n              setToolOutputSettles((count) => count + 1);\n            }\n          });\n      }\n    }\n  }, [\n    messages,\n    isMessageMounted,\n    window,\n    sendCommand,\n    toolOutputs,\n    maxConcurrentToolOutputs,\n    toolOutputSettles,\n  ]);\n\n  const loadOlder = useCallback(() => {\n    setRequests((count) => count + 1);\n  }, []);\n\n  const canLoadOlder = useMemo(\n    () => window !== null && pageInterestRequests(window, pageSize) !== null,\n    [window, pageSize]\n  );\n\n  return { window, hasOlder: window?.hasOlder ?? false, canLoadOlder, loading, loadOlder };\n}\n"],"names":["useAuiState","hasStatewireThreadExtras","useSyncExternalStore","useMemo","readDeepAgentMessageWindow","useState","useRef","useEffect","interestsCovered","DEEP_AGENT_INTEREST_PROTOCOL","pageInterestRequests","_a","readTruncatedToolOutputArtifact","buildToolOutputCommand","readToolOutputResult","useCallback"],"mappings":"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"}
+{"version":3,"file":"use-deep-agent-window-sync.cjs","sources":["../../../../agent-runtime/src/use-deep-agent-window-sync.ts"],"sourcesContent":["import type { StatewireThread } from '@assistant-ui/react-statewire';\nimport { useAuiState } from '@assistant-ui/store';\nimport { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { DEEP_AGENT_INTEREST_PROTOCOL } from './generated/runconfig-contract';\nimport {\n  buildToolOutputCommand,\n  type DeepAgentInterestRequest,\n  type DeepAgentMessageWindow,\n  interestsCovered,\n  pageInterestRequests,\n  readDeepAgentMessageWindow,\n  readToolOutputResult,\n  readTruncatedToolOutputArtifact,\n} from './message-window';\nimport { hasStatewireThreadExtras } from './thread-extras';\nimport type { DeepAgentToolOutputStore } from './tool-outputs';\n\n/**\n * Pages of older history chained per approach to the top. A renderer lowers\n * its near-top level once prepended content has pushed the first message out\n * of its band; this bounds the case where it cannot (no viewport to scroll,\n * a list too short to overflow) so a 2,000-message thread never streams whole.\n */\nexport const DEEP_AGENT_MAX_CHAINED_HISTORY_LOADS = 3;\n\n/**\n * Pages of older history that add no converted message — every message on\n * them folds into the first loaded turn, such as one agent run's hundreds of\n * tool steps — loaded on top of a request (or an approach's chain) before it\n * stops. Such a page changes nothing the user can see, so it neither answers\n * an ask nor counts against the per-approach chain.\n */\nexport const DEEP_AGENT_MAX_UNSEEN_HISTORY_LOADS = 25;\n\n/** The converted thread messages the tool-output half scans (web and native `ThreadMessage` both satisfy it). */\nexport interface DeepAgentWindowSyncMessage {\n  readonly id: string;\n  /** The converted role; lets the opening fill tell a turn's prompt from its reply. */\n  readonly role?: string;\n  readonly content: readonly { readonly type: string; readonly artifact?: unknown }[];\n}\n\n/** One page interest round trip, for the host's telemetry. */\nexport interface DeepAgentHistoryLoadEvent {\n  /** The page's ordinal (`1` extends the head). */\n  page: number;\n  request: DeepAgentInterestRequest;\n  durationMs: number;\n}\n\nexport interface UseDeepAgentWindowSyncOptions {\n  /**\n   * The converted thread messages — read by the host through its platform\n   * `useAuiState((s) => s.thread.messages)`, so this hook imports neither\n   * `@assistant-ui/react` nor `@assistant-ui/react-native`.\n   */\n  messages: readonly DeepAgentWindowSyncMessage[];\n  /** Messages per page; the thread's window size by default. */\n  pageSize?: number;\n  /**\n   * Full tool outputs fetched back for cut tool messages; the same store the\n   * thread converts with (`useDeepAgentThread({ toolOutputs })`). Omitted, the\n   * tool-output half is inert (a surface that never shows a cut output whole).\n   */\n  toolOutputs?: DeepAgentToolOutputStore | undefined;\n  /**\n   * The renderer's report that the top of the LOADED history is near — a\n   * level, not an edge: while it holds and older messages exist, pages load\n   * one after another (bounded by `maxChainedLoads` per approach). Omitted for\n   * hosts with only a manual affordance (`loadOlder`).\n   */\n  nearTop?: boolean;\n  /** Bumped on every rise of `nearTop` (and every explicit request), so the chain bound is per approach. */\n  nearTopEpoch?: number;\n  /**\n   * Whether a message's content is mounted right now, so lazy fetches (cut\n   * tool outputs) target what the user can see rather than the whole loaded\n   * history. Omitted: every message counts as mounted (the flat renderers).\n   */\n  isMessageMounted?: ((messageId: string) => boolean) | undefined;\n  /**\n   * Cut tool outputs this mount reads at once; the rest wait for one to\n   * settle. One mounted message can hold a whole agent run — a hundred tool\n   * steps — and the host rate-limits a client's frames, so a reader that sends\n   * them all together gets refusals back for most of them. Omitted: every\n   * mounted output is asked for together (renderers whose mounted set is\n   * already small).\n   */\n  maxConcurrentToolOutputs?: number;\n  maxChainedLoads?: number;\n  /** Pages adding no converted message loaded per request before it stops; see {@link DEEP_AGENT_MAX_UNSEEN_HISTORY_LOADS}. */\n  maxUnseenLoads?: number;\n  /** A page interest resolved (telemetry). */\n  onHistoryLoad?: ((event: DeepAgentHistoryLoadEvent) => void) | undefined;\n  /** A read failed; the sync itself recovers (the pending marks are released). */\n  onError?: ((error: unknown, command: 'athena/interest' | 'history/tool_output') => void) | undefined;\n  now?: () => number;\n}\n\nexport interface DeepAgentWindowSyncState {\n  /** The joined window, or `null` while the head interest has not resolved (both halves are inert). */\n  window: DeepAgentMessageWindow | null;\n  /** Whether the host holds messages older than the loaded window. */\n  hasOlder: boolean;\n  /**\n   * Whether the next page can be asked for: older messages exist and the\n   * host's interest cap has room for them. `hasOlder && !canLoadOlder` is the\n   * depth limit (`MAX_INTERESTS × MAX_MESSAGE_WINDOW` messages loaded in one\n   * connection) — an edge row says so instead of offering a dead button.\n   */\n  canLoadOlder: boolean;\n  /** A page of older history is in flight. */\n  loading: boolean;\n  /** Ask for the next page of older history now (an edge row's button, a keypress). A no-op before the head resolved or at the beginning. */\n  loadOlder: () => void;\n}\n\nconst everyMessageMounted = (): boolean => true;\nconst defaultNow = (): number => Date.now();\nconst noopSubscribe = () => () => {};\n\n/** The statewire extras of the nearest aui thread; throws on a non-statewire thread like the library's own hooks. */\nconst useStatewireExtras = (): StatewireThread.Extras =>\n  useAuiState((s) => {\n    if (!hasStatewireThreadExtras(s.thread.extras)) {\n      throw new Error('useDeepAgentWindowSync requires a statewire thread');\n    }\n    return s.thread.extras as StatewireThread.Extras;\n  });\n\n/** The joined interest window of the nearest statewire thread. */\nexport function useDeepAgentMessageWindow(): DeepAgentMessageWindow | null {\n  const documents = useStatewireExtras().documents;\n  const mounted = useSyncExternalStore(\n    documents?.subscribe ?? noopSubscribe,\n    () => documents?.list(),\n    () => documents?.list()\n  );\n  return useMemo(() => readDeepAgentMessageWindow(mounted), [mounted]);\n}\n\n/**\n * The client half of the interest window, shared by every surface — mounted\n * once per runtime, inside its aui provider.\n *\n * - **Older history.** While the host renderer reports the top of the loaded\n *   history near (`nearTop`) and the window says older messages exist, this\n *   re-states the interests with one more page (anchored at the window's\n *   first message) — the host mounts its documents for this client alone —\n *   chaining at most `maxChainedLoads` pages per approach; `loadOlder` asks\n *   for one page on demand (an edge row's button). Never two loads in flight.\n *   A reconnect whose hello does not carry the interests this mount last\n *   stated (the host remembers a client id's view across its attaches; a new\n *   host instance does not) re-states them.\n * - **Cut tool outputs.** Tool cards whose output the wire carried cut\n *   (`artifact._athena_content_truncated`) get it fetched whole through\n *   `history/tool_output` once their message is mounted, at most\n *   `maxConcurrentToolOutputs` at a time; the converter puts it back\n *   (`toolOutputs`), so the card re-renders complete. An output the host\n *   replaced since (the marker's `chars` changed) is fetched again.\n */\n/**\n * Whether an older page put a new converted message ahead of the thread's\n * first one. Older history only ever merges into or lands before the first\n * converted message, so the second one is a stable landmark: it moved down iff\n * the page showed something. A new tail message does not move it. Without a\n * second message (or once it is gone) the converted count decides.\n */\nfunction pageShowedEarlierMessage(\n  from: { count: number; secondId: string | undefined },\n  messages: readonly DeepAgentWindowSyncMessage[]\n): boolean {\n  if (from.secondId !== undefined) {\n    const index = messages.findIndex((message) => message.id === from.secondId);\n    if (index !== -1) return index > 1;\n  }\n  return messages.length > from.count;\n}\n\n/**\n * Whether the loaded thread still opens without context: it should open on a\n * prompt and hold at least one earlier turn, so the newest turn shows with the\n * one before it (a turn is a prompt followed by its reply). Queued and live\n * prompts land at the tail with no reply yet, so they never count; prompts\n * alone need nothing. Without roles, a lone converted message stands in for it.\n */\nfunction opensMidTurn(messages: readonly DeepAgentWindowSyncMessage[]): boolean {\n  const first = messages[0];\n  if (first === undefined) return false;\n  if (messages.every((message) => message.role === undefined)) return messages.length < 2;\n  if (first.role !== 'user') return true;\n  if (messages.every((message) => message.role === 'user')) return false;\n  let turns = 0;\n  for (let index = 1; index < messages.length; index += 1) {\n    if (messages[index - 1]!.role === 'user' && messages[index]!.role !== 'user') turns += 1;\n  }\n  return turns < 2;\n}\n\nexport function useDeepAgentWindowSync({\n  messages,\n  pageSize,\n  toolOutputs,\n  nearTop = false,\n  nearTopEpoch = 0,\n  isMessageMounted = everyMessageMounted,\n  maxConcurrentToolOutputs = Number.POSITIVE_INFINITY,\n  maxChainedLoads = DEEP_AGENT_MAX_CHAINED_HISTORY_LOADS,\n  maxUnseenLoads = DEEP_AGENT_MAX_UNSEEN_HISTORY_LOADS,\n  onHistoryLoad,\n  onError,\n  now = defaultNow,\n}: UseDeepAgentWindowSyncOptions): DeepAgentWindowSyncState {\n  const { sendCommand, invoke, connection } = useStatewireExtras();\n  const window = useDeepAgentMessageWindow();\n  const [loading, setLoading] = useState(false);\n  const [requests, setRequests] = useState(0);\n  const servedRequestsRef = useRef(0);\n  const inflightRef = useRef(false);\n  const chainRef = useRef({ epoch: 0, loads: 0, unseen: 0, requested: false });\n  // Pages loaded to show the opening turn's prompt; `null` once it shows, the\n  // user took over, or a page failed — never re-armed for this mount.\n  const openingFillRef = useRef<number | null>(0);\n  // The converted thread when the in-flight page was stated; `null` once its\n  // settle was judged (or it failed).\n  const pageFromRef = useRef<{ count: number; secondId: string | undefined } | null>(null);\n  const aliveRef = useRef(true);\n  // The interests this mount last stated, re-stated on the next connected\n  // session (a hello resets the documents) so a reconnect keeps the loaded history.\n  const statedRef = useRef<DeepAgentInterestRequest[] | null>(null);\n  const restatedConnectionRef = useRef<unknown>(null);\n  // Outputs already asked for and answered by this mount — fetched, refused,\n  // or failed — by the `chars` they were asked for. The converter re-runs on\n  // every wire change, and the store is a bounded LRU: without this memory a\n  // refused read would leave on every pass, and once a transcript holds more\n  // cut outputs than the store retains, each fetch would evict a still-loaded\n  // output and the next pass would fetch it again, forever. An evicted output\n  // renders its cut text (the REST display limit) rather than re-entering the\n  // loop; a marker whose `chars` moved (the host replaced the output) is asked\n  // for again.\n  const answeredRef = useRef(new Map<string, number>());\n  // Reads this mount has in flight, and whether a pass left outputs waiting\n  // for one to settle (`maxConcurrentToolOutputs`): only then does a settle\n  // re-run the pass, so an unbounded mount renders no more than before.\n  const toolOutputsInFlightRef = useRef(0);\n  const toolOutputsWaitingRef = useRef(false);\n  const [toolOutputSettles, setToolOutputSettles] = useState(0);\n  const onHistoryLoadRef = useRef(onHistoryLoad);\n  onHistoryLoadRef.current = onHistoryLoad;\n  const onErrorRef = useRef(onError);\n  onErrorRef.current = onError;\n  const nowRef = useRef(now);\n  nowRef.current = now;\n  useEffect(() => {\n    aliveRef.current = true;\n    return () => {\n      aliveRef.current = false;\n    };\n  }, []);\n\n  useEffect(() => {\n    if (connection.status !== 'connected' || restatedConnectionRef.current === connection) return;\n    // Decided once per connected session, on the hello's interest document.\n    if (window === null) return;\n    restatedConnectionRef.current = connection;\n    const stated = statedRef.current;\n    if (stated === null || interestsCovered(window.requests, stated)) return;\n    invoke(DEEP_AGENT_INTEREST_PROTOCOL, 'set', [stated]).catch((error: unknown) => {\n      onErrorRef.current?.(error, 'athena/interest');\n    });\n  }, [connection, invoke, window]);\n\n  useEffect(() => {\n    if (window === null || inflightRef.current) return;\n    const from = pageFromRef.current;\n    pageFromRef.current = null;\n    const lastPageUnseen =\n      from !== null && from.count > 0 && !pageShowedEarlierMessage(from, messages);\n    const pageRequests = pageInterestRequests(window, pageSize);\n    if (pageRequests === null) return;\n    const requested = requests !== servedRequestsRef.current;\n    const chain = chainRef.current;\n    let fillPage = false;\n    if (\n      openingFillRef.current !== null &&\n      (requested || nearTop || (messages.length > 0 && !opensMidTurn(messages)))\n    ) {\n      openingFillRef.current = null;\n    }\n    if (requested) {\n      // An explicit ask re-arms the chain for this approach.\n      servedRequestsRef.current = requests;\n      chainRef.current = { epoch: nearTopEpoch, loads: 1, unseen: 0, requested: true };\n    } else if (lastPageUnseen && (chain.requested || (nearTop && chain.epoch === nearTopEpoch))) {\n      // The page landed inside the first loaded turn: keep going until one shows.\n      if (chain.unseen >= maxUnseenLoads) return;\n      chain.unseen += 1;\n    } else if (openingFillRef.current !== null && opensMidTurn(messages)) {\n      if (openingFillRef.current >= maxUnseenLoads) return;\n      openingFillRef.current += 1;\n      fillPage = true;\n    } else {\n      if (!nearTop) return;\n      if (chain.epoch !== nearTopEpoch) {\n        chainRef.current = { epoch: nearTopEpoch, loads: 0, unseen: 0, requested: false };\n      }\n      if (chainRef.current.loads >= maxChainedLoads) return;\n      chainRef.current.loads += 1;\n    }\n    pageFromRef.current = { count: messages.length, secondId: messages[1]?.id };\n    const page = window.pages + 1;\n    const request = pageRequests[pageRequests.length - 1] as DeepAgentInterestRequest;\n    inflightRef.current = true;\n    setLoading(true);\n    const startedAt = nowRef.current();\n    invoke(DEEP_AGENT_INTEREST_PROTOCOL, 'set', [pageRequests])\n      .then(() => {\n        statedRef.current = pageRequests;\n        onHistoryLoadRef.current?.({\n          page,\n          request,\n          durationMs: Math.max(0, Math.round(nowRef.current() - startedAt)),\n        });\n      })\n      .catch((error: unknown) => {\n        pageFromRef.current = null;\n        if (fillPage) openingFillRef.current = null;\n        onErrorRef.current?.(error, 'athena/interest');\n      })\n      .finally(() => {\n        inflightRef.current = false;\n        if (aliveRef.current) setLoading(false);\n      });\n    // `loading` re-arms the chain once a page settled after its documents moved the window.\n  }, [\n    nearTop,\n    nearTopEpoch,\n    requests,\n    window,\n    loading,\n    messages,\n    invoke,\n    maxChainedLoads,\n    maxUnseenLoads,\n    pageSize,\n  ]);\n\n  useEffect(() => {\n    if (window === null || toolOutputs === undefined) return;\n    toolOutputsWaitingRef.current = false;\n    for (const message of messages) {\n      if (!isMessageMounted(message.id)) continue;\n      for (const part of message.content) {\n        if (part.type !== 'tool-call') continue;\n        const marker = readTruncatedToolOutputArtifact(part.artifact);\n        if (marker === null || toolOutputs.isPending(marker.messageId)) continue;\n        // Fetched for this very length already; a different length means the\n        // host replaced the output under the same id since.\n        if (toolOutputs.entry(marker.messageId)?.chars === marker.chars) continue;\n        if (answeredRef.current.get(marker.messageId) === marker.chars) continue;\n        if (toolOutputsInFlightRef.current >= maxConcurrentToolOutputs) {\n          toolOutputsWaitingRef.current = true;\n          return;\n        }\n        const { messageId, chars } = marker;\n        toolOutputsInFlightRef.current += 1;\n        toolOutputs.markPending(messageId);\n        Promise.resolve(sendCommand(buildToolOutputCommand({ messageId })))\n          .then((payload) => {\n            answeredRef.current.set(messageId, chars);\n            const result = readToolOutputResult(payload);\n            if (result === null) {\n              toolOutputs.clearPending(messageId);\n              return;\n            }\n            toolOutputs.set(result.messageId, { content: result.content, chars });\n          })\n          .catch((error: unknown) => {\n            answeredRef.current.set(messageId, chars);\n            toolOutputs.clearPending(messageId);\n            onErrorRef.current?.(error, 'history/tool_output');\n          })\n          .finally(() => {\n            toolOutputsInFlightRef.current -= 1;\n            if (toolOutputsWaitingRef.current && aliveRef.current) {\n              setToolOutputSettles((count) => count + 1);\n            }\n          });\n      }\n    }\n  }, [\n    messages,\n    isMessageMounted,\n    window,\n    sendCommand,\n    toolOutputs,\n    maxConcurrentToolOutputs,\n    toolOutputSettles,\n  ]);\n\n  const loadOlder = useCallback(() => {\n    setRequests((count) => count + 1);\n  }, []);\n\n  const canLoadOlder = useMemo(\n    () => window !== null && pageInterestRequests(window, pageSize) !== null,\n    [window, pageSize]\n  );\n\n  return { window, hasOlder: window?.hasOlder ?? false, canLoadOlder, loading, loadOlder };\n}\n"],"names":["useAuiState","hasStatewireThreadExtras","useSyncExternalStore","useMemo","readDeepAgentMessageWindow","useState","useRef","useEffect","interestsCovered","DEEP_AGENT_INTEREST_PROTOCOL","pageInterestRequests","_a","readTruncatedToolOutputArtifact","buildToolOutputCommand","readToolOutputResult","useCallback"],"mappings":"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"}

package/dist/agent-runtime/src/use-historical-edit-attachments.cjs

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const store = require("@assistant-ui/store");
-const react = require("react");
+const require$$0 = require("react");
 function useHistoricalEditAttachments() {
   const aui = store.useAui();
   const isEditing = store.useAuiState((state) => state.message.composer.isEditing);
-  const restoredMessage = react.useRef(null);
-  const [restoreError, setRestoreError] = react.useState();
-  react.useEffect(() => {
+  const restoredMessage = require$$0.useRef(null);
+  const [restoreError, setRestoreError] = require$$0.useState();
+  require$$0.useEffect(() => {
     if (!isEditing) {
       restoredMessage.current = null;
       return;

package/dist/agent-runtime/src/use-historical-edit-attachments.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-historical-edit-attachments.cjs","sources":["../../../../agent-runtime/src/use-historical-edit-attachments.ts"],"sourcesContent":["import type { ThreadUserMessagePart } from \"@assistant-ui/core\";\nimport { useAui, useAuiState } from \"@assistant-ui/store\";\nimport { useEffect, useRef, useState } from \"react\";\n\n/** Restore once per edit so published SDKs work with unpatched upstream AUI. */\nexport function useHistoricalEditAttachments(): void {\n\tconst aui = useAui();\n\tconst isEditing = useAuiState((state) => state.message.composer.isEditing);\n\tconst restoredMessage = useRef<string | null>(null);\n\tconst [restoreError, setRestoreError] = useState<Error>();\n\tuseEffect(() => {\n\t\tif (!isEditing) {\n\t\t\trestoredMessage.current = null;\n\t\t\treturn;\n\t\t}\n\t\tconst message = aui.message().getState();\n\t\tif (message.role !== \"user\" || restoredMessage.current === message.id)\n\t\t\treturn;\n\t\trestoredMessage.current = message.id;\n\t\tconst composer = aui.message().composer();\n\t\t// Match occurrences, preserving repeated images without duplicating parts\n\t\t// already lifted by the monorepo's patched core. Removing one afterward\n\t\t// must remain a deliberate removal throughout this edit session.\n\t\tconst existing = composer\n\t\t\t.getState()\n\t\t\t.attachments.flatMap((attachment) => attachment.content ?? []);\n\t\tfor (const part of message.content) {\n\t\t\tif (part.type !== \"image\" && part.type !== \"file\") continue;\n\t\t\tconst index = existing.findIndex((candidate) =>\n\t\t\t\tsamePart(candidate, part),\n\t\t\t);\n\t\t\tif (index >= 0) {\n\t\t\t\texisting.splice(index, 1);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tvoid composer\n\t\t\t\t.addAttachment({\n\t\t\t\t\tname: part.filename ?? (part.type === \"image\" ? \"image\" : \"document\"),\n\t\t\t\t\ttype: part.type === \"image\" ? \"image\" : \"document\",\n\t\t\t\t\tcontentType: part.type === \"image\" ? \"image/*\" : part.mimeType,\n\t\t\t\t\tcontent: [part],\n\t\t\t\t})\n\t\t\t\t.catch((error: unknown) => {\n\t\t\t\t\tsetRestoreError(\n\t\t\t\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t\t\t\t);\n\t\t\t\t});\n\t\t}\n\t}, [aui, isEditing]);\n\tif (restoreError) throw restoreError;\n}\n\nfunction samePart(\n\tleft: ThreadUserMessagePart,\n\tright: ThreadUserMessagePart,\n): boolean {\n\tif (left.type === \"image\" && right.type === \"image\")\n\t\treturn left.image === right.image;\n\tif (left.type === \"file\" && right.type === \"file\")\n\t\treturn (\n\t\t\tleft.data === right.data &&\n\t\t\tleft.mimeType === right.mimeType &&\n\t\t\tleft.filename === right.filename\n\t\t);\n\treturn false;\n}\n"],"names":["useAui","useAuiState","useRef","useState","useEffect"],"mappings":";;;;AAKO,SAAS,+BAAqC;AACpD,QAAM,MAAMA,MAAAA,OAAA;AACZ,QAAM,YAAYC,MAAAA,YAAY,CAAC,UAAU,MAAM,QAAQ,SAAS,SAAS;AACzE,QAAM,kBAAkBC,MAAAA,OAAsB,IAAI;AAClD,QAAM,CAAC,cAAc,eAAe,IAAIC,eAAA;AACxCC,QAAAA,UAAU,MAAM;AACf,QAAI,CAAC,WAAW;AACf,sBAAgB,UAAU;AAC1B;AAAA,IACD;AACA,UAAM,UAAU,IAAI,QAAA,EAAU,SAAA;AAC9B,QAAI,QAAQ,SAAS,UAAU,gBAAgB,YAAY,QAAQ;AAClE;AACD,oBAAgB,UAAU,QAAQ;AAClC,UAAM,WAAW,IAAI,QAAA,EAAU,SAAA;AAI/B,UAAM,WAAW,SACf,SAAA,EACA,YAAY,QAAQ,CAAC,eAAe,WAAW,WAAW,EAAE;AAC9D,eAAW,QAAQ,QAAQ,SAAS;AACnC,UAAI,KAAK,SAAS,WAAW,KAAK,SAAS,OAAQ;AACnD,YAAM,QAAQ,SAAS;AAAA,QAAU,CAAC,cACjC,SAAS,WAAW,IAAI;AAAA,MAAA;AAEzB,UAAI,SAAS,GAAG;AACf,iBAAS,OAAO,OAAO,CAAC;AACxB;AAAA,MACD;AACA,WAAK,SACH,cAAc;AAAA,QACd,MAAM,KAAK,aAAa,KAAK,SAAS,UAAU,UAAU;AAAA,QAC1D,MAAM,KAAK,SAAS,UAAU,UAAU;AAAA,QACxC,aAAa,KAAK,SAAS,UAAU,YAAY,KAAK;AAAA,QACtD,SAAS,CAAC,IAAI;AAAA,MAAA,CACd,EACA,MAAM,CAAC,UAAmB;AAC1B;AAAA,UACC,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,QAAA;AAAA,MAE1D,CAAC;AAAA,IACH;AAAA,EACD,GAAG,CAAC,KAAK,SAAS,CAAC;AACnB,MAAI,aAAc,OAAM;AACzB;AAEA,SAAS,SACR,MACA,OACU;AACV,MAAI,KAAK,SAAS,WAAW,MAAM,SAAS;AAC3C,WAAO,KAAK,UAAU,MAAM;AAC7B,MAAI,KAAK,SAAS,UAAU,MAAM,SAAS;AAC1C,WACC,KAAK,SAAS,MAAM,QACpB,KAAK,aAAa,MAAM,YACxB,KAAK,aAAa,MAAM;AAE1B,SAAO;AACR;;"}
+{"version":3,"file":"use-historical-edit-attachments.cjs","sources":["../../../../agent-runtime/src/use-historical-edit-attachments.ts"],"sourcesContent":["import type { ThreadUserMessagePart } from \"@assistant-ui/core\";\nimport { useAui, useAuiState } from \"@assistant-ui/store\";\nimport { useEffect, useRef, useState } from \"react\";\n\n/** Restore once per edit so published SDKs work with unpatched upstream AUI. */\nexport function useHistoricalEditAttachments(): void {\n\tconst aui = useAui();\n\tconst isEditing = useAuiState((state) => state.message.composer.isEditing);\n\tconst restoredMessage = useRef<string | null>(null);\n\tconst [restoreError, setRestoreError] = useState<Error>();\n\tuseEffect(() => {\n\t\tif (!isEditing) {\n\t\t\trestoredMessage.current = null;\n\t\t\treturn;\n\t\t}\n\t\tconst message = aui.message().getState();\n\t\tif (message.role !== \"user\" || restoredMessage.current === message.id)\n\t\t\treturn;\n\t\trestoredMessage.current = message.id;\n\t\tconst composer = aui.message().composer();\n\t\t// Match occurrences, preserving repeated images without duplicating parts\n\t\t// already lifted by the monorepo's patched core. Removing one afterward\n\t\t// must remain a deliberate removal throughout this edit session.\n\t\tconst existing = composer\n\t\t\t.getState()\n\t\t\t.attachments.flatMap((attachment) => attachment.content ?? []);\n\t\tfor (const part of message.content) {\n\t\t\tif (part.type !== \"image\" && part.type !== \"file\") continue;\n\t\t\tconst index = existing.findIndex((candidate) =>\n\t\t\t\tsamePart(candidate, part),\n\t\t\t);\n\t\t\tif (index >= 0) {\n\t\t\t\texisting.splice(index, 1);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tvoid composer\n\t\t\t\t.addAttachment({\n\t\t\t\t\tname: part.filename ?? (part.type === \"image\" ? \"image\" : \"document\"),\n\t\t\t\t\ttype: part.type === \"image\" ? \"image\" : \"document\",\n\t\t\t\t\tcontentType: part.type === \"image\" ? \"image/*\" : part.mimeType,\n\t\t\t\t\tcontent: [part],\n\t\t\t\t})\n\t\t\t\t.catch((error: unknown) => {\n\t\t\t\t\tsetRestoreError(\n\t\t\t\t\t\terror instanceof Error ? error : new Error(String(error)),\n\t\t\t\t\t);\n\t\t\t\t});\n\t\t}\n\t}, [aui, isEditing]);\n\tif (restoreError) throw restoreError;\n}\n\nfunction samePart(\n\tleft: ThreadUserMessagePart,\n\tright: ThreadUserMessagePart,\n): boolean {\n\tif (left.type === \"image\" && right.type === \"image\")\n\t\treturn left.image === right.image;\n\tif (left.type === \"file\" && right.type === \"file\")\n\t\treturn (\n\t\t\tleft.data === right.data &&\n\t\t\tleft.mimeType === right.mimeType &&\n\t\t\tleft.filename === right.filename\n\t\t);\n\treturn false;\n}\n"],"names":["useAui","useAuiState","useRef","useState","useEffect"],"mappings":";;;;AAKO,SAAS,+BAAqC;AACpD,QAAM,MAAMA,MAAAA,OAAA;AACZ,QAAM,YAAYC,MAAAA,YAAY,CAAC,UAAU,MAAM,QAAQ,SAAS,SAAS;AACzE,QAAM,kBAAkBC,WAAAA,OAAsB,IAAI;AAClD,QAAM,CAAC,cAAc,eAAe,IAAIC,oBAAA;AACxCC,aAAAA,UAAU,MAAM;AACf,QAAI,CAAC,WAAW;AACf,sBAAgB,UAAU;AAC1B;AAAA,IACD;AACA,UAAM,UAAU,IAAI,QAAA,EAAU,SAAA;AAC9B,QAAI,QAAQ,SAAS,UAAU,gBAAgB,YAAY,QAAQ;AAClE;AACD,oBAAgB,UAAU,QAAQ;AAClC,UAAM,WAAW,IAAI,QAAA,EAAU,SAAA;AAI/B,UAAM,WAAW,SACf,SAAA,EACA,YAAY,QAAQ,CAAC,eAAe,WAAW,WAAW,EAAE;AAC9D,eAAW,QAAQ,QAAQ,SAAS;AACnC,UAAI,KAAK,SAAS,WAAW,KAAK,SAAS,OAAQ;AACnD,YAAM,QAAQ,SAAS;AAAA,QAAU,CAAC,cACjC,SAAS,WAAW,IAAI;AAAA,MAAA;AAEzB,UAAI,SAAS,GAAG;AACf,iBAAS,OAAO,OAAO,CAAC;AACxB;AAAA,MACD;AACA,WAAK,SACH,cAAc;AAAA,QACd,MAAM,KAAK,aAAa,KAAK,SAAS,UAAU,UAAU;AAAA,QAC1D,MAAM,KAAK,SAAS,UAAU,UAAU;AAAA,QACxC,aAAa,KAAK,SAAS,UAAU,YAAY,KAAK;AAAA,QACtD,SAAS,CAAC,IAAI;AAAA,MAAA,CACd,EACA,MAAM,CAAC,UAAmB;AAC1B;AAAA,UACC,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAAA,QAAA;AAAA,MAE1D,CAAC;AAAA,IACH;AAAA,EACD,GAAG,CAAC,KAAK,SAAS,CAAC;AACnB,MAAI,aAAc,OAAM;AACzB;AAEA,SAAS,SACR,MACA,OACU;AACV,MAAI,KAAK,SAAS,WAAW,MAAM,SAAS;AAC3C,WAAO,KAAK,UAAU,MAAM;AAC7B,MAAI,KAAK,SAAS,UAAU,MAAM,SAAS;AAC1C,WACC,KAAK,SAAS,MAAM,QACpB,KAAK,aAAa,MAAM,YACxB,KAAK,aAAa,MAAM;AAE1B,SAAO;AACR;;"}

package/dist/agent-runtime/src/use-thread-handoff-flow.d.ts

@@ -1,84 +1,86 @@
-import { type HandoffLaunch, type HandoffOutcome, type HandoffSource, type ServerHandoffDestination, type ThreadHandoffTransport, type ThreadHandoffView } from './thread-handoff';
+import { type HandoffLaunch, type HandoffMode, type HandoffOutcome, type HandoffSource, type OfficeLaunchMode, type ServerHandoffDestination, type ThreadHandoffDestination, type ThreadHandoffTransport, type ThreadHandoffView } from './thread-handoff-protocol';
 /** Mobile: a push lands in seconds; the QR path needs time to unlock a phone. */
 export declare const DEFAULT_MOBILE_HANDOFF_TIMEOUT_MS = 120000;
 /** Office: launching a desktop host from cold takes tens of seconds. */
 export declare const DEFAULT_OFFICE_HANDOFF_TIMEOUT_MS = 180000;
-export type ThreadHandoffFlowPhase = {
+/** "Wherever I pick up next": the whole ten-minute life of the record. */
+export declare const DEFAULT_PICKUP_HANDOFF_TIMEOUT_MS = 600000;
+export type ThreadHandoffFlowPhase<D extends ThreadHandoffDestination = ServerHandoffDestination> = {
     status: 'idle';
 } | {
     status: 'creating';
-    destination: ServerHandoffDestination;
+    destination: D;
     threadId: string;
 } | {
     status: 'waiting';
-    destination: ServerHandoffDestination;
+    destination: D;
     threadId: string;
     handoff: ThreadHandoffView;
     launch: HandoffLaunch;
     startedAt: number;
 } | {
     status: 'acknowledged';
-    destination: ServerHandoffDestination;
+    destination: D;
     threadId: string;
     handoff: ThreadHandoffView;
     launch: HandoffLaunch;
 } | {
     status: 'failed';
-    destination: ServerHandoffDestination;
+    destination: D;
     threadId: string;
     handoff: ThreadHandoffView | null;
     launch: HandoffLaunch | null;
     reason: string;
 } | {
     status: 'timeout';
-    destination: ServerHandoffDestination;
+    destination: D;
     threadId: string;
     handoff: ThreadHandoffView | null;
     launch: HandoffLaunch;
 };
-export interface StartThreadHandoffInput {
+export interface StartThreadHandoffInput<D extends ThreadHandoffDestination = ServerHandoffDestination> {
     threadId: string;
-    destination: ServerHandoffDestination;
+    destination: D;
+    officeLaunchMode?: OfficeLaunchMode;
+    expectedWorkspaceId?: string;
+    /** The composer's unsent text; the destination prefills it and never sends it. */
+    draft?: string;
+    /** `voice` offers "Continue by voice" on the destination; omitted means text. */
+    mode?: HandoffMode;
 }
-export interface ThreadHandoffFlowCallbacks {
+export interface ThreadHandoffFlowCallbacks<D extends ThreadHandoffDestination = ServerHandoffDestination> {
     /** The server accepted the handoff; open the launch URL / show the QR. */
     onLaunched?: (context: {
-        destination: ServerHandoffDestination;
+        destination: D;
         threadId: string;
         handoff: ThreadHandoffView;
         launch: HandoffLaunch;
     }) => void;
     /** Terminal result (acknowledged/failed/timeout); `cancelled` is not reported. */
     onSettled?: (context: {
-        destination: ServerHandoffDestination;
+        destination: D;
         threadId: string;
         outcome: Exclude<HandoffOutcome, {
             status: 'cancelled';
         }>;
     }) => void;
 }
-export interface UseThreadHandoffFlowOptions extends ThreadHandoffFlowCallbacks {
+export interface UseThreadHandoffFlowOptions<D extends ThreadHandoffDestination = ServerHandoffDestination> extends ThreadHandoffFlowCallbacks<D> {
     transport: ThreadHandoffTransport;
     source: HandoffSource;
-    timeoutMs?: Partial<Record<ServerHandoffDestination, number>>;
+    /** Change this with the person, workspace, environment or active thread to cancel the old flow. */
+    scopeKey?: string;
+    timeoutMs?: Partial<Record<ThreadHandoffDestination, number>>;
     pollIntervalMs?: number;
 }
-export interface ThreadHandoffFlowController {
-    phase: ThreadHandoffFlowPhase;
+export interface ThreadHandoffFlowController<D extends ThreadHandoffDestination = ServerHandoffDestination> {
+    phase: ThreadHandoffFlowPhase<D>;
     /** True while a handoff is being created or awaiting the destination. */
     isActive: boolean;
-    start: (input: StartThreadHandoffInput) => Promise<void>;
+    start: (input: StartThreadHandoffInput<D>) => Promise<void>;
     /** Stop waiting; the source keeps its copilot. The server record simply expires. */
     cancel: () => void;
     /** Back to idle after a terminal phase (dismisses the result UI). */
     reset: () => void;
 }
-/**
- * Drives one server-brokered handoff (mobile / Word / PowerPoint / Excel):
- * create → launch → poll until the destination acknowledges. Exactly one
- * handoff runs at a time; starting another cancels the previous wait.
- *
- * Source-side effects (closing the copilot only after `acknowledged`, toasts,
- * opening `ms-word:` URLs) belong to the caller via `onLaunched`/`onSettled`.
- */
-export declare function useThreadHandoffFlow({ transport, source, timeoutMs, pollIntervalMs, onLaunched, onSettled, }: UseThreadHandoffFlowOptions): ThreadHandoffFlowController;
+export declare function useThreadHandoffFlow<D extends ThreadHandoffDestination = ServerHandoffDestination>({ transport, source, scopeKey, timeoutMs, pollIntervalMs, onLaunched, onSettled, }: UseThreadHandoffFlowOptions<D>): ThreadHandoffFlowController<D>;

package/dist/agent-runtime/src/voice-media.cjs

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const VOICE_MICROPHONE_CAPTURE = {
+  echoCancellation: true,
+  noiseSuppression: true,
+  autoGainControl: true
+};
+const VOICE_DEVICE_IDENTITY = /^(user-.+)-[^-]+$/;
+function isOwnOtherVoiceDevice({
+  identity,
+  localIdentity
+}) {
+  var _a, _b;
+  if (localIdentity === void 0 || identity === localIdentity) return false;
+  const person = (_a = VOICE_DEVICE_IDENTITY.exec(localIdentity)) == null ? void 0 : _a[1];
+  return person !== void 0 && ((_b = VOICE_DEVICE_IDENTITY.exec(identity)) == null ? void 0 : _b[1]) === person;
+}
+async function connectVoiceMedia({
+  createDriver,
+  handlers
+}) {
+  const { signal } = handlers;
+  const endedError = () => {
+    const error = new Error("The voice session ended");
+    error.name = "AbortError";
+    return error;
+  };
+  if (signal == null ? void 0 : signal.aborted) throw endedError();
+  const driver = createDriver();
+  let connected = false;
+  let joined = false;
+  let closed = false;
+  let disconnecting = null;
+  let rejectEnded;
+  const ended = new Promise((_, reject) => {
+    rejectEnded = reject;
+  });
+  const close = () => {
+    closed = true;
+    signal == null ? void 0 : signal.removeEventListener("abort", onAbort);
+    if (!disconnecting) {
+      try {
+        disconnecting = Promise.resolve(driver.disconnect()).then(
+          () => void 0
+        );
+      } catch (error) {
+        disconnecting = Promise.reject(error);
+      }
+    }
+    return disconnecting;
+  };
+  const disconnectAgain = async () => {
+    try {
+      await driver.disconnect();
+    } catch {
+    }
+  };
+  const onAbort = () => {
+    rejectEnded(endedError());
+    void close().catch(() => void 0);
+  };
+  signal == null ? void 0 : signal.addEventListener("abort", onAbort, { once: true });
+  if (signal == null ? void 0 : signal.aborted) onAbort();
+  driver.onDisconnected(({ reason, joinFailure }) => {
+    if (closed) return;
+    if (!connected && joinFailure) return;
+    rejectEnded(new Error(reason));
+    void close().catch(() => void 0);
+    if (joined) handlers.onDisconnected(reason);
+  });
+  const checkOpen = () => {
+    if (closed) throw endedError();
+  };
+  const joining = (async () => {
+    try {
+      checkOpen();
+      await driver.connect();
+      connected = true;
+      checkOpen();
+      await driver.setMicrophoneEnabled({
+        enabled: !handlers.micMuted,
+        initial: true
+      });
+      checkOpen();
+    } catch (error) {
+      const alreadyClosed = closed;
+      await close().catch(() => void 0);
+      if (alreadyClosed) await disconnectAgain();
+      throw error;
+    }
+  })();
+  await Promise.race([joining, ended]);
+  checkOpen();
+  joined = true;
+  return {
+    setMicrophoneEnabled: (enabled) => {
+      const changing = (async () => {
+        checkOpen();
+        try {
+          await driver.setMicrophoneEnabled({ enabled, initial: false });
+          checkOpen();
+        } finally {
+          if (closed) await disconnectAgain();
+        }
+      })();
+      return Promise.race([changing, ended]);
+    },
+    disconnect: () => {
+      rejectEnded(endedError());
+      return close();
+    }
+  };
+}
+exports.VOICE_MICROPHONE_CAPTURE = VOICE_MICROPHONE_CAPTURE;
+exports.connectVoiceMedia = connectVoiceMedia;
+exports.isOwnOtherVoiceDevice = isOwnOtherVoiceDevice;
+//# sourceMappingURL=voice-media.cjs.map

package/dist/agent-runtime/src/voice-media.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-media.cjs","sources":["../../../../agent-runtime/src/voice-media.ts"],"sourcesContent":["/** Capture processing shared by browser and native chat voice rooms. */\nexport const VOICE_MICROPHONE_CAPTURE = {\n  echoCancellation: true,\n  noiseSuppression: true,\n  autoGainControl: true,\n} as const;\n\n/** `user-<user id>-<client>`: one device of the call's owner (agora's `voice_client_identity`). */\nconst VOICE_DEVICE_IDENTITY = /^(user-.+)-[^-]+$/;\n\n/**\n * Whether a remote participant of a chat voice room is another of the person's\n * own devices. The room holds the voice agent and the owner's devices, and\n * while a call moves (`voice/transfer-*`) the old and the new device are in it\n * together. A device plays the agent only: the other device's microphone is\n * the person's own voice, and on a browser's one `<audio>` sink it would also\n * take the agent's place. `false` while this device's identity is unknown.\n */\nexport function isOwnOtherVoiceDevice({\n  identity,\n  localIdentity,\n}: {\n  identity: string;\n  localIdentity: string | undefined;\n}): boolean {\n  if (localIdentity === undefined || identity === localIdentity) return false;\n  const person = VOICE_DEVICE_IDENTITY.exec(localIdentity)?.[1];\n  return person !== undefined && VOICE_DEVICE_IDENTITY.exec(identity)?.[1] === person;\n}\n\nexport interface VoiceMediaHandlers {\n  micMuted: boolean;\n  signal?: AbortSignal;\n  onDisconnected: (reason: string) => void;\n}\n\nexport interface VoiceMediaSession {\n  setMicrophoneEnabled(enabled: boolean): Promise<void>;\n  disconnect(): Promise<void>;\n}\n\n/**\n * The platform owns its room, audio sink and capture configuration. The shared\n * lifecycle owns cancellation, late capture, mute and loss of that room. No DOM\n * or LiveKit implementation is imported by this entrypoint.\n */\nexport interface VoiceMediaDriver {\n  connect(): Promise<void>;\n  setMicrophoneEnabled(options: {\n    enabled: boolean;\n    initial: boolean;\n  }): Promise<unknown>;\n  /** Must also release the platform's remote audio sinks. Safe to call again. */\n  disconnect(): Promise<unknown>;\n  onDisconnected(\n    listener: (event: { reason: string; joinFailure: boolean }) => void\n  ): void;\n}\n\nexport async function connectVoiceMedia({\n  createDriver,\n  handlers,\n}: {\n  createDriver: () => VoiceMediaDriver;\n  handlers: VoiceMediaHandlers;\n}): Promise<VoiceMediaSession> {\n  const { signal } = handlers;\n  // Hermes does not need a DOMException implementation to cancel a voice join.\n  const endedError = (): Error => {\n    const error = new Error('The voice session ended');\n    error.name = 'AbortError';\n    return error;\n  };\n  if (signal?.aborted) throw endedError();\n  const driver = createDriver();\n  let connected = false;\n  let joined = false;\n  let closed = false;\n  let disconnecting: Promise<void> | null = null;\n  let rejectEnded!: (error: Error) => void;\n  const ended = new Promise<never>((_, reject) => {\n    rejectEnded = reject;\n  });\n  const close = (): Promise<void> => {\n    closed = true;\n    signal?.removeEventListener('abort', onAbort);\n    if (!disconnecting) {\n      try {\n        // Invoke synchronously so a browser's playback sinks stop at hangup.\n        disconnecting = Promise.resolve(driver.disconnect()).then(\n          () => undefined\n        );\n      } catch (error) {\n        disconnecting = Promise.reject(error);\n      }\n    }\n    return disconnecting;\n  };\n  const disconnectAgain = async (): Promise<void> => {\n    try {\n      await driver.disconnect();\n    } catch {\n      /* Preserve the original failure. */\n    }\n  };\n  const onAbort = (): void => {\n    rejectEnded(endedError());\n    void close().catch(() => undefined);\n  };\n  signal?.addEventListener('abort', onAbort, { once: true });\n  // A platform factory may synchronously cancel the attempt that created it.\n  if (signal?.aborted) onAbort();\n  driver.onDisconnected(({ reason, joinFailure }) => {\n    if (closed) return;\n    // Preserve connect()'s real cause when its room emits JOIN_FAILURE first.\n    if (!connected && joinFailure) return;\n    rejectEnded(new Error(reason));\n    void close().catch(() => undefined);\n    if (joined) handlers.onDisconnected(reason);\n  });\n  const checkOpen = (): void => {\n    if (closed) throw endedError();\n  };\n  const joining = (async () => {\n    try {\n      checkOpen();\n      await driver.connect();\n      connected = true;\n      checkOpen();\n      await driver.setMicrophoneEnabled({\n        enabled: !handlers.micMuted,\n        initial: true,\n      });\n      checkOpen();\n    } catch (error) {\n      const alreadyClosed = closed;\n      await close().catch(() => undefined);\n      // An uncancellable platform capture can finish after its first close.\n      if (alreadyClosed) await disconnectAgain();\n      throw error;\n    }\n  })();\n  await Promise.race([joining, ended]);\n  checkOpen();\n  joined = true;\n  return {\n    setMicrophoneEnabled: (enabled) => {\n      const changing = (async () => {\n        checkOpen();\n        try {\n          await driver.setMicrophoneEnabled({ enabled, initial: false });\n          checkOpen();\n        } finally {\n          if (closed) await disconnectAgain();\n        }\n      })();\n      return Promise.race([changing, ended]);\n    },\n    disconnect: () => {\n      rejectEnded(endedError());\n      return close();\n    },\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/agent-runtime/src/voice-media.d.ts

@@ -0,0 +1,49 @@
+/** Capture processing shared by browser and native chat voice rooms. */
+export declare const VOICE_MICROPHONE_CAPTURE: {
+    readonly echoCancellation: true;
+    readonly noiseSuppression: true;
+    readonly autoGainControl: true;
+};
+/**
+ * Whether a remote participant of a chat voice room is another of the person's
+ * own devices. The room holds the voice agent and the owner's devices, and
+ * while a call moves (`voice/transfer-*`) the old and the new device are in it
+ * together. A device plays the agent only: the other device's microphone is
+ * the person's own voice, and on a browser's one `<audio>` sink it would also
+ * take the agent's place. `false` while this device's identity is unknown.
+ */
+export declare function isOwnOtherVoiceDevice({ identity, localIdentity, }: {
+    identity: string;
+    localIdentity: string | undefined;
+}): boolean;
+export interface VoiceMediaHandlers {
+    micMuted: boolean;
+    signal?: AbortSignal;
+    onDisconnected: (reason: string) => void;
+}
+export interface VoiceMediaSession {
+    setMicrophoneEnabled(enabled: boolean): Promise<void>;
+    disconnect(): Promise<void>;
+}
+/**
+ * The platform owns its room, audio sink and capture configuration. The shared
+ * lifecycle owns cancellation, late capture, mute and loss of that room. No DOM
+ * or LiveKit implementation is imported by this entrypoint.
+ */
+export interface VoiceMediaDriver {
+    connect(): Promise<void>;
+    setMicrophoneEnabled(options: {
+        enabled: boolean;
+        initial: boolean;
+    }): Promise<unknown>;
+    /** Must also release the platform's remote audio sinks. Safe to call again. */
+    disconnect(): Promise<unknown>;
+    onDisconnected(listener: (event: {
+        reason: string;
+        joinFailure: boolean;
+    }) => void): void;
+}
+export declare function connectVoiceMedia({ createDriver, handlers, }: {
+    createDriver: () => VoiceMediaDriver;
+    handlers: VoiceMediaHandlers;
+}): Promise<VoiceMediaSession>;