@athenaintel/react 0.42.2 → 0.48.0

package/dist/dictation/audio-level-history.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"audio-level-history.cjs","sources":["../../src/dictation/audio-level-history.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/**\n * A rolling window of microphone levels (0..1), newest last, for the\n * composer's waveform strip. `size` slots are always present: unfilled slots\n * are `null` so the strip can draw them as the resting dotted baseline.\n */\nexport type AudioLevelHistory = ReadonlyArray<number | null>;\n\nexport function emptyAudioLevelHistory(size: number): AudioLevelHistory {\n  return new Array<number | null>(Math.max(0, size)).fill(null);\n}\n\n/** Append one level, dropping the oldest slot. Pure. */\nexport function pushAudioLevel(history: AudioLevelHistory, level: number): AudioLevelHistory {\n  if (history.length === 0) return history;\n  const clamped = Math.min(1, Math.max(0, level));\n  return [...history.slice(1), clamped];\n}\n\n/**\n * RMS of a PCM sample window scaled to 0..1 for display. Speech peaks sit\n * around 0.1-0.3 RMS, so a gain lifts them into the visible range while the\n * noise floor (about 0.005) stays flat.\n */\nexport function displayLevelFromSamples(samples: ArrayLike<number>, gain = 4): number {\n  if (samples.length === 0) return 0;\n  let sum = 0;\n  for (let i = 0; i < samples.length; i += 1) {\n    const sample = samples[i] ?? 0;\n    sum += sample * sample;\n  }\n  const rms = Math.sqrt(sum / samples.length);\n  return Math.min(1, rms * gain);\n}\n\ninterface UseAudioLevelHistoryOptions {\n  /** Number of bars in the strip. */\n  size: number;\n  /** Sample cadence in ms; 50ms gives ~20 bars per second. */\n  intervalMs?: number;\n}\n\n/**\n * Sample a `MediaStream` through an `AnalyserNode` into a rolling level\n * history. Returns the resting baseline when `stream` is null.\n */\nexport function useAudioLevelHistory(\n  stream: MediaStream | null,\n  { size, intervalMs = 50 }: UseAudioLevelHistoryOptions,\n): AudioLevelHistory {\n  const [history, setHistory] = useState<AudioLevelHistory>(() => emptyAudioLevelHistory(size));\n\n  useEffect(() => {\n    setHistory(emptyAudioLevelHistory(size));\n    if (!stream || typeof window === 'undefined') return;\n    const AudioContextCtor =\n      window.AudioContext ??\n      (window as typeof window & { webkitAudioContext?: typeof AudioContext }).webkitAudioContext;\n    if (!AudioContextCtor) return;\n\n    let audioContext: AudioContext;\n    try {\n      audioContext = new AudioContextCtor();\n    } catch {\n      return;\n    }\n    const analyser = audioContext.createAnalyser();\n    analyser.fftSize = 1024;\n    analyser.smoothingTimeConstant = 0;\n    let source: MediaStreamAudioSourceNode | null = null;\n    try {\n      source = audioContext.createMediaStreamSource(stream);\n      source.connect(analyser);\n    } catch {\n      void audioContext.close();\n      return;\n    }\n    const samples = new Float32Array(analyser.fftSize);\n    const interval = window.setInterval(() => {\n      analyser.getFloatTimeDomainData(samples);\n      const level = displayLevelFromSamples(samples);\n      setHistory((current) => pushAudioLevel(current, level));\n    }, intervalMs);\n\n    return () => {\n      window.clearInterval(interval);\n      try {\n        source?.disconnect();\n        analyser.disconnect();\n      } catch {\n        // Already disconnected.\n      }\n      void audioContext.close();\n    };\n  }, [stream, size, intervalMs]);\n\n  return history;\n}\n"],"names":["useState","useEffect"],"mappings":";;;AASO,SAAS,uBAAuB,MAAiC;AACtE,SAAO,IAAI,MAAqB,KAAK,IAAI,GAAG,IAAI,CAAC,EAAE,KAAK,IAAI;AAC9D;AAGO,SAAS,eAAe,SAA4B,OAAkC;AAC3F,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAM,UAAU,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,KAAK,CAAC;AAC9C,SAAO,CAAC,GAAG,QAAQ,MAAM,CAAC,GAAG,OAAO;AACtC;AAOO,SAAS,wBAAwB,SAA4B,OAAO,GAAW;AACpF,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,MAAI,MAAM;AACV,WAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK,GAAG;AAC1C,UAAM,SAAS,QAAQ,CAAC,KAAK;AAC7B,WAAO,SAAS;AAAA,EAClB;AACA,QAAM,MAAM,KAAK,KAAK,MAAM,QAAQ,MAAM;AAC1C,SAAO,KAAK,IAAI,GAAG,MAAM,IAAI;AAC/B;AAaO,SAAS,qBACd,QACA,EAAE,MAAM,aAAa,MACF;AACnB,QAAM,CAAC,SAAS,UAAU,IAAIA,MAAAA,SAA4B,MAAM,uBAAuB,IAAI,CAAC;AAE5FC,QAAAA,UAAU,MAAM;AACd,eAAW,uBAAuB,IAAI,CAAC;AACvC,QAAI,CAAC,UAAU,OAAO,WAAW,YAAa;AAC9C,UAAM,mBACJ,OAAO,gBACN,OAAwE;AAC3E,QAAI,CAAC,iBAAkB;AAEvB,QAAI;AACJ,QAAI;AACF,qBAAe,IAAI,iBAAA;AAAA,IACrB,QAAQ;AACN;AAAA,IACF;AACA,UAAM,WAAW,aAAa,eAAA;AAC9B,aAAS,UAAU;AACnB,aAAS,wBAAwB;AACjC,QAAI,SAA4C;AAChD,QAAI;AACF,eAAS,aAAa,wBAAwB,MAAM;AACpD,aAAO,QAAQ,QAAQ;AAAA,IACzB,QAAQ;AACN,WAAK,aAAa,MAAA;AAClB;AAAA,IACF;AACA,UAAM,UAAU,IAAI,aAAa,SAAS,OAAO;AACjD,UAAM,WAAW,OAAO,YAAY,MAAM;AACxC,eAAS,uBAAuB,OAAO;AACvC,YAAM,QAAQ,wBAAwB,OAAO;AAC7C,iBAAW,CAAC,YAAY,eAAe,SAAS,KAAK,CAAC;AAAA,IACxD,GAAG,UAAU;AAEb,WAAO,MAAM;AACX,aAAO,cAAc,QAAQ;AAC7B,UAAI;AACF,yCAAQ;AACR,iBAAS,WAAA;AAAA,MACX,QAAQ;AAAA,MAER;AACA,WAAK,aAAa,MAAA;AAAA,IACpB;AAAA,EACF,GAAG,CAAC,QAAQ,MAAM,UAAU,CAAC;AAE7B,SAAO;AACT;;;;;"}
+{"version":3,"file":"audio-level-history.cjs","sources":["../../src/dictation/audio-level-history.ts"],"sourcesContent":["import { useEffect, useState } from 'react';\n\n/**\n * A rolling window of microphone levels (0..1), newest last, for the\n * composer's waveform strip. `size` slots are always present: unfilled slots\n * are `null` so the strip can draw them as the resting dotted baseline.\n */\nexport type AudioLevelHistory = ReadonlyArray<number | null>;\n\nexport function emptyAudioLevelHistory(size: number): AudioLevelHistory {\n  return new Array<number | null>(Math.max(0, size)).fill(null);\n}\n\n/** Append one level, dropping the oldest slot. Pure. */\nexport function pushAudioLevel(history: AudioLevelHistory, level: number): AudioLevelHistory {\n  if (history.length === 0) return history;\n  const clamped = Math.min(1, Math.max(0, level));\n  return [...history.slice(1), clamped];\n}\n\n/**\n * RMS of a PCM sample window scaled to 0..1 for display. Speech peaks sit\n * around 0.1-0.3 RMS, so a gain lifts them into the visible range while the\n * noise floor (about 0.005) stays flat.\n */\nexport function displayLevelFromSamples(samples: ArrayLike<number>, gain = 4): number {\n  if (samples.length === 0) return 0;\n  let sum = 0;\n  for (let i = 0; i < samples.length; i += 1) {\n    const sample = samples[i] ?? 0;\n    sum += sample * sample;\n  }\n  const rms = Math.sqrt(sum / samples.length);\n  return Math.min(1, rms * gain);\n}\n\ninterface UseAudioLevelHistoryOptions {\n  /** Number of bars in the strip. */\n  size: number;\n  /** Sample cadence in ms; 50ms gives ~20 bars per second. */\n  intervalMs?: number;\n}\n\n/**\n * Sample a `MediaStream` through an `AnalyserNode` into a rolling level\n * history. Returns the resting baseline when `stream` is null.\n */\nexport function useAudioLevelHistory(\n  stream: MediaStream | null,\n  { size, intervalMs = 50 }: UseAudioLevelHistoryOptions,\n): AudioLevelHistory {\n  const [history, setHistory] = useState<AudioLevelHistory>(() => emptyAudioLevelHistory(size));\n\n  useEffect(() => {\n    setHistory(emptyAudioLevelHistory(size));\n    if (!stream || typeof window === 'undefined') return;\n    const AudioContextCtor =\n      window.AudioContext ??\n      (window as typeof window & { webkitAudioContext?: typeof AudioContext }).webkitAudioContext;\n    if (!AudioContextCtor) return;\n\n    let audioContext: AudioContext;\n    try {\n      audioContext = new AudioContextCtor();\n    } catch {\n      return;\n    }\n    const analyser = audioContext.createAnalyser();\n    analyser.fftSize = 1024;\n    analyser.smoothingTimeConstant = 0;\n    let source: MediaStreamAudioSourceNode | null = null;\n    try {\n      source = audioContext.createMediaStreamSource(stream);\n      source.connect(analyser);\n    } catch {\n      void audioContext.close();\n      return;\n    }\n    const samples = new Float32Array(analyser.fftSize);\n    const interval = window.setInterval(() => {\n      analyser.getFloatTimeDomainData(samples);\n      const level = displayLevelFromSamples(samples);\n      setHistory((current) => pushAudioLevel(current, level));\n    }, intervalMs);\n\n    return () => {\n      window.clearInterval(interval);\n      try {\n        source?.disconnect();\n        analyser.disconnect();\n      } catch {\n        // Already disconnected.\n      }\n      void audioContext.close();\n    };\n  }, [stream, size, intervalMs]);\n\n  return history;\n}\n"],"names":["useState","useEffect"],"mappings":";;;AASO,SAAS,uBAAuB,MAAiC;AACtE,SAAO,IAAI,MAAqB,KAAK,IAAI,GAAG,IAAI,CAAC,EAAE,KAAK,IAAI;AAC9D;AAGO,SAAS,eAAe,SAA4B,OAAkC;AAC3F,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAM,UAAU,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,KAAK,CAAC;AAC9C,SAAO,CAAC,GAAG,QAAQ,MAAM,CAAC,GAAG,OAAO;AACtC;AAOO,SAAS,wBAAwB,SAA4B,OAAO,GAAW;AACpF,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,MAAI,MAAM;AACV,WAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK,GAAG;AAC1C,UAAM,SAAS,QAAQ,CAAC,KAAK;AAC7B,WAAO,SAAS;AAAA,EAClB;AACA,QAAM,MAAM,KAAK,KAAK,MAAM,QAAQ,MAAM;AAC1C,SAAO,KAAK,IAAI,GAAG,MAAM,IAAI;AAC/B;AAaO,SAAS,qBACd,QACA,EAAE,MAAM,aAAa,MACF;AACnB,QAAM,CAAC,SAAS,UAAU,IAAIA,WAAAA,SAA4B,MAAM,uBAAuB,IAAI,CAAC;AAE5FC,aAAAA,UAAU,MAAM;AACd,eAAW,uBAAuB,IAAI,CAAC;AACvC,QAAI,CAAC,UAAU,OAAO,WAAW,YAAa;AAC9C,UAAM,mBACJ,OAAO,gBACN,OAAwE;AAC3E,QAAI,CAAC,iBAAkB;AAEvB,QAAI;AACJ,QAAI;AACF,qBAAe,IAAI,iBAAA;AAAA,IACrB,QAAQ;AACN;AAAA,IACF;AACA,UAAM,WAAW,aAAa,eAAA;AAC9B,aAAS,UAAU;AACnB,aAAS,wBAAwB;AACjC,QAAI,SAA4C;AAChD,QAAI;AACF,eAAS,aAAa,wBAAwB,MAAM;AACpD,aAAO,QAAQ,QAAQ;AAAA,IACzB,QAAQ;AACN,WAAK,aAAa,MAAA;AAClB;AAAA,IACF;AACA,UAAM,UAAU,IAAI,aAAa,SAAS,OAAO;AACjD,UAAM,WAAW,OAAO,YAAY,MAAM;AACxC,eAAS,uBAAuB,OAAO;AACvC,YAAM,QAAQ,wBAAwB,OAAO;AAC7C,iBAAW,CAAC,YAAY,eAAe,SAAS,KAAK,CAAC;AAAA,IACxD,GAAG,UAAU;AAEb,WAAO,MAAM;AACX,aAAO,cAAc,QAAQ;AAC7B,UAAI;AACF,yCAAQ;AACR,iBAAS,WAAA;AAAA,MACX,QAAQ;AAAA,MAER;AACA,WAAK,aAAa,MAAA;AAAA,IACpB;AAAA,EACF,GAAG,CAAC,QAAQ,MAAM,UAAU,CAAC;AAE7B,SAAO;AACT;;;;;"}

package/dist/dictation/dictation-controls.cjs

@@ -4,26 +4,30 @@ const jsxRuntime = require("react/jsx-runtime");
 const lucideReact = require("lucide-react");
 const tooltipIconButton = require("../chat/tooltip-icon-button.cjs");
 const cnfast = require("cnfast");
-const DictationMicButton = ({
-  onClick,
-  disabled,
-  className,
-  title = "Dictate a message"
-}) => /* @__PURE__ */ jsxRuntime.jsx(
-  tooltipIconButton.TooltipIconButton,
-  {
-    tooltip: title,
-    side: "bottom",
-    type: "button",
-    variant: "ghost",
-    size: "icon",
-    className: cnfast.cn("aui-composer-dictate size-8 rounded-full text-muted-foreground hover:text-foreground", className),
-    "aria-label": title,
-    onClick,
-    disabled,
-    children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.MicIcon, { className: "aui-composer-dictate-icon size-4" })
-  }
-);
+const DictationMicButton = ({ onClick, disabled, className, title = "Dictate a message", disabledReason = null }) => {
+  const unavailable = Boolean(disabledReason);
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    tooltipIconButton.TooltipIconButton,
+    {
+      tooltip: disabledReason || title,
+      side: "bottom",
+      type: "button",
+      variant: "ghost",
+      size: "icon",
+      className: cnfast.cn(
+        "aui-composer-dictate size-8 rounded-full text-muted-foreground hover:text-foreground",
+        className,
+        unavailable && "cursor-not-allowed opacity-30 hover:bg-transparent hover:text-muted-foreground"
+      ),
+      "aria-label": title,
+      "aria-disabled": unavailable || void 0,
+      "data-unavailable": unavailable || void 0,
+      onClick: unavailable ? void 0 : onClick,
+      disabled: !unavailable && disabled,
+      children: /* @__PURE__ */ jsxRuntime.jsx(lucideReact.MicIcon, { className: "aui-composer-dictate-icon size-4" })
+    }
+  );
+};
 const DictationCancelButton = ({ onClick, disabled, className }) => /* @__PURE__ */ jsxRuntime.jsx(
   tooltipIconButton.TooltipIconButton,
   {

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

@@ -1 +1 @@
-{"version":3,"file":"dictation-controls.cjs","sources":["../../src/dictation/dictation-controls.tsx"],"sourcesContent":["import type { FC } from 'react';\nimport { MicIcon, SquareIcon, XIcon } from 'lucide-react';\nimport { TooltipIconButton } from '../chat/tooltip-icon-button';\nimport { cn } from '../lib/utils';\n\ninterface DictationControlProps {\n  onClick: () => void;\n  disabled?: boolean;\n  className?: string;\n}\n\n/** Toolbar mic: starts a dictation session. */\nexport const DictationMicButton: FC<DictationControlProps & { title?: string }> = ({\n  onClick,\n  disabled,\n  className,\n  title = 'Dictate a message',\n}) => (\n  <TooltipIconButton\n    tooltip={title}\n    side=\"bottom\"\n    type=\"button\"\n    variant=\"ghost\"\n    size=\"icon\"\n    className={cn('aui-composer-dictate size-8 rounded-full text-muted-foreground hover:text-foreground', className)}\n    aria-label={title}\n    onClick={onClick}\n    disabled={disabled}\n  >\n    <MicIcon className=\"aui-composer-dictate-icon size-4\" />\n  </TooltipIconButton>\n);\n\n/** Recording mode, left side: discard the session. */\nexport const DictationCancelButton: FC<DictationControlProps> = ({ onClick, disabled, className }) => (\n  <TooltipIconButton\n    tooltip=\"Cancel dictation\"\n    side=\"bottom\"\n    type=\"button\"\n    variant=\"outline\"\n    size=\"icon\"\n    className={cn('aui-composer-dictate-cancel size-8 rounded-full', className)}\n    aria-label=\"Cancel dictation\"\n    onClick={onClick}\n    disabled={disabled}\n  >\n    <XIcon className=\"size-4\" />\n  </TooltipIconButton>\n);\n\n/** Recording mode, right side: stop and put the words in the composer. */\nexport const DictationStopButton: FC<DictationControlProps> = ({ onClick, disabled, className }) => (\n  <TooltipIconButton\n    tooltip=\"Stop and review\"\n    side=\"bottom\"\n    type=\"button\"\n    variant=\"outline\"\n    size=\"icon\"\n    className={cn('aui-composer-dictate-stop size-8 rounded-full', className)}\n    aria-label=\"Stop dictation\"\n    onClick={onClick}\n    disabled={disabled}\n  >\n    <SquareIcon className=\"size-3 fill-current\" />\n  </TooltipIconButton>\n);\n"],"names":["jsx","TooltipIconButton","cn","MicIcon","XIcon","SquareIcon"],"mappings":";;;;;;AAYO,MAAM,qBAAqE,CAAC;AAAA,EACjF;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AACV,MACEA,2BAAAA;AAAAA,EAACC,kBAAAA;AAAAA,EAAA;AAAA,IACC,SAAS;AAAA,IACT,MAAK;AAAA,IACL,MAAK;AAAA,IACL,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,WAAWC,OAAAA,GAAG,wFAAwF,SAAS;AAAA,IAC/G,cAAY;AAAA,IACZ;AAAA,IACA;AAAA,IAEA,UAAAF,2BAAAA,IAACG,YAAAA,SAAA,EAAQ,WAAU,mCAAA,CAAmC;AAAA,EAAA;AACxD;AAIK,MAAM,wBAAmD,CAAC,EAAE,SAAS,UAAU,gBACpFH,2BAAAA;AAAAA,EAACC,kBAAAA;AAAAA,EAAA;AAAA,IACC,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,MAAK;AAAA,IACL,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,WAAWC,OAAAA,GAAG,mDAAmD,SAAS;AAAA,IAC1E,cAAW;AAAA,IACX;AAAA,IACA;AAAA,IAEA,UAAAF,2BAAAA,IAACI,YAAAA,OAAA,EAAM,WAAU,SAAA,CAAS;AAAA,EAAA;AAC5B;AAIK,MAAM,sBAAiD,CAAC,EAAE,SAAS,UAAU,gBAClFJ,2BAAAA;AAAAA,EAACC,kBAAAA;AAAAA,EAAA;AAAA,IACC,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,MAAK;AAAA,IACL,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,WAAWC,OAAAA,GAAG,iDAAiD,SAAS;AAAA,IACxE,cAAW;AAAA,IACX;AAAA,IACA;AAAA,IAEA,UAAAF,2BAAAA,IAACK,YAAAA,YAAA,EAAW,WAAU,sBAAA,CAAsB;AAAA,EAAA;AAC9C;;;;"}
+{"version":3,"file":"dictation-controls.cjs","sources":["../../src/dictation/dictation-controls.tsx"],"sourcesContent":["import type { FC } from 'react';\nimport { MicIcon, SquareIcon, XIcon } from 'lucide-react';\nimport { TooltipIconButton } from '../chat/tooltip-icon-button';\nimport { cn } from '../lib/utils';\n\ninterface DictationControlProps {\n  onClick: () => void;\n  disabled?: boolean;\n  className?: string;\n}\n\n/**\n * Toolbar mic: starts a dictation session. With a `disabledReason` (Athena can't be reached, so\n * nothing could transcribe) it shows off with the reason as its tooltip, keeping its pointer and\n * focus so the reason reads, and starts nothing.\n */\nexport const DictationMicButton: FC<\n  DictationControlProps & { title?: string; disabledReason?: string | null }\n> = ({ onClick, disabled, className, title = 'Dictate a message', disabledReason = null }) => {\n  const unavailable = Boolean(disabledReason);\n  return (\n    <TooltipIconButton\n      tooltip={disabledReason || title}\n      side=\"bottom\"\n      type=\"button\"\n      variant=\"ghost\"\n      size=\"icon\"\n      className={cn(\n        'aui-composer-dictate size-8 rounded-full text-muted-foreground hover:text-foreground',\n        className,\n        unavailable && 'cursor-not-allowed opacity-30 hover:bg-transparent hover:text-muted-foreground',\n      )}\n      aria-label={title}\n      aria-disabled={unavailable || undefined}\n      data-unavailable={unavailable || undefined}\n      onClick={unavailable ? undefined : onClick}\n      disabled={!unavailable && disabled}\n    >\n      <MicIcon className=\"aui-composer-dictate-icon size-4\" />\n    </TooltipIconButton>\n  );\n};\n\n/** Recording mode, left side: discard the session. */\nexport const DictationCancelButton: FC<DictationControlProps> = ({ onClick, disabled, className }) => (\n  <TooltipIconButton\n    tooltip=\"Cancel dictation\"\n    side=\"bottom\"\n    type=\"button\"\n    variant=\"outline\"\n    size=\"icon\"\n    className={cn('aui-composer-dictate-cancel size-8 rounded-full', className)}\n    aria-label=\"Cancel dictation\"\n    onClick={onClick}\n    disabled={disabled}\n  >\n    <XIcon className=\"size-4\" />\n  </TooltipIconButton>\n);\n\n/** Recording mode, right side: stop and put the words in the composer. */\nexport const DictationStopButton: FC<DictationControlProps> = ({ onClick, disabled, className }) => (\n  <TooltipIconButton\n    tooltip=\"Stop and review\"\n    side=\"bottom\"\n    type=\"button\"\n    variant=\"outline\"\n    size=\"icon\"\n    className={cn('aui-composer-dictate-stop size-8 rounded-full', className)}\n    aria-label=\"Stop dictation\"\n    onClick={onClick}\n    disabled={disabled}\n  >\n    <SquareIcon className=\"size-3 fill-current\" />\n  </TooltipIconButton>\n);\n"],"names":["jsx","TooltipIconButton","cn","MicIcon","XIcon","SquareIcon"],"mappings":";;;;;;AAgBO,MAAM,qBAET,CAAC,EAAE,SAAS,UAAU,WAAW,QAAQ,qBAAqB,iBAAiB,WAAW;AAC5F,QAAM,cAAc,QAAQ,cAAc;AAC1C,SACEA,2BAAAA;AAAAA,IAACC,kBAAAA;AAAAA,IAAA;AAAA,MACC,SAAS,kBAAkB;AAAA,MAC3B,MAAK;AAAA,MACL,MAAK;AAAA,MACL,SAAQ;AAAA,MACR,MAAK;AAAA,MACL,WAAWC,OAAAA;AAAAA,QACT;AAAA,QACA;AAAA,QACA,eAAe;AAAA,MAAA;AAAA,MAEjB,cAAY;AAAA,MACZ,iBAAe,eAAe;AAAA,MAC9B,oBAAkB,eAAe;AAAA,MACjC,SAAS,cAAc,SAAY;AAAA,MACnC,UAAU,CAAC,eAAe;AAAA,MAE1B,UAAAF,2BAAAA,IAACG,YAAAA,SAAA,EAAQ,WAAU,mCAAA,CAAmC;AAAA,IAAA;AAAA,EAAA;AAG5D;AAGO,MAAM,wBAAmD,CAAC,EAAE,SAAS,UAAU,gBACpFH,2BAAAA;AAAAA,EAACC,kBAAAA;AAAAA,EAAA;AAAA,IACC,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,MAAK;AAAA,IACL,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,WAAWC,OAAAA,GAAG,mDAAmD,SAAS;AAAA,IAC1E,cAAW;AAAA,IACX;AAAA,IACA;AAAA,IAEA,UAAAF,2BAAAA,IAACI,YAAAA,OAAA,EAAM,WAAU,SAAA,CAAS;AAAA,EAAA;AAC5B;AAIK,MAAM,sBAAiD,CAAC,EAAE,SAAS,UAAU,gBAClFJ,2BAAAA;AAAAA,EAACC,kBAAAA;AAAAA,EAAA;AAAA,IACC,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,MAAK;AAAA,IACL,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,WAAWC,OAAAA,GAAG,iDAAiD,SAAS;AAAA,IACxE,cAAW;AAAA,IACX;AAAA,IACA;AAAA,IAEA,UAAAF,2BAAAA,IAACK,YAAAA,YAAA,EAAW,WAAU,sBAAA,CAAsB;AAAA,EAAA;AAC9C;;;;"}

package/dist/dictation/dictation-controls.d.ts

@@ -4,9 +4,14 @@ interface DictationControlProps {
     disabled?: boolean;
     className?: string;
 }
-/** Toolbar mic: starts a dictation session. */
+/**
+ * Toolbar mic: starts a dictation session. With a `disabledReason` (Athena can't be reached, so
+ * nothing could transcribe) it shows off with the reason as its tooltip, keeping its pointer and
+ * focus so the reason reads, and starts nothing.
+ */
 export declare const DictationMicButton: FC<DictationControlProps & {
     title?: string;
+    disabledReason?: string | null;
 }>;
 /** Recording mode, left side: discard the session. */
 export declare const DictationCancelButton: FC<DictationControlProps>;

package/dist/dictation/dictation-controls.js

@@ -2,26 +2,30 @@ import { jsx } from "react/jsx-runtime";
 import { SquareIcon, MicIcon, XIcon } from "lucide-react";
 import { TooltipIconButton } from "../chat/tooltip-icon-button.js";
 import { cn } from "cnfast";
-const DictationMicButton = ({
-  onClick,
-  disabled,
-  className,
-  title = "Dictate a message"
-}) => /* @__PURE__ */ jsx(
-  TooltipIconButton,
-  {
-    tooltip: title,
-    side: "bottom",
-    type: "button",
-    variant: "ghost",
-    size: "icon",
-    className: cn("aui-composer-dictate size-8 rounded-full text-muted-foreground hover:text-foreground", className),
-    "aria-label": title,
-    onClick,
-    disabled,
-    children: /* @__PURE__ */ jsx(MicIcon, { className: "aui-composer-dictate-icon size-4" })
-  }
-);
+const DictationMicButton = ({ onClick, disabled, className, title = "Dictate a message", disabledReason = null }) => {
+  const unavailable = Boolean(disabledReason);
+  return /* @__PURE__ */ jsx(
+    TooltipIconButton,
+    {
+      tooltip: disabledReason || title,
+      side: "bottom",
+      type: "button",
+      variant: "ghost",
+      size: "icon",
+      className: cn(
+        "aui-composer-dictate size-8 rounded-full text-muted-foreground hover:text-foreground",
+        className,
+        unavailable && "cursor-not-allowed opacity-30 hover:bg-transparent hover:text-muted-foreground"
+      ),
+      "aria-label": title,
+      "aria-disabled": unavailable || void 0,
+      "data-unavailable": unavailable || void 0,
+      onClick: unavailable ? void 0 : onClick,
+      disabled: !unavailable && disabled,
+      children: /* @__PURE__ */ jsx(MicIcon, { className: "aui-composer-dictate-icon size-4" })
+    }
+  );
+};
 const DictationCancelButton = ({ onClick, disabled, className }) => /* @__PURE__ */ jsx(
   TooltipIconButton,
   {

package/dist/dictation/dictation-controls.js.map

@@ -1 +1 @@
-{"version":3,"file":"dictation-controls.js","sources":["../../src/dictation/dictation-controls.tsx"],"sourcesContent":["import type { FC } from 'react';\nimport { MicIcon, SquareIcon, XIcon } from 'lucide-react';\nimport { TooltipIconButton } from '../chat/tooltip-icon-button';\nimport { cn } from '../lib/utils';\n\ninterface DictationControlProps {\n  onClick: () => void;\n  disabled?: boolean;\n  className?: string;\n}\n\n/** Toolbar mic: starts a dictation session. */\nexport const DictationMicButton: FC<DictationControlProps & { title?: string }> = ({\n  onClick,\n  disabled,\n  className,\n  title = 'Dictate a message',\n}) => (\n  <TooltipIconButton\n    tooltip={title}\n    side=\"bottom\"\n    type=\"button\"\n    variant=\"ghost\"\n    size=\"icon\"\n    className={cn('aui-composer-dictate size-8 rounded-full text-muted-foreground hover:text-foreground', className)}\n    aria-label={title}\n    onClick={onClick}\n    disabled={disabled}\n  >\n    <MicIcon className=\"aui-composer-dictate-icon size-4\" />\n  </TooltipIconButton>\n);\n\n/** Recording mode, left side: discard the session. */\nexport const DictationCancelButton: FC<DictationControlProps> = ({ onClick, disabled, className }) => (\n  <TooltipIconButton\n    tooltip=\"Cancel dictation\"\n    side=\"bottom\"\n    type=\"button\"\n    variant=\"outline\"\n    size=\"icon\"\n    className={cn('aui-composer-dictate-cancel size-8 rounded-full', className)}\n    aria-label=\"Cancel dictation\"\n    onClick={onClick}\n    disabled={disabled}\n  >\n    <XIcon className=\"size-4\" />\n  </TooltipIconButton>\n);\n\n/** Recording mode, right side: stop and put the words in the composer. */\nexport const DictationStopButton: FC<DictationControlProps> = ({ onClick, disabled, className }) => (\n  <TooltipIconButton\n    tooltip=\"Stop and review\"\n    side=\"bottom\"\n    type=\"button\"\n    variant=\"outline\"\n    size=\"icon\"\n    className={cn('aui-composer-dictate-stop size-8 rounded-full', className)}\n    aria-label=\"Stop dictation\"\n    onClick={onClick}\n    disabled={disabled}\n  >\n    <SquareIcon className=\"size-3 fill-current\" />\n  </TooltipIconButton>\n);\n"],"names":[],"mappings":";;;;AAYO,MAAM,qBAAqE,CAAC;AAAA,EACjF;AAAA,EACA;AAAA,EACA;AAAA,EACA,QAAQ;AACV,MACE;AAAA,EAAC;AAAA,EAAA;AAAA,IACC,SAAS;AAAA,IACT,MAAK;AAAA,IACL,MAAK;AAAA,IACL,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,WAAW,GAAG,wFAAwF,SAAS;AAAA,IAC/G,cAAY;AAAA,IACZ;AAAA,IACA;AAAA,IAEA,UAAA,oBAAC,SAAA,EAAQ,WAAU,mCAAA,CAAmC;AAAA,EAAA;AACxD;AAIK,MAAM,wBAAmD,CAAC,EAAE,SAAS,UAAU,gBACpF;AAAA,EAAC;AAAA,EAAA;AAAA,IACC,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,MAAK;AAAA,IACL,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,WAAW,GAAG,mDAAmD,SAAS;AAAA,IAC1E,cAAW;AAAA,IACX;AAAA,IACA;AAAA,IAEA,UAAA,oBAAC,OAAA,EAAM,WAAU,SAAA,CAAS;AAAA,EAAA;AAC5B;AAIK,MAAM,sBAAiD,CAAC,EAAE,SAAS,UAAU,gBAClF;AAAA,EAAC;AAAA,EAAA;AAAA,IACC,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,MAAK;AAAA,IACL,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,WAAW,GAAG,iDAAiD,SAAS;AAAA,IACxE,cAAW;AAAA,IACX;AAAA,IACA;AAAA,IAEA,UAAA,oBAAC,YAAA,EAAW,WAAU,sBAAA,CAAsB;AAAA,EAAA;AAC9C;"}
+{"version":3,"file":"dictation-controls.js","sources":["../../src/dictation/dictation-controls.tsx"],"sourcesContent":["import type { FC } from 'react';\nimport { MicIcon, SquareIcon, XIcon } from 'lucide-react';\nimport { TooltipIconButton } from '../chat/tooltip-icon-button';\nimport { cn } from '../lib/utils';\n\ninterface DictationControlProps {\n  onClick: () => void;\n  disabled?: boolean;\n  className?: string;\n}\n\n/**\n * Toolbar mic: starts a dictation session. With a `disabledReason` (Athena can't be reached, so\n * nothing could transcribe) it shows off with the reason as its tooltip, keeping its pointer and\n * focus so the reason reads, and starts nothing.\n */\nexport const DictationMicButton: FC<\n  DictationControlProps & { title?: string; disabledReason?: string | null }\n> = ({ onClick, disabled, className, title = 'Dictate a message', disabledReason = null }) => {\n  const unavailable = Boolean(disabledReason);\n  return (\n    <TooltipIconButton\n      tooltip={disabledReason || title}\n      side=\"bottom\"\n      type=\"button\"\n      variant=\"ghost\"\n      size=\"icon\"\n      className={cn(\n        'aui-composer-dictate size-8 rounded-full text-muted-foreground hover:text-foreground',\n        className,\n        unavailable && 'cursor-not-allowed opacity-30 hover:bg-transparent hover:text-muted-foreground',\n      )}\n      aria-label={title}\n      aria-disabled={unavailable || undefined}\n      data-unavailable={unavailable || undefined}\n      onClick={unavailable ? undefined : onClick}\n      disabled={!unavailable && disabled}\n    >\n      <MicIcon className=\"aui-composer-dictate-icon size-4\" />\n    </TooltipIconButton>\n  );\n};\n\n/** Recording mode, left side: discard the session. */\nexport const DictationCancelButton: FC<DictationControlProps> = ({ onClick, disabled, className }) => (\n  <TooltipIconButton\n    tooltip=\"Cancel dictation\"\n    side=\"bottom\"\n    type=\"button\"\n    variant=\"outline\"\n    size=\"icon\"\n    className={cn('aui-composer-dictate-cancel size-8 rounded-full', className)}\n    aria-label=\"Cancel dictation\"\n    onClick={onClick}\n    disabled={disabled}\n  >\n    <XIcon className=\"size-4\" />\n  </TooltipIconButton>\n);\n\n/** Recording mode, right side: stop and put the words in the composer. */\nexport const DictationStopButton: FC<DictationControlProps> = ({ onClick, disabled, className }) => (\n  <TooltipIconButton\n    tooltip=\"Stop and review\"\n    side=\"bottom\"\n    type=\"button\"\n    variant=\"outline\"\n    size=\"icon\"\n    className={cn('aui-composer-dictate-stop size-8 rounded-full', className)}\n    aria-label=\"Stop dictation\"\n    onClick={onClick}\n    disabled={disabled}\n  >\n    <SquareIcon className=\"size-3 fill-current\" />\n  </TooltipIconButton>\n);\n"],"names":[],"mappings":";;;;AAgBO,MAAM,qBAET,CAAC,EAAE,SAAS,UAAU,WAAW,QAAQ,qBAAqB,iBAAiB,WAAW;AAC5F,QAAM,cAAc,QAAQ,cAAc;AAC1C,SACE;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,SAAS,kBAAkB;AAAA,MAC3B,MAAK;AAAA,MACL,MAAK;AAAA,MACL,SAAQ;AAAA,MACR,MAAK;AAAA,MACL,WAAW;AAAA,QACT;AAAA,QACA;AAAA,QACA,eAAe;AAAA,MAAA;AAAA,MAEjB,cAAY;AAAA,MACZ,iBAAe,eAAe;AAAA,MAC9B,oBAAkB,eAAe;AAAA,MACjC,SAAS,cAAc,SAAY;AAAA,MACnC,UAAU,CAAC,eAAe;AAAA,MAE1B,UAAA,oBAAC,SAAA,EAAQ,WAAU,mCAAA,CAAmC;AAAA,IAAA;AAAA,EAAA;AAG5D;AAGO,MAAM,wBAAmD,CAAC,EAAE,SAAS,UAAU,gBACpF;AAAA,EAAC;AAAA,EAAA;AAAA,IACC,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,MAAK;AAAA,IACL,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,WAAW,GAAG,mDAAmD,SAAS;AAAA,IAC1E,cAAW;AAAA,IACX;AAAA,IACA;AAAA,IAEA,UAAA,oBAAC,OAAA,EAAM,WAAU,SAAA,CAAS;AAAA,EAAA;AAC5B;AAIK,MAAM,sBAAiD,CAAC,EAAE,SAAS,UAAU,gBAClF;AAAA,EAAC;AAAA,EAAA;AAAA,IACC,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,MAAK;AAAA,IACL,SAAQ;AAAA,IACR,MAAK;AAAA,IACL,WAAW,GAAG,iDAAiD,SAAS;AAAA,IACxE,cAAW;AAAA,IACX;AAAA,IACA;AAAA,IAEA,UAAA,oBAAC,YAAA,EAAW,WAAU,sBAAA,CAAsB;AAAA,EAAA;AAC9C;"}

package/dist/dictation/use-athena-dictation-engine.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const react = require("react");
+const require$$0 = require("react");
 const AthenaContext = require("../provider/AthenaContext.cjs");
 const credentialRenewal = require("../runtime/credential-renewal.cjs");
 const dictationEngine = require("./dictation-engine.cjs");
@@ -48,9 +48,9 @@ function createAthenaUploadTranscriber(getConfig) {
 }
 function useAthenaDictationEngine(override) {
   const config = AthenaContext.useAthenaConfig();
-  const configRef = react.useRef(config);
+  const configRef = require$$0.useRef(config);
   configRef.current = config;
-  return react.useMemo(() => {
+  return require$$0.useMemo(() => {
     if (override) return override;
     const recorded = recordedDictationEngine.createRecordedDictationEngine({
       transcribe: createAthenaUploadTranscriber(() => configRef.current)

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

@@ -1 +1 @@
-{"version":3,"file":"use-athena-dictation-engine.cjs","sources":["../../src/dictation/use-athena-dictation-engine.ts"],"sourcesContent":["import { useMemo, useRef } from 'react';\nimport { type AthenaConfig, useAthenaConfig } from '../provider/AthenaContext';\nimport { sendWithCredentialRenewal } from '../runtime/credential-renewal';\nimport { createWebSpeechDictationEngine, type DictationEngine } from './dictation-engine';\nimport { createRecordedDictationEngine, type DictationTranscriber } from './recorded-dictation-engine';\n\ninterface UploadTranscriptionResponse {\n  transcript: string;\n}\n\n/** Agora's REST base from the configured backend URL (which may point at a nested endpoint). */\nexport function transcriptionUploadUrl(backendUrl: string): string {\n  return `${backendUrl.replace(/\\/api\\/assistant-ui\\/?$/, '').replace(/\\/$/, '')}/api/transcription/upload`;\n}\n\n/**\n * One line for the composer per way `/transcription/upload` refuses a clip.\n * The copy lives here, apart from the fetch, so it can be pinned by a test.\n */\nexport function transcriptionUploadErrorMessage(status: number): string {\n  switch (status) {\n    case 401:\n    case 403:\n      return 'Dictation is not available for this sign-in. Reload and try again.';\n    case 413:\n      return 'That recording is too long to transcribe.';\n    case 422:\n      return 'The dictation language was rejected. Use a BCP-47 tag such as en-US.';\n    case 429:\n      return 'Too many dictations in a row. Wait a moment and try again.';\n    case 503:\n      return 'Dictation is not set up on this server.';\n    default:\n      return `Transcription failed (${status}).`;\n  }\n}\n\n/**\n * Post a finished clip to agora's `/transcription/upload` route, which runs\n * it through Deepgram and returns the text. Credentials are read at call\n * time so a rotated token is picked up, and a `401` gets one forced renewal\n * (`getToken({ force: true })`) and a resend before it fails. The session\n * language (host `lang` or the document's) is forwarded so non-English speech\n * is recognised as such; the request is dropped when the engine aborts.\n */\nexport function createAthenaUploadTranscriber(\n  getConfig: () => Pick<AthenaConfig, 'backendUrl' | 'apiKey' | 'token' | 'getToken'>,\n): DictationTranscriber {\n  return async (clip, { lang, signal }) => {\n    const config = getConfig();\n    const extension = clip.type.includes('mp4') ? 'mp4' : clip.type.includes('ogg') ? 'ogg' : 'webm';\n    const response = await sendWithCredentialRenewal(config, (headers) => {\n      // A request body is single-use: every attempt builds its own form.\n      const form = new FormData();\n      form.append('file', clip, `dictation.${extension}`);\n      if (lang) form.append('language', lang);\n      return fetch(transcriptionUploadUrl(config.backendUrl), {\n        method: 'POST',\n        headers,\n        body: form,\n        credentials: 'include',\n        signal,\n      });\n    });\n    if (!response.ok) throw new Error(transcriptionUploadErrorMessage(response.status));\n    const payload = (await response.json()) as UploadTranscriptionResponse;\n    return typeof payload.transcript === 'string' ? payload.transcript : '';\n  };\n}\n\n/**\n * The composer's default speech engine: record with `MediaRecorder`, then\n * transcribe the clip through agora (Deepgram). Falls back to the browser's\n * Web Speech API only where `MediaRecorder` is missing. A host-provided\n * `engine` always wins.\n */\nexport function useAthenaDictationEngine(override?: DictationEngine): DictationEngine {\n  const config = useAthenaConfig();\n  const configRef = useRef(config);\n  configRef.current = config;\n  return useMemo(() => {\n    if (override) return override;\n    const recorded = createRecordedDictationEngine({\n      transcribe: createAthenaUploadTranscriber(() => configRef.current),\n    });\n    return recorded.isSupported() ? recorded : createWebSpeechDictationEngine();\n  }, [override]);\n}\n"],"names":["sendWithCredentialRenewal","useAthenaConfig","useRef","useMemo","createRecordedDictationEngine","createWebSpeechDictationEngine"],"mappings":";;;;;;;AAWO,SAAS,uBAAuB,YAA4B;AACjE,SAAO,GAAG,WAAW,QAAQ,2BAA2B,EAAE,EAAE,QAAQ,OAAO,EAAE,CAAC;AAChF;AAMO,SAAS,gCAAgC,QAAwB;AACtE,UAAQ,QAAA;AAAA,IACN,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO,yBAAyB,MAAM;AAAA,EAAA;AAE5C;AAUO,SAAS,8BACd,WACsB;AACtB,SAAO,OAAO,MAAM,EAAE,MAAM,aAAa;AACvC,UAAM,SAAS,UAAA;AACf,UAAM,YAAY,KAAK,KAAK,SAAS,KAAK,IAAI,QAAQ,KAAK,KAAK,SAAS,KAAK,IAAI,QAAQ;AAC1F,UAAM,WAAW,MAAMA,kBAAAA,0BAA0B,QAAQ,CAAC,YAAY;AAEpE,YAAM,OAAO,IAAI,SAAA;AACjB,WAAK,OAAO,QAAQ,MAAM,aAAa,SAAS,EAAE;AAClD,UAAI,KAAM,MAAK,OAAO,YAAY,IAAI;AACtC,aAAO,MAAM,uBAAuB,OAAO,UAAU,GAAG;AAAA,QACtD,QAAQ;AAAA,QACR;AAAA,QACA,MAAM;AAAA,QACN,aAAa;AAAA,QACb;AAAA,MAAA,CACD;AAAA,IACH,CAAC;AACD,QAAI,CAAC,SAAS,GAAI,OAAM,IAAI,MAAM,gCAAgC,SAAS,MAAM,CAAC;AAClF,UAAM,UAAW,MAAM,SAAS,KAAA;AAChC,WAAO,OAAO,QAAQ,eAAe,WAAW,QAAQ,aAAa;AAAA,EACvE;AACF;AAQO,SAAS,yBAAyB,UAA6C;AACpF,QAAM,SAASC,cAAAA,gBAAA;AACf,QAAM,YAAYC,MAAAA,OAAO,MAAM;AAC/B,YAAU,UAAU;AACpB,SAAOC,MAAAA,QAAQ,MAAM;AACnB,QAAI,SAAU,QAAO;AACrB,UAAM,WAAWC,wBAAAA,8BAA8B;AAAA,MAC7C,YAAY,8BAA8B,MAAM,UAAU,OAAO;AAAA,IAAA,CAClE;AACD,WAAO,SAAS,gBAAgB,WAAWC,gBAAAA,+BAAA;AAAA,EAC7C,GAAG,CAAC,QAAQ,CAAC;AACf;;;;;"}
+{"version":3,"file":"use-athena-dictation-engine.cjs","sources":["../../src/dictation/use-athena-dictation-engine.ts"],"sourcesContent":["import { useMemo, useRef } from 'react';\nimport { type AthenaConfig, useAthenaConfig } from '../provider/AthenaContext';\nimport { sendWithCredentialRenewal } from '../runtime/credential-renewal';\nimport { createWebSpeechDictationEngine, type DictationEngine } from './dictation-engine';\nimport { createRecordedDictationEngine, type DictationTranscriber } from './recorded-dictation-engine';\n\ninterface UploadTranscriptionResponse {\n  transcript: string;\n}\n\n/** Agora's REST base from the configured backend URL (which may point at a nested endpoint). */\nexport function transcriptionUploadUrl(backendUrl: string): string {\n  return `${backendUrl.replace(/\\/api\\/assistant-ui\\/?$/, '').replace(/\\/$/, '')}/api/transcription/upload`;\n}\n\n/**\n * One line for the composer per way `/transcription/upload` refuses a clip.\n * The copy lives here, apart from the fetch, so it can be pinned by a test.\n */\nexport function transcriptionUploadErrorMessage(status: number): string {\n  switch (status) {\n    case 401:\n    case 403:\n      return 'Dictation is not available for this sign-in. Reload and try again.';\n    case 413:\n      return 'That recording is too long to transcribe.';\n    case 422:\n      return 'The dictation language was rejected. Use a BCP-47 tag such as en-US.';\n    case 429:\n      return 'Too many dictations in a row. Wait a moment and try again.';\n    case 503:\n      return 'Dictation is not set up on this server.';\n    default:\n      return `Transcription failed (${status}).`;\n  }\n}\n\n/**\n * Post a finished clip to agora's `/transcription/upload` route, which runs\n * it through Deepgram and returns the text. Credentials are read at call\n * time so a rotated token is picked up, and a `401` gets one forced renewal\n * (`getToken({ force: true })`) and a resend before it fails. The session\n * language (host `lang` or the document's) is forwarded so non-English speech\n * is recognised as such; the request is dropped when the engine aborts.\n */\nexport function createAthenaUploadTranscriber(\n  getConfig: () => Pick<AthenaConfig, 'backendUrl' | 'apiKey' | 'token' | 'getToken'>,\n): DictationTranscriber {\n  return async (clip, { lang, signal }) => {\n    const config = getConfig();\n    const extension = clip.type.includes('mp4') ? 'mp4' : clip.type.includes('ogg') ? 'ogg' : 'webm';\n    const response = await sendWithCredentialRenewal(config, (headers) => {\n      // A request body is single-use: every attempt builds its own form.\n      const form = new FormData();\n      form.append('file', clip, `dictation.${extension}`);\n      if (lang) form.append('language', lang);\n      return fetch(transcriptionUploadUrl(config.backendUrl), {\n        method: 'POST',\n        headers,\n        body: form,\n        credentials: 'include',\n        signal,\n      });\n    });\n    if (!response.ok) throw new Error(transcriptionUploadErrorMessage(response.status));\n    const payload = (await response.json()) as UploadTranscriptionResponse;\n    return typeof payload.transcript === 'string' ? payload.transcript : '';\n  };\n}\n\n/**\n * The composer's default speech engine: record with `MediaRecorder`, then\n * transcribe the clip through agora (Deepgram). Falls back to the browser's\n * Web Speech API only where `MediaRecorder` is missing. A host-provided\n * `engine` always wins.\n */\nexport function useAthenaDictationEngine(override?: DictationEngine): DictationEngine {\n  const config = useAthenaConfig();\n  const configRef = useRef(config);\n  configRef.current = config;\n  return useMemo(() => {\n    if (override) return override;\n    const recorded = createRecordedDictationEngine({\n      transcribe: createAthenaUploadTranscriber(() => configRef.current),\n    });\n    return recorded.isSupported() ? recorded : createWebSpeechDictationEngine();\n  }, [override]);\n}\n"],"names":["sendWithCredentialRenewal","useAthenaConfig","useRef","useMemo","createRecordedDictationEngine","createWebSpeechDictationEngine"],"mappings":";;;;;;;AAWO,SAAS,uBAAuB,YAA4B;AACjE,SAAO,GAAG,WAAW,QAAQ,2BAA2B,EAAE,EAAE,QAAQ,OAAO,EAAE,CAAC;AAChF;AAMO,SAAS,gCAAgC,QAAwB;AACtE,UAAQ,QAAA;AAAA,IACN,KAAK;AAAA,IACL,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT,KAAK;AACH,aAAO;AAAA,IACT;AACE,aAAO,yBAAyB,MAAM;AAAA,EAAA;AAE5C;AAUO,SAAS,8BACd,WACsB;AACtB,SAAO,OAAO,MAAM,EAAE,MAAM,aAAa;AACvC,UAAM,SAAS,UAAA;AACf,UAAM,YAAY,KAAK,KAAK,SAAS,KAAK,IAAI,QAAQ,KAAK,KAAK,SAAS,KAAK,IAAI,QAAQ;AAC1F,UAAM,WAAW,MAAMA,kBAAAA,0BAA0B,QAAQ,CAAC,YAAY;AAEpE,YAAM,OAAO,IAAI,SAAA;AACjB,WAAK,OAAO,QAAQ,MAAM,aAAa,SAAS,EAAE;AAClD,UAAI,KAAM,MAAK,OAAO,YAAY,IAAI;AACtC,aAAO,MAAM,uBAAuB,OAAO,UAAU,GAAG;AAAA,QACtD,QAAQ;AAAA,QACR;AAAA,QACA,MAAM;AAAA,QACN,aAAa;AAAA,QACb;AAAA,MAAA,CACD;AAAA,IACH,CAAC;AACD,QAAI,CAAC,SAAS,GAAI,OAAM,IAAI,MAAM,gCAAgC,SAAS,MAAM,CAAC;AAClF,UAAM,UAAW,MAAM,SAAS,KAAA;AAChC,WAAO,OAAO,QAAQ,eAAe,WAAW,QAAQ,aAAa;AAAA,EACvE;AACF;AAQO,SAAS,yBAAyB,UAA6C;AACpF,QAAM,SAASC,cAAAA,gBAAA;AACf,QAAM,YAAYC,WAAAA,OAAO,MAAM;AAC/B,YAAU,UAAU;AACpB,SAAOC,WAAAA,QAAQ,MAAM;AACnB,QAAI,SAAU,QAAO;AACrB,UAAM,WAAWC,wBAAAA,8BAA8B;AAAA,MAC7C,YAAY,8BAA8B,MAAM,UAAU,OAAO;AAAA,IAAA,CAClE;AACD,WAAO,SAAS,gBAAgB,WAAWC,gBAAAA,+BAAA;AAAA,EAC7C,GAAG,CAAC,QAAQ,CAAC;AACf;;;;;"}

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":"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"}

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");
@@ -121,6 +128,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 +181,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 +203,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 +243,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 +329,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 +448,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;
@@ -502,6 +525,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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}