@athenaintel/react 0.43.0 → 0.50.0

package/dist/dictation/use-dictation.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const react = require("react");
+const require$$0 = require("react");
 const athenaDiagnostics = require("../diagnostics/athena-diagnostics.cjs");
 const dictationEngine = require("./dictation-engine.cjs");
 const dictationState = require("./dictation-state.cjs");
@@ -23,37 +23,37 @@ function releaseStream(stream) {
   for (const track of stream.getTracks()) track.stop();
 }
 function useDictation(options = {}) {
-  const engine = react.useMemo(() => options.engine ?? dictationEngine.createWebSpeechDictationEngine(), [options.engine]);
+  const engine = require$$0.useMemo(() => options.engine ?? dictationEngine.createWebSpeechDictationEngine(), [options.engine]);
   const { lang, captureStream = true, onAutoEnd } = options;
-  const [state, dispatch] = react.useReducer(dictationState.dictationReducer, dictationState.INITIAL_DICTATION_STATE);
-  const [stream, setStream] = react.useState(null);
-  const [isSupported, setIsSupported] = react.useState(false);
-  const sessionRef = react.useRef(null);
-  const streamRef = react.useRef(null);
-  const stateRef = react.useRef(state);
+  const [state, dispatch] = require$$0.useReducer(dictationState.dictationReducer, dictationState.INITIAL_DICTATION_STATE);
+  const [stream, setStream] = require$$0.useState(null);
+  const [isSupported, setIsSupported] = require$$0.useState(false);
+  const sessionRef = require$$0.useRef(null);
+  const streamRef = require$$0.useRef(null);
+  const stateRef = require$$0.useRef(state);
   stateRef.current = state;
-  const transcriptRef = react.useRef(EMPTY_TRANSCRIPT);
-  const onAutoEndRef = react.useRef(onAutoEnd);
+  const transcriptRef = require$$0.useRef(EMPTY_TRANSCRIPT);
+  const onAutoEndRef = require$$0.useRef(onAutoEnd);
   onAutoEndRef.current = onAutoEnd;
-  const stopWaitersRef = react.useRef([]);
-  const sessionErrorRef = react.useRef(null);
-  const generationRef = react.useRef(0);
-  react.useEffect(() => {
+  const stopWaitersRef = require$$0.useRef([]);
+  const sessionErrorRef = require$$0.useRef(null);
+  const generationRef = require$$0.useRef(0);
+  require$$0.useEffect(() => {
     setIsSupported(engine.isSupported());
   }, [engine]);
-  const settleWaiters = react.useCallback((spoken) => {
+  const settleWaiters = require$$0.useCallback((spoken) => {
     const waiters = stopWaitersRef.current;
     stopWaitersRef.current = [];
     const result = { text: spoken, error: sessionErrorRef.current };
     for (const resolve of waiters) resolve(result);
   }, []);
-  const releaseSession = react.useCallback(() => {
+  const releaseSession = require$$0.useCallback(() => {
     sessionRef.current = null;
     releaseStream(streamRef.current);
     streamRef.current = null;
     setStream(null);
   }, []);
-  const teardown = react.useCallback(() => {
+  const teardown = require$$0.useCallback(() => {
     var _a;
     generationRef.current += 1;
     (_a = sessionRef.current) == null ? void 0 : _a.abort();
@@ -61,7 +61,7 @@ function useDictation(options = {}) {
     transcriptRef.current = EMPTY_TRANSCRIPT;
     settleWaiters("");
   }, [releaseSession, settleWaiters]);
-  const reportEngineError = react.useCallback(
+  const reportEngineError = require$$0.useCallback(
     (engineError) => {
       athenaDiagnostics.athenaDiagnostics.emit("composer.dictation", {
         level: "warn",
@@ -72,7 +72,7 @@ function useDictation(options = {}) {
     },
     [engine.id]
   );
-  const start = react.useCallback(() => {
+  const start = require$$0.useCallback(() => {
     if (sessionRef.current) return;
     const generation = generationRef.current + 1;
     generationRef.current = generation;
@@ -160,7 +160,7 @@ function useDictation(options = {}) {
     };
     void run();
   }, [captureStream, engine, lang, releaseSession, reportEngineError, settleWaiters]);
-  const stop = react.useCallback(() => {
+  const stop = require$$0.useCallback(() => {
     const session = sessionRef.current;
     if (!session) {
       if (stateRef.current.status === dictationState.DICTATION_STATUSES.starting) {
@@ -191,11 +191,11 @@ function useDictation(options = {}) {
     session.stop();
     return flushed;
   }, [engine.flushTimeoutMs, releaseSession, reportEngineError, settleWaiters, teardown]);
-  const cancel = react.useCallback(() => {
+  const cancel = require$$0.useCallback(() => {
     teardown();
     dispatch({ type: "cancel" });
   }, [teardown]);
-  react.useEffect(() => () => teardown(), [teardown]);
+  require$$0.useEffect(() => () => teardown(), [teardown]);
   const isActive = state.status === dictationState.DICTATION_STATUSES.starting || state.status === dictationState.DICTATION_STATUSES.listening || state.status === dictationState.DICTATION_STATUSES.stopping;
   return {
     status: state.status,

package/dist/dictation/use-dictation.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-dictation.cjs","sources":["../../src/dictation/use-dictation.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useReducer, useRef, useState } from 'react';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport {\n  createWebSpeechDictationEngine,\n  DICTATION_ENGINE_ERROR_KINDS,\n  type DictationEngine,\n  type DictationEngineError,\n  type DictationEngineSession,\n} from './dictation-engine';\nimport {\n  DICTATION_STATUSES,\n  dictationReducer,\n  INITIAL_DICTATION_STATE,\n  joinSpeech,\n  spokenText,\n  type DictationStatus,\n  type DictationTranscript,\n} from './dictation-state';\n\nexport interface UseDictationOptions {\n  /**\n   * Speech engine. Defaults to the browser's Web Speech API; `AthenaChat`\n   * passes the record-then-transcribe engine from `useAthenaDictationEngine`.\n   */\n  engine?: DictationEngine;\n  /** BCP-47 language tag. Defaults to the document language, else `en-US`. */\n  lang?: string;\n  /**\n   * Open the microphone through `getUserMedia` so callers get a `stream` for\n   * a waveform. Web Speech opens its own capture; this second capture is\n   * what the level meter reads. Defaults to true.\n   */\n  captureStream?: boolean;\n  /**\n   * The engine ended on its own (silence window, recognizer timeout) while\n   * listening, without `stop()` or `cancel()`. Receives the spoken text so\n   * the words are not lost; the composer puts them into the draft.\n   */\n  onAutoEnd?: (spoken: string) => void;\n}\n\nexport interface DictationStopResult {\n  /** Spoken text (final plus interim tail) gathered before the engine closed. */\n  text: string;\n  /**\n   * The engine error reported during this session, if any. When set the\n   * transcript may be incomplete: a recorded engine whose upload failed has no\n   * words to hand over, so callers should not send the draft as if it were.\n   */\n  error: DictationEngineError | null;\n}\n\nexport interface DictationController {\n  status: DictationStatus;\n  /** True while starting, listening or stopping. */\n  isActive: boolean;\n  transcript: DictationTranscript;\n  /** `final` plus the interim tail, ready to hand to the composer. */\n  text: string;\n  error: DictationEngineError | null;\n  /** The microphone stream while active (for a waveform), else null. */\n  stream: MediaStream | null;\n  /** Whether the engine can run here. Hide the control when false. */\n  isSupported: boolean;\n  /** The engine in use (for its `stoppingLabel` and diagnostics). */\n  engine: DictationEngine;\n  start: () => void;\n  /**\n   * Finish recording. Resolves once the engine has flushed (bounded wait), so\n   * trailing words are not lost, with the spoken text and any error raised\n   * along the way.\n   */\n  stop: () => Promise<DictationStopResult>;\n  /** Discard the session and its transcript. */\n  cancel: () => void;\n}\n\n/** How long `stop()` waits for a live engine's final flush before giving up. */\nconst DEFAULT_STOP_FLUSH_TIMEOUT_MS = 1500;\n\ntype StopResolver = (result: DictationStopResult) => void;\n\nconst EMPTY_TRANSCRIPT: DictationTranscript = { final: '', interim: '' };\n\nfunction documentLanguage(): string {\n  if (typeof document !== 'undefined' && document.documentElement.lang) {\n    return document.documentElement.lang;\n  }\n  if (typeof navigator !== 'undefined' && navigator.language) return navigator.language;\n  return 'en-US';\n}\n\nasync function openMicrophone(): Promise<MediaStream | null> {\n  if (typeof navigator === 'undefined' || !navigator.mediaDevices?.getUserMedia) return null;\n  return navigator.mediaDevices.getUserMedia({ audio: true });\n}\n\nfunction releaseStream(stream: MediaStream | null): void {\n  if (!stream) return;\n  for (const track of stream.getTracks()) track.stop();\n}\n\n/**\n * Drive a dictation session: microphone, speech engine, and the transcript\n * state machine. The composer renders the waveform from `stream` and the\n * live caption from `transcript`; on `stop()` it appends `text` to the draft.\n */\nexport function useDictation(options: UseDictationOptions = {}): DictationController {\n  const engine = useMemo(() => options.engine ?? createWebSpeechDictationEngine(), [options.engine]);\n  const { lang, captureStream = true, onAutoEnd } = options;\n  const [state, dispatch] = useReducer(dictationReducer, INITIAL_DICTATION_STATE);\n  const [stream, setStream] = useState<MediaStream | null>(null);\n  const [isSupported, setIsSupported] = useState(false);\n\n  const sessionRef = useRef<DictationEngineSession | null>(null);\n  const streamRef = useRef<MediaStream | null>(null);\n  const stateRef = useRef(state);\n  stateRef.current = state;\n  // The authoritative transcript, updated synchronously as the engine reports\n  // it. The reducer's copy renders the caption; this one is what `stop()` and\n  // `onAutoEnd` hand over, so an engine that flushes its last words and ends\n  // in the same tick — before React has rendered — loses nothing.\n  const transcriptRef = useRef<DictationTranscript>(EMPTY_TRANSCRIPT);\n  const onAutoEndRef = useRef(onAutoEnd);\n  onAutoEndRef.current = onAutoEnd;\n  // stop() callers waiting for the engine's final flush.\n  const stopWaitersRef = useRef<StopResolver[]>([]);\n  // Last engine error of the current session, handed to stop() callers\n  // synchronously (the reducer's copy may not have rendered yet).\n  const sessionErrorRef = useRef<DictationEngineError | null>(null);\n  // Distinguishes a fresh session from the callbacks of a torn-down one.\n  const generationRef = useRef(0);\n\n  useEffect(() => {\n    setIsSupported(engine.isSupported());\n  }, [engine]);\n\n  const settleWaiters = useCallback((spoken: string) => {\n    const waiters = stopWaitersRef.current;\n    stopWaitersRef.current = [];\n    const result: DictationStopResult = { text: spoken, error: sessionErrorRef.current };\n    for (const resolve of waiters) resolve(result);\n  }, []);\n\n  const releaseSession = useCallback(() => {\n    sessionRef.current = null;\n    releaseStream(streamRef.current);\n    streamRef.current = null;\n    setStream(null);\n  }, []);\n\n  const teardown = useCallback(() => {\n    generationRef.current += 1;\n    sessionRef.current?.abort();\n    releaseSession();\n    transcriptRef.current = EMPTY_TRANSCRIPT;\n    settleWaiters('');\n  }, [releaseSession, settleWaiters]);\n\n  const reportEngineError = useCallback(\n    (engineError: DictationEngineError) => {\n      athenaDiagnostics.emit('composer.dictation', {\n        level: 'warn',\n        data: { phase: 'error', engine: engine.id, kind: engineError.kind },\n      });\n      sessionErrorRef.current = engineError;\n      dispatch({ type: 'error', error: engineError });\n    },\n    [engine.id],\n  );\n\n  const start = useCallback(() => {\n    if (sessionRef.current) return;\n    const generation = generationRef.current + 1;\n    generationRef.current = generation;\n    transcriptRef.current = EMPTY_TRANSCRIPT;\n    sessionErrorRef.current = null;\n    dispatch({ type: 'start' });\n    athenaDiagnostics.emit('composer.dictation', {\n      level: 'debug',\n      data: { phase: 'start', engine: engine.id },\n    });\n\n    const run = async () => {\n      let microphone: MediaStream | null = null;\n      if (captureStream) {\n        try {\n          microphone = await openMicrophone();\n        } catch (error) {\n          if (generationRef.current !== generation) {\n            releaseStream(microphone);\n            return;\n          }\n          dispatch({\n            type: 'error',\n            error: {\n              kind: DICTATION_ENGINE_ERROR_KINDS.permission,\n              message:\n                error instanceof DOMException && error.name === 'NotFoundError'\n                  ? 'No microphone was found.'\n                  : 'Microphone access was denied. Allow the microphone for this site and try again.',\n            },\n          });\n          return;\n        }\n      }\n      if (generationRef.current !== generation) {\n        releaseStream(microphone);\n        return;\n      }\n      streamRef.current = microphone;\n      setStream(microphone);\n\n      // An engine may fail synchronously inside start() (Web Speech throws\n      // when recognition.start() is refused) and run onError/onEnd before we\n      // hold the session. Those callbacks flip this flag so a dead session is\n      // never stored, which would make every later mic click return early.\n      let terminated = false;\n      const endSession = () => {\n        terminated = true;\n        const current = stateRef.current;\n        const spoken = spokenText(transcriptRef.current);\n        // No stop() is waiting: the engine gave up on its own. Hand the\n        // words over so they land in the draft instead of vanishing.\n        const endedOnItsOwn =\n          stopWaitersRef.current.length === 0 && current.status === DICTATION_STATUSES.listening;\n        // The reducer keeps an error status through 'ended', so an error\n        // reported just before the engine closed stays on screen.\n        dispatch({ type: 'ended' });\n        releaseSession();\n        settleWaiters(spoken);\n        if (endedOnItsOwn) onAutoEndRef.current?.(spoken);\n      };\n      let session: DictationEngineSession;\n      try {\n        session = engine.start({\n          stream: microphone,\n          lang: lang ?? documentLanguage(),\n          callbacks: {\n            onTranscript: (update) => {\n              if (generationRef.current !== generation) return;\n              transcriptRef.current = {\n                final: joinSpeech(transcriptRef.current.final, update.final),\n                interim: update.interim,\n              };\n              dispatch({ type: 'transcript', update });\n            },\n            onError: (engineError) => {\n              if (generationRef.current !== generation) return;\n              // A silence timeout is the engine giving up politely; keep the\n              // words we have instead of showing an error.\n              if (engineError.kind === DICTATION_ENGINE_ERROR_KINDS.noSpeech) return;\n              reportEngineError(engineError);\n            },\n            onEnd: () => {\n              if (generationRef.current !== generation) return;\n              endSession();\n            },\n          },\n        });\n      } catch (error) {\n        // A relay engine that cannot build its session must not strand the\n        // microphone or leave the composer in `starting`.\n        releaseSession();\n        reportEngineError({\n          kind: DICTATION_ENGINE_ERROR_KINDS.connection,\n          message: error instanceof Error ? error.message : 'Dictation could not start.',\n        });\n        return;\n      }\n      if (terminated) return;\n      sessionRef.current = session;\n      dispatch({ type: 'listening' });\n    };\n    void run();\n  }, [captureStream, engine, lang, releaseSession, reportEngineError, settleWaiters]);\n\n  const stop = useCallback((): Promise<DictationStopResult> => {\n    const session = sessionRef.current;\n    if (!session) {\n      // Stopped while the microphone prompt was still open: nothing was heard\n      // yet, and the pending start must not bring the engine up afterwards.\n      if (stateRef.current.status === DICTATION_STATUSES.starting) {\n        teardown();\n        dispatch({ type: 'cancel' });\n        return Promise.resolve({ text: '', error: null });\n      }\n      return Promise.resolve({ text: spokenText(transcriptRef.current), error: sessionErrorRef.current });\n    }\n    dispatch({ type: 'stop' });\n    const flushed = new Promise<DictationStopResult>((resolve) => {\n      stopWaitersRef.current.push(resolve);\n      window.setTimeout(() => {\n        // Bounded wait: a recognizer that never fires onend must not hold the\n        // composer hostage. Force the session closed and hand over what was\n        // heard so far. An engine that had nothing to show yet (a recorded\n        // clip still transcribing) surfaces that as an error rather than\n        // passing off silence as the result.\n        if (sessionRef.current === session) {\n          // Report before abort(): an engine that ends synchronously on\n          // abort settles the waiters, and they must see this error.\n          if (!spokenText(transcriptRef.current)) {\n            reportEngineError({\n              kind: DICTATION_ENGINE_ERROR_KINDS.connection,\n              message: 'Transcription timed out. Try again.',\n            });\n          }\n          session.abort();\n          dispatch({ type: 'ended' });\n          releaseSession();\n          settleWaiters(spokenText(transcriptRef.current));\n        }\n      }, engine.flushTimeoutMs ?? DEFAULT_STOP_FLUSH_TIMEOUT_MS);\n    });\n    session.stop();\n    return flushed;\n  }, [engine.flushTimeoutMs, releaseSession, reportEngineError, settleWaiters, teardown]);\n\n  const cancel = useCallback(() => {\n    teardown();\n    dispatch({ type: 'cancel' });\n  }, [teardown]);\n\n  // Release the microphone with the component.\n  useEffect(() => () => teardown(), [teardown]);\n\n  const isActive =\n    state.status === DICTATION_STATUSES.starting ||\n    state.status === DICTATION_STATUSES.listening ||\n    state.status === DICTATION_STATUSES.stopping;\n\n  return {\n    status: state.status,\n    isActive,\n    transcript: state.transcript,\n    text: spokenText(state.transcript),\n    error: state.error,\n    stream,\n    isSupported,\n    engine,\n    start,\n    stop,\n    cancel,\n  };\n}\n"],"names":["useMemo","createWebSpeechDictationEngine","useReducer","dictationReducer","INITIAL_DICTATION_STATE","useState","useRef","useEffect","useCallback","athenaDiagnostics","DICTATION_ENGINE_ERROR_KINDS","spokenText","DICTATION_STATUSES","joinSpeech"],"mappings":"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"}
+{"version":3,"file":"use-dictation.cjs","sources":["../../src/dictation/use-dictation.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useReducer, useRef, useState } from 'react';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport {\n  createWebSpeechDictationEngine,\n  DICTATION_ENGINE_ERROR_KINDS,\n  type DictationEngine,\n  type DictationEngineError,\n  type DictationEngineSession,\n} from './dictation-engine';\nimport {\n  DICTATION_STATUSES,\n  dictationReducer,\n  INITIAL_DICTATION_STATE,\n  joinSpeech,\n  spokenText,\n  type DictationStatus,\n  type DictationTranscript,\n} from './dictation-state';\n\nexport interface UseDictationOptions {\n  /**\n   * Speech engine. Defaults to the browser's Web Speech API; `AthenaChat`\n   * passes the record-then-transcribe engine from `useAthenaDictationEngine`.\n   */\n  engine?: DictationEngine;\n  /** BCP-47 language tag. Defaults to the document language, else `en-US`. */\n  lang?: string;\n  /**\n   * Open the microphone through `getUserMedia` so callers get a `stream` for\n   * a waveform. Web Speech opens its own capture; this second capture is\n   * what the level meter reads. Defaults to true.\n   */\n  captureStream?: boolean;\n  /**\n   * The engine ended on its own (silence window, recognizer timeout) while\n   * listening, without `stop()` or `cancel()`. Receives the spoken text so\n   * the words are not lost; the composer puts them into the draft.\n   */\n  onAutoEnd?: (spoken: string) => void;\n}\n\nexport interface DictationStopResult {\n  /** Spoken text (final plus interim tail) gathered before the engine closed. */\n  text: string;\n  /**\n   * The engine error reported during this session, if any. When set the\n   * transcript may be incomplete: a recorded engine whose upload failed has no\n   * words to hand over, so callers should not send the draft as if it were.\n   */\n  error: DictationEngineError | null;\n}\n\nexport interface DictationController {\n  status: DictationStatus;\n  /** True while starting, listening or stopping. */\n  isActive: boolean;\n  transcript: DictationTranscript;\n  /** `final` plus the interim tail, ready to hand to the composer. */\n  text: string;\n  error: DictationEngineError | null;\n  /** The microphone stream while active (for a waveform), else null. */\n  stream: MediaStream | null;\n  /** Whether the engine can run here. Hide the control when false. */\n  isSupported: boolean;\n  /** The engine in use (for its `stoppingLabel` and diagnostics). */\n  engine: DictationEngine;\n  start: () => void;\n  /**\n   * Finish recording. Resolves once the engine has flushed (bounded wait), so\n   * trailing words are not lost, with the spoken text and any error raised\n   * along the way.\n   */\n  stop: () => Promise<DictationStopResult>;\n  /** Discard the session and its transcript. */\n  cancel: () => void;\n}\n\n/** How long `stop()` waits for a live engine's final flush before giving up. */\nconst DEFAULT_STOP_FLUSH_TIMEOUT_MS = 1500;\n\ntype StopResolver = (result: DictationStopResult) => void;\n\nconst EMPTY_TRANSCRIPT: DictationTranscript = { final: '', interim: '' };\n\nfunction documentLanguage(): string {\n  if (typeof document !== 'undefined' && document.documentElement.lang) {\n    return document.documentElement.lang;\n  }\n  if (typeof navigator !== 'undefined' && navigator.language) return navigator.language;\n  return 'en-US';\n}\n\nasync function openMicrophone(): Promise<MediaStream | null> {\n  if (typeof navigator === 'undefined' || !navigator.mediaDevices?.getUserMedia) return null;\n  return navigator.mediaDevices.getUserMedia({ audio: true });\n}\n\nfunction releaseStream(stream: MediaStream | null): void {\n  if (!stream) return;\n  for (const track of stream.getTracks()) track.stop();\n}\n\n/**\n * Drive a dictation session: microphone, speech engine, and the transcript\n * state machine. The composer renders the waveform from `stream` and the\n * live caption from `transcript`; on `stop()` it appends `text` to the draft.\n */\nexport function useDictation(options: UseDictationOptions = {}): DictationController {\n  const engine = useMemo(() => options.engine ?? createWebSpeechDictationEngine(), [options.engine]);\n  const { lang, captureStream = true, onAutoEnd } = options;\n  const [state, dispatch] = useReducer(dictationReducer, INITIAL_DICTATION_STATE);\n  const [stream, setStream] = useState<MediaStream | null>(null);\n  const [isSupported, setIsSupported] = useState(false);\n\n  const sessionRef = useRef<DictationEngineSession | null>(null);\n  const streamRef = useRef<MediaStream | null>(null);\n  const stateRef = useRef(state);\n  stateRef.current = state;\n  // The authoritative transcript, updated synchronously as the engine reports\n  // it. The reducer's copy renders the caption; this one is what `stop()` and\n  // `onAutoEnd` hand over, so an engine that flushes its last words and ends\n  // in the same tick — before React has rendered — loses nothing.\n  const transcriptRef = useRef<DictationTranscript>(EMPTY_TRANSCRIPT);\n  const onAutoEndRef = useRef(onAutoEnd);\n  onAutoEndRef.current = onAutoEnd;\n  // stop() callers waiting for the engine's final flush.\n  const stopWaitersRef = useRef<StopResolver[]>([]);\n  // Last engine error of the current session, handed to stop() callers\n  // synchronously (the reducer's copy may not have rendered yet).\n  const sessionErrorRef = useRef<DictationEngineError | null>(null);\n  // Distinguishes a fresh session from the callbacks of a torn-down one.\n  const generationRef = useRef(0);\n\n  useEffect(() => {\n    setIsSupported(engine.isSupported());\n  }, [engine]);\n\n  const settleWaiters = useCallback((spoken: string) => {\n    const waiters = stopWaitersRef.current;\n    stopWaitersRef.current = [];\n    const result: DictationStopResult = { text: spoken, error: sessionErrorRef.current };\n    for (const resolve of waiters) resolve(result);\n  }, []);\n\n  const releaseSession = useCallback(() => {\n    sessionRef.current = null;\n    releaseStream(streamRef.current);\n    streamRef.current = null;\n    setStream(null);\n  }, []);\n\n  const teardown = useCallback(() => {\n    generationRef.current += 1;\n    sessionRef.current?.abort();\n    releaseSession();\n    transcriptRef.current = EMPTY_TRANSCRIPT;\n    settleWaiters('');\n  }, [releaseSession, settleWaiters]);\n\n  const reportEngineError = useCallback(\n    (engineError: DictationEngineError) => {\n      athenaDiagnostics.emit('composer.dictation', {\n        level: 'warn',\n        data: { phase: 'error', engine: engine.id, kind: engineError.kind },\n      });\n      sessionErrorRef.current = engineError;\n      dispatch({ type: 'error', error: engineError });\n    },\n    [engine.id],\n  );\n\n  const start = useCallback(() => {\n    if (sessionRef.current) return;\n    const generation = generationRef.current + 1;\n    generationRef.current = generation;\n    transcriptRef.current = EMPTY_TRANSCRIPT;\n    sessionErrorRef.current = null;\n    dispatch({ type: 'start' });\n    athenaDiagnostics.emit('composer.dictation', {\n      level: 'debug',\n      data: { phase: 'start', engine: engine.id },\n    });\n\n    const run = async () => {\n      let microphone: MediaStream | null = null;\n      if (captureStream) {\n        try {\n          microphone = await openMicrophone();\n        } catch (error) {\n          if (generationRef.current !== generation) {\n            releaseStream(microphone);\n            return;\n          }\n          dispatch({\n            type: 'error',\n            error: {\n              kind: DICTATION_ENGINE_ERROR_KINDS.permission,\n              message:\n                error instanceof DOMException && error.name === 'NotFoundError'\n                  ? 'No microphone was found.'\n                  : 'Microphone access was denied. Allow the microphone for this site and try again.',\n            },\n          });\n          return;\n        }\n      }\n      if (generationRef.current !== generation) {\n        releaseStream(microphone);\n        return;\n      }\n      streamRef.current = microphone;\n      setStream(microphone);\n\n      // An engine may fail synchronously inside start() (Web Speech throws\n      // when recognition.start() is refused) and run onError/onEnd before we\n      // hold the session. Those callbacks flip this flag so a dead session is\n      // never stored, which would make every later mic click return early.\n      let terminated = false;\n      const endSession = () => {\n        terminated = true;\n        const current = stateRef.current;\n        const spoken = spokenText(transcriptRef.current);\n        // No stop() is waiting: the engine gave up on its own. Hand the\n        // words over so they land in the draft instead of vanishing.\n        const endedOnItsOwn =\n          stopWaitersRef.current.length === 0 && current.status === DICTATION_STATUSES.listening;\n        // The reducer keeps an error status through 'ended', so an error\n        // reported just before the engine closed stays on screen.\n        dispatch({ type: 'ended' });\n        releaseSession();\n        settleWaiters(spoken);\n        if (endedOnItsOwn) onAutoEndRef.current?.(spoken);\n      };\n      let session: DictationEngineSession;\n      try {\n        session = engine.start({\n          stream: microphone,\n          lang: lang ?? documentLanguage(),\n          callbacks: {\n            onTranscript: (update) => {\n              if (generationRef.current !== generation) return;\n              transcriptRef.current = {\n                final: joinSpeech(transcriptRef.current.final, update.final),\n                interim: update.interim,\n              };\n              dispatch({ type: 'transcript', update });\n            },\n            onError: (engineError) => {\n              if (generationRef.current !== generation) return;\n              // A silence timeout is the engine giving up politely; keep the\n              // words we have instead of showing an error.\n              if (engineError.kind === DICTATION_ENGINE_ERROR_KINDS.noSpeech) return;\n              reportEngineError(engineError);\n            },\n            onEnd: () => {\n              if (generationRef.current !== generation) return;\n              endSession();\n            },\n          },\n        });\n      } catch (error) {\n        // A relay engine that cannot build its session must not strand the\n        // microphone or leave the composer in `starting`.\n        releaseSession();\n        reportEngineError({\n          kind: DICTATION_ENGINE_ERROR_KINDS.connection,\n          message: error instanceof Error ? error.message : 'Dictation could not start.',\n        });\n        return;\n      }\n      if (terminated) return;\n      sessionRef.current = session;\n      dispatch({ type: 'listening' });\n    };\n    void run();\n  }, [captureStream, engine, lang, releaseSession, reportEngineError, settleWaiters]);\n\n  const stop = useCallback((): Promise<DictationStopResult> => {\n    const session = sessionRef.current;\n    if (!session) {\n      // Stopped while the microphone prompt was still open: nothing was heard\n      // yet, and the pending start must not bring the engine up afterwards.\n      if (stateRef.current.status === DICTATION_STATUSES.starting) {\n        teardown();\n        dispatch({ type: 'cancel' });\n        return Promise.resolve({ text: '', error: null });\n      }\n      return Promise.resolve({ text: spokenText(transcriptRef.current), error: sessionErrorRef.current });\n    }\n    dispatch({ type: 'stop' });\n    const flushed = new Promise<DictationStopResult>((resolve) => {\n      stopWaitersRef.current.push(resolve);\n      window.setTimeout(() => {\n        // Bounded wait: a recognizer that never fires onend must not hold the\n        // composer hostage. Force the session closed and hand over what was\n        // heard so far. An engine that had nothing to show yet (a recorded\n        // clip still transcribing) surfaces that as an error rather than\n        // passing off silence as the result.\n        if (sessionRef.current === session) {\n          // Report before abort(): an engine that ends synchronously on\n          // abort settles the waiters, and they must see this error.\n          if (!spokenText(transcriptRef.current)) {\n            reportEngineError({\n              kind: DICTATION_ENGINE_ERROR_KINDS.connection,\n              message: 'Transcription timed out. Try again.',\n            });\n          }\n          session.abort();\n          dispatch({ type: 'ended' });\n          releaseSession();\n          settleWaiters(spokenText(transcriptRef.current));\n        }\n      }, engine.flushTimeoutMs ?? DEFAULT_STOP_FLUSH_TIMEOUT_MS);\n    });\n    session.stop();\n    return flushed;\n  }, [engine.flushTimeoutMs, releaseSession, reportEngineError, settleWaiters, teardown]);\n\n  const cancel = useCallback(() => {\n    teardown();\n    dispatch({ type: 'cancel' });\n  }, [teardown]);\n\n  // Release the microphone with the component.\n  useEffect(() => () => teardown(), [teardown]);\n\n  const isActive =\n    state.status === DICTATION_STATUSES.starting ||\n    state.status === DICTATION_STATUSES.listening ||\n    state.status === DICTATION_STATUSES.stopping;\n\n  return {\n    status: state.status,\n    isActive,\n    transcript: state.transcript,\n    text: spokenText(state.transcript),\n    error: state.error,\n    stream,\n    isSupported,\n    engine,\n    start,\n    stop,\n    cancel,\n  };\n}\n"],"names":["useMemo","createWebSpeechDictationEngine","useReducer","dictationReducer","INITIAL_DICTATION_STATE","useState","useRef","useEffect","useCallback","athenaDiagnostics","DICTATION_ENGINE_ERROR_KINDS","spokenText","DICTATION_STATUSES","joinSpeech"],"mappings":";;;;;;AA8EA,MAAM,gCAAgC;AAItC,MAAM,mBAAwC,EAAE,OAAO,IAAI,SAAS,GAAA;AAEpE,SAAS,mBAA2B;AAClC,MAAI,OAAO,aAAa,eAAe,SAAS,gBAAgB,MAAM;AACpE,WAAO,SAAS,gBAAgB;AAAA,EAClC;AACA,MAAI,OAAO,cAAc,eAAe,UAAU,iBAAiB,UAAU;AAC7E,SAAO;AACT;AAEA,eAAe,iBAA8C;;AAC3D,MAAI,OAAO,cAAc,eAAe,GAAC,eAAU,iBAAV,mBAAwB,cAAc,QAAO;AACtF,SAAO,UAAU,aAAa,aAAa,EAAE,OAAO,MAAM;AAC5D;AAEA,SAAS,cAAc,QAAkC;AACvD,MAAI,CAAC,OAAQ;AACb,aAAW,SAAS,OAAO,UAAA,SAAmB,KAAA;AAChD;AAOO,SAAS,aAAa,UAA+B,IAAyB;AACnF,QAAM,SAASA,mBAAQ,MAAM,QAAQ,UAAUC,gBAAAA,kCAAkC,CAAC,QAAQ,MAAM,CAAC;AACjG,QAAM,EAAE,MAAM,gBAAgB,MAAM,cAAc;AAClD,QAAM,CAAC,OAAO,QAAQ,IAAIC,WAAAA,WAAWC,eAAAA,kBAAkBC,eAAAA,uBAAuB;AAC9E,QAAM,CAAC,QAAQ,SAAS,IAAIC,WAAAA,SAA6B,IAAI;AAC7D,QAAM,CAAC,aAAa,cAAc,IAAIA,WAAAA,SAAS,KAAK;AAEpD,QAAM,aAAaC,WAAAA,OAAsC,IAAI;AAC7D,QAAM,YAAYA,WAAAA,OAA2B,IAAI;AACjD,QAAM,WAAWA,WAAAA,OAAO,KAAK;AAC7B,WAAS,UAAU;AAKnB,QAAM,gBAAgBA,WAAAA,OAA4B,gBAAgB;AAClE,QAAM,eAAeA,WAAAA,OAAO,SAAS;AACrC,eAAa,UAAU;AAEvB,QAAM,iBAAiBA,WAAAA,OAAuB,EAAE;AAGhD,QAAM,kBAAkBA,WAAAA,OAAoC,IAAI;AAEhE,QAAM,gBAAgBA,WAAAA,OAAO,CAAC;AAE9BC,aAAAA,UAAU,MAAM;AACd,mBAAe,OAAO,aAAa;AAAA,EACrC,GAAG,CAAC,MAAM,CAAC;AAEX,QAAM,gBAAgBC,uBAAY,CAAC,WAAmB;AACpD,UAAM,UAAU,eAAe;AAC/B,mBAAe,UAAU,CAAA;AACzB,UAAM,SAA8B,EAAE,MAAM,QAAQ,OAAO,gBAAgB,QAAA;AAC3E,eAAW,WAAW,QAAS,SAAQ,MAAM;AAAA,EAC/C,GAAG,CAAA,CAAE;AAEL,QAAM,iBAAiBA,WAAAA,YAAY,MAAM;AACvC,eAAW,UAAU;AACrB,kBAAc,UAAU,OAAO;AAC/B,cAAU,UAAU;AACpB,cAAU,IAAI;AAAA,EAChB,GAAG,CAAA,CAAE;AAEL,QAAM,WAAWA,WAAAA,YAAY,MAAM;;AACjC,kBAAc,WAAW;AACzB,qBAAW,YAAX,mBAAoB;AACpB,mBAAA;AACA,kBAAc,UAAU;AACxB,kBAAc,EAAE;AAAA,EAClB,GAAG,CAAC,gBAAgB,aAAa,CAAC;AAElC,QAAM,oBAAoBA,WAAAA;AAAAA,IACxB,CAAC,gBAAsC;AACrCC,wBAAAA,kBAAkB,KAAK,sBAAsB;AAAA,QAC3C,OAAO;AAAA,QACP,MAAM,EAAE,OAAO,SAAS,QAAQ,OAAO,IAAI,MAAM,YAAY,KAAA;AAAA,MAAK,CACnE;AACD,sBAAgB,UAAU;AAC1B,eAAS,EAAE,MAAM,SAAS,OAAO,aAAa;AAAA,IAChD;AAAA,IACA,CAAC,OAAO,EAAE;AAAA,EAAA;AAGZ,QAAM,QAAQD,WAAAA,YAAY,MAAM;AAC9B,QAAI,WAAW,QAAS;AACxB,UAAM,aAAa,cAAc,UAAU;AAC3C,kBAAc,UAAU;AACxB,kBAAc,UAAU;AACxB,oBAAgB,UAAU;AAC1B,aAAS,EAAE,MAAM,SAAS;AAC1BC,sBAAAA,kBAAkB,KAAK,sBAAsB;AAAA,MAC3C,OAAO;AAAA,MACP,MAAM,EAAE,OAAO,SAAS,QAAQ,OAAO,GAAA;AAAA,IAAG,CAC3C;AAED,UAAM,MAAM,YAAY;AACtB,UAAI,aAAiC;AACrC,UAAI,eAAe;AACjB,YAAI;AACF,uBAAa,MAAM,eAAA;AAAA,QACrB,SAAS,OAAO;AACd,cAAI,cAAc,YAAY,YAAY;AACxC,0BAAc,UAAU;AACxB;AAAA,UACF;AACA,mBAAS;AAAA,YACP,MAAM;AAAA,YACN,OAAO;AAAA,cACL,MAAMC,gBAAAA,6BAA6B;AAAA,cACnC,SACE,iBAAiB,gBAAgB,MAAM,SAAS,kBAC5C,6BACA;AAAA,YAAA;AAAA,UACR,CACD;AACD;AAAA,QACF;AAAA,MACF;AACA,UAAI,cAAc,YAAY,YAAY;AACxC,sBAAc,UAAU;AACxB;AAAA,MACF;AACA,gBAAU,UAAU;AACpB,gBAAU,UAAU;AAMpB,UAAI,aAAa;AACjB,YAAM,aAAa,MAAM;;AACvB,qBAAa;AACb,cAAM,UAAU,SAAS;AACzB,cAAM,SAASC,eAAAA,WAAW,cAAc,OAAO;AAG/C,cAAM,gBACJ,eAAe,QAAQ,WAAW,KAAK,QAAQ,WAAWC,eAAAA,mBAAmB;AAG/E,iBAAS,EAAE,MAAM,SAAS;AAC1B,uBAAA;AACA,sBAAc,MAAM;AACpB,YAAI,cAAe,oBAAa,YAAb,sCAAuB;AAAA,MAC5C;AACA,UAAI;AACJ,UAAI;AACF,kBAAU,OAAO,MAAM;AAAA,UACrB,QAAQ;AAAA,UACR,MAAM,QAAQ,iBAAA;AAAA,UACd,WAAW;AAAA,YACT,cAAc,CAAC,WAAW;AACxB,kBAAI,cAAc,YAAY,WAAY;AAC1C,4BAAc,UAAU;AAAA,gBACtB,OAAOC,eAAAA,WAAW,cAAc,QAAQ,OAAO,OAAO,KAAK;AAAA,gBAC3D,SAAS,OAAO;AAAA,cAAA;AAElB,uBAAS,EAAE,MAAM,cAAc,OAAA,CAAQ;AAAA,YACzC;AAAA,YACA,SAAS,CAAC,gBAAgB;AACxB,kBAAI,cAAc,YAAY,WAAY;AAG1C,kBAAI,YAAY,SAASH,gBAAAA,6BAA6B,SAAU;AAChE,gCAAkB,WAAW;AAAA,YAC/B;AAAA,YACA,OAAO,MAAM;AACX,kBAAI,cAAc,YAAY,WAAY;AAC1C,yBAAA;AAAA,YACF;AAAA,UAAA;AAAA,QACF,CACD;AAAA,MACH,SAAS,OAAO;AAGd,uBAAA;AACA,0BAAkB;AAAA,UAChB,MAAMA,gBAAAA,6BAA6B;AAAA,UACnC,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AAAA,QAAA,CACnD;AACD;AAAA,MACF;AACA,UAAI,WAAY;AAChB,iBAAW,UAAU;AACrB,eAAS,EAAE,MAAM,aAAa;AAAA,IAChC;AACA,SAAK,IAAA;AAAA,EACP,GAAG,CAAC,eAAe,QAAQ,MAAM,gBAAgB,mBAAmB,aAAa,CAAC;AAElF,QAAM,OAAOF,WAAAA,YAAY,MAAoC;AAC3D,UAAM,UAAU,WAAW;AAC3B,QAAI,CAAC,SAAS;AAGZ,UAAI,SAAS,QAAQ,WAAWI,eAAAA,mBAAmB,UAAU;AAC3D,iBAAA;AACA,iBAAS,EAAE,MAAM,UAAU;AAC3B,eAAO,QAAQ,QAAQ,EAAE,MAAM,IAAI,OAAO,MAAM;AAAA,MAClD;AACA,aAAO,QAAQ,QAAQ,EAAE,MAAMD,eAAAA,WAAW,cAAc,OAAO,GAAG,OAAO,gBAAgB,QAAA,CAAS;AAAA,IACpG;AACA,aAAS,EAAE,MAAM,QAAQ;AACzB,UAAM,UAAU,IAAI,QAA6B,CAAC,YAAY;AAC5D,qBAAe,QAAQ,KAAK,OAAO;AACnC,aAAO,WAAW,MAAM;AAMtB,YAAI,WAAW,YAAY,SAAS;AAGlC,cAAI,CAACA,eAAAA,WAAW,cAAc,OAAO,GAAG;AACtC,8BAAkB;AAAA,cAChB,MAAMD,gBAAAA,6BAA6B;AAAA,cACnC,SAAS;AAAA,YAAA,CACV;AAAA,UACH;AACA,kBAAQ,MAAA;AACR,mBAAS,EAAE,MAAM,SAAS;AAC1B,yBAAA;AACA,wBAAcC,eAAAA,WAAW,cAAc,OAAO,CAAC;AAAA,QACjD;AAAA,MACF,GAAG,OAAO,kBAAkB,6BAA6B;AAAA,IAC3D,CAAC;AACD,YAAQ,KAAA;AACR,WAAO;AAAA,EACT,GAAG,CAAC,OAAO,gBAAgB,gBAAgB,mBAAmB,eAAe,QAAQ,CAAC;AAEtF,QAAM,SAASH,WAAAA,YAAY,MAAM;AAC/B,aAAA;AACA,aAAS,EAAE,MAAM,UAAU;AAAA,EAC7B,GAAG,CAAC,QAAQ,CAAC;AAGbD,aAAAA,UAAU,MAAM,MAAM,YAAY,CAAC,QAAQ,CAAC;AAE5C,QAAM,WACJ,MAAM,WAAWK,eAAAA,mBAAmB,YACpC,MAAM,WAAWA,eAAAA,mBAAmB,aACpC,MAAM,WAAWA,eAAAA,mBAAmB;AAEtC,SAAO;AAAA,IACL,QAAQ,MAAM;AAAA,IACd;AAAA,IACA,YAAY,MAAM;AAAA,IAClB,MAAMD,eAAAA,WAAW,MAAM,UAAU;AAAA,IACjC,OAAO,MAAM;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;;"}

package/dist/index.cjs

@@ -18,12 +18,18 @@ const GroupedMessageParts = require("./chat/super-grouping/GroupedMessageParts.c
 const groupingFunction = require("./chat/super-grouping/grouping-function.cjs");
 const SuperGroupingCard = require("./chat/super-grouping/SuperGroupingCard.cjs");
 const SuperGroupingTranscript = require("./chat/super-grouping/SuperGroupingTranscript.cjs");
+const toolPartPlacement = require("./chat/super-grouping/tool-part-placement.cjs");
 const turnSegments = require("./chat/super-grouping/turn-segments.cjs");
 const turnTiming = require("./chat/super-grouping/turn-timing.cjs");
 const toolkitMap = require("./chat/super-grouping/toolkit-map.cjs");
+const inlineTools = require("./tools/inline-tools.cjs");
 const StatewireApprovalCard = require("./chat/StatewireApprovalCard.cjs");
 const useStatewireApprovalRequest = require("./chat/use-statewire-approval-request.cjs");
+const deviceOperation = require("./chat/device-operation.cjs");
+const browserDecisionCheck = require("./chat/browser-decision-check.cjs");
 const useAthenaRunLive = require("./chat/use-athena-run-live.cjs");
+const useAthenaVoiceLive = require("./chat/use-athena-voice-live.cjs");
+const athenaTurnEndStatus = require("./chat/athena-turn-end-status.cjs");
 const statewireHistoryEdge = require("./chat-ui/thread/statewire-history-edge.cjs");
 const threadLoadingOverlay = require("./chat-ui/thread/thread-loading-overlay.cjs");
 const statewireWindowContext = require("./provider/statewire-window-context.cjs");
@@ -36,6 +42,7 @@ const statewireClientTools = require("./chat/statewire-client-tools.cjs");
 const statewireLifecycleContext = require("./provider/statewire-lifecycle-context.cjs");
 const statewireLifecycle = require("./runtime/statewire-lifecycle.cjs");
 const statewireThreadList = require("./threads/statewire-thread-list.cjs");
+const DrivingOnChip = require("./chat/DrivingOnChip.cjs");
 const WaitingOnYouBanner = require("./chat/WaitingOnYouBanner.cjs");
 const wakeMarker = require("./chat-ui/messages/wake-marker.cjs");
 const offlineHistory = require("./offline/offline-history.cjs");
@@ -56,7 +63,6 @@ const toolFallback = require("./tools/tool-fallback.cjs");
 const voiceUpdateToolUi = require("./tools/voice-update-tool-ui.cjs");
 const testRecordingToolUis = require("./tools/test-recording-tool-uis.cjs");
 const testRecordingReport = require("./tools/test-recording-report.cjs");
-const inlineTools = require("./tools/inline-tools.cjs");
 const voiceDelegationCard = require("./chat-ui/messages/voice-delegation-card.cjs");
 const NestedPtcMessages = require("./tools/NestedPtcMessages.cjs");
 const readAssetToolUi = require("./tools/read-asset-tool-ui.cjs");
@@ -91,6 +97,7 @@ const sessionsPageModel = require("./threads/sessions-page-model.cjs");
 const sessionListModel = require("./threads/session-list-model.cjs");
 const threadIdContext = require("./threads/thread-id-context.cjs");
 const useAthenaThreadModel = require("./threads/use-athena-thread-model.cjs");
+const sessionPersistenceContext = require("./provider/session-persistence-context.cjs");
 const api = require("./threads/api.cjs");
 const threadPrefetcher = require("./threads/thread-prefetcher.cjs");
 const useRestConversationHistory = require("./threads/use-rest-conversation-history.cjs");
@@ -102,6 +109,7 @@ const dictationEngine = require("./dictation/dictation-engine.cjs");
 const recordedDictationEngine = require("./dictation/recorded-dictation-engine.cjs");
 const useAthenaDictationEngine = require("./dictation/use-athena-dictation-engine.cjs");
 const dictationState = require("./dictation/dictation-state.cjs");
+const useChatVoiceEnabled = require("./voice/use-chat-voice-enabled.cjs");
 const useAppendToComposer = require("./composer/useAppendToComposer.cjs");
 const composerHandoff = require("./composer/composer-handoff.cjs");
 const useReadComposerDraft = require("./composer/useReadComposerDraft.cjs");
@@ -121,6 +129,7 @@ const athenaUrls = require("./lib/athena-urls.cjs");
 const button = require("./ui/button.cjs");
 const tooltip = require("./ui/tooltip.cjs");
 const collapsible = require("./ui/collapsible.cjs");
+const imageViewer = require("./ui/image-viewer.cjs");
 const lib_ownerDocument = require("./lib/owner-document.cjs");
 const a1 = require("./sheet-range/a1.cjs");
 const rangePreview = require("./sheet-range/range-preview.cjs");
@@ -173,6 +182,7 @@ exports.AthenaReasoningPart = AthenaChat.AthenaReasoningPart;
 exports.AthenaUserMessage = AthenaChat.AthenaUserMessage;
 exports.AthenaChatErrorBoundary = AthenaChatErrorBoundary.AthenaChatErrorBoundary;
 exports.buildActivityTimeline = activityTimeline.buildActivityTimeline;
+exports.countActivityDelegations = activityTimeline.countActivityDelegations;
 exports.countActivityTools = activityTimeline.countActivityTools;
 exports.excludeFinalTextFromGroups = activityTimeline.excludeFinalTextFromGroups;
 exports.excludePartsFromGroups = activityTimeline.excludePartsFromGroups;
@@ -194,15 +204,28 @@ exports.SuperGroupingFinalText = SuperGroupingCard.SuperGroupingFinalText;
 exports.resetRememberedExpansionsForTests = SuperGroupingCard.resetRememberedExpansionsForTests;
 exports.useActivityExpansion = SuperGroupingCard.useActivityExpansion;
 exports.SuperGroupingTranscript = SuperGroupingTranscript.SuperGroupingTranscript;
+exports.ToolPartPlacementProvider = toolPartPlacement.ToolPartPlacementProvider;
+exports.useToolPartPlacement = toolPartPlacement.useToolPartPlacement;
 exports.splitTurnSegments = turnSegments.splitTurnSegments;
 exports.formatWorkDuration = turnTiming.formatWorkDuration;
 exports.readTurnTiming = turnTiming.readTurnTiming;
 exports.workedDurationMs = turnTiming.workedDurationMs;
 exports.defaultGetToolGroupKey = toolkitMap.defaultGetToolGroupKey;
+exports.isSdkInlineTool = inlineTools.isSdkInlineTool;
 exports.StatewireApprovalCard = StatewireApprovalCard.StatewireApprovalCard;
 exports.useStatewireApprovalRequest = useStatewireApprovalRequest.useStatewireApprovalRequest;
 exports.useStatewireApprovalWait = useStatewireApprovalRequest.useStatewireApprovalWait;
+exports.DeviceOperationProvider = deviceOperation.DeviceOperationProvider;
+exports.UNREADABLE_DEVICE_OPERATION = deviceOperation.UNREADABLE_DEVICE_OPERATION;
+exports.deviceOperationStamp = deviceOperation.deviceOperationStamp;
+exports.useDeviceOperationReader = deviceOperation.useDeviceOperationReader;
+exports.agoraApiRoot = browserDecisionCheck.agoraApiRoot;
+exports.useAthenaBrowserDecisionConfirmer = browserDecisionCheck.useAthenaBrowserDecisionConfirmer;
+exports.useBrowserDecisionConfirmer = browserDecisionCheck.useBrowserDecisionConfirmer;
 exports.useAthenaRunLive = useAthenaRunLive.useAthenaRunLive;
+exports.useAthenaVoiceLive = useAthenaVoiceLive.useAthenaVoiceLive;
+exports.AthenaTurnEndStatus = athenaTurnEndStatus.AthenaTurnEndStatus;
+exports.useAthenaTurnEnded = athenaTurnEndStatus.useAthenaTurnEnded;
 exports.StatewireHistoryEdge = statewireHistoryEdge.StatewireHistoryEdge;
 exports.ThreadLoadingOverlay = threadLoadingOverlay.ThreadLoadingOverlay;
 exports.useStatewireToolOutputs = statewireWindowContext.useStatewireToolOutputs;
@@ -221,6 +244,7 @@ exports.athenaStatewireErrorNotice = statewireLifecycle.athenaStatewireErrorNoti
 exports.threadSummaryFromConversation = statewireThreadList.threadSummaryFromConversation;
 exports.useAthenaStatewireThreadList = statewireThreadList.useAthenaStatewireThreadList;
 exports.useRefreshThreadList = statewireThreadList.useRefreshThreadList;
+exports.DrivingOnChip = DrivingOnChip.DrivingOnChip;
 exports.WaitingOnYouBanner = WaitingOnYouBanner.WaitingOnYouBanner;
 exports.WaitingOnYouBannerView = WaitingOnYouBanner.WaitingOnYouBannerView;
 exports.WakeMarkerCard = wakeMarker.WakeMarkerCard;
@@ -306,7 +330,6 @@ exports.describeTestRecordingStart = testRecordingReport.describeTestRecordingSt
 exports.formatRecordingClock = testRecordingReport.formatRecordingClock;
 exports.formatTestRecordingCounts = testRecordingReport.formatTestRecordingCounts;
 exports.parseTestRecordingStopResult = testRecordingReport.parseTestRecordingStopResult;
-exports.isSdkInlineTool = inlineTools.isSdkInlineTool;
 exports.VoiceDelegationCard = voiceDelegationCard.VoiceDelegationCard;
 exports.VoiceDelegationMessage = voiceDelegationCard.VoiceDelegationMessage;
 exports.NestedPtcComponentsProvider = NestedPtcMessages.NestedPtcComponentsProvider;
@@ -426,6 +449,7 @@ exports.AthenaThreadIdContext = threadIdContext.AthenaThreadIdContext;
 exports.useAthenaStatewireThreadId = threadIdContext.useAthenaStatewireThreadId;
 exports.useAthenaThreadId = threadIdContext.useAthenaThreadId;
 exports.useAthenaThreadModel = useAthenaThreadModel.useAthenaThreadModel;
+exports.useAthenaSessionPersistence = sessionPersistenceContext.useAthenaSessionPersistence;
 exports.THREAD_TITLE_MAX_LENGTH = api.THREAD_TITLE_MAX_LENGTH;
 exports.archiveThread = api.archiveThread;
 exports.createThread = api.createThread;
@@ -454,10 +478,12 @@ exports.createRecordedDictationEngine = recordedDictationEngine.createRecordedDi
 exports.useAthenaDictationEngine = useAthenaDictationEngine.useAthenaDictationEngine;
 exports.DICTATION_STATUSES = dictationState.DICTATION_STATUSES;
 exports.composeDictationDraft = dictationState.composeDictationDraft;
+exports.useChatVoiceEnabled = useChatVoiceEnabled.useChatVoiceEnabled;
 exports.useAppendToComposer = useAppendToComposer.useAppendToComposer;
 exports.useComposerReady = composerHandoff.useComposerReady;
 exports.useFocusComposer = composerHandoff.useFocusComposer;
 exports.useReadComposerDraft = useReadComposerDraft.useReadComposerDraft;
+exports.useTryReadComposerDraft = useReadComposerDraft.useTryReadComposerDraft;
 exports.useSendMessage = useSendMessage.useSendMessage;
 exports.useComposerAttachment = useComposerAttachment.useComposerAttachment;
 exports.ChatAgentPicker = chatPickers.ChatAgentPicker;
@@ -502,6 +528,7 @@ exports.TooltipTrigger = tooltip.TooltipTrigger;
 exports.Collapsible = collapsible.Collapsible;
 exports.CollapsibleContent = collapsible.CollapsibleContent;
 exports.CollapsibleTrigger = collapsible.CollapsibleTrigger;
+exports.ImageViewer = imageViewer.ImageViewer;
 exports.OwnerDocumentProvider = lib_ownerDocument.OwnerDocumentProvider;
 exports.useIsInPopoutDocument = lib_ownerDocument.useIsInPopoutDocument;
 exports.useOwnerDocument = lib_ownerDocument.useOwnerDocument;

package/dist/index.cjs.map

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

package/dist/index.d.ts

@@ -20,15 +20,21 @@ export { AthenaAssistantActionBar, AthenaAssistantMessage, AthenaChat, AthenaRea
 export type { AthenaAssistantActionBarProps, AthenaAssistantMessageProps, AthenaChatComponents, AthenaChatMessagePartComponents, AthenaChatProps, AthenaChatVoiceOptions, AthenaReasoningPartProps, AthenaUserMessageProps, } from './chat/AthenaChat';
 export type { WelcomeSuggestion } from './chat/athena-chat-welcome';
 export { AthenaChatErrorBoundary } from './chat/AthenaChatErrorBoundary';
-export { type ActivityItem, type ActivityPhase, type ActivityTimelineOptions, type ActivityToolState, buildActivityTimeline, CollapsibleGroup, type CollapsibleGroupProps, countActivityTools, createToolBasedGroupingFunction, DEFAULT_TOOLKIT_THEME, defaultGetToolGroupKey, excludeFinalTextFromGroups, excludePartsFromGroups, type FinalTextPart, type FinalTextSegment, formatWorkDuration, getActivityItemLabel, getActivitySummary, getActivityToolState, getFinalText, getFinalTextParts, getReasoningLabel, type GetToolGroupKey, type GroupablePart, GroupedMessageParts, type GroupedMessagePartsProps, type GroupingFunction, type MessagePartGroup, readTurnTiming, resetRememberedExpansionsForTests, resolveActivityPhase, splitTurnSegments, SuperGroupingCard, type SuperGroupingCardProps, SuperGroupingFinalText, SuperGroupingProvider, SuperGroupingTranscript, type SuperGroupingTranscriptProps, TOOLKIT_THEMES, type ToolGroupKeyOptions, type ToolkitTheme, type TurnSegment, type TurnTiming, useActivityExpansion, workedDurationMs, } from './chat/super-grouping';
+export { type ActivityItem, type ActivityPhase, type ActivityTimelineOptions, type ActivityToolState, buildActivityTimeline, CollapsibleGroup, type CollapsibleGroupProps, countActivityDelegations, countActivityTools, createToolBasedGroupingFunction, DEFAULT_TOOLKIT_THEME, defaultGetToolGroupKey, excludeFinalTextFromGroups, excludePartsFromGroups, type FinalTextPart, type FinalTextSegment, formatWorkDuration, getActivityItemLabel, getActivitySummary, getActivityToolState, getFinalText, getFinalTextParts, getReasoningLabel, type GetToolGroupKey, type GroupablePart, GroupedMessageParts, type GroupedMessagePartsProps, type GroupingFunction, type MessagePartGroup, readTurnTiming, resetRememberedExpansionsForTests, resolveActivityPhase, splitTurnSegments, SuperGroupingCard, type SuperGroupingCardProps, SuperGroupingFinalText, SuperGroupingProvider, SuperGroupingTranscript, type SuperGroupingTranscriptProps, TOOLKIT_THEMES, type ToolGroupKeyOptions, type ToolkitTheme, type ToolPartPlacement, ToolPartPlacementProvider, type TurnSegment, type TurnTiming, useActivityExpansion, useToolPartPlacement, workedDurationMs, } from './chat/super-grouping';
 export { StatewireApprovalCard } from './chat/StatewireApprovalCard';
-export type { StatewireApprovalCardProps, StatewireApprovalEditorContext, StatewireApprovalRequestContext, } from './chat/StatewireApprovalCard';
+export type { StatewireApprovalCardProps, StatewireApprovalEditorContext, StatewireApprovalRequestContext, StatewireDecisionAnswer, StatewireDecisionConfirmer, } from './chat/StatewireApprovalCard';
 export { useStatewireApprovalRequest } from './chat/use-statewire-approval-request';
+export { DeviceOperationProvider, deviceOperationStamp, UNREADABLE_DEVICE_OPERATION, useDeviceOperationReader, } from './chat/device-operation';
+export type { DeviceOperationReader } from './chat/device-operation';
+export { agoraApiRoot, useAthenaBrowserDecisionConfirmer, useBrowserDecisionConfirmer, } from './chat/browser-decision-check';
+export type { AthenaBrowserDecisionConfirmerOptions, BrowserDecisionConfirmerOptions, PendingBrowserDecisionConfirm, } from './chat/browser-decision-check';
 export type { StatewireApprovalRequest, StatewireInterruptPredicate, UseStatewireApprovalRequestOptions, } from './chat/use-statewire-approval-request';
 export { useStatewireApprovalWait } from './chat/use-statewire-approval-request';
 export type { StatewireApprovalWait } from './chat/use-statewire-approval-request';
 export { useTurnToolCallsAwaitingApproval } from './agent-runtime/src/index';
 export { useAthenaRunLive } from './chat/use-athena-run-live';
+export { useAthenaVoiceLive } from './chat/use-athena-voice-live';
+export { AthenaTurnEndStatus, type AthenaTurnEndStatusProps, useAthenaTurnEnded, } from './chat/athena-turn-end-status';
 export { StatewireHistoryEdge } from './chat-ui/thread/statewire-history-edge';
 export type { StatewireHistoryEdgeProps } from './chat-ui/thread/statewire-history-edge';
 export { ThreadLoadingOverlay } from './chat-ui/thread/thread-loading-overlay';
@@ -50,6 +56,8 @@ export { athenaStatewireErrorNotice } from './runtime/statewire-lifecycle';
 export type { AthenaStatewireErrorNotice, AthenaStatewireLifecycleState, } from './runtime/statewire-lifecycle';
 export { threadSummaryFromConversation, useAthenaStatewireThreadList, } from './threads/statewire-thread-list';
 export type { AthenaStatewireThreadListState, AthenaStatewireThreadSummary, } from './threads/statewire-thread-list';
+export { DrivingOnChip } from './chat/DrivingOnChip';
+export type { DrivingOnChipProps } from './chat/DrivingOnChip';
 export { WaitingOnYouBanner, WaitingOnYouBannerView } from './chat/WaitingOnYouBanner';
 export type { WaitingOnYouBannerProps, WaitingOnYouBannerViewProps, } from './chat/WaitingOnYouBanner';
 export { WakeMarkerCard, WakeMarkerMessage } from './chat-ui/messages/wake-marker';
@@ -158,6 +166,8 @@ export type { ThreadFavoriteResponse, ThreadInboxDismissResponse, ThreadListFilt
 export { useRefreshThreadList } from './threads/statewire-thread-list';
 export { useAthenaThreadId, AthenaThreadIdContext, useAthenaStatewireThreadId, } from './threads/thread-id-context';
 export { useAthenaThreadModel } from './threads/use-athena-thread-model';
+export { useAthenaSessionPersistence } from './provider/session-persistence-context';
+export type { AthenaSessionPersistence } from './provider/session-persistence-context';
 export type { AthenaThreadModel } from './threads/use-athena-thread-model';
 export { listThreads, archiveThread, getThreadState, createThread, renameThread, setThreadReadState, setThreadFavorite, dismissThreadFromInbox, isThreadArchiveUnavailableError, isThreadFavoriteUnavailableError, isThreadRenameUnavailableError, THREAD_TITLE_MAX_LENGTH, } from './threads/api';
 export type { ThreadFavoriteTarget } from './threads/use-thread-favorite';
@@ -178,11 +188,13 @@ export type { DictationTranscribeContext, DictationTranscriber, RecordedDictatio
 export { useAthenaDictationEngine } from './dictation/use-athena-dictation-engine';
 export { composeDictationDraft, DICTATION_STATUSES } from './dictation/dictation-state';
 export type { DictationStatus, DictationTranscript } from './dictation/dictation-state';
-export type { AthenaChatComposerSlots, AthenaChatDictationOptions } from './chat/AthenaChat';
+export type { AthenaChatComposerSlots, AthenaChatContinueByVoice, AthenaChatDictationOptions, } from './chat/AthenaChat';
+/** Whether the chat's voice control shows for this sign-in: the gate `AthenaChat`'s mic uses. */
+export { useChatVoiceEnabled } from './voice/use-chat-voice-enabled';
 export { useAppendToComposer } from './composer/useAppendToComposer';
 export type { AppendToComposerOptions } from './composer/useAppendToComposer';
 export { useComposerReady, useFocusComposer } from './composer/composer-handoff';
-export { useReadComposerDraft } from './composer/useReadComposerDraft';
+export { useReadComposerDraft, useTryReadComposerDraft } from './composer/useReadComposerDraft';
 export { useSendMessage } from './composer/useSendMessage';
 export type { SendMessageOptions } from './composer/useSendMessage';
 export { useComposerAttachment } from './composer/useComposerAttachment';
@@ -218,6 +230,8 @@ export type { AthenaEnvironment } from './lib/athena-urls';
 export { Button, buttonVariants } from './ui/button';
 export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider } from './ui/tooltip';
 export { Collapsible, CollapsibleTrigger, CollapsibleContent } from './ui/collapsible';
+export { ImageViewer } from './ui/image-viewer';
+export type { ImageViewerImage, ImageViewerProps } from './ui/image-viewer';
 export { OwnerDocumentProvider, useIsInPopoutDocument, useOwnerDocument, usePortalContainer, } from './lib/owner-document';
 export type { OwnerDocumentProviderProps } from './lib/owner-document';
 export { a1AnchorCell, a1RangeBounds, columnLettersToNumber, columnNumberToLetters, formatA1Cell, formatA1Range, parseA1Range, RANGE_PREVIEW_MAX_COLUMNS, RANGE_PREVIEW_MAX_ROWS, RangePreviewTable, rangePreviewFromCellMap, rangePreviewFromRows, rangePreviewToTableData, SHEET_MAX_COLUMN, SHEET_MAX_ROW, splitSheetPrefix, } from './sheet-range';

package/dist/index.js

@@ -10,18 +10,24 @@ import { capturePosthogEvent, capturePosthogException, getPosthogCaptureGate, wr
 import { buildCoalescedCaptureProperties, isCriticalPosthogEvent, withCaptureGateBypass } from "./lib/posthog/capture-gate.js";
 import { AthenaAssistantActionBar, AthenaAssistantMessage, AthenaChat, AthenaReasoningPart, AthenaUserMessage } from "./chat/AthenaChat.js";
 import { AthenaChatErrorBoundary } from "./chat/AthenaChatErrorBoundary.js";
-import { buildActivityTimeline, countActivityTools, excludeFinalTextFromGroups, excludePartsFromGroups, getActivityItemLabel, getActivitySummary, getActivityToolState, getFinalText, getFinalTextParts, getReasoningLabel, resolveActivityPhase } from "./chat/super-grouping/activity-timeline.js";
+import { buildActivityTimeline, countActivityDelegations, countActivityTools, excludeFinalTextFromGroups, excludePartsFromGroups, getActivityItemLabel, getActivitySummary, getActivityToolState, getFinalText, getFinalTextParts, getReasoningLabel, resolveActivityPhase } from "./chat/super-grouping/activity-timeline.js";
 import { CollapsibleGroup, DEFAULT_TOOLKIT_THEME, SuperGroupingProvider, TOOLKIT_THEMES } from "./chat/super-grouping/CollapsibleGroup.js";
 import { GroupedMessageParts } from "./chat/super-grouping/GroupedMessageParts.js";
 import { createToolBasedGroupingFunction } from "./chat/super-grouping/grouping-function.js";
 import { SuperGroupingCard, SuperGroupingFinalText, resetRememberedExpansionsForTests, useActivityExpansion } from "./chat/super-grouping/SuperGroupingCard.js";
 import { SuperGroupingTranscript } from "./chat/super-grouping/SuperGroupingTranscript.js";
+import { ToolPartPlacementProvider, useToolPartPlacement } from "./chat/super-grouping/tool-part-placement.js";
 import { splitTurnSegments } from "./chat/super-grouping/turn-segments.js";
 import { formatWorkDuration, readTurnTiming, workedDurationMs } from "./chat/super-grouping/turn-timing.js";
 import { defaultGetToolGroupKey } from "./chat/super-grouping/toolkit-map.js";
+import { isSdkInlineTool } from "./tools/inline-tools.js";
 import { StatewireApprovalCard } from "./chat/StatewireApprovalCard.js";
 import { useStatewireApprovalRequest, useStatewireApprovalWait } from "./chat/use-statewire-approval-request.js";
+import { DeviceOperationProvider, UNREADABLE_DEVICE_OPERATION, deviceOperationStamp, useDeviceOperationReader } from "./chat/device-operation.js";
+import { agoraApiRoot, useAthenaBrowserDecisionConfirmer, useBrowserDecisionConfirmer } from "./chat/browser-decision-check.js";
 import { useAthenaRunLive } from "./chat/use-athena-run-live.js";
+import { useAthenaVoiceLive } from "./chat/use-athena-voice-live.js";
+import { AthenaTurnEndStatus, useAthenaTurnEnded } from "./chat/athena-turn-end-status.js";
 import { StatewireHistoryEdge } from "./chat-ui/thread/statewire-history-edge.js";
 import { ThreadLoadingOverlay } from "./chat-ui/thread/thread-loading-overlay.js";
 import { useStatewireToolOutputs } from "./provider/statewire-window-context.js";
@@ -34,6 +40,7 @@ import { collectStatewireClientTools, statewireClientToolWireEntries } from "./c
 import { useAthenaStatewireLifecycle } from "./provider/statewire-lifecycle-context.js";
 import { athenaStatewireErrorNotice } from "./runtime/statewire-lifecycle.js";
 import { threadSummaryFromConversation, useAthenaStatewireThreadList, useRefreshThreadList } from "./threads/statewire-thread-list.js";
+import { DrivingOnChip } from "./chat/DrivingOnChip.js";
 import { WaitingOnYouBanner, WaitingOnYouBannerView } from "./chat/WaitingOnYouBanner.js";
 import { WakeMarkerCard, WakeMarkerMessage } from "./chat-ui/messages/wake-marker.js";
 import { OFFLINE_SNAPSHOT_READ_WAIT_MS, OfflineSnapshotBanner, formatOfflineSnapshotTime, useAthenaOfflineSnapshotAt } from "./offline/offline-history.js";
@@ -54,7 +61,6 @@ import { ToolFallback, ToolFallbackAppearanceProvider, ToolFallbackArgs, ToolFal
 import { VoiceUpdateCard, VoiceUpdateToolUI } from "./tools/voice-update-tool-ui.js";
 import { TestRecordingMarkToolUI, TestRecordingReportCard, TestRecordingStartToolUI, TestRecordingStopToolUI } from "./tools/test-recording-tool-uis.js";
 import { TEST_RECORDING_MARK_TOOL, TEST_RECORDING_START_TOOL, TEST_RECORDING_STOP_TOOL, describeTestRecordingMark, describeTestRecordingStart, formatRecordingClock, formatTestRecordingCounts, parseTestRecordingStopResult } from "./tools/test-recording-report.js";
-import { isSdkInlineTool } from "./tools/inline-tools.js";
 import { VoiceDelegationCard, VoiceDelegationMessage } from "./chat-ui/messages/voice-delegation-card.js";
 import { NestedPtcComponentsProvider, NestedPtcMessages, useNestedPtcComponents } from "./tools/NestedPtcMessages.js";
 import { ReadAssetToolUI } from "./tools/read-asset-tool-ui.js";
@@ -89,6 +95,7 @@ import { SESSIONS_COLUMNS, agentLabel, channelLabel, creatorLabel, groupSessions
 import { WEB_APP_ORIGIN_LABEL, groupSessions, orderedPullRequests, pullRequestChip, pullRequestChipState, sessionIndicator, sessionListGroupOf, sessionOriginBadge, sessionOriginLabel, sessionSecondaryLine } from "./threads/session-list-model.js";
 import { AthenaThreadIdContext, useAthenaStatewireThreadId, useAthenaThreadId } from "./threads/thread-id-context.js";
 import { useAthenaThreadModel } from "./threads/use-athena-thread-model.js";
+import { useAthenaSessionPersistence } from "./provider/session-persistence-context.js";
 import { THREAD_TITLE_MAX_LENGTH, archiveThread, createThread, dismissThreadFromInbox, getThreadState, isThreadArchiveUnavailableError, isThreadFavoriteUnavailableError, isThreadRenameUnavailableError, listThreads, renameThread, setThreadFavorite, setThreadReadState } from "./threads/api.js";
 import { THREAD_PREFETCH_HOVER_DELAY_MS, THREAD_PREFETCH_MAX_CONCURRENT } from "./threads/thread-prefetcher.js";
 import { conversationDisplayTitle, useRestConversationHistory } from "./threads/use-rest-conversation-history.js";
@@ -100,9 +107,10 @@ import { DICTATION_ENGINE_ERROR_KINDS, createWebSpeechDictationEngine } from "./
 import { createRecordedDictationEngine } from "./dictation/recorded-dictation-engine.js";
 import { useAthenaDictationEngine } from "./dictation/use-athena-dictation-engine.js";
 import { DICTATION_STATUSES, composeDictationDraft } from "./dictation/dictation-state.js";
+import { useChatVoiceEnabled } from "./voice/use-chat-voice-enabled.js";
 import { useAppendToComposer } from "./composer/useAppendToComposer.js";
 import { useComposerReady, useFocusComposer } from "./composer/composer-handoff.js";
-import { useReadComposerDraft } from "./composer/useReadComposerDraft.js";
+import { useReadComposerDraft, useTryReadComposerDraft } from "./composer/useReadComposerDraft.js";
 import { useSendMessage } from "./composer/useSendMessage.js";
 import { useComposerAttachment } from "./composer/useComposerAttachment.js";
 import { ChatAgentPicker, ChatModePicker, ChatModelPicker } from "./catalog/chat-pickers.js";
@@ -119,6 +127,7 @@ import { DEFAULT_APP_URL, DEFAULT_STATEWIRE_SYNC_URL, athenaLinkAppUrl, createAt
 import { Button, buttonVariants } from "./ui/button.js";
 import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "./ui/tooltip.js";
 import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "./ui/collapsible.js";
+import { ImageViewer } from "./ui/image-viewer.js";
 import { OwnerDocumentProvider, useIsInPopoutDocument, useOwnerDocument, usePortalContainer } from "./lib/owner-document.js";
 import { SHEET_MAX_COLUMN, SHEET_MAX_ROW, a1AnchorCell, a1RangeBounds, columnLettersToNumber, columnNumberToLetters, formatA1Cell, formatA1Range, parseA1Range, splitSheetPrefix } from "./sheet-range/a1.js";
 import { RANGE_PREVIEW_MAX_COLUMNS, RANGE_PREVIEW_MAX_ROWS, rangePreviewFromCellMap, rangePreviewFromRows, rangePreviewToTableData } from "./sheet-range/range-preview.js";
@@ -153,6 +162,7 @@ export {
   AthenaReasoningPart,
   AthenaSdkError,
   AthenaThreadIdContext,
+  AthenaTurnEndStatus,
   AthenaUserMessage,
   AttachmentProvider,
   BrowseToolUI,
@@ -187,8 +197,10 @@ export {
   DICTATION_ENGINE_ERROR_KINDS,
   DICTATION_STATUSES,
   DescribeDatabaseToolUI,
+  DeviceOperationProvider,
   DictationStrip,
   DictationWaveform,
+  DrivingOnChip,
   EditFileToolUI,
   EmailSearchToolUI,
   ExpandableSection,
@@ -200,6 +212,7 @@ export {
   INBOX_PAGE_SIZE,
   INBOX_QUERY,
   INBOX_UNREAD_QUERY,
+  ImageViewer,
   Inbox,
   InboxButton,
   InstallPackageToolUI,
@@ -287,12 +300,14 @@ export {
   ToolFallbackResult,
   ToolFallbackRoot,
   ToolFallbackTrigger,
+  ToolPartPlacementProvider,
   Toolkits,
   Tooltip,
   TooltipContent,
   TooltipIconButton,
   TooltipProvider,
   TooltipTrigger,
+  UNREADABLE_DEVICE_OPERATION,
   UpdateSheetRangeToolUI,
   VoiceDelegationCard,
   VoiceDelegationMessage,
@@ -309,6 +324,7 @@ export {
   a1AnchorCell,
   a1RangeBounds,
   agentLabel,
+  agoraApiRoot,
   appendCitationReferenceParams,
   archiveThread,
   asHitlApproval,
@@ -341,6 +357,7 @@ export {
   computerStatusPath,
   conversationDisplayTitle,
   conversationSummaryFromIndexEntry,
+  countActivityDelegations,
   countActivityTools,
   countChatOutboxMessages,
   createAssetToolUI,
@@ -364,6 +381,7 @@ export {
   describeTestRecordingMark,
   describeTestRecordingStart,
   describeToolArgs,
+  deviceOperationStamp,
   dismissThreadFromInbox,
   excludeFinalTextFromGroups,
   excludePartsFromGroups,
@@ -492,6 +510,7 @@ export {
   useAthenaAgentCatalog,
   useAthenaAgentModelOptions,
   useAthenaAssetContent,
+  useAthenaBrowserDecisionConfirmer,
   useAthenaChatMode,
   useAthenaCitationLinkHandler,
   useAthenaComputerSshAccess,
@@ -506,6 +525,7 @@ export {
   useAthenaRepoSearch,
   useAthenaRunLive,
   useAthenaSessionAttention,
+  useAthenaSessionPersistence,
   useAthenaSessionWorkspace,
   useAthenaSessions,
   useAthenaStatewireLifecycle,
@@ -515,9 +535,14 @@ export {
   useAthenaThreadId,
   useAthenaThreadManager,
   useAthenaThreadModel,
+  useAthenaTurnEnded,
+  useAthenaVoiceLive,
   useAttachments,
+  useBrowserDecisionConfirmer,
+  useChatVoiceEnabled,
   useComposerAttachment,
   useComposerReady,
+  useDeviceOperationReader,
   useDictation,
   useFileUpload,
   useFocusComposer,
@@ -542,6 +567,8 @@ export {
   useStatewireHistory,
   useStatewireToolOutputs,
   useToolAppearance,
+  useToolPartPlacement,
+  useTryReadComposerDraft,
   useTurnToolCallsAwaitingApproval,
   windowInFrontSignal,
   withCaptureGateBypass,

package/dist/index.js.map

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

package/dist/keryx-http/src/receive-only-socket.cjs

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const updateAttributions = require("./update-attributions.cjs");
+const MESSAGE_SYNC = 0;
+const MESSAGE_SYNC_STEP_1 = 0;
+function isDocContentFrame(frame) {
+  const type = updateAttributions.readVarUint({ bytes: frame, start: 0 });
+  if ((type == null ? void 0 : type.value) !== MESSAGE_SYNC) return false;
+  const syncType = updateAttributions.readVarUint({ bytes: frame, start: type.next });
+  if ((syncType == null ? void 0 : syncType.value) !== MESSAGE_SYNC_STEP_1) return true;
+  const length = updateAttributions.readVarUint({ bytes: frame, start: syncType.next });
+  return length === null || length.next + length.value !== frame.length;
+}
+function frameBytes(data) {
+  if (data instanceof Uint8Array) return data;
+  if (ArrayBuffer.isView(data))
+    return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+  if (data instanceof ArrayBuffer) return new Uint8Array(data);
+  return null;
+}
+function receiveOnlyWebSocket({
+  Base
+}) {
+  if (typeof Base !== "function") return Base;
+  return new Proxy(Base, {
+    construct(target, args) {
+      const socket = Reflect.construct(target, args);
+      const send = socket.send.bind(socket);
+      socket.send = (data) => {
+        const bytes = frameBytes(data);
+        if (bytes === null || isDocContentFrame(bytes)) return;
+        send(data);
+      };
+      return socket;
+    }
+  });
+}
+exports.isDocContentFrame = isDocContentFrame;
+exports.receiveOnlyWebSocket = receiveOnlyWebSocket;
+//# sourceMappingURL=receive-only-socket.cjs.map