@athenaintel/react 0.18.0 → 0.20.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-deep-agent-window-sync.cjs","sources":["../../../../../agent-runtime/src/use-deep-agent-window-sync.ts"],"sourcesContent":["import { useStatewireSendCommand, useStatewireState } from '@assistant-ui/react-statewire';\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY } from './generated/runconfig-contract';\nimport {\n  buildHistoryLoadCommand,\n  buildToolOutputCommand,\n  type DeepAgentMessagesWindow,\n  type HistoryLoadResult,\n  readDeepAgentMessagesWindow,\n  readHistoryLoadResult,\n  readToolOutputResult,\n  readTruncatedToolOutputArtifact,\n} from './message-window';\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/** The converted thread messages the tool-output half scans (web and native `ThreadMessage` both satisfy it). */\nexport interface DeepAgentWindowSyncMessage {\n  readonly id: string;\n  readonly content: readonly { readonly type: string; readonly artifact?: unknown }[];\n}\n\n/** One `history/load` round trip, for the host's telemetry. */\nexport interface DeepAgentHistoryLoadEvent {\n  beforeIndex: number;\n  limit: number;\n  /** The host's answer, or `null` when it was not a history-load result. */\n  result: HistoryLoadResult | null;\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  /**\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  maxChainedLoads?: number;\n  /** A `history/load` settled (telemetry). */\n  onHistoryLoad?: ((event: DeepAgentHistoryLoadEvent) => void) | undefined;\n  /** A read command failed; the sync itself recovers (the pending marks are released). */\n  onError?: ((error: unknown, command: 'history/load' | 'history/tool_output') => void) | undefined;\n  now?: () => number;\n}\n\nexport interface DeepAgentWindowSyncState {\n  /** The lane, or `null` on a wire that is not windowed (both halves are inert). */\n  window: DeepAgentMessagesWindow | null;\n  /** Messages older than the loaded window the server still holds. */\n  olderCount: number;\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 on a wire that is not windowed or at the beginning. */\n  loadOlder: () => void;\n}\n\n/** The raw lane, selected without derivation (selectors compare by identity). */\nfunction selectMessagesWindowLane(state: unknown): unknown {\n  return typeof state === 'object' && state !== null\n    ? (state as Record<string, unknown>)[DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY]\n    : undefined;\n}\n\n/** The `messagesWindow` lane of the nearest statewire thread, or `null` when the wire is not windowed. */\nexport function useDeepAgentMessagesWindow(): DeepAgentMessagesWindow | null {\n  const lane = useStatewireState(selectMessagesWindowLane);\n  return useMemo(\n    () => readDeepAgentMessagesWindow({ [DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY]: lane }),\n    [lane]\n  );\n}\n\nconst everyMessageMounted = (): boolean => true;\nconst defaultNow = (): number => Date.now();\n\n/**\n * The client half of the windowed wire, shared by every surface that declares\n * a message window (`useDeepAgentThread({ messageWindow })`) — mounted once\n * 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 `messagesWindow` lane says older\n *   messages exist, this sends `history/load` for the next page — the host\n *   prepends it as ops for this client alone — chaining at most\n *   `maxChainedLoads` pages per approach; `loadOlder` asks for one page on\n *   demand (an edge row's button). Never two loads in flight.\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; the converter puts\n *   it back (`toolOutputs`), so the card re-renders complete. An output the\n *   host replaced since (the marker's `chars` changed) is fetched again.\n *\n * On a thread whose wire is not windowed (no lane) both halves are inert.\n */\nexport function useDeepAgentWindowSync({\n  messages,\n  toolOutputs,\n  nearTop = false,\n  nearTopEpoch = 0,\n  isMessageMounted = everyMessageMounted,\n  maxChainedLoads = DEEP_AGENT_MAX_CHAINED_HISTORY_LOADS,\n  onHistoryLoad,\n  onError,\n  now = defaultNow,\n}: UseDeepAgentWindowSyncOptions): DeepAgentWindowSyncState {\n  const sendCommand = useStatewireSendCommand();\n  const window = useDeepAgentMessagesWindow();\n  const [loading, setLoading] = useState(false);\n  const [requests, setRequests] = useState(0);\n  // Bumped when a page settled AFTER its ops moved the lane (the host's\n  // order: prepend, then answer), so the chain re-evaluates against the moved\n  // window instead of waiting for another signal.\n  const [settledLoads, setSettledLoads] = useState(0);\n  const servedRequestsRef = useRef(0);\n  const inflightRef = useRef<number | null>(null);\n  const chainRef = useRef({ epoch: 0, loads: 0 });\n  const aliveRef = useRef(true);\n  const windowRef = useRef(window);\n  windowRef.current = window;\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  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 (window === null || window.start === 0 || inflightRef.current !== null) return;\n    const requested = requests !== servedRequestsRef.current;\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 };\n    } else {\n      if (!nearTop) return;\n      if (chainRef.current.epoch !== nearTopEpoch) {\n        chainRef.current = { epoch: nearTopEpoch, loads: 0 };\n      }\n      if (chainRef.current.loads >= maxChainedLoads) return;\n      chainRef.current.loads += 1;\n    }\n    const command = buildHistoryLoadCommand({ window });\n    if (command === null) return;\n    inflightRef.current = command.beforeIndex;\n    setLoading(true);\n    const startedAt = nowRef.current();\n    Promise.resolve(sendCommand(command))\n      .then((payload) => {\n        onHistoryLoadRef.current?.({\n          beforeIndex: command.beforeIndex,\n          limit: command.limit,\n          result: readHistoryLoadResult(payload),\n          durationMs: Math.max(0, Math.round(nowRef.current() - startedAt)),\n        });\n      })\n      .catch((error: unknown) => {\n        onErrorRef.current?.(error, 'history/load');\n      })\n      .finally(() => {\n        inflightRef.current = null;\n        if (!aliveRef.current) return;\n        setLoading(false);\n        if (windowRef.current?.start !== command.beforeIndex) {\n          setSettledLoads((count) => count + 1);\n        }\n      });\n  }, [nearTop, nearTopEpoch, requests, settledLoads, window, sendCommand, maxChainedLoads]);\n\n  useEffect(() => {\n    if (window === null || toolOutputs === undefined) return;\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        const { messageId, chars } = marker;\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      }\n    }\n  }, [messages, isMessageMounted, window, sendCommand, toolOutputs]);\n\n  const loadOlder = useCallback(() => {\n    setRequests((count) => count + 1);\n  }, []);\n\n  return { window, olderCount: window?.start ?? 0, loading, loadOlder };\n}\n"],"names":["DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY","useStatewireState","useMemo","readDeepAgentMessagesWindow","useStatewireSendCommand","useState","useRef","useEffect","buildHistoryLoadCommand","readHistoryLoadResult","readTruncatedToolOutputArtifact","buildToolOutputCommand","readToolOutputResult","_a","useCallback"],"mappings":"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"}

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

@@ -0,0 +1,133 @@
+import { useStatewireSendCommand, useStatewireState } from "@assistant-ui/react-statewire";
+import { useState, useRef, useEffect, useCallback, useMemo } from "react";
+import { DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY } from "./generated/runconfig-contract.js";
+import { buildHistoryLoadCommand, readHistoryLoadResult, readTruncatedToolOutputArtifact, buildToolOutputCommand, readToolOutputResult, readDeepAgentMessagesWindow } from "./message-window.js";
+const DEEP_AGENT_MAX_CHAINED_HISTORY_LOADS = 3;
+function selectMessagesWindowLane(state) {
+  return typeof state === "object" && state !== null ? state[DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY] : void 0;
+}
+function useDeepAgentMessagesWindow() {
+  const lane = useStatewireState(selectMessagesWindowLane);
+  return useMemo(
+    () => readDeepAgentMessagesWindow({ [DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY]: lane }),
+    [lane]
+  );
+}
+const everyMessageMounted = () => true;
+const defaultNow = () => Date.now();
+function useDeepAgentWindowSync({
+  messages,
+  toolOutputs,
+  nearTop = false,
+  nearTopEpoch = 0,
+  isMessageMounted = everyMessageMounted,
+  maxChainedLoads = DEEP_AGENT_MAX_CHAINED_HISTORY_LOADS,
+  onHistoryLoad,
+  onError,
+  now = defaultNow
+}) {
+  const sendCommand = useStatewireSendCommand();
+  const window = useDeepAgentMessagesWindow();
+  const [loading, setLoading] = useState(false);
+  const [requests, setRequests] = useState(0);
+  const [settledLoads, setSettledLoads] = useState(0);
+  const servedRequestsRef = useRef(0);
+  const inflightRef = useRef(null);
+  const chainRef = useRef({ epoch: 0, loads: 0 });
+  const aliveRef = useRef(true);
+  const windowRef = useRef(window);
+  windowRef.current = window;
+  const answeredRef = useRef(/* @__PURE__ */ new Map());
+  const onHistoryLoadRef = useRef(onHistoryLoad);
+  onHistoryLoadRef.current = onHistoryLoad;
+  const onErrorRef = useRef(onError);
+  onErrorRef.current = onError;
+  const nowRef = useRef(now);
+  nowRef.current = now;
+  useEffect(() => {
+    aliveRef.current = true;
+    return () => {
+      aliveRef.current = false;
+    };
+  }, []);
+  useEffect(() => {
+    if (window === null || window.start === 0 || inflightRef.current !== null) return;
+    const requested = requests !== servedRequestsRef.current;
+    if (requested) {
+      servedRequestsRef.current = requests;
+      chainRef.current = { epoch: nearTopEpoch, loads: 1 };
+    } else {
+      if (!nearTop) return;
+      if (chainRef.current.epoch !== nearTopEpoch) {
+        chainRef.current = { epoch: nearTopEpoch, loads: 0 };
+      }
+      if (chainRef.current.loads >= maxChainedLoads) return;
+      chainRef.current.loads += 1;
+    }
+    const command = buildHistoryLoadCommand({ window });
+    if (command === null) return;
+    inflightRef.current = command.beforeIndex;
+    setLoading(true);
+    const startedAt = nowRef.current();
+    Promise.resolve(sendCommand(command)).then((payload) => {
+      var _a;
+      (_a = onHistoryLoadRef.current) == null ? void 0 : _a.call(onHistoryLoadRef, {
+        beforeIndex: command.beforeIndex,
+        limit: command.limit,
+        result: readHistoryLoadResult(payload),
+        durationMs: Math.max(0, Math.round(nowRef.current() - startedAt))
+      });
+    }).catch((error) => {
+      var _a;
+      (_a = onErrorRef.current) == null ? void 0 : _a.call(onErrorRef, error, "history/load");
+    }).finally(() => {
+      var _a;
+      inflightRef.current = null;
+      if (!aliveRef.current) return;
+      setLoading(false);
+      if (((_a = windowRef.current) == null ? void 0 : _a.start) !== command.beforeIndex) {
+        setSettledLoads((count) => count + 1);
+      }
+    });
+  }, [nearTop, nearTopEpoch, requests, settledLoads, window, sendCommand, maxChainedLoads]);
+  useEffect(() => {
+    var _a;
+    if (window === null || toolOutputs === void 0) return;
+    for (const message of messages) {
+      if (!isMessageMounted(message.id)) continue;
+      for (const part of message.content) {
+        if (part.type !== "tool-call") continue;
+        const marker = readTruncatedToolOutputArtifact(part.artifact);
+        if (marker === null || toolOutputs.isPending(marker.messageId)) continue;
+        if (((_a = toolOutputs.entry(marker.messageId)) == null ? void 0 : _a.chars) === marker.chars) continue;
+        if (answeredRef.current.get(marker.messageId) === marker.chars) continue;
+        const { messageId, chars } = marker;
+        toolOutputs.markPending(messageId);
+        Promise.resolve(sendCommand(buildToolOutputCommand({ messageId }))).then((payload) => {
+          answeredRef.current.set(messageId, chars);
+          const result = readToolOutputResult(payload);
+          if (result === null) {
+            toolOutputs.clearPending(messageId);
+            return;
+          }
+          toolOutputs.set(result.messageId, { content: result.content, chars });
+        }).catch((error) => {
+          var _a2;
+          answeredRef.current.set(messageId, chars);
+          toolOutputs.clearPending(messageId);
+          (_a2 = onErrorRef.current) == null ? void 0 : _a2.call(onErrorRef, error, "history/tool_output");
+        });
+      }
+    }
+  }, [messages, isMessageMounted, window, sendCommand, toolOutputs]);
+  const loadOlder = useCallback(() => {
+    setRequests((count) => count + 1);
+  }, []);
+  return { window, olderCount: (window == null ? void 0 : window.start) ?? 0, loading, loadOlder };
+}
+export {
+  DEEP_AGENT_MAX_CHAINED_HISTORY_LOADS,
+  useDeepAgentMessagesWindow,
+  useDeepAgentWindowSync
+};
+//# sourceMappingURL=use-deep-agent-window-sync.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-deep-agent-window-sync.js","sources":["../../../../../agent-runtime/src/use-deep-agent-window-sync.ts"],"sourcesContent":["import { useStatewireSendCommand, useStatewireState } from '@assistant-ui/react-statewire';\nimport { useCallback, useEffect, useMemo, useRef, useState } from 'react';\nimport { DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY } from './generated/runconfig-contract';\nimport {\n  buildHistoryLoadCommand,\n  buildToolOutputCommand,\n  type DeepAgentMessagesWindow,\n  type HistoryLoadResult,\n  readDeepAgentMessagesWindow,\n  readHistoryLoadResult,\n  readToolOutputResult,\n  readTruncatedToolOutputArtifact,\n} from './message-window';\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/** The converted thread messages the tool-output half scans (web and native `ThreadMessage` both satisfy it). */\nexport interface DeepAgentWindowSyncMessage {\n  readonly id: string;\n  readonly content: readonly { readonly type: string; readonly artifact?: unknown }[];\n}\n\n/** One `history/load` round trip, for the host's telemetry. */\nexport interface DeepAgentHistoryLoadEvent {\n  beforeIndex: number;\n  limit: number;\n  /** The host's answer, or `null` when it was not a history-load result. */\n  result: HistoryLoadResult | null;\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  /**\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  maxChainedLoads?: number;\n  /** A `history/load` settled (telemetry). */\n  onHistoryLoad?: ((event: DeepAgentHistoryLoadEvent) => void) | undefined;\n  /** A read command failed; the sync itself recovers (the pending marks are released). */\n  onError?: ((error: unknown, command: 'history/load' | 'history/tool_output') => void) | undefined;\n  now?: () => number;\n}\n\nexport interface DeepAgentWindowSyncState {\n  /** The lane, or `null` on a wire that is not windowed (both halves are inert). */\n  window: DeepAgentMessagesWindow | null;\n  /** Messages older than the loaded window the server still holds. */\n  olderCount: number;\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 on a wire that is not windowed or at the beginning. */\n  loadOlder: () => void;\n}\n\n/** The raw lane, selected without derivation (selectors compare by identity). */\nfunction selectMessagesWindowLane(state: unknown): unknown {\n  return typeof state === 'object' && state !== null\n    ? (state as Record<string, unknown>)[DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY]\n    : undefined;\n}\n\n/** The `messagesWindow` lane of the nearest statewire thread, or `null` when the wire is not windowed. */\nexport function useDeepAgentMessagesWindow(): DeepAgentMessagesWindow | null {\n  const lane = useStatewireState(selectMessagesWindowLane);\n  return useMemo(\n    () => readDeepAgentMessagesWindow({ [DEEP_AGENT_MESSAGES_WINDOW_STATE_KEY]: lane }),\n    [lane]\n  );\n}\n\nconst everyMessageMounted = (): boolean => true;\nconst defaultNow = (): number => Date.now();\n\n/**\n * The client half of the windowed wire, shared by every surface that declares\n * a message window (`useDeepAgentThread({ messageWindow })`) — mounted once\n * 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 `messagesWindow` lane says older\n *   messages exist, this sends `history/load` for the next page — the host\n *   prepends it as ops for this client alone — chaining at most\n *   `maxChainedLoads` pages per approach; `loadOlder` asks for one page on\n *   demand (an edge row's button). Never two loads in flight.\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; the converter puts\n *   it back (`toolOutputs`), so the card re-renders complete. An output the\n *   host replaced since (the marker's `chars` changed) is fetched again.\n *\n * On a thread whose wire is not windowed (no lane) both halves are inert.\n */\nexport function useDeepAgentWindowSync({\n  messages,\n  toolOutputs,\n  nearTop = false,\n  nearTopEpoch = 0,\n  isMessageMounted = everyMessageMounted,\n  maxChainedLoads = DEEP_AGENT_MAX_CHAINED_HISTORY_LOADS,\n  onHistoryLoad,\n  onError,\n  now = defaultNow,\n}: UseDeepAgentWindowSyncOptions): DeepAgentWindowSyncState {\n  const sendCommand = useStatewireSendCommand();\n  const window = useDeepAgentMessagesWindow();\n  const [loading, setLoading] = useState(false);\n  const [requests, setRequests] = useState(0);\n  // Bumped when a page settled AFTER its ops moved the lane (the host's\n  // order: prepend, then answer), so the chain re-evaluates against the moved\n  // window instead of waiting for another signal.\n  const [settledLoads, setSettledLoads] = useState(0);\n  const servedRequestsRef = useRef(0);\n  const inflightRef = useRef<number | null>(null);\n  const chainRef = useRef({ epoch: 0, loads: 0 });\n  const aliveRef = useRef(true);\n  const windowRef = useRef(window);\n  windowRef.current = window;\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  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 (window === null || window.start === 0 || inflightRef.current !== null) return;\n    const requested = requests !== servedRequestsRef.current;\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 };\n    } else {\n      if (!nearTop) return;\n      if (chainRef.current.epoch !== nearTopEpoch) {\n        chainRef.current = { epoch: nearTopEpoch, loads: 0 };\n      }\n      if (chainRef.current.loads >= maxChainedLoads) return;\n      chainRef.current.loads += 1;\n    }\n    const command = buildHistoryLoadCommand({ window });\n    if (command === null) return;\n    inflightRef.current = command.beforeIndex;\n    setLoading(true);\n    const startedAt = nowRef.current();\n    Promise.resolve(sendCommand(command))\n      .then((payload) => {\n        onHistoryLoadRef.current?.({\n          beforeIndex: command.beforeIndex,\n          limit: command.limit,\n          result: readHistoryLoadResult(payload),\n          durationMs: Math.max(0, Math.round(nowRef.current() - startedAt)),\n        });\n      })\n      .catch((error: unknown) => {\n        onErrorRef.current?.(error, 'history/load');\n      })\n      .finally(() => {\n        inflightRef.current = null;\n        if (!aliveRef.current) return;\n        setLoading(false);\n        if (windowRef.current?.start !== command.beforeIndex) {\n          setSettledLoads((count) => count + 1);\n        }\n      });\n  }, [nearTop, nearTopEpoch, requests, settledLoads, window, sendCommand, maxChainedLoads]);\n\n  useEffect(() => {\n    if (window === null || toolOutputs === undefined) return;\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        const { messageId, chars } = marker;\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      }\n    }\n  }, [messages, isMessageMounted, window, sendCommand, toolOutputs]);\n\n  const loadOlder = useCallback(() => {\n    setRequests((count) => count + 1);\n  }, []);\n\n  return { window, olderCount: window?.start ?? 0, loading, loadOlder };\n}\n"],"names":["_a"],"mappings":"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"}

package/dist/packages/agent-runtime/src/voice-presentation.cjs

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const VOICE_SOURCE_DELEGATION = "voice_delegation";
+const VOICE_DELEGATION_ID_PREFIX = "voicetask_";
+const VOICE_UPDATE_TOOL_NAME = "send_voice_update";
+function isVoiceDelegationMessage({ messageId, custom }) {
+  return (custom == null ? void 0 : custom.source) === VOICE_SOURCE_DELEGATION || typeof messageId === "string" && messageId.startsWith(VOICE_DELEGATION_ID_PREFIX);
+}
+function describeVoiceUpdateToolCall({
+  args,
+  result
+}) {
+  const text = typeof (args == null ? void 0 : args.text) === "string" ? args.text.trim() : "";
+  const spoken = (args == null ? void 0 : args.mode) === "speak";
+  if (typeof result !== "string" || result.trim() === "") {
+    return { spoken, text, delivered: null };
+  }
+  const outcome = result.toLowerCase();
+  const failed = outcome.includes("could not be delivered") || outcome.includes("was not delivered") || outcome.includes("rejected the update") || outcome.includes("has ended") || outcome.includes("not configured") || outcome.includes("no voice session");
+  return { spoken, text, delivered: !failed };
+}
+function voiceUpdateStatusLabel(call, status) {
+  if (status === "running" || call.delivered === null && status !== "incomplete") {
+    return call.spoken ? "Saying to you…" : "Noting progress…";
+  }
+  if (call.delivered === false || status === "incomplete") {
+    return call.spoken ? "Could not say this to you" : "Progress note not delivered";
+  }
+  return call.spoken ? "Said aloud" : "Progress noted silently";
+}
+exports.VOICE_DELEGATION_ID_PREFIX = VOICE_DELEGATION_ID_PREFIX;
+exports.VOICE_SOURCE_DELEGATION = VOICE_SOURCE_DELEGATION;
+exports.VOICE_UPDATE_TOOL_NAME = VOICE_UPDATE_TOOL_NAME;
+exports.describeVoiceUpdateToolCall = describeVoiceUpdateToolCall;
+exports.isVoiceDelegationMessage = isVoiceDelegationMessage;
+exports.voiceUpdateStatusLabel = voiceUpdateStatusLabel;
+//# sourceMappingURL=voice-presentation.cjs.map

package/dist/packages/agent-runtime/src/voice-presentation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-presentation.cjs","sources":["../../../../../agent-runtime/src/voice-presentation.ts"],"sourcesContent":["/**\n * How voice-mode transcript entries present, shared by every chat surface\n * (Olympus, the Chrome side panel, the mobile app) so a spoken turn, a\n * delegation the live voice model handed off, and an interim spoken update\n * read the same everywhere. The wire contract is the deep-agent host's\n * `additional_kwargs.metadata` (exposed as `message.metadata.custom`):\n *\n * - `source: \"voice\"` — a spoken turn; `voice_live: true` while it is still\n *   being heard or spoken (the ephemeral entry the durable row replaces);\n * - `source: \"text\"` — a message typed into the live conversation;\n * - `source: \"voice_delegation\"` (id prefix `voicetask_`) — the unit of work\n *   the live voice model delegated to the thread.\n */\n\n/** `metadata.custom.source` of a spoken turn. */\nexport const VOICE_SOURCE_SPOKEN = 'voice';\n/** `metadata.custom.source` of a message typed into the live conversation. */\nexport const VOICE_SOURCE_TYPED = 'text';\n/** `metadata.custom.source` of a voice delegation's anchor message. */\nexport const VOICE_SOURCE_DELEGATION = 'voice_delegation';\n/** Id prefix of a voice delegation's anchor message (the working signal on\n * hosts that drop the command's metadata). */\nexport const VOICE_DELEGATION_ID_PREFIX = 'voicetask_';\n/** `metadata.custom` flag on a spoken turn still in flight. */\nexport const VOICE_LIVE_KEY = 'voice_live';\n\n/** The delegated run's interim-update tool (agora `send_voice_update`). */\nexport const VOICE_UPDATE_TOOL_NAME = 'send_voice_update';\n\n/** Trailing hint on the live-session strip, worded once for every surface. */\nexport const VOICE_LIVE_TYPED_HINT = 'typed messages go to the voice conversation';\n\n/**\n * The one-time disclosure every surface shows when voice mode is first\n * turned on: the audio path has no zero-data-retention guarantee yet, which\n * users must know before speaking.\n */\nexport const VOICE_MODE_EXPERIMENTAL_NOTICE =\n  \"Voice mode is experimental and doesn't currently have zero data retention\";\n\nexport interface VoiceMessageMarker {\n  /** The thread message id; a host may not have assigned one yet. */\n  messageId: string | undefined;\n  /** The thread message's `metadata.custom`, when any. */\n  custom: Record<string, unknown> | undefined;\n}\n\n/** Whether a thread message is a voice delegation's anchor (the ask the live\n * voice model handed to the thread), by source or by id prefix. */\nexport function isVoiceDelegationMessage({ messageId, custom }: VoiceMessageMarker): boolean {\n  return (\n    custom?.source === VOICE_SOURCE_DELEGATION ||\n    (typeof messageId === 'string' && messageId.startsWith(VOICE_DELEGATION_ID_PREFIX))\n  );\n}\n\nexport interface VoiceProvenance {\n  /** Chip copy: \"Listening\", \"Speaking\", \"Spoken\", or \"Delegated from voice\". */\n  readonly label: string;\n  /** True while the turn is still being heard or spoken. */\n  readonly live: boolean;\n}\n\n// These values are read directly by useAuiState/useSyncExternalStore selectors.\n// Equal presentation must retain its identity, even when a transport replaces\n// the message metadata. Fresh objects here cause React's update-depth crash.\nconst SPOKEN_PROVENANCE: VoiceProvenance = Object.freeze({\n  label: 'Spoken',\n  live: false,\n});\nconst LISTENING_PROVENANCE: VoiceProvenance = Object.freeze({\n  label: 'Listening',\n  live: true,\n});\nconst SPEAKING_PROVENANCE: VoiceProvenance = Object.freeze({\n  label: 'Speaking',\n  live: true,\n});\nconst DELEGATED_PROVENANCE: VoiceProvenance = Object.freeze({\n  label: 'Delegated from voice',\n  live: false,\n});\n\n/**\n * The provenance chip for a message, or `null` for ordinary chat messages so\n * the chip is free to mount on every row. A spoken turn still in flight reads\n * as what is happening (\"Listening\" for the user, \"Speaking\" for the\n * assistant) rather than as a finished \"Spoken\" turn; a typed-in-voice turn\n * is a normal message and gets no chip. Results are immutable and stable for\n * equal presentation, so all surfaces can use this function as a selector.\n */\nexport function voiceProvenanceLabel({\n  messageId,\n  custom,\n  role,\n}: VoiceMessageMarker & { role: 'user' | 'assistant' | string }): VoiceProvenance | null {\n  const source = custom?.source;\n  if (source === VOICE_SOURCE_SPOKEN) {\n    if (custom?.[VOICE_LIVE_KEY] === true) {\n      return role === 'user' ? LISTENING_PROVENANCE : SPEAKING_PROVENANCE;\n    }\n    return SPOKEN_PROVENANCE;\n  }\n  if (isVoiceDelegationMessage({ messageId, custom })) {\n    return DELEGATED_PROVENANCE;\n  }\n  return null;\n}\n\nexport interface VoiceUpdateToolCall {\n  /** `mode: \"speak\"` — read aloud to the user; otherwise a silent progress note. */\n  spoken: boolean;\n  /** The update's words. */\n  text: string;\n  /** Whether the live session took it; `null` while the call is still running. */\n  delivered: boolean | null;\n}\n\n/**\n * What a `send_voice_update` tool call did, from its arguments and the tool's\n * teaching-text result (agora returns prose, not JSON, so the run can read it).\n */\nexport function describeVoiceUpdateToolCall({\n  args,\n  result,\n}: {\n  args: Record<string, unknown> | undefined;\n  result: unknown;\n}): VoiceUpdateToolCall {\n  const text = typeof args?.text === 'string' ? args.text.trim() : '';\n  const spoken = args?.mode === 'speak';\n  if (typeof result !== 'string' || result.trim() === '') {\n    return { spoken, text, delivered: null };\n  }\n  const outcome = result.toLowerCase();\n  const failed =\n    outcome.includes('could not be delivered') ||\n    outcome.includes('was not delivered') ||\n    outcome.includes('rejected the update') ||\n    outcome.includes('has ended') ||\n    outcome.includes('not configured') ||\n    outcome.includes('no voice session');\n  return { spoken, text, delivered: !failed };\n}\n\n/** The card's status line for a voice update in a given tool-call state. */\nexport function voiceUpdateStatusLabel(\n  call: VoiceUpdateToolCall,\n  status: 'running' | 'complete' | 'incomplete' | 'requires-action' | undefined\n): string {\n  if (status === 'running' || (call.delivered === null && status !== 'incomplete')) {\n    return call.spoken ? 'Saying to you…' : 'Noting progress…';\n  }\n  if (call.delivered === false || status === 'incomplete') {\n    return call.spoken ? 'Could not say this to you' : 'Progress note not delivered';\n  }\n  return call.spoken ? 'Said aloud' : 'Progress noted silently';\n}\n"],"names":[],"mappings":";;AAmBO,MAAM,0BAA0B;AAGhC,MAAM,6BAA6B;AAKnC,MAAM,yBAAyB;AAsB/B,SAAS,yBAAyB,EAAE,WAAW,UAAuC;AAC3F,UACE,iCAAQ,YAAW,2BAClB,OAAO,cAAc,YAAY,UAAU,WAAW,0BAA0B;AAErF;AAoEO,SAAS,4BAA4B;AAAA,EAC1C;AAAA,EACA;AACF,GAGwB;AACtB,QAAM,OAAO,QAAO,6BAAM,UAAS,WAAW,KAAK,KAAK,SAAS;AACjE,QAAM,UAAS,6BAAM,UAAS;AAC9B,MAAI,OAAO,WAAW,YAAY,OAAO,KAAA,MAAW,IAAI;AACtD,WAAO,EAAE,QAAQ,MAAM,WAAW,KAAA;AAAA,EACpC;AACA,QAAM,UAAU,OAAO,YAAA;AACvB,QAAM,SACJ,QAAQ,SAAS,wBAAwB,KACzC,QAAQ,SAAS,mBAAmB,KACpC,QAAQ,SAAS,qBAAqB,KACtC,QAAQ,SAAS,WAAW,KAC5B,QAAQ,SAAS,gBAAgB,KACjC,QAAQ,SAAS,kBAAkB;AACrC,SAAO,EAAE,QAAQ,MAAM,WAAW,CAAC,OAAA;AACrC;AAGO,SAAS,uBACd,MACA,QACQ;AACR,MAAI,WAAW,aAAc,KAAK,cAAc,QAAQ,WAAW,cAAe;AAChF,WAAO,KAAK,SAAS,mBAAmB;AAAA,EAC1C;AACA,MAAI,KAAK,cAAc,SAAS,WAAW,cAAc;AACvD,WAAO,KAAK,SAAS,8BAA8B;AAAA,EACrD;AACA,SAAO,KAAK,SAAS,eAAe;AACtC;;;;;;;"}

package/dist/packages/agent-runtime/src/voice-presentation.js

@@ -0,0 +1,37 @@
+const VOICE_SOURCE_DELEGATION = "voice_delegation";
+const VOICE_DELEGATION_ID_PREFIX = "voicetask_";
+const VOICE_UPDATE_TOOL_NAME = "send_voice_update";
+function isVoiceDelegationMessage({ messageId, custom }) {
+  return (custom == null ? void 0 : custom.source) === VOICE_SOURCE_DELEGATION || typeof messageId === "string" && messageId.startsWith(VOICE_DELEGATION_ID_PREFIX);
+}
+function describeVoiceUpdateToolCall({
+  args,
+  result
+}) {
+  const text = typeof (args == null ? void 0 : args.text) === "string" ? args.text.trim() : "";
+  const spoken = (args == null ? void 0 : args.mode) === "speak";
+  if (typeof result !== "string" || result.trim() === "") {
+    return { spoken, text, delivered: null };
+  }
+  const outcome = result.toLowerCase();
+  const failed = outcome.includes("could not be delivered") || outcome.includes("was not delivered") || outcome.includes("rejected the update") || outcome.includes("has ended") || outcome.includes("not configured") || outcome.includes("no voice session");
+  return { spoken, text, delivered: !failed };
+}
+function voiceUpdateStatusLabel(call, status) {
+  if (status === "running" || call.delivered === null && status !== "incomplete") {
+    return call.spoken ? "Saying to you…" : "Noting progress…";
+  }
+  if (call.delivered === false || status === "incomplete") {
+    return call.spoken ? "Could not say this to you" : "Progress note not delivered";
+  }
+  return call.spoken ? "Said aloud" : "Progress noted silently";
+}
+export {
+  VOICE_DELEGATION_ID_PREFIX,
+  VOICE_SOURCE_DELEGATION,
+  VOICE_UPDATE_TOOL_NAME,
+  describeVoiceUpdateToolCall,
+  isVoiceDelegationMessage,
+  voiceUpdateStatusLabel
+};
+//# sourceMappingURL=voice-presentation.js.map

package/dist/packages/agent-runtime/src/voice-presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-presentation.js","sources":["../../../../../agent-runtime/src/voice-presentation.ts"],"sourcesContent":["/**\n * How voice-mode transcript entries present, shared by every chat surface\n * (Olympus, the Chrome side panel, the mobile app) so a spoken turn, a\n * delegation the live voice model handed off, and an interim spoken update\n * read the same everywhere. The wire contract is the deep-agent host's\n * `additional_kwargs.metadata` (exposed as `message.metadata.custom`):\n *\n * - `source: \"voice\"` — a spoken turn; `voice_live: true` while it is still\n *   being heard or spoken (the ephemeral entry the durable row replaces);\n * - `source: \"text\"` — a message typed into the live conversation;\n * - `source: \"voice_delegation\"` (id prefix `voicetask_`) — the unit of work\n *   the live voice model delegated to the thread.\n */\n\n/** `metadata.custom.source` of a spoken turn. */\nexport const VOICE_SOURCE_SPOKEN = 'voice';\n/** `metadata.custom.source` of a message typed into the live conversation. */\nexport const VOICE_SOURCE_TYPED = 'text';\n/** `metadata.custom.source` of a voice delegation's anchor message. */\nexport const VOICE_SOURCE_DELEGATION = 'voice_delegation';\n/** Id prefix of a voice delegation's anchor message (the working signal on\n * hosts that drop the command's metadata). */\nexport const VOICE_DELEGATION_ID_PREFIX = 'voicetask_';\n/** `metadata.custom` flag on a spoken turn still in flight. */\nexport const VOICE_LIVE_KEY = 'voice_live';\n\n/** The delegated run's interim-update tool (agora `send_voice_update`). */\nexport const VOICE_UPDATE_TOOL_NAME = 'send_voice_update';\n\n/** Trailing hint on the live-session strip, worded once for every surface. */\nexport const VOICE_LIVE_TYPED_HINT = 'typed messages go to the voice conversation';\n\n/**\n * The one-time disclosure every surface shows when voice mode is first\n * turned on: the audio path has no zero-data-retention guarantee yet, which\n * users must know before speaking.\n */\nexport const VOICE_MODE_EXPERIMENTAL_NOTICE =\n  \"Voice mode is experimental and doesn't currently have zero data retention\";\n\nexport interface VoiceMessageMarker {\n  /** The thread message id; a host may not have assigned one yet. */\n  messageId: string | undefined;\n  /** The thread message's `metadata.custom`, when any. */\n  custom: Record<string, unknown> | undefined;\n}\n\n/** Whether a thread message is a voice delegation's anchor (the ask the live\n * voice model handed to the thread), by source or by id prefix. */\nexport function isVoiceDelegationMessage({ messageId, custom }: VoiceMessageMarker): boolean {\n  return (\n    custom?.source === VOICE_SOURCE_DELEGATION ||\n    (typeof messageId === 'string' && messageId.startsWith(VOICE_DELEGATION_ID_PREFIX))\n  );\n}\n\nexport interface VoiceProvenance {\n  /** Chip copy: \"Listening\", \"Speaking\", \"Spoken\", or \"Delegated from voice\". */\n  readonly label: string;\n  /** True while the turn is still being heard or spoken. */\n  readonly live: boolean;\n}\n\n// These values are read directly by useAuiState/useSyncExternalStore selectors.\n// Equal presentation must retain its identity, even when a transport replaces\n// the message metadata. Fresh objects here cause React's update-depth crash.\nconst SPOKEN_PROVENANCE: VoiceProvenance = Object.freeze({\n  label: 'Spoken',\n  live: false,\n});\nconst LISTENING_PROVENANCE: VoiceProvenance = Object.freeze({\n  label: 'Listening',\n  live: true,\n});\nconst SPEAKING_PROVENANCE: VoiceProvenance = Object.freeze({\n  label: 'Speaking',\n  live: true,\n});\nconst DELEGATED_PROVENANCE: VoiceProvenance = Object.freeze({\n  label: 'Delegated from voice',\n  live: false,\n});\n\n/**\n * The provenance chip for a message, or `null` for ordinary chat messages so\n * the chip is free to mount on every row. A spoken turn still in flight reads\n * as what is happening (\"Listening\" for the user, \"Speaking\" for the\n * assistant) rather than as a finished \"Spoken\" turn; a typed-in-voice turn\n * is a normal message and gets no chip. Results are immutable and stable for\n * equal presentation, so all surfaces can use this function as a selector.\n */\nexport function voiceProvenanceLabel({\n  messageId,\n  custom,\n  role,\n}: VoiceMessageMarker & { role: 'user' | 'assistant' | string }): VoiceProvenance | null {\n  const source = custom?.source;\n  if (source === VOICE_SOURCE_SPOKEN) {\n    if (custom?.[VOICE_LIVE_KEY] === true) {\n      return role === 'user' ? LISTENING_PROVENANCE : SPEAKING_PROVENANCE;\n    }\n    return SPOKEN_PROVENANCE;\n  }\n  if (isVoiceDelegationMessage({ messageId, custom })) {\n    return DELEGATED_PROVENANCE;\n  }\n  return null;\n}\n\nexport interface VoiceUpdateToolCall {\n  /** `mode: \"speak\"` — read aloud to the user; otherwise a silent progress note. */\n  spoken: boolean;\n  /** The update's words. */\n  text: string;\n  /** Whether the live session took it; `null` while the call is still running. */\n  delivered: boolean | null;\n}\n\n/**\n * What a `send_voice_update` tool call did, from its arguments and the tool's\n * teaching-text result (agora returns prose, not JSON, so the run can read it).\n */\nexport function describeVoiceUpdateToolCall({\n  args,\n  result,\n}: {\n  args: Record<string, unknown> | undefined;\n  result: unknown;\n}): VoiceUpdateToolCall {\n  const text = typeof args?.text === 'string' ? args.text.trim() : '';\n  const spoken = args?.mode === 'speak';\n  if (typeof result !== 'string' || result.trim() === '') {\n    return { spoken, text, delivered: null };\n  }\n  const outcome = result.toLowerCase();\n  const failed =\n    outcome.includes('could not be delivered') ||\n    outcome.includes('was not delivered') ||\n    outcome.includes('rejected the update') ||\n    outcome.includes('has ended') ||\n    outcome.includes('not configured') ||\n    outcome.includes('no voice session');\n  return { spoken, text, delivered: !failed };\n}\n\n/** The card's status line for a voice update in a given tool-call state. */\nexport function voiceUpdateStatusLabel(\n  call: VoiceUpdateToolCall,\n  status: 'running' | 'complete' | 'incomplete' | 'requires-action' | undefined\n): string {\n  if (status === 'running' || (call.delivered === null && status !== 'incomplete')) {\n    return call.spoken ? 'Saying to you…' : 'Noting progress…';\n  }\n  if (call.delivered === false || status === 'incomplete') {\n    return call.spoken ? 'Could not say this to you' : 'Progress note not delivered';\n  }\n  return call.spoken ? 'Said aloud' : 'Progress noted silently';\n}\n"],"names":[],"mappings":"AAmBO,MAAM,0BAA0B;AAGhC,MAAM,6BAA6B;AAKnC,MAAM,yBAAyB;AAsB/B,SAAS,yBAAyB,EAAE,WAAW,UAAuC;AAC3F,UACE,iCAAQ,YAAW,2BAClB,OAAO,cAAc,YAAY,UAAU,WAAW,0BAA0B;AAErF;AAoEO,SAAS,4BAA4B;AAAA,EAC1C;AAAA,EACA;AACF,GAGwB;AACtB,QAAM,OAAO,QAAO,6BAAM,UAAS,WAAW,KAAK,KAAK,SAAS;AACjE,QAAM,UAAS,6BAAM,UAAS;AAC9B,MAAI,OAAO,WAAW,YAAY,OAAO,KAAA,MAAW,IAAI;AACtD,WAAO,EAAE,QAAQ,MAAM,WAAW,KAAA;AAAA,EACpC;AACA,QAAM,UAAU,OAAO,YAAA;AACvB,QAAM,SACJ,QAAQ,SAAS,wBAAwB,KACzC,QAAQ,SAAS,mBAAmB,KACpC,QAAQ,SAAS,qBAAqB,KACtC,QAAQ,SAAS,WAAW,KAC5B,QAAQ,SAAS,gBAAgB,KACjC,QAAQ,SAAS,kBAAkB;AACrC,SAAO,EAAE,QAAQ,MAAM,WAAW,CAAC,OAAA;AACrC;AAGO,SAAS,uBACd,MACA,QACQ;AACR,MAAI,WAAW,aAAc,KAAK,cAAc,QAAQ,WAAW,cAAe;AAChF,WAAO,KAAK,SAAS,mBAAmB;AAAA,EAC1C;AACA,MAAI,KAAK,cAAc,SAAS,WAAW,cAAc;AACvD,WAAO,KAAK,SAAS,8BAA8B;AAAA,EACrD;AACA,SAAO,KAAK,SAAS,eAAe;AACtC;"}

package/dist/packages/react/package.json.cjs

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
+const version = "0.20.0";
+const packageJson = {
+  version
+};
+exports.default = packageJson;
+exports.version = version;
+//# sourceMappingURL=package.json.cjs.map

package/dist/packages/react/package.json.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.json.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}

package/dist/packages/react/package.json.js

@@ -0,0 +1,9 @@
+const version = "0.20.0";
+const packageJson = {
+  version
+};
+export {
+  packageJson as default,
+  version
+};
+//# sourceMappingURL=package.json.js.map

package/dist/packages/react/package.json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.json.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

package/dist/{AthenaContext-B1QMhIP-.cjs → provider/AthenaContext.cjs}

@@ -1,8 +1,9 @@
 "use strict";
-const React = require("react");
-const AthenaContext = React.createContext(null);
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const AthenaContext = react.createContext(null);
 function useAthenaConfig() {
-  const ctx = React.useContext(AthenaContext);
+  const ctx = react.useContext(AthenaContext);
   if (!ctx) {
     throw new Error("[AthenaSDK] useAthenaConfig must be used within <AthenaProvider>");
   }
@@ -10,4 +11,4 @@ function useAthenaConfig() {
 }
 exports.AthenaContext = AthenaContext;
 exports.useAthenaConfig = useAthenaConfig;
-//# sourceMappingURL=AthenaContext-B1QMhIP-.cjs.map
+//# sourceMappingURL=AthenaContext.cjs.map

package/dist/provider/AthenaContext.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AthenaContext.cjs","sources":["../../src/provider/AthenaContext.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\nimport type { AthenaProviderConfig } from './config';\nimport type { AthenaCitationLinkOptions, AthenaLinkClickOptions } from './citation-links';\n\nexport interface AthenaConfig extends Pick<AthenaProviderConfig, 'apiKey' | 'token'> {\n  backendUrl: string;\n  appUrl: string;\n  enabledToolkits: string[];\n  linkClicks?: AthenaLinkClickOptions;\n  citationLinks?: AthenaCitationLinkOptions;\n}\n\nexport const AthenaContext = createContext<AthenaConfig | null>(null);\n\nexport function useAthenaConfig(): AthenaConfig {\n  const ctx = useContext(AthenaContext);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useAthenaConfig must be used within <AthenaProvider>');\n  }\n  return ctx;\n}\n"],"names":["createContext","useContext"],"mappings":";;;AAYO,MAAM,gBAAgBA,MAAAA,cAAmC,IAAI;AAE7D,SAAS,kBAAgC;AAC9C,QAAM,MAAMC,MAAAA,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,kEAAkE;AAAA,EACpF;AACA,SAAO;AACT;;;"}

package/dist/{AthenaContext-MOslgOmE.js → provider/AthenaContext.js}

@@ -8,7 +8,7 @@ function useAthenaConfig() {
   return ctx;
 }
 export {
-  AthenaContext as A,
-  useAthenaConfig as u
+  AthenaContext,
+  useAthenaConfig
 };
-//# sourceMappingURL=AthenaContext-MOslgOmE.js.map
+//# sourceMappingURL=AthenaContext.js.map

package/dist/provider/AthenaContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AthenaContext.js","sources":["../../src/provider/AthenaContext.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\nimport type { AthenaProviderConfig } from './config';\nimport type { AthenaCitationLinkOptions, AthenaLinkClickOptions } from './citation-links';\n\nexport interface AthenaConfig extends Pick<AthenaProviderConfig, 'apiKey' | 'token'> {\n  backendUrl: string;\n  appUrl: string;\n  enabledToolkits: string[];\n  linkClicks?: AthenaLinkClickOptions;\n  citationLinks?: AthenaCitationLinkOptions;\n}\n\nexport const AthenaContext = createContext<AthenaConfig | null>(null);\n\nexport function useAthenaConfig(): AthenaConfig {\n  const ctx = useContext(AthenaContext);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useAthenaConfig must be used within <AthenaProvider>');\n  }\n  return ctx;\n}\n"],"names":[],"mappings":";AAYO,MAAM,gBAAgB,cAAmC,IAAI;AAE7D,SAAS,kBAAgC;AAC9C,QAAM,MAAM,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,kEAAkE;AAAA,EACpF;AACA,SAAO;AACT;"}