@athenaintel/react 0.24.1 → 0.25.0

package/dist/collab/react.cjs

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const react = require("react");
+const AthenaCredentialSourceContext = require("../auth/AthenaCredentialSourceContext.cjs");
 const AthenaContext = require("../provider/AthenaContext.cjs");
 const client = require("./client.cjs");
 function useGenericDoc(assetId, options) {
   const config = AthenaContext.useAthenaConfig();
+  const identityEpoch = AthenaCredentialSourceContext.useAthenaCredentialIdentityEpoch();
   const access = (options == null ? void 0 : options.access) ?? "view";
   const [handle, setHandle] = react.useState(null);
   const handleRef = react.useRef(null);
@@ -15,7 +17,8 @@ function useGenericDoc(assetId, options) {
       auth: {
         backendUrl: config.backendUrl,
         apiKey: config.apiKey,
-        token: config.token
+        token: config.token,
+        getToken: config.getToken
       }
     });
     handleRef.current = next;
@@ -24,7 +27,7 @@ function useGenericDoc(assetId, options) {
       handleRef.current = null;
       next.destroy();
     };
-  }, [assetId, access, config.backendUrl, config.apiKey, config.token]);
+  }, [assetId, access, config.backendUrl, config.apiKey, config.getToken, identityEpoch]);
   const subscribe = react.useMemo(() => {
     return (onStoreChange) => {
       if (!handle) return () => {

package/dist/collab/react.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"react.cjs","sources":["../../src/collab/react.ts"],"sourcesContent":["/**\n * React bindings for Generic Doc live collaboration.\n *\n * `useGenericDoc(assetId)` opens (and owns) a `connectGenericDoc` handle,\n * resolving auth from the surrounding `AthenaProvider` (per-viewer bearer when\n * present, API key otherwise) and re-rendering on status/presence changes via\n * `useSyncExternalStore`.\n */\n\nimport { useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { useAthenaConfig } from '../provider/AthenaContext';\nimport {\n  type GenericDocHandle,\n  type GenericDocStatus,\n  type PresenceEntry,\n  connectGenericDoc,\n} from './client';\nimport type * as Y from '@y/y';\n\nexport interface UseGenericDocResult {\n  /** Null until the handle is created (first render effect). */\n  doc: Y.Doc | null;\n  status: GenericDocStatus;\n  /**\n   * Whether the initial server sync completed for the current connection —\n   * `status === 'connected'` fires before the server state arrives, so gate\n   * \"is this doc really empty?\" UI on this.\n   */\n  synced: boolean;\n  accessType: 'r' | 'rw' | null;\n  error: Error | null;\n  presence: PresenceEntry[];\n  setPresence: (state: Record<string, unknown> | null) => void;\n}\n\nexport function useGenericDoc(\n  assetId: string,\n  options?: { access?: 'view' | 'edit' }\n): UseGenericDocResult {\n  const config = useAthenaConfig();\n  const access = options?.access ?? 'view';\n  const [handle, setHandle] = useState<GenericDocHandle | null>(null);\n  const handleRef = useRef<GenericDocHandle | null>(null);\n\n  useEffect(() => {\n    const next = connectGenericDoc({\n      assetId,\n      access,\n      auth: {\n        backendUrl: config.backendUrl,\n        apiKey: config.apiKey,\n        token: config.token,\n      },\n    });\n    handleRef.current = next;\n    setHandle(next);\n    return () => {\n      handleRef.current = null;\n      next.destroy();\n    };\n    // Recreate when the target or credentials change; the handle re-mints on\n    // its own schedule otherwise.\n  }, [assetId, access, config.backendUrl, config.apiKey, config.token]);\n\n  const subscribe = useMemo(() => {\n    return (onStoreChange: () => void) => {\n      if (!handle) return () => {};\n      return handle.onChange(onStoreChange);\n    };\n  }, [handle]);\n\n  const snapshot = useSyncExternalStore(\n    subscribe,\n    () => {\n      if (!handle) return EMPTY_SNAPSHOT;\n      return `${handle.status}|${handle.synced}|${handle.accessType ?? ''}|${handle.version}`;\n    },\n    () => EMPTY_SNAPSHOT\n  );\n  void snapshot;\n\n  return {\n    doc: handle?.doc ?? null,\n    status: handle?.status ?? 'connecting',\n    synced: handle?.synced ?? false,\n    accessType: handle?.accessType ?? null,\n    error: handle?.error ?? null,\n    presence: handle?.getPresence() ?? [],\n    setPresence: (state) => handleRef.current?.setPresence(state),\n  };\n}\n\nconst EMPTY_SNAPSHOT = 'init|false||0';\n"],"names":["useAthenaConfig","useState","useRef","useEffect","connectGenericDoc","useMemo","useSyncExternalStore"],"mappings":";;;;;AAmCO,SAAS,cACd,SACA,SACqB;AACrB,QAAM,SAASA,cAAAA,gBAAA;AACf,QAAM,UAAS,mCAAS,WAAU;AAClC,QAAM,CAAC,QAAQ,SAAS,IAAIC,MAAAA,SAAkC,IAAI;AAClE,QAAM,YAAYC,MAAAA,OAAgC,IAAI;AAEtDC,QAAAA,UAAU,MAAM;AACd,UAAM,OAAOC,OAAAA,kBAAkB;AAAA,MAC7B;AAAA,MACA;AAAA,MACA,MAAM;AAAA,QACJ,YAAY,OAAO;AAAA,QACnB,QAAQ,OAAO;AAAA,QACf,OAAO,OAAO;AAAA,MAAA;AAAA,IAChB,CACD;AACD,cAAU,UAAU;AACpB,cAAU,IAAI;AACd,WAAO,MAAM;AACX,gBAAU,UAAU;AACpB,WAAK,QAAA;AAAA,IACP;AAAA,EAGF,GAAG,CAAC,SAAS,QAAQ,OAAO,YAAY,OAAO,QAAQ,OAAO,KAAK,CAAC;AAEpE,QAAM,YAAYC,MAAAA,QAAQ,MAAM;AAC9B,WAAO,CAAC,kBAA8B;AACpC,UAAI,CAAC,OAAQ,QAAO,MAAM;AAAA,MAAC;AAC3B,aAAO,OAAO,SAAS,aAAa;AAAA,IACtC;AAAA,EACF,GAAG,CAAC,MAAM,CAAC;AAEMC,QAAAA;AAAAA,IACf;AAAA,IACA,MAAM;AACJ,UAAI,CAAC,OAAQ,QAAO;AACpB,aAAO,GAAG,OAAO,MAAM,IAAI,OAAO,MAAM,IAAI,OAAO,cAAc,EAAE,IAAI,OAAO,OAAO;AAAA,IACvF;AAAA,IACA,MAAM;AAAA,EAAA;AAIR,SAAO;AAAA,IACL,MAAK,iCAAQ,QAAO;AAAA,IACpB,SAAQ,iCAAQ,WAAU;AAAA,IAC1B,SAAQ,iCAAQ,WAAU;AAAA,IAC1B,aAAY,iCAAQ,eAAc;AAAA,IAClC,QAAO,iCAAQ,UAAS;AAAA,IACxB,WAAU,iCAAQ,kBAAiB,CAAA;AAAA,IACnC,aAAa,CAAC,UAAA;;AAAU,6BAAU,YAAV,mBAAmB,YAAY;AAAA;AAAA,EAAK;AAEhE;AAEA,MAAM,iBAAiB;;"}
+{"version":3,"file":"react.cjs","sources":["../../src/collab/react.ts"],"sourcesContent":["/**\n * React bindings for Generic Doc live collaboration.\n *\n * `useGenericDoc(assetId)` opens (and owns) a `connectGenericDoc` handle,\n * resolving auth from the surrounding `AthenaProvider` (per-viewer bearer when\n * present, API key otherwise) and re-rendering on status/presence changes via\n * `useSyncExternalStore`.\n */\n\nimport { useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { useAthenaCredentialIdentityEpoch } from '../auth/AthenaCredentialSourceContext';\nimport { useAthenaConfig } from '../provider/AthenaContext';\nimport {\n  type GenericDocHandle,\n  type GenericDocStatus,\n  type PresenceEntry,\n  connectGenericDoc,\n} from './client';\nimport type * as Y from '@y/y';\n\nexport interface UseGenericDocResult {\n  /** Null until the handle is created (first render effect). */\n  doc: Y.Doc | null;\n  status: GenericDocStatus;\n  /**\n   * Whether the initial server sync completed for the current connection —\n   * `status === 'connected'` fires before the server state arrives, so gate\n   * \"is this doc really empty?\" UI on this.\n   */\n  synced: boolean;\n  accessType: 'r' | 'rw' | null;\n  error: Error | null;\n  presence: PresenceEntry[];\n  setPresence: (state: Record<string, unknown> | null) => void;\n}\n\nexport function useGenericDoc(\n  assetId: string,\n  options?: { access?: 'view' | 'edit' }\n): UseGenericDocResult {\n  const config = useAthenaConfig();\n  const identityEpoch = useAthenaCredentialIdentityEpoch();\n  const access = options?.access ?? 'view';\n  const [handle, setHandle] = useState<GenericDocHandle | null>(null);\n  const handleRef = useRef<GenericDocHandle | null>(null);\n\n  useEffect(() => {\n    const next = connectGenericDoc({\n      assetId,\n      access,\n      auth: {\n        backendUrl: config.backendUrl,\n        apiKey: config.apiKey,\n        token: config.token,\n        getToken: config.getToken,\n      },\n    });\n    handleRef.current = next;\n    setHandle(next);\n    return () => {\n      handleRef.current = null;\n      next.destroy();\n    };\n    // Recreate when the target or the signed-in identity changes (the\n    // credential source's identity epoch). A renewed token for the same\n    // identity reaches the next re-mint through `getToken`, so a renewal\n    // does not tear the live connection down.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [assetId, access, config.backendUrl, config.apiKey, config.getToken, identityEpoch]);\n\n  const subscribe = useMemo(() => {\n    return (onStoreChange: () => void) => {\n      if (!handle) return () => {};\n      return handle.onChange(onStoreChange);\n    };\n  }, [handle]);\n\n  const snapshot = useSyncExternalStore(\n    subscribe,\n    () => {\n      if (!handle) return EMPTY_SNAPSHOT;\n      return `${handle.status}|${handle.synced}|${handle.accessType ?? ''}|${handle.version}`;\n    },\n    () => EMPTY_SNAPSHOT\n  );\n  void snapshot;\n\n  return {\n    doc: handle?.doc ?? null,\n    status: handle?.status ?? 'connecting',\n    synced: handle?.synced ?? false,\n    accessType: handle?.accessType ?? null,\n    error: handle?.error ?? null,\n    presence: handle?.getPresence() ?? [],\n    setPresence: (state) => handleRef.current?.setPresence(state),\n  };\n}\n\nconst EMPTY_SNAPSHOT = 'init|false||0';\n"],"names":["useAthenaConfig","useAthenaCredentialIdentityEpoch","useState","useRef","useEffect","connectGenericDoc","useMemo","useSyncExternalStore"],"mappings":";;;;;;AAoCO,SAAS,cACd,SACA,SACqB;AACrB,QAAM,SAASA,cAAAA,gBAAA;AACf,QAAM,gBAAgBC,8BAAAA,iCAAA;AACtB,QAAM,UAAS,mCAAS,WAAU;AAClC,QAAM,CAAC,QAAQ,SAAS,IAAIC,MAAAA,SAAkC,IAAI;AAClE,QAAM,YAAYC,MAAAA,OAAgC,IAAI;AAEtDC,QAAAA,UAAU,MAAM;AACd,UAAM,OAAOC,OAAAA,kBAAkB;AAAA,MAC7B;AAAA,MACA;AAAA,MACA,MAAM;AAAA,QACJ,YAAY,OAAO;AAAA,QACnB,QAAQ,OAAO;AAAA,QACf,OAAO,OAAO;AAAA,QACd,UAAU,OAAO;AAAA,MAAA;AAAA,IACnB,CACD;AACD,cAAU,UAAU;AACpB,cAAU,IAAI;AACd,WAAO,MAAM;AACX,gBAAU,UAAU;AACpB,WAAK,QAAA;AAAA,IACP;AAAA,EAMF,GAAG,CAAC,SAAS,QAAQ,OAAO,YAAY,OAAO,QAAQ,OAAO,UAAU,aAAa,CAAC;AAEtF,QAAM,YAAYC,MAAAA,QAAQ,MAAM;AAC9B,WAAO,CAAC,kBAA8B;AACpC,UAAI,CAAC,OAAQ,QAAO,MAAM;AAAA,MAAC;AAC3B,aAAO,OAAO,SAAS,aAAa;AAAA,IACtC;AAAA,EACF,GAAG,CAAC,MAAM,CAAC;AAEMC,QAAAA;AAAAA,IACf;AAAA,IACA,MAAM;AACJ,UAAI,CAAC,OAAQ,QAAO;AACpB,aAAO,GAAG,OAAO,MAAM,IAAI,OAAO,MAAM,IAAI,OAAO,cAAc,EAAE,IAAI,OAAO,OAAO;AAAA,IACvF;AAAA,IACA,MAAM;AAAA,EAAA;AAIR,SAAO;AAAA,IACL,MAAK,iCAAQ,QAAO;AAAA,IACpB,SAAQ,iCAAQ,WAAU;AAAA,IAC1B,SAAQ,iCAAQ,WAAU;AAAA,IAC1B,aAAY,iCAAQ,eAAc;AAAA,IAClC,QAAO,iCAAQ,UAAS;AAAA,IACxB,WAAU,iCAAQ,kBAAiB,CAAA;AAAA,IACnC,aAAa,CAAC,UAAA;;AAAU,6BAAU,YAAV,mBAAmB,YAAY;AAAA;AAAA,EAAK;AAEhE;AAEA,MAAM,iBAAiB;;"}

package/dist/collab/react.js

@@ -1,8 +1,10 @@
 import { useState, useRef, useEffect, useMemo, useSyncExternalStore } from "react";
+import { useAthenaCredentialIdentityEpoch } from "../auth/AthenaCredentialSourceContext.js";
 import { useAthenaConfig } from "../provider/AthenaContext.js";
 import { connectGenericDoc } from "./client.js";
 function useGenericDoc(assetId, options) {
   const config = useAthenaConfig();
+  const identityEpoch = useAthenaCredentialIdentityEpoch();
   const access = (options == null ? void 0 : options.access) ?? "view";
   const [handle, setHandle] = useState(null);
   const handleRef = useRef(null);
@@ -13,7 +15,8 @@ function useGenericDoc(assetId, options) {
       auth: {
         backendUrl: config.backendUrl,
         apiKey: config.apiKey,
-        token: config.token
+        token: config.token,
+        getToken: config.getToken
       }
     });
     handleRef.current = next;
@@ -22,7 +25,7 @@ function useGenericDoc(assetId, options) {
       handleRef.current = null;
       next.destroy();
     };
-  }, [assetId, access, config.backendUrl, config.apiKey, config.token]);
+  }, [assetId, access, config.backendUrl, config.apiKey, config.getToken, identityEpoch]);
   const subscribe = useMemo(() => {
     return (onStoreChange) => {
       if (!handle) return () => {

package/dist/collab/react.js.map

@@ -1 +1 @@
-{"version":3,"file":"react.js","sources":["../../src/collab/react.ts"],"sourcesContent":["/**\n * React bindings for Generic Doc live collaboration.\n *\n * `useGenericDoc(assetId)` opens (and owns) a `connectGenericDoc` handle,\n * resolving auth from the surrounding `AthenaProvider` (per-viewer bearer when\n * present, API key otherwise) and re-rendering on status/presence changes via\n * `useSyncExternalStore`.\n */\n\nimport { useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { useAthenaConfig } from '../provider/AthenaContext';\nimport {\n  type GenericDocHandle,\n  type GenericDocStatus,\n  type PresenceEntry,\n  connectGenericDoc,\n} from './client';\nimport type * as Y from '@y/y';\n\nexport interface UseGenericDocResult {\n  /** Null until the handle is created (first render effect). */\n  doc: Y.Doc | null;\n  status: GenericDocStatus;\n  /**\n   * Whether the initial server sync completed for the current connection —\n   * `status === 'connected'` fires before the server state arrives, so gate\n   * \"is this doc really empty?\" UI on this.\n   */\n  synced: boolean;\n  accessType: 'r' | 'rw' | null;\n  error: Error | null;\n  presence: PresenceEntry[];\n  setPresence: (state: Record<string, unknown> | null) => void;\n}\n\nexport function useGenericDoc(\n  assetId: string,\n  options?: { access?: 'view' | 'edit' }\n): UseGenericDocResult {\n  const config = useAthenaConfig();\n  const access = options?.access ?? 'view';\n  const [handle, setHandle] = useState<GenericDocHandle | null>(null);\n  const handleRef = useRef<GenericDocHandle | null>(null);\n\n  useEffect(() => {\n    const next = connectGenericDoc({\n      assetId,\n      access,\n      auth: {\n        backendUrl: config.backendUrl,\n        apiKey: config.apiKey,\n        token: config.token,\n      },\n    });\n    handleRef.current = next;\n    setHandle(next);\n    return () => {\n      handleRef.current = null;\n      next.destroy();\n    };\n    // Recreate when the target or credentials change; the handle re-mints on\n    // its own schedule otherwise.\n  }, [assetId, access, config.backendUrl, config.apiKey, config.token]);\n\n  const subscribe = useMemo(() => {\n    return (onStoreChange: () => void) => {\n      if (!handle) return () => {};\n      return handle.onChange(onStoreChange);\n    };\n  }, [handle]);\n\n  const snapshot = useSyncExternalStore(\n    subscribe,\n    () => {\n      if (!handle) return EMPTY_SNAPSHOT;\n      return `${handle.status}|${handle.synced}|${handle.accessType ?? ''}|${handle.version}`;\n    },\n    () => EMPTY_SNAPSHOT\n  );\n  void snapshot;\n\n  return {\n    doc: handle?.doc ?? null,\n    status: handle?.status ?? 'connecting',\n    synced: handle?.synced ?? false,\n    accessType: handle?.accessType ?? null,\n    error: handle?.error ?? null,\n    presence: handle?.getPresence() ?? [],\n    setPresence: (state) => handleRef.current?.setPresence(state),\n  };\n}\n\nconst EMPTY_SNAPSHOT = 'init|false||0';\n"],"names":[],"mappings":";;;AAmCO,SAAS,cACd,SACA,SACqB;AACrB,QAAM,SAAS,gBAAA;AACf,QAAM,UAAS,mCAAS,WAAU;AAClC,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAkC,IAAI;AAClE,QAAM,YAAY,OAAgC,IAAI;AAEtD,YAAU,MAAM;AACd,UAAM,OAAO,kBAAkB;AAAA,MAC7B;AAAA,MACA;AAAA,MACA,MAAM;AAAA,QACJ,YAAY,OAAO;AAAA,QACnB,QAAQ,OAAO;AAAA,QACf,OAAO,OAAO;AAAA,MAAA;AAAA,IAChB,CACD;AACD,cAAU,UAAU;AACpB,cAAU,IAAI;AACd,WAAO,MAAM;AACX,gBAAU,UAAU;AACpB,WAAK,QAAA;AAAA,IACP;AAAA,EAGF,GAAG,CAAC,SAAS,QAAQ,OAAO,YAAY,OAAO,QAAQ,OAAO,KAAK,CAAC;AAEpE,QAAM,YAAY,QAAQ,MAAM;AAC9B,WAAO,CAAC,kBAA8B;AACpC,UAAI,CAAC,OAAQ,QAAO,MAAM;AAAA,MAAC;AAC3B,aAAO,OAAO,SAAS,aAAa;AAAA,IACtC;AAAA,EACF,GAAG,CAAC,MAAM,CAAC;AAEM;AAAA,IACf;AAAA,IACA,MAAM;AACJ,UAAI,CAAC,OAAQ,QAAO;AACpB,aAAO,GAAG,OAAO,MAAM,IAAI,OAAO,MAAM,IAAI,OAAO,cAAc,EAAE,IAAI,OAAO,OAAO;AAAA,IACvF;AAAA,IACA,MAAM;AAAA,EAAA;AAIR,SAAO;AAAA,IACL,MAAK,iCAAQ,QAAO;AAAA,IACpB,SAAQ,iCAAQ,WAAU;AAAA,IAC1B,SAAQ,iCAAQ,WAAU;AAAA,IAC1B,aAAY,iCAAQ,eAAc;AAAA,IAClC,QAAO,iCAAQ,UAAS;AAAA,IACxB,WAAU,iCAAQ,kBAAiB,CAAA;AAAA,IACnC,aAAa,CAAC,UAAA;;AAAU,6BAAU,YAAV,mBAAmB,YAAY;AAAA;AAAA,EAAK;AAEhE;AAEA,MAAM,iBAAiB;"}
+{"version":3,"file":"react.js","sources":["../../src/collab/react.ts"],"sourcesContent":["/**\n * React bindings for Generic Doc live collaboration.\n *\n * `useGenericDoc(assetId)` opens (and owns) a `connectGenericDoc` handle,\n * resolving auth from the surrounding `AthenaProvider` (per-viewer bearer when\n * present, API key otherwise) and re-rendering on status/presence changes via\n * `useSyncExternalStore`.\n */\n\nimport { useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';\nimport { useAthenaCredentialIdentityEpoch } from '../auth/AthenaCredentialSourceContext';\nimport { useAthenaConfig } from '../provider/AthenaContext';\nimport {\n  type GenericDocHandle,\n  type GenericDocStatus,\n  type PresenceEntry,\n  connectGenericDoc,\n} from './client';\nimport type * as Y from '@y/y';\n\nexport interface UseGenericDocResult {\n  /** Null until the handle is created (first render effect). */\n  doc: Y.Doc | null;\n  status: GenericDocStatus;\n  /**\n   * Whether the initial server sync completed for the current connection —\n   * `status === 'connected'` fires before the server state arrives, so gate\n   * \"is this doc really empty?\" UI on this.\n   */\n  synced: boolean;\n  accessType: 'r' | 'rw' | null;\n  error: Error | null;\n  presence: PresenceEntry[];\n  setPresence: (state: Record<string, unknown> | null) => void;\n}\n\nexport function useGenericDoc(\n  assetId: string,\n  options?: { access?: 'view' | 'edit' }\n): UseGenericDocResult {\n  const config = useAthenaConfig();\n  const identityEpoch = useAthenaCredentialIdentityEpoch();\n  const access = options?.access ?? 'view';\n  const [handle, setHandle] = useState<GenericDocHandle | null>(null);\n  const handleRef = useRef<GenericDocHandle | null>(null);\n\n  useEffect(() => {\n    const next = connectGenericDoc({\n      assetId,\n      access,\n      auth: {\n        backendUrl: config.backendUrl,\n        apiKey: config.apiKey,\n        token: config.token,\n        getToken: config.getToken,\n      },\n    });\n    handleRef.current = next;\n    setHandle(next);\n    return () => {\n      handleRef.current = null;\n      next.destroy();\n    };\n    // Recreate when the target or the signed-in identity changes (the\n    // credential source's identity epoch). A renewed token for the same\n    // identity reaches the next re-mint through `getToken`, so a renewal\n    // does not tear the live connection down.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [assetId, access, config.backendUrl, config.apiKey, config.getToken, identityEpoch]);\n\n  const subscribe = useMemo(() => {\n    return (onStoreChange: () => void) => {\n      if (!handle) return () => {};\n      return handle.onChange(onStoreChange);\n    };\n  }, [handle]);\n\n  const snapshot = useSyncExternalStore(\n    subscribe,\n    () => {\n      if (!handle) return EMPTY_SNAPSHOT;\n      return `${handle.status}|${handle.synced}|${handle.accessType ?? ''}|${handle.version}`;\n    },\n    () => EMPTY_SNAPSHOT\n  );\n  void snapshot;\n\n  return {\n    doc: handle?.doc ?? null,\n    status: handle?.status ?? 'connecting',\n    synced: handle?.synced ?? false,\n    accessType: handle?.accessType ?? null,\n    error: handle?.error ?? null,\n    presence: handle?.getPresence() ?? [],\n    setPresence: (state) => handleRef.current?.setPresence(state),\n  };\n}\n\nconst EMPTY_SNAPSHOT = 'init|false||0';\n"],"names":[],"mappings":";;;;AAoCO,SAAS,cACd,SACA,SACqB;AACrB,QAAM,SAAS,gBAAA;AACf,QAAM,gBAAgB,iCAAA;AACtB,QAAM,UAAS,mCAAS,WAAU;AAClC,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAkC,IAAI;AAClE,QAAM,YAAY,OAAgC,IAAI;AAEtD,YAAU,MAAM;AACd,UAAM,OAAO,kBAAkB;AAAA,MAC7B;AAAA,MACA;AAAA,MACA,MAAM;AAAA,QACJ,YAAY,OAAO;AAAA,QACnB,QAAQ,OAAO;AAAA,QACf,OAAO,OAAO;AAAA,QACd,UAAU,OAAO;AAAA,MAAA;AAAA,IACnB,CACD;AACD,cAAU,UAAU;AACpB,cAAU,IAAI;AACd,WAAO,MAAM;AACX,gBAAU,UAAU;AACpB,WAAK,QAAA;AAAA,IACP;AAAA,EAMF,GAAG,CAAC,SAAS,QAAQ,OAAO,YAAY,OAAO,QAAQ,OAAO,UAAU,aAAa,CAAC;AAEtF,QAAM,YAAY,QAAQ,MAAM;AAC9B,WAAO,CAAC,kBAA8B;AACpC,UAAI,CAAC,OAAQ,QAAO,MAAM;AAAA,MAAC;AAC3B,aAAO,OAAO,SAAS,aAAa;AAAA,IACtC;AAAA,EACF,GAAG,CAAC,MAAM,CAAC;AAEM;AAAA,IACf;AAAA,IACA,MAAM;AACJ,UAAI,CAAC,OAAQ,QAAO;AACpB,aAAO,GAAG,OAAO,MAAM,IAAI,OAAO,MAAM,IAAI,OAAO,cAAc,EAAE,IAAI,OAAO,OAAO;AAAA,IACvF;AAAA,IACA,MAAM;AAAA,EAAA;AAIR,SAAO;AAAA,IACL,MAAK,iCAAQ,QAAO;AAAA,IACpB,SAAQ,iCAAQ,WAAU;AAAA,IAC1B,SAAQ,iCAAQ,WAAU;AAAA,IAC1B,aAAY,iCAAQ,eAAc;AAAA,IAClC,QAAO,iCAAQ,UAAS;AAAA,IACxB,WAAU,iCAAQ,kBAAiB,CAAA;AAAA,IACnC,aAAa,CAAC,UAAA;;AAAU,6BAAU,YAAV,mBAAmB,YAAY;AAAA;AAAA,EAAK;AAEhE;AAEA,MAAM,iBAAiB;"}

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

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const react = require("react");
 const AthenaContext = require("../provider/AthenaContext.cjs");
-const statewireAuthHeaders = require("../runtime/statewire-auth-headers.cjs");
+const credentialRenewal = require("../runtime/credential-renewal.cjs");
 const dictationEngine = require("./dictation-engine.cjs");
 const recordedDictationEngine = require("./recorded-dictation-engine.cjs");
 function transcriptionUploadUrl(backendUrl) {
@@ -28,17 +28,18 @@ function transcriptionUploadErrorMessage(status) {
 function createAthenaUploadTranscriber(getConfig) {
   return async (clip, { lang, signal }) => {
     const config = getConfig();
-    const headers = await statewireAuthHeaders.resolveStatewireAuthHeaders(config, { staleAuth: false });
-    const form = new FormData();
     const extension = clip.type.includes("mp4") ? "mp4" : clip.type.includes("ogg") ? "ogg" : "webm";
-    form.append("file", clip, `dictation.${extension}`);
-    if (lang) form.append("language", lang);
-    const response = await fetch(transcriptionUploadUrl(config.backendUrl), {
-      method: "POST",
-      headers,
-      body: form,
-      credentials: "include",
-      signal
+    const response = await credentialRenewal.sendWithCredentialRenewal(config, (headers) => {
+      const form = new FormData();
+      form.append("file", clip, `dictation.${extension}`);
+      if (lang) form.append("language", lang);
+      return fetch(transcriptionUploadUrl(config.backendUrl), {
+        method: "POST",
+        headers,
+        body: form,
+        credentials: "include",
+        signal
+      });
     });
     if (!response.ok) throw new Error(transcriptionUploadErrorMessage(response.status));
     const payload = await response.json();

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 { resolveStatewireAuthHeaders } from '../runtime/statewire-auth-headers';\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. The session language (host `lang`\n * or the document's) is forwarded so non-English speech is recognised as\n * 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 headers = await resolveStatewireAuthHeaders(config, { staleAuth: false });\n    const form = new FormData();\n    const extension = clip.type.includes('mp4') ? 'mp4' : clip.type.includes('ogg') ? 'ogg' : 'webm';\n    form.append('file', clip, `dictation.${extension}`);\n    if (lang) form.append('language', lang);\n    const response = await fetch(transcriptionUploadUrl(config.backendUrl), {\n      method: 'POST',\n      headers,\n      body: form,\n      credentials: 'include',\n      signal,\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":["resolveStatewireAuthHeaders","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;AASO,SAAS,8BACd,WACsB;AACtB,SAAO,OAAO,MAAM,EAAE,MAAM,aAAa;AACvC,UAAM,SAAS,UAAA;AACf,UAAM,UAAU,MAAMA,qBAAAA,4BAA4B,QAAQ,EAAE,WAAW,OAAO;AAC9E,UAAM,OAAO,IAAI,SAAA;AACjB,UAAM,YAAY,KAAK,KAAK,SAAS,KAAK,IAAI,QAAQ,KAAK,KAAK,SAAS,KAAK,IAAI,QAAQ;AAC1F,SAAK,OAAO,QAAQ,MAAM,aAAa,SAAS,EAAE;AAClD,QAAI,KAAM,MAAK,OAAO,YAAY,IAAI;AACtC,UAAM,WAAW,MAAM,MAAM,uBAAuB,OAAO,UAAU,GAAG;AAAA,MACtE,QAAQ;AAAA,MACR;AAAA,MACA,MAAM;AAAA,MACN,aAAa;AAAA,MACb;AAAA,IAAA,CACD;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,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;;;;;"}

package/dist/dictation/use-athena-dictation-engine.d.ts

@@ -11,9 +11,10 @@ export declare function transcriptionUploadErrorMessage(status: number): string;
 /**
  * Post a finished clip to agora's `/transcription/upload` route, which runs
  * it through Deepgram and returns the text. Credentials are read at call
- * time so a rotated token is picked up. The session language (host `lang`
- * or the document's) is forwarded so non-English speech is recognised as
- * such; the request is dropped when the engine aborts.
+ * time so a rotated token is picked up, and a `401` gets one forced renewal
+ * (`getToken({ force: true })`) and a resend before it fails. The session
+ * language (host `lang` or the document's) is forwarded so non-English speech
+ * is recognised as such; the request is dropped when the engine aborts.
  */
 export declare function createAthenaUploadTranscriber(getConfig: () => Pick<AthenaConfig, 'backendUrl' | 'apiKey' | 'token' | 'getToken'>): DictationTranscriber;
 /**

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

@@ -1,6 +1,6 @@
 import { useRef, useMemo } from "react";
 import { useAthenaConfig } from "../provider/AthenaContext.js";
-import { resolveStatewireAuthHeaders } from "../runtime/statewire-auth-headers.js";
+import { sendWithCredentialRenewal } from "../runtime/credential-renewal.js";
 import { createWebSpeechDictationEngine } from "./dictation-engine.js";
 import { createRecordedDictationEngine } from "./recorded-dictation-engine.js";
 function transcriptionUploadUrl(backendUrl) {
@@ -26,17 +26,18 @@ function transcriptionUploadErrorMessage(status) {
 function createAthenaUploadTranscriber(getConfig) {
   return async (clip, { lang, signal }) => {
     const config = getConfig();
-    const headers = await resolveStatewireAuthHeaders(config, { staleAuth: false });
-    const form = new FormData();
     const extension = clip.type.includes("mp4") ? "mp4" : clip.type.includes("ogg") ? "ogg" : "webm";
-    form.append("file", clip, `dictation.${extension}`);
-    if (lang) form.append("language", lang);
-    const response = await fetch(transcriptionUploadUrl(config.backendUrl), {
-      method: "POST",
-      headers,
-      body: form,
-      credentials: "include",
-      signal
+    const response = await sendWithCredentialRenewal(config, (headers) => {
+      const form = new FormData();
+      form.append("file", clip, `dictation.${extension}`);
+      if (lang) form.append("language", lang);
+      return fetch(transcriptionUploadUrl(config.backendUrl), {
+        method: "POST",
+        headers,
+        body: form,
+        credentials: "include",
+        signal
+      });
     });
     if (!response.ok) throw new Error(transcriptionUploadErrorMessage(response.status));
     const payload = await response.json();

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

@@ -1 +1 @@
-{"version":3,"file":"use-athena-dictation-engine.js","sources":["../../src/dictation/use-athena-dictation-engine.ts"],"sourcesContent":["import { useMemo, useRef } from 'react';\nimport { type AthenaConfig, useAthenaConfig } from '../provider/AthenaContext';\nimport { resolveStatewireAuthHeaders } from '../runtime/statewire-auth-headers';\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. The session language (host `lang`\n * or the document's) is forwarded so non-English speech is recognised as\n * 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 headers = await resolveStatewireAuthHeaders(config, { staleAuth: false });\n    const form = new FormData();\n    const extension = clip.type.includes('mp4') ? 'mp4' : clip.type.includes('ogg') ? 'ogg' : 'webm';\n    form.append('file', clip, `dictation.${extension}`);\n    if (lang) form.append('language', lang);\n    const response = await fetch(transcriptionUploadUrl(config.backendUrl), {\n      method: 'POST',\n      headers,\n      body: form,\n      credentials: 'include',\n      signal,\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":[],"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;AASO,SAAS,8BACd,WACsB;AACtB,SAAO,OAAO,MAAM,EAAE,MAAM,aAAa;AACvC,UAAM,SAAS,UAAA;AACf,UAAM,UAAU,MAAM,4BAA4B,QAAQ,EAAE,WAAW,OAAO;AAC9E,UAAM,OAAO,IAAI,SAAA;AACjB,UAAM,YAAY,KAAK,KAAK,SAAS,KAAK,IAAI,QAAQ,KAAK,KAAK,SAAS,KAAK,IAAI,QAAQ;AAC1F,SAAK,OAAO,QAAQ,MAAM,aAAa,SAAS,EAAE;AAClD,QAAI,KAAM,MAAK,OAAO,YAAY,IAAI;AACtC,UAAM,WAAW,MAAM,MAAM,uBAAuB,OAAO,UAAU,GAAG;AAAA,MACtE,QAAQ;AAAA,MACR;AAAA,MACA,MAAM;AAAA,MACN,aAAa;AAAA,MACb;AAAA,IAAA,CACD;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,SAAS,gBAAA;AACf,QAAM,YAAY,OAAO,MAAM;AAC/B,YAAU,UAAU;AACpB,SAAO,QAAQ,MAAM;AACnB,QAAI,SAAU,QAAO;AACrB,UAAM,WAAW,8BAA8B;AAAA,MAC7C,YAAY,8BAA8B,MAAM,UAAU,OAAO;AAAA,IAAA,CAClE;AACD,WAAO,SAAS,gBAAgB,WAAW,+BAAA;AAAA,EAC7C,GAAG,CAAC,QAAQ,CAAC;AACf;"}
+{"version":3,"file":"use-athena-dictation-engine.js","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":[],"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,MAAM,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,SAAS,gBAAA;AACf,QAAM,YAAY,OAAO,MAAM;AAC/B,YAAU,UAAU;AACpB,SAAO,QAAQ,MAAM;AACnB,QAAI,SAAU,QAAO;AACrB,UAAM,WAAW,8BAA8B;AAAA,MAC7C,YAAY,8BAA8B,MAAM,UAAU,OAAO;AAAA,IAAA,CAClE;AACD,WAAO,SAAS,gBAAgB,WAAW,+BAAA;AAAA,EAC7C,GAAG,CAAC,QAAQ,CAAC;AACf;"}

package/dist/index.d.ts

@@ -148,7 +148,7 @@ export type { AthenaStatewireRuntimeConfig } from './runtime/useAthenaStatewireR
 export { buildStatewireRunConfig } from './runtime/statewire-run-config';
 export type { StatewireRunConfigOptions } from './runtime/statewire-run-config';
 export { useParentAuth, useParentBridge } from './runtime/auth';
-export type { ParentBridgeState } from './runtime/auth';
+export type { ParentBridge, ParentBridgeState } from './runtime/auth';
 export { createAthenaSpacesUrl, DEFAULT_APP_URL, DEFAULT_STATEWIRE_SYNC_URL, deriveAthenaApiUrl, deriveAthenaAppUrl, deriveStatewireSyncUrl, resolveStatewireSyncUrl, } from './lib/athena-urls';
 export type { AthenaEnvironment } from './lib/athena-urls';
 export { Button, buttonVariants } from './ui/button';

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const version = "0.24.1";
+const version = "0.25.0";
 const packageJson = {
   version
 };

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

@@ -1,4 +1,4 @@
-const version = "0.24.1";
+const version = "0.25.0";
 const packageJson = {
   version
 };

package/dist/provider/AthenaContext.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"AthenaContext.cjs","sources":["../../src/provider/AthenaContext.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\nimport type { AthenaStatewireTokenGetter } from '../runtime/statewire-auth-headers';\nimport type { AthenaProviderConfig } from './config';\nimport type { AthenaCitationLinkOptions, AthenaLinkClickOptions } from './citation-links';\n\nexport interface AthenaConfig extends Pick<AthenaProviderConfig, 'apiKey' | 'token'> {\n  backendUrl: string;\n  /** The host's live token resolver, for SDK hooks that call agora's REST surface directly. */\n  getToken?: AthenaStatewireTokenGetter;\n  appUrl: string;\n  enabledToolkits: string[];\n  linkClicks?: AthenaLinkClickOptions;\n  citationLinks?: AthenaCitationLinkOptions;\n}\n\nexport const AthenaContext = createContext<AthenaConfig | null>(null);\n\nexport function useAthenaConfig(): AthenaConfig {\n  const ctx = useContext(AthenaContext);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useAthenaConfig must be used within <AthenaProvider>');\n  }\n  return ctx;\n}\n"],"names":["createContext","useContext"],"mappings":";;;AAeO,MAAM,gBAAgBA,MAAAA,cAAmC,IAAI;AAE7D,SAAS,kBAAgC;AAC9C,QAAM,MAAMC,MAAAA,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,kEAAkE;AAAA,EACpF;AACA,SAAO;AACT;;;"}
+{"version":3,"file":"AthenaContext.cjs","sources":["../../src/provider/AthenaContext.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\nimport type { AthenaStatewireTokenGetter } from '../runtime/statewire-auth-headers';\nimport type { AthenaProviderConfig } from './config';\nimport type { AthenaCitationLinkOptions, AthenaLinkClickOptions } from './citation-links';\n\nexport interface AthenaConfig extends Pick<AthenaProviderConfig, 'apiKey' | 'token'> {\n  backendUrl: string;\n  /**\n   * The SDK's live token resolver, for SDK hooks that call agora's REST\n   * surface directly. Every sign-in mode feeds it (the host's `getToken`, a\n   * sign-in provider, the Marathon or parent-window bridge); pass\n   * `{ force: true }` after a 401 to renew the token before one resend.\n   * Undefined when there is no token to resolve (API key alone).\n   */\n  getToken?: AthenaStatewireTokenGetter;\n  appUrl: string;\n  enabledToolkits: string[];\n  linkClicks?: AthenaLinkClickOptions;\n  citationLinks?: AthenaCitationLinkOptions;\n}\n\nexport const AthenaContext = createContext<AthenaConfig | null>(null);\n\nexport function useAthenaConfig(): AthenaConfig {\n  const ctx = useContext(AthenaContext);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useAthenaConfig must be used within <AthenaProvider>');\n  }\n  return ctx;\n}\n"],"names":["createContext","useContext"],"mappings":";;;AAqBO,MAAM,gBAAgBA,MAAAA,cAAmC,IAAI;AAE7D,SAAS,kBAAgC;AAC9C,QAAM,MAAMC,MAAAA,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,kEAAkE;AAAA,EACpF;AACA,SAAO;AACT;;;"}

package/dist/provider/AthenaContext.d.ts

@@ -3,7 +3,13 @@ import type { AthenaProviderConfig } from './config';
 import type { AthenaCitationLinkOptions, AthenaLinkClickOptions } from './citation-links';
 export interface AthenaConfig extends Pick<AthenaProviderConfig, 'apiKey' | 'token'> {
     backendUrl: string;
-    /** The host's live token resolver, for SDK hooks that call agora's REST surface directly. */
+    /**
+     * The SDK's live token resolver, for SDK hooks that call agora's REST
+     * surface directly. Every sign-in mode feeds it (the host's `getToken`, a
+     * sign-in provider, the Marathon or parent-window bridge); pass
+     * `{ force: true }` after a 401 to renew the token before one resend.
+     * Undefined when there is no token to resolve (API key alone).
+     */
     getToken?: AthenaStatewireTokenGetter;
     appUrl: string;
     enabledToolkits: string[];

package/dist/provider/AthenaContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"AthenaContext.js","sources":["../../src/provider/AthenaContext.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\nimport type { AthenaStatewireTokenGetter } from '../runtime/statewire-auth-headers';\nimport type { AthenaProviderConfig } from './config';\nimport type { AthenaCitationLinkOptions, AthenaLinkClickOptions } from './citation-links';\n\nexport interface AthenaConfig extends Pick<AthenaProviderConfig, 'apiKey' | 'token'> {\n  backendUrl: string;\n  /** The host's live token resolver, for SDK hooks that call agora's REST surface directly. */\n  getToken?: AthenaStatewireTokenGetter;\n  appUrl: string;\n  enabledToolkits: string[];\n  linkClicks?: AthenaLinkClickOptions;\n  citationLinks?: AthenaCitationLinkOptions;\n}\n\nexport const AthenaContext = createContext<AthenaConfig | null>(null);\n\nexport function useAthenaConfig(): AthenaConfig {\n  const ctx = useContext(AthenaContext);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useAthenaConfig must be used within <AthenaProvider>');\n  }\n  return ctx;\n}\n"],"names":[],"mappings":";AAeO,MAAM,gBAAgB,cAAmC,IAAI;AAE7D,SAAS,kBAAgC;AAC9C,QAAM,MAAM,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,kEAAkE;AAAA,EACpF;AACA,SAAO;AACT;"}
+{"version":3,"file":"AthenaContext.js","sources":["../../src/provider/AthenaContext.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\nimport type { AthenaStatewireTokenGetter } from '../runtime/statewire-auth-headers';\nimport type { AthenaProviderConfig } from './config';\nimport type { AthenaCitationLinkOptions, AthenaLinkClickOptions } from './citation-links';\n\nexport interface AthenaConfig extends Pick<AthenaProviderConfig, 'apiKey' | 'token'> {\n  backendUrl: string;\n  /**\n   * The SDK's live token resolver, for SDK hooks that call agora's REST\n   * surface directly. Every sign-in mode feeds it (the host's `getToken`, a\n   * sign-in provider, the Marathon or parent-window bridge); pass\n   * `{ force: true }` after a 401 to renew the token before one resend.\n   * Undefined when there is no token to resolve (API key alone).\n   */\n  getToken?: AthenaStatewireTokenGetter;\n  appUrl: string;\n  enabledToolkits: string[];\n  linkClicks?: AthenaLinkClickOptions;\n  citationLinks?: AthenaCitationLinkOptions;\n}\n\nexport const AthenaContext = createContext<AthenaConfig | null>(null);\n\nexport function useAthenaConfig(): AthenaConfig {\n  const ctx = useContext(AthenaContext);\n  if (!ctx) {\n    throw new Error('[AthenaSDK] useAthenaConfig must be used within <AthenaProvider>');\n  }\n  return ctx;\n}\n"],"names":[],"mappings":";AAqBO,MAAM,gBAAgB,cAAmC,IAAI;AAE7D,SAAS,kBAAgC;AAC9C,QAAM,MAAM,WAAW,aAAa;AACpC,MAAI,CAAC,KAAK;AACR,UAAM,IAAI,MAAM,kEAAkE;AAAA,EACpF;AACA,SAAO;AACT;"}

package/dist/provider/AthenaProvider.cjs

@@ -7,6 +7,9 @@ const athenaUrls = require("../lib/athena-urls.cjs");
 const mint = require("../collab/mint.cjs");
 const auth = require("../runtime/auth.cjs");
 const AthenaAuthContext = require("../auth/AthenaAuthContext.cjs");
+const AthenaCredentialSourceContext = require("../auth/AthenaCredentialSourceContext.cjs");
+const credentialSource = require("../auth/credential-source.cjs");
+const authRefusalRestart = require("../runtime/auth-refusal-restart.cjs");
 const useAthenaStatewireRuntime = require("../runtime/useAthenaStatewireRuntime.cjs");
 const statewireLifecycle = require("../runtime/statewire-lifecycle.cjs");
 const statewireRunConfig = require("../runtime/statewire-run-config.cjs");
@@ -150,6 +153,10 @@ function AthenaStatewireRuntimeMount({
       dispatchLifecycle({ type: "raw-connection", reconnect: connection.reconnect });
     }
   });
+  authRefusalRestart.useRestartAfterAuthRefusal({
+    connection: lifecycle.connection,
+    reconnect: lifecycle.reconnect
+  });
   const dismissError = react.useCallback(
     () => dispatchLifecycle({ type: "error", error: null }),
     []
@@ -414,6 +421,20 @@ function AthenaProvider({
     [composerHandoff$1]
   );
   const effectiveToken = configuredToken !== void 0 ? configuredToken : authProviderToken ?? bridge.token;
+  const authProviderGetToken = authContext == null ? void 0 : authContext.getToken;
+  const credentialInputsRef = react.useRef({ token: null });
+  credentialInputsRef.current = {
+    hostGetToken: configuredGetToken,
+    token: effectiveToken,
+    renew: configuredToken !== void 0 ? void 0 : authProviderToken !== null ? authProviderGetToken ? async ({ force }) => await authProviderGetToken({ force }) ?? null : void 0 : bridge.token !== null ? bridge.renewToken : void 0
+  };
+  const [credentials] = react.useState(
+    () => credentialSource.createAthenaCredentialSource(() => credentialInputsRef.current)
+  );
+  react.useEffect(() => {
+    credentials.notifyTokenChanged();
+  }, [credentials, effectiveToken]);
+  const credentialGetToken = configuredGetToken !== void 0 || effectiveToken ? credentials.getToken : void 0;
   const effectiveApiUrl = configuredApiUrl ?? environmentUrls.apiUrl;
   const effectiveBackendUrl = mint.getAthenaApiBaseUrl(
     configuredBackendUrl ?? bridge.backendBaseUrl ?? environmentUrls.backendUrl
@@ -439,7 +460,7 @@ function AthenaProvider({
     appUrl: effectiveAppUrl,
     apiKey: configuredApiKey,
     token: effectiveToken,
-    getToken: configuredGetToken,
+    getToken: credentialGetToken,
     model,
     agent,
     channel,
@@ -470,7 +491,7 @@ function AthenaProvider({
     {
       className: themeStyleVars ? "athena-sdk athena-themed" : "athena-sdk",
       style: themeStyleVars,
-      children: /* @__PURE__ */ jsxRuntime.jsx(PostHogProvider.PostHogProvider, { config: posthogConfig, children: /* @__PURE__ */ jsxRuntime.jsx(composerHandoff.ComposerHandoffContext.Provider, { value: composerHandoff$1, children: /* @__PURE__ */ jsxRuntime.jsx(themeStyleContext.AthenaThemeStyleContext.Provider, { value: themeStyleVars, children: inner }) }) })
+      children: /* @__PURE__ */ jsxRuntime.jsx(PostHogProvider.PostHogProvider, { config: posthogConfig, children: /* @__PURE__ */ jsxRuntime.jsx(composerHandoff.ComposerHandoffContext.Provider, { value: composerHandoff$1, children: /* @__PURE__ */ jsxRuntime.jsx(themeStyleContext.AthenaThemeStyleContext.Provider, { value: themeStyleVars, children: /* @__PURE__ */ jsxRuntime.jsx(AthenaCredentialSourceContext.AthenaCredentialSourceContext.Provider, { value: credentials, children: inner }) }) }) })
     }
   );
 }