@athenaintel/react 0.30.0 → 0.35.0

package/dist/collab/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sources":["../../src/collab/client.ts"],"sourcesContent":["/**\n * Vanilla (framework-agnostic) live client for Generic Doc assets.\n *\n * `connectGenericDoc` owns the full connection lifecycle: mint a room-bound\n * token via the public API, open the Keryx WebSocket with the v14 provider\n * (`@y/websocket` + `@y/y`), re-mint before expiry, apply the close-code\n * policy (4401 → one fresh mint, other 44xx → permanent stop, everything\n * else → provider backoff), and expose presence from awareness. React apps\n * use `useGenericDoc` from `@athenaintel/react/collab` instead of calling\n * this directly.\n *\n * A host that keeps a local copy of the document (`localCopy`) gets it applied\n * before the first connection, keeps its unacknowledged edits waiting across\n * sessions, and can hold a connection that would send edits made without one\n * until it has checked them against the server (`beforeConnect`). Offline, a\n * mint that fails for want of the network is retried (`retryMintError`)\n * instead of ending the handle, and past `offlineGateAfterMs` without a socket\n * the handle reconnects itself, re-minting each time, so every reconnect after\n * a real outage re-checks access and passes the host's gate.\n */\n\nimport { WebsocketProvider } from '@y/websocket';\nimport * as Y from '@y/y';\nimport { classifyClose } from './close-policy';\nimport {\n  type CollabAuth,\n  type CollabTokenResponse,\n  CollabTokenError,\n  mintCollabToken,\n} from './mint';\nimport { MAX_CONSECUTIVE_REMINTS, MIN_REFRESH_DELAY_MS, refreshDelayMs } from './token-refresh';\n\nexport type GenericDocStatus =\n  | 'connecting'\n  | 'connected'\n  | 'disconnected'\n  | 'closed'\n  | 'error';\n\nexport interface PresenceEntry {\n  clientId: number;\n  state: Record<string, unknown>;\n}\n\nexport interface GenericDocHandle {\n  /** The live shared document. Owned by the handle; destroyed with it. */\n  readonly doc: Y.Doc;\n  readonly status: GenericDocStatus;\n  /**\n   * Whether the initial server sync has completed for the current connection.\n   * `status === 'connected'` fires before the server state arrives, so a doc\n   * read immediately after connect can still be empty — gate first reads on\n   * this (or `waitForSync`).\n   */\n  readonly synced: boolean;\n  /**\n   * Whether every change made to this document has reached the server: `false` from a local edit\n   * until the server sends it back (`@y/websocket`'s `syncStatus.localUpdatesSynced`; yhub echoes\n   * every update to its sender). Kept across reconnects and re-mints: a replaced provider hands its\n   * unconfirmed edits to the next, and an edit made between providers waits for one. A host that\n   * closes the document while this is `false` loses those edits, unless a local copy keeps them.\n   */\n  readonly localChangesSynced: boolean;\n  /** Granted access from the last successful mint. */\n  readonly accessType: 'r' | 'rw' | null;\n  /** Terminal error, when status is 'error' or 'closed'. */\n  readonly error: Error | null;\n  /**\n   * Whether the document holds what the host's local copy stored (always `true` without one).\n   * Mount readers after it: until then the document is still empty.\n   */\n  readonly prepared: boolean;\n  /**\n   * A connection the host's `beforeConnect` held: the handle waits, sending nothing, until the\n   * host calls `resume()` (or destroys the handle).\n   */\n  readonly held: boolean;\n  /** Monotonic change counter — bumps on every status/presence notification. */\n  readonly version: number;\n  /**\n   * Resolve once the initial server sync completes; reject on timeout, on a\n   * terminal connection state, or if the handle is destroyed first.\n   */\n  waitForSync: (timeoutMs?: number) => Promise<void>;\n  getPresence: () => PresenceEntry[];\n  /** Broadcast this client's presence state (requires a live connection). */\n  setPresence: (state: Record<string, unknown> | null) => void;\n  /**\n   * Force an early token refresh. Session-preserving: the live connection\n   * stays up until the fresh token is minted; a failed mint retries on a\n   * short timer instead of dropping the session. Without a connection it\n   * reconnects now.\n   */\n  refreshNow: () => Promise<void>;\n  /** Connect past a hold, without asking `beforeConnect` again. */\n  resume: () => void;\n  /** Local edits the server has not echoed yet (handed between providers too), or `null`. */\n  unconfirmedEdits: () => Y.ContentIds | null;\n  onChange: (listener: () => void) => () => void;\n  destroy: () => void;\n}\n\n/**\n * Issues a room-bound Keryx token for one asset. The default calls the public\n * `/collab-token` route with the handle's `auth`; a host with its own trusted\n * mint (a desktop app's main process holding the user's key) passes one\n * instead, and the handle uses it for the first mint and every re-mint.\n */\nexport type CollabMint = (params: {\n  assetId: string;\n  access: 'view' | 'edit';\n}) => Promise<CollabTokenResponse>;\n\n/** What a host's local copy reads of the handle's transport. */\nexport interface GenericDocTransportView {\n  /** True for a transaction the transport applied (the server's state, a peer's edit). */\n  isRemoteOrigin: (origin: unknown) => boolean;\n  /** Local edits the server has not echoed yet, or `null`. */\n  getUnconfirmed: () => Y.ContentIds | null;\n  /** Connected, past the initial sync, and nothing unconfirmed. */\n  isFullySynced: () => boolean;\n}\n\n/** What `beforeConnect` is asked about. */\nexport interface GenericDocConnectGate {\n  /** The grant the connection would use (its access is the server's current verdict). */\n  grant: CollabTokenResponse;\n  /** The handle has not connected yet. */\n  firstConnection: boolean;\n  /** How long the handle had been without a connection, when it had one before. */\n  offlineForMs: number | null;\n  /** Local edits made without a connection (or inherited from an earlier session) wait to be sent. */\n  hasUnsyncedEdits: boolean;\n}\n\n/** A host's local copy of the document (`@athenaintel/local-copy` behind a host's glue). */\nexport interface GenericDocLocalCopy {\n  /**\n   * Called once, before the first mint: apply the stored copy to `doc` and return the local edits\n   * it holds that the server never acknowledged. The handle sends them and waits for their echo\n   * like its own. A failure here must resolve `{ unsyncedEdits: null }`: the handle then runs\n   * without a copy.\n   */\n  prepare: (params: {\n    doc: Y.Doc;\n    transport: GenericDocTransportView;\n  }) => Promise<{ unsyncedEdits: Y.ContentIds | null }>;\n  /** The handle's unconfirmed edits or sync state changed. */\n  transportChanged: () => void;\n  /**\n   * Asked after each mint and before the connection it would open: the first connection, a\n   * reconnect after an outage longer than `offlineGateAfterMs`, and a re-mint after a revocation\n   * (never a scheduled token refresh of a live connection, never past `resume()`). The host\n   * checks what it must before anything is sent (the document still opens here; access; edits\n   * made without a connection against the server's). `'hold'` keeps the handle from connecting\n   * until `resume()`; a throw counts as \"not yet\" and is asked again on the next attempt.\n   */\n  beforeConnect?: (gate: GenericDocConnectGate) => Promise<'connect' | 'hold'>;\n}\n\n/** After this long without a socket, the handle reconnects itself (re-mint, gate) instead of the provider. */\nexport const DEFAULT_OFFLINE_GATE_AFTER_MS = 15_000;\n\n/** Retry delays for a mint that failed for want of the network. */\nconst MINT_RETRY_DELAYS_MS = [1_000, 2_000, 4_000, 8_000, 15_000, 30_000, 60_000];\n\n/**\n * The default `retryMintError`: a network failure, a timeout, a rate limit or a server error is\n * worth retrying; a refusal (401/403/404) is the server's verdict and ends the handle.\n */\nexport function isRetryableMintError(error: unknown): boolean {\n  if (error instanceof CollabTokenError) {\n    return error.status >= 500 || error.status === 408 || error.status === 429;\n  }\n  return error instanceof TypeError || (error instanceof DOMException && error.name === 'TimeoutError');\n}\n\nfunction resolveMint({ auth, mint }: { auth?: CollabAuth; mint?: CollabMint }): CollabMint {\n  if (mint) return mint;\n  if (!auth) throw new Error('connectGenericDoc needs `auth` or `mint`');\n  return ({ assetId, access }) => mintCollabToken({ auth, assetId, access });\n}\n\nexport function connectGenericDoc(args: {\n  assetId: string;\n  /** Credentials for the default mint; not used when `mint` is given. */\n  auth?: CollabAuth;\n  access?: 'view' | 'edit';\n  mint?: CollabMint;\n  /** A local copy of the document the host keeps (see {@link GenericDocLocalCopy}). */\n  localCopy?: GenericDocLocalCopy;\n  /** Whether a failed mint is worth retrying; defaults to {@link isRetryableMintError}. */\n  retryMintError?: (error: unknown) => boolean;\n  /** See {@link DEFAULT_OFFLINE_GATE_AFTER_MS}. */\n  offlineGateAfterMs?: number;\n}): GenericDocHandle {\n  const access = args.access ?? 'view';\n  const mint = resolveMint({ auth: args.auth, mint: args.mint });\n  const localCopy = args.localCopy;\n  const retryMintError = args.retryMintError ?? isRetryableMintError;\n  const offlineGateAfterMs = args.offlineGateAfterMs ?? DEFAULT_OFFLINE_GATE_AFTER_MS;\n  const doc = new Y.Doc();\n  const listeners = new Set<() => void>();\n\n  let provider: WebsocketProvider | null = null;\n  let refreshTimer: ReturnType<typeof setTimeout> | null = null;\n  let retryTimer: ReturnType<typeof setTimeout> | null = null;\n  let offlineTimer: ReturnType<typeof setTimeout> | null = null;\n  /** The provider whose socket was still opening, with nothing to send, at the threshold. */\n  let openingPastThreshold: WebsocketProvider | null = null;\n  let mintRetries = 0;\n  let destroyed = false;\n  let status: GenericDocStatus = 'connecting';\n  let synced = false;\n  let accessType: 'r' | 'rw' | null = null;\n  let error: Error | null = null;\n  let lastPresence: Record<string, unknown> | null = null;\n  let version = 0;\n  let consecutiveRemints = 0;\n  let prepared = localCopy === undefined;\n  let held = false;\n  let heldGrant: CollabTokenResponse | null = null;\n  let everConnected = false;\n  let disconnectedSince: number | null = null;\n  /** Bumped by every connect attempt: an attempt that finds it changed after an await stops. */\n  let connectSeq = 0;\n  /** Local edits no provider holds: handed on by a replaced provider, or made with none. */\n  let carriedUpdates: WebsocketProvider['unconfirmedUpdates'] = [];\n  let localChangesSynced = true;\n\n  const notify = () => {\n    version += 1;\n    for (const listener of listeners) listener();\n  };\n\n  const unconfirmedEdits = (): Y.ContentIds | null => {\n    const all = [...carriedUpdates, ...(provider?.unconfirmedUpdates ?? [])].map(\n      (entry) => entry.ids as Y.ContentIds\n    );\n    if (all.length === 0) return null;\n    return all.length === 1 ? (all[0] as Y.ContentIds) : Y.mergeContentIds(all);\n  };\n\n  const transport: GenericDocTransportView = {\n    isRemoteOrigin: (origin) => origin instanceof WebsocketProvider,\n    getUnconfirmed: unconfirmedEdits,\n    isFullySynced: () => status === 'connected' && synced && localChangesSynced,\n  };\n\n  const transportChanged = () => {\n    localCopy?.transportChanged();\n  };\n\n  const refreshLocalChangesSynced = () => {\n    const next = carriedUpdates.length === 0 && (provider?.unconfirmedUpdates.length ?? 0) === 0;\n    if (next !== localChangesSynced) {\n      localChangesSynced = next;\n      notify();\n    }\n    // After the flag: the copy reads `isFullySynced()` in its callback.\n    transportChanged();\n  };\n\n  // An edit made while no provider exists (a re-mint in flight, offline) is sent by the next one,\n  // which takes it as unconfirmed. The local copy's own load is not an edit.\n  doc.on('update', (update: Uint8Array, origin: unknown) => {\n    if (!prepared || provider !== null || destroyed || origin instanceof WebsocketProvider) return;\n    carriedUpdates = [\n      ...carriedUpdates,\n      { created: Date.now(), ids: Y.createContentIdsFromUpdate(update) },\n    ];\n    refreshLocalChangesSynced();\n  });\n\n  const setStatus = (next: GenericDocStatus, err: Error | null = null) => {\n    if (destroyed && next !== 'closed') return;\n    const wasConnected = status === 'connected';\n    status = next;\n    error = err;\n    if (next === 'connected') {\n      everConnected = true;\n      disconnectedSince = null;\n      clearOfflineTimer();\n    } else if (wasConnected || (everConnected && disconnectedSince === null)) {\n      disconnectedSince = Date.now();\n    }\n    transportChanged();\n    notify();\n  };\n\n  const clearRefreshTimer = () => {\n    if (refreshTimer !== null) {\n      clearTimeout(refreshTimer);\n      refreshTimer = null;\n    }\n  };\n\n  const clearRetryTimer = () => {\n    if (retryTimer !== null) {\n      clearTimeout(retryTimer);\n      retryTimer = null;\n    }\n  };\n\n  function clearOfflineTimer() {\n    if (offlineTimer !== null) {\n      clearTimeout(offlineTimer);\n      offlineTimer = null;\n    }\n  }\n\n  const teardownProvider = () => {\n    clearRefreshTimer();\n    // A future provider must complete its own initial sync; the doc keeps its\n    // content either way. Subscribers must observe the flip immediately —\n    // waiting for the next provider event would let them act on synced=true\n    // across the replacement gap.\n    if (synced) {\n      synced = false;\n      notify();\n    }\n    if (provider) {\n      // Its unconfirmed edits outlive it: the next provider sends them and waits for their echo.\n      carriedUpdates = [...carriedUpdates, ...provider.unconfirmedUpdates];\n      provider.destroy();\n      provider = null;\n    }\n  };\n\n  const scheduleRefresh = (grant: CollabTokenResponse) => {\n    clearRefreshTimer();\n    const delay = refreshDelayMs({ expiresAtMs: grant.expires_at_ms, now: Date.now() });\n    refreshTimer = setTimeout(() => {\n      void connect({ scheduledRefresh: true });\n    }, delay);\n  };\n\n  /** A failed attempt that is worth retrying: try again later, or as soon as the network returns. */\n  const scheduleRetry = () => {\n    clearRetryTimer();\n    const delay = MINT_RETRY_DELAYS_MS[Math.min(mintRetries, MINT_RETRY_DELAYS_MS.length - 1)];\n    mintRetries += 1;\n    retryTimer = setTimeout(() => {\n      retryTimer = null;\n      void connect();\n    }, delay);\n  };\n\n  const onBrowserOnline = () => {\n    // Only a handle waiting to retry: a refused or permanently closed one stays stopped.\n    if (destroyed || status === 'closed' || status === 'error' || provider !== null || held) return;\n    mintRetries = 0;\n    clearRetryTimer();\n    void connect();\n  };\n  if (typeof window !== 'undefined') window.addEventListener('online', onBrowserOnline);\n\n  /**\n   * Past the gate's threshold without a socket, the handle reconnects itself (re-mint, gate). A\n   * socket still being opened with nothing waiting to be sent is left to finish (a slow network\n   * is not restarted every threshold), and the handle looks again a threshold later; if it opens\n   * holding edits made since, they go through the gate first (`status`).\n   */\n  const armOfflineTakeover = () => {\n    if (offlineTimer !== null || !localCopy?.beforeConnect) return;\n    offlineTimer = setTimeout(() => {\n      offlineTimer = null;\n      if (destroyed || status === 'connected' || provider === null) return;\n      if (provider.wsconnecting && !hasUnsyncedLocalEdits()) {\n        openingPastThreshold = provider;\n        armOfflineTakeover();\n        return;\n      }\n      teardownProvider();\n      void connect();\n    }, offlineGateAfterMs);\n  };\n\n  const hasUnsyncedLocalEdits = () =>\n    carriedUpdates.length > 0 || (provider?.unconfirmedUpdates.length ?? 0) > 0;\n\n\n  const connect = async (opts?: {\n    scheduledRefresh?: boolean;\n    skipGate?: boolean;\n    grant?: CollabTokenResponse;\n  }): Promise<void> => {\n    if (destroyed) return;\n    await preparing;\n    if (destroyed) return;\n    const seq = ++connectSeq;\n    // Only a live connection is refreshed in place (and skips the host's gate); a refresh while the\n    // socket is down is a reconnect like any other.\n    const scheduledRefresh = opts?.scheduledRefresh === true && status === 'connected';\n    // A scheduled refresh mints FIRST and keeps the live session up: the old\n    // token has ~5 minutes of headroom, so a transient mint failure retries\n    // on a short timer instead of dropping a healthy connection.\n    if (!scheduledRefresh) {\n      teardownProvider();\n    } else {\n      clearRefreshTimer();\n    }\n    clearRetryTimer();\n    let grant: CollabTokenResponse;\n    if (opts?.grant && opts.grant.expires_at_ms - Date.now() > MIN_REFRESH_DELAY_MS) {\n      grant = opts.grant;\n    } else {\n      try {\n        grant = await mint({ assetId: args.assetId, access });\n      } catch (err) {\n        if (destroyed || seq !== connectSeq) return;\n        if (scheduledRefresh) {\n          refreshTimer = setTimeout(() => {\n            void connect({ scheduledRefresh: true });\n          }, MIN_REFRESH_DELAY_MS);\n          return;\n        }\n        if (retryMintError(err)) {\n          // Offline (or the mint's server is): keep the document and try again.\n          if (status !== 'disconnected') setStatus('disconnected');\n          scheduleRetry();\n          return;\n        }\n        // A denied mint is authoritative (revoked / not shared / not eligible).\n        setStatus('error', err instanceof Error ? err : new Error(String(err)));\n        return;\n      }\n    }\n    if (destroyed || seq !== connectSeq) return;\n    mintRetries = 0;\n    accessType = grant.access_type;\n    const beforeConnect = localCopy?.beforeConnect;\n    if (beforeConnect && !scheduledRefresh && !opts?.skipGate) {\n      const firstConnection = !everConnected;\n      const offlineForMs = disconnectedSince === null ? null : Date.now() - disconnectedSince;\n      let decision: 'connect' | 'hold';\n      try {\n        decision = await beforeConnect({\n          grant,\n          firstConnection,\n          offlineForMs,\n          hasUnsyncedEdits: hasUnsyncedLocalEdits(),\n        });\n      } catch {\n        if (destroyed || seq !== connectSeq) return;\n        if (status !== 'disconnected') setStatus('disconnected');\n        scheduleRetry();\n        return;\n      }\n      if (destroyed || seq !== connectSeq) return;\n      if (decision === 'hold') {\n        held = true;\n        heldGrant = grant;\n        if (status !== 'disconnected') setStatus('disconnected');\n        else notify();\n        return;\n      }\n    }\n    if (scheduledRefresh) {\n      teardownProvider();\n    }\n\n    const nextProvider = new WebsocketProvider(grant.ws_url, `${grant.org}/${grant.doc_id}`, doc, {\n      params: {\n        yauth: grant.token,\n        branch: grant.branch,\n        gc: 'true',\n      },\n      // BroadcastChannel would sync same-origin clients locally, bypassing the\n      // server's permission enforcement (a read-only tab could write into an\n      // editor tab's doc). Permissioned docs must round-trip the server.\n      disableBc: true,\n    });\n    provider = nextProvider;\n    nextProvider.unconfirmedUpdates = [...carriedUpdates, ...nextProvider.unconfirmedUpdates];\n    carriedUpdates = [];\n    refreshLocalChangesSynced();\n\n    nextProvider.on('sync-status', () => {\n      if (provider !== nextProvider) return;\n      refreshLocalChangesSynced();\n    });\n\n    nextProvider.on('status', (event: { status: 'connecting' | 'connected' | 'disconnected' }) => {\n      if (provider !== nextProvider) return;\n      if (\n        event.status === 'connected' &&\n        openingPastThreshold === nextProvider &&\n        hasUnsyncedLocalEdits()\n      ) {\n        // Opened after the threshold holding edits made meanwhile: before its handshake sends\n        // them (`@y/websocket` reports `connected` first), they go through the gate.\n        teardownProvider();\n        void connect();\n        return;\n      }\n      if (event.status === 'connected') {\n        consecutiveRemints = 0;\n      }\n      setStatus(event.status);\n      if (event.status === 'connected' && lastPresence !== null) {\n        nextProvider.awareness.setLocalState(lastPresence);\n      }\n      // `@y/websocket` reports `disconnected` only for a socket that had opened: one that never\n      // opens (the server unreachable while the mint goes through) only ever reports `connecting`,\n      // and is just as offline.\n      if (event.status !== 'connected') armOfflineTakeover();\n    });\n    // Its first `connecting` came from its constructor, before this listener existed.\n    if (!nextProvider.wsconnected) armOfflineTakeover();\n\n    nextProvider.on('sync', (state: boolean) => {\n      if (provider !== nextProvider) return;\n      if (synced !== state) {\n        synced = state;\n        transportChanged();\n        notify();\n      }\n    });\n\n    nextProvider.on('connection-close', (event: CloseEvent | null) => {\n      if (provider !== nextProvider) return;\n      const action = classifyClose(event?.code);\n      if (action === 'remint') {\n        // Revoked mid-session: a fresh mint re-runs the server-side permission\n        // check. If access is truly gone the mint 403s and we land in 'error'.\n        // Bounded: repeated 4401s without an intervening successful connect\n        // mean the server keeps rejecting freshly minted tokens — stop rather\n        // than loop mint→connect→kick.\n        consecutiveRemints += 1;\n        teardownProvider();\n        if (consecutiveRemints > MAX_CONSECUTIVE_REMINTS) {\n          setStatus(\n            'closed',\n            new Error('Access repeatedly revoked mid-session (4401); giving up.')\n          );\n          return;\n        }\n        void connect();\n      } else if (action === 'stop') {\n        teardownProvider();\n        setStatus(\n          'closed',\n          new Error(`Connection closed permanently (code ${event?.code ?? 'unknown'})`)\n        );\n      }\n      // 'retry': the provider's exponential backoff handles it, until the offline takeover.\n    });\n\n    nextProvider.awareness.on('change', () => {\n      if (provider !== nextProvider) return;\n      notify();\n    });\n\n    scheduleRefresh(grant);\n  };\n\n  const preparing: Promise<void> = localCopy\n    ? localCopy\n        .prepare({ doc, transport })\n        .catch(() => ({ unsyncedEdits: null }))\n        .then(({ unsyncedEdits }) => {\n          if (destroyed) return;\n          if (unsyncedEdits && !(unsyncedEdits.inserts.isEmpty() && unsyncedEdits.deletes.isEmpty())) {\n            carriedUpdates = [...carriedUpdates, { created: Date.now(), ids: unsyncedEdits }];\n          }\n          prepared = true;\n          refreshLocalChangesSynced();\n          notify();\n        })\n    : Promise.resolve();\n\n  void connect();\n\n  const waitForSync = (timeoutMs = 15_000): Promise<void> =>\n    new Promise<void>((resolve, reject) => {\n      const terminal = (): Error | null => {\n        if (destroyed) return new Error('Handle destroyed before initial sync');\n        if (status === 'closed' || status === 'error') {\n          return error ?? new Error(`Connection ${status} before initial sync`);\n        }\n        return null;\n      };\n      if (synced) {\n        resolve();\n        return;\n      }\n      const immediate = terminal();\n      if (immediate) {\n        reject(immediate);\n        return;\n      }\n      const cleanup = () => {\n        clearTimeout(timer);\n        listeners.delete(listener);\n      };\n      const timer = setTimeout(() => {\n        cleanup();\n        reject(new Error(`Timed out after ${timeoutMs}ms waiting for initial sync`));\n      }, timeoutMs);\n      const listener = () => {\n        if (synced) {\n          cleanup();\n          resolve();\n          return;\n        }\n        const err = terminal();\n        if (err) {\n          cleanup();\n          reject(err);\n        }\n      };\n      listeners.add(listener);\n    });\n\n  return {\n    doc,\n    get status() {\n      return status;\n    },\n    get synced() {\n      return synced;\n    },\n    get localChangesSynced() {\n      return localChangesSynced;\n    },\n    get accessType() {\n      return accessType;\n    },\n    get error() {\n      return error;\n    },\n    get prepared() {\n      return prepared;\n    },\n    get held() {\n      return held;\n    },\n    get version() {\n      return version;\n    },\n    waitForSync,\n    getPresence: () => {\n      if (!provider) return [];\n      const entries: PresenceEntry[] = [];\n      provider.awareness.getStates().forEach((state, clientId) => {\n        entries.push({ clientId, state: state as Record<string, unknown> });\n      });\n      return entries;\n    },\n    setPresence: (state) => {\n      lastPresence = state;\n      provider?.awareness.setLocalState(state);\n    },\n    refreshNow: () => {\n      if (held) return Promise.resolve();\n      return provider ? connect({ scheduledRefresh: true }) : connect();\n    },\n    resume: () => {\n      if (!held || destroyed) return;\n      held = false;\n      const grant = heldGrant;\n      heldGrant = null;\n      notify();\n      void connect({ skipGate: true, grant: grant ?? undefined });\n    },\n    unconfirmedEdits,\n    onChange: (listener) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    destroy: () => {\n      if (destroyed) return;\n      destroyed = true;\n      teardownProvider();\n      clearRetryTimer();\n      clearOfflineTimer();\n      if (typeof window !== 'undefined') window.removeEventListener('online', onBrowserOnline);\n      status = 'closed';\n      // Final notification so pending waitForSync callers reject instead of\n      // hanging on listeners that are about to be dropped.\n      for (const listener of [...listeners]) listener();\n      listeners.clear();\n      doc.destroy();\n    },\n  };\n}\n\nexport { CollabTokenError };\nexport type { CollabAuth, CollabTokenResponse };\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sources":["../../src/collab/client.ts"],"sourcesContent":["/**\n * Vanilla (framework-agnostic) live client for Generic Doc assets.\n *\n * `connectGenericDoc` owns the full connection lifecycle: mint a room-bound\n * token via the public API, open the Keryx WebSocket with the v14 provider\n * (`@y/websocket` + `@y/y`), re-mint before expiry, apply the close-code\n * policy (4401 → one fresh mint, other 44xx → permanent stop, everything\n * else → provider backoff), and expose presence from awareness. React apps\n * use `useGenericDoc` from `@athenaintel/react/collab` instead of calling\n * this directly.\n *\n * A host that keeps a local copy of the document (`localCopy`) gets it applied\n * before the first connection, keeps its unacknowledged edits waiting across\n * sessions, and can hold a connection that would send edits made without one\n * until it has checked them against the server (`beforeConnect`). Offline, a\n * mint that fails for want of the network is retried (`retryMintError`)\n * instead of ending the handle, and past `offlineGateAfterMs` without a socket\n * the handle reconnects itself, re-minting each time, so every reconnect after\n * a real outage re-checks access and passes the host's gate.\n */\n\nimport { WebsocketProvider } from '@y/websocket';\nimport * as Y from '@y/y';\nimport { classifyClose } from './close-policy';\nimport {\n  type CollabAuth,\n  type CollabTokenResponse,\n  CollabTokenError,\n  mintCollabToken,\n} from './mint';\nimport { MAX_CONSECUTIVE_REMINTS, MIN_REFRESH_DELAY_MS, refreshDelayMs } from './token-refresh';\n\nexport type GenericDocStatus =\n  | 'connecting'\n  | 'connected'\n  | 'disconnected'\n  | 'closed'\n  | 'error';\n\nexport interface PresenceEntry {\n  clientId: number;\n  state: Record<string, unknown>;\n}\n\nexport interface GenericDocHandle {\n  /** The live shared document. Owned by the handle; destroyed with it. */\n  readonly doc: Y.Doc;\n  readonly status: GenericDocStatus;\n  /**\n   * Whether the initial server sync has completed for the current connection.\n   * `status === 'connected'` fires before the server state arrives, so a doc\n   * read immediately after connect can still be empty — gate first reads on\n   * this (or `waitForSync`).\n   */\n  readonly synced: boolean;\n  /**\n   * Whether every change made to this document has reached the server: `false` from a local edit\n   * until the server sends it back (`@y/websocket`'s `syncStatus.localUpdatesSynced`; yhub echoes\n   * every update to its sender). Kept across reconnects and re-mints: a replaced provider hands its\n   * unconfirmed edits to the next, and an edit made between providers waits for one. A host that\n   * closes the document while this is `false` loses those edits, unless a local copy keeps them.\n   */\n  readonly localChangesSynced: boolean;\n  /** Granted access from the last successful mint. */\n  readonly accessType: 'r' | 'rw' | null;\n  /** Terminal error, when status is 'error' or 'closed'. */\n  readonly error: Error | null;\n  /**\n   * Whether the document holds what the host's local copy stored (always `true` without one).\n   * Mount readers after it: until then the document is still empty.\n   */\n  readonly prepared: boolean;\n  /** Whether this host allows a live connection. Disabled documents remain editable locally. */\n  readonly connectionEnabled: boolean;\n  /**\n   * A connection the host's `beforeConnect` held: the handle waits, sending nothing, until the\n   * host calls `resume()` (or destroys the handle).\n   */\n  readonly held: boolean;\n  /** Monotonic change counter — bumps on every status/presence notification. */\n  readonly version: number;\n  /**\n   * Resolve once the initial server sync completes; reject on timeout, on a\n   * terminal connection state, or if the handle is destroyed first.\n   */\n  waitForSync: (timeoutMs?: number) => Promise<void>;\n  /**\n   * Resolve once connected, initially synced, and every local change has been acknowledged,\n   * including any edits the local-copy hook restores after sync. The host must prevent further\n   * editing while saving a checkpoint. Reject on timeout, a disabled connection, or a terminal state.\n   */\n  waitForAcknowledged: (timeoutMs?: number) => Promise<void>;\n  getPresence: () => PresenceEntry[];\n  /** Broadcast this client's presence state (requires a live connection). */\n  setPresence: (state: Record<string, unknown> | null) => void;\n  /**\n   * Force an early token refresh. Session-preserving: the live connection\n   * stays up until the fresh token is minted; a failed mint retries on a\n   * short timer instead of dropping the session. Without a connection it\n   * reconnects now.\n   */\n  refreshNow: () => Promise<void>;\n  /**\n   * Disable all connections without losing the document or its pending edits. Enabling mints a\n   * fresh grant and runs the host's beforeConnect gate; it never bypasses a permission or review.\n   */\n  setConnectionEnabled: (enabled: boolean) => void;\n  /** Connect past a hold, without asking `beforeConnect` again. */\n  resume: () => void;\n  /** Local edits the server has not echoed yet (handed between providers too), or `null`. */\n  unconfirmedEdits: () => Y.ContentIds | null;\n  onChange: (listener: () => void) => () => void;\n  destroy: () => void;\n}\n\n/**\n * Issues a room-bound Keryx token for one asset. The default calls the public\n * `/collab-token` route with the handle's `auth`; a host with its own trusted\n * mint (a desktop app's main process holding the user's key) passes one\n * instead, and the handle uses it for the first mint and every re-mint.\n */\nexport type CollabMint = (params: {\n  assetId: string;\n  access: 'view' | 'edit';\n}) => Promise<CollabTokenResponse>;\n\n/** What a host's local copy reads of the handle's transport. */\nexport interface GenericDocTransportView {\n  /** True for a transaction the transport applied (the server's state, a peer's edit). */\n  isRemoteOrigin: (origin: unknown) => boolean;\n  /** Local edits the server has not echoed yet, or `null`. */\n  getUnconfirmed: () => Y.ContentIds | null;\n  /** Connected, past the initial sync, and nothing unconfirmed. */\n  isFullySynced: () => boolean;\n}\n\n/** What `beforeConnect` is asked about. */\nexport interface GenericDocConnectGate {\n  /** The grant the connection would use (its access is the server's current verdict). */\n  grant: CollabTokenResponse;\n  /** The handle has not connected yet. */\n  firstConnection: boolean;\n  /** How long the handle had been without a connection, when it had one before. */\n  offlineForMs: number | null;\n  /** Local edits made without a connection (or inherited from an earlier session) wait to be sent. */\n  hasUnsyncedEdits: boolean;\n}\n\n/** A host's local copy of the document (`@athenaintel/local-copy` behind a host's glue). */\nexport interface GenericDocLocalCopy {\n  /**\n   * Called once, before the first mint: apply the stored copy to `doc` and return the local edits\n   * it holds that the server never acknowledged. The handle sends them and waits for their echo\n   * like its own. A failure here must resolve `{ unsyncedEdits: null }`: the handle then runs\n   * without a copy.\n   */\n  prepare: (params: {\n    doc: Y.Doc;\n    transport: GenericDocTransportView;\n  }) => Promise<{ unsyncedEdits: Y.ContentIds | null }>;\n  /** The handle's unconfirmed edits or sync state changed. */\n  transportChanged: () => void;\n  /**\n   * An explicit host pause/resume policy changed. Invalidate decisions that must be checked afresh\n   * before a later manual save. A pause runs after its provider is destroyed and its status is\n   * disconnected, so edits restored by the hook stay local. A resume runs before minting.\n   * Network retries and an immediate conflict `resume()` do not call it.\n   */\n  connectionPolicyChanged?: (enabled: boolean) => void;\n  /**\n   * Asked after each mint and before the connection it would open: the first connection, a\n   * reconnect after an outage longer than `offlineGateAfterMs`, and a re-mint after a revocation\n   * (never a scheduled token refresh of a live connection, never past `resume()`). The host\n   * checks what it must before anything is sent (the document still opens here; access; edits\n   * made without a connection against the server's). `'hold'` keeps the handle from connecting\n   * until `resume()`; a throw counts as \"not yet\" and is asked again on the next attempt.\n   */\n  beforeConnect?: (gate: GenericDocConnectGate) => Promise<'connect' | 'hold'>;\n}\n\n/** After this long without a socket, the handle reconnects itself (re-mint, gate) instead of the provider. */\nexport const DEFAULT_OFFLINE_GATE_AFTER_MS = 15_000;\n\n/** Retry delays for a mint that failed for want of the network. */\nconst MINT_RETRY_DELAYS_MS = [1_000, 2_000, 4_000, 8_000, 15_000, 30_000, 60_000];\n\n/**\n * The default `retryMintError`: a network failure, a timeout, a rate limit or a server error is\n * worth retrying; a refusal (401/403/404) is the server's verdict and ends the handle.\n */\nexport function isRetryableMintError(error: unknown): boolean {\n  if (error instanceof CollabTokenError) {\n    return error.status >= 500 || error.status === 408 || error.status === 429;\n  }\n  return error instanceof TypeError || (error instanceof DOMException && error.name === 'TimeoutError');\n}\n\nfunction resolveMint({ auth, mint }: { auth?: CollabAuth; mint?: CollabMint }): CollabMint {\n  if (mint) return mint;\n  if (!auth) throw new Error('connectGenericDoc needs `auth` or `mint`');\n  return ({ assetId, access }) => mintCollabToken({ auth, assetId, access });\n}\n\nexport function connectGenericDoc(args: {\n  assetId: string;\n  /** Credentials for the default mint; not used when `mint` is given. */\n  auth?: CollabAuth;\n  access?: 'view' | 'edit';\n  mint?: CollabMint;\n  /** A local copy of the document the host keeps (see {@link GenericDocLocalCopy}). */\n  localCopy?: GenericDocLocalCopy;\n  /** Whether a failed mint is worth retrying; defaults to {@link isRetryableMintError}. */\n  retryMintError?: (error: unknown) => boolean;\n  /** See {@link DEFAULT_OFFLINE_GATE_AFTER_MS}. */\n  offlineGateAfterMs?: number;\n  /** Start without connecting or minting (for a host's manual-save mode). Defaults to true. */\n  connectionEnabled?: boolean;\n}): GenericDocHandle {\n  const access = args.access ?? 'view';\n  const mint = resolveMint({ auth: args.auth, mint: args.mint });\n  const localCopy = args.localCopy;\n  const retryMintError = args.retryMintError ?? isRetryableMintError;\n  const offlineGateAfterMs = args.offlineGateAfterMs ?? DEFAULT_OFFLINE_GATE_AFTER_MS;\n  const doc = new Y.Doc();\n  const listeners = new Set<() => void>();\n\n  let provider: WebsocketProvider | null = null;\n  let refreshTimer: ReturnType<typeof setTimeout> | null = null;\n  let retryTimer: ReturnType<typeof setTimeout> | null = null;\n  let offlineTimer: ReturnType<typeof setTimeout> | null = null;\n  /** The provider whose socket was still opening, with nothing to send, at the threshold. */\n  let openingPastThreshold: WebsocketProvider | null = null;\n  let mintRetries = 0;\n  let destroyed = false;\n  let connectionEnabled = args.connectionEnabled ?? true;\n  let status: GenericDocStatus = connectionEnabled ? 'connecting' : 'disconnected';\n  let synced = false;\n  let accessType: 'r' | 'rw' | null = null;\n  let error: Error | null = null;\n  let lastPresence: Record<string, unknown> | null = null;\n  let version = 0;\n  let consecutiveRemints = 0;\n  let prepared = localCopy === undefined;\n  let held = false;\n  let heldGrant: CollabTokenResponse | null = null;\n  let everConnected = false;\n  let disconnectedSince: number | null = null;\n  /** Bumped by every connect attempt: an attempt that finds it changed after an await stops. */\n  let connectSeq = 0;\n  /** Local edits no provider holds: handed on by a replaced provider, or made with none. */\n  let carriedUpdates: WebsocketProvider['unconfirmedUpdates'] = [];\n  let localChangesSynced = true;\n\n  const notify = () => {\n    version += 1;\n    for (const listener of listeners) listener();\n  };\n\n  const unconfirmedEdits = (): Y.ContentIds | null => {\n    const all = [...carriedUpdates, ...(provider?.unconfirmedUpdates ?? [])].map(\n      (entry) => entry.ids as Y.ContentIds\n    );\n    if (all.length === 0) return null;\n    return all.length === 1 ? (all[0] as Y.ContentIds) : Y.mergeContentIds(all);\n  };\n\n  const transport: GenericDocTransportView = {\n    isRemoteOrigin: (origin) => origin instanceof WebsocketProvider,\n    getUnconfirmed: unconfirmedEdits,\n    isFullySynced: () => status === 'connected' && synced && localChangesSynced,\n  };\n\n  const transportChanged = () => {\n    localCopy?.transportChanged();\n  };\n\n  const refreshLocalChangesSynced = () => {\n    const next = carriedUpdates.length === 0 && (provider?.unconfirmedUpdates.length ?? 0) === 0;\n    const changed = next !== localChangesSynced;\n    localChangesSynced = next;\n    // After the flag: the copy reads `isFullySynced()` in its callback.\n    // Before notifying: the callback can restore values and create more unconfirmed edits.\n    transportChanged();\n    if (changed) notify();\n  };\n\n  // An edit made while no provider exists (a re-mint in flight, offline) is sent by the next one,\n  // which takes it as unconfirmed. The local copy's own load is not an edit.\n  doc.on('update', (update: Uint8Array, origin: unknown) => {\n    if (!prepared || provider !== null || destroyed || origin instanceof WebsocketProvider) return;\n    carriedUpdates = [\n      ...carriedUpdates,\n      { created: Date.now(), ids: Y.createContentIdsFromUpdate(update) },\n    ];\n    refreshLocalChangesSynced();\n  });\n\n  const setStatus = (next: GenericDocStatus, err: Error | null = null) => {\n    if (destroyed && next !== 'closed') return;\n    const wasConnected = status === 'connected';\n    status = next;\n    error = err;\n    if (next === 'connected') {\n      everConnected = true;\n      disconnectedSince = null;\n      clearOfflineTimer();\n    } else if (wasConnected || (everConnected && disconnectedSince === null)) {\n      disconnectedSince = Date.now();\n    }\n    transportChanged();\n    notify();\n  };\n\n  const clearRefreshTimer = () => {\n    if (refreshTimer !== null) {\n      clearTimeout(refreshTimer);\n      refreshTimer = null;\n    }\n  };\n\n  const clearRetryTimer = () => {\n    if (retryTimer !== null) {\n      clearTimeout(retryTimer);\n      retryTimer = null;\n    }\n  };\n\n  function clearOfflineTimer() {\n    if (offlineTimer !== null) {\n      clearTimeout(offlineTimer);\n      offlineTimer = null;\n    }\n  }\n\n  const teardownProvider = () => {\n    clearRefreshTimer();\n    // A future provider must complete its own initial sync; the doc keeps its\n    // content either way. Subscribers must observe the flip immediately —\n    // waiting for the next provider event would let them act on synced=true\n    // across the replacement gap.\n    if (synced) {\n      synced = false;\n      notify();\n    }\n    if (provider) {\n      // Its unconfirmed edits outlive it: the next provider sends them and waits for their echo.\n      const previous = provider;\n      provider = null;\n      carriedUpdates = [...carriedUpdates, ...previous.unconfirmedUpdates];\n      previous.destroy();\n    }\n  };\n\n  const scheduleRefresh = (grant: CollabTokenResponse) => {\n    clearRefreshTimer();\n    const delay = refreshDelayMs({ expiresAtMs: grant.expires_at_ms, now: Date.now() });\n    refreshTimer = setTimeout(() => {\n      void connect({ scheduledRefresh: true });\n    }, delay);\n  };\n\n  /** A failed attempt that is worth retrying: try again later, or as soon as the network returns. */\n  const scheduleRetry = () => {\n    clearRetryTimer();\n    const delay = MINT_RETRY_DELAYS_MS[Math.min(mintRetries, MINT_RETRY_DELAYS_MS.length - 1)];\n    mintRetries += 1;\n    retryTimer = setTimeout(() => {\n      retryTimer = null;\n      void connect();\n    }, delay);\n  };\n\n  const onBrowserOnline = () => {\n    // Only a handle waiting to retry: a refused or permanently closed one stays stopped.\n    if (\n      destroyed || !connectionEnabled || status === 'closed' || status === 'error' ||\n      provider !== null || held\n    ) return;\n    mintRetries = 0;\n    clearRetryTimer();\n    void connect();\n  };\n  if (typeof window !== 'undefined') window.addEventListener('online', onBrowserOnline);\n\n  /**\n   * Past the gate's threshold without a socket, the handle reconnects itself (re-mint, gate). A\n   * socket still being opened with nothing waiting to be sent is left to finish (a slow network\n   * is not restarted every threshold), and the handle looks again a threshold later; if it opens\n   * holding edits made since, they go through the gate first (`status`).\n   */\n  const armOfflineTakeover = () => {\n    if (!connectionEnabled || offlineTimer !== null || !localCopy?.beforeConnect) return;\n    offlineTimer = setTimeout(() => {\n      offlineTimer = null;\n      if (destroyed || !connectionEnabled || status === 'connected' || provider === null) return;\n      if (provider.wsconnecting && !hasUnsyncedLocalEdits()) {\n        openingPastThreshold = provider;\n        armOfflineTakeover();\n        return;\n      }\n      teardownProvider();\n      void connect();\n    }, offlineGateAfterMs);\n  };\n\n  const hasUnsyncedLocalEdits = () =>\n    carriedUpdates.length > 0 || (provider?.unconfirmedUpdates.length ?? 0) > 0;\n\n\n  const connect = async (opts?: {\n    scheduledRefresh?: boolean;\n    skipGate?: boolean;\n    grant?: CollabTokenResponse;\n  }): Promise<void> => {\n    if (destroyed || !connectionEnabled) return;\n    const seq = ++connectSeq;\n    await preparing;\n    if (destroyed || !connectionEnabled || seq !== connectSeq) return;\n    // Only a live connection is refreshed in place (and skips the host's gate); a refresh while the\n    // socket is down is a reconnect like any other.\n    const scheduledRefresh = opts?.scheduledRefresh === true && status === 'connected';\n    // A scheduled refresh mints FIRST and keeps the live session up: the old\n    // token has ~5 minutes of headroom, so a transient mint failure retries\n    // on a short timer instead of dropping a healthy connection.\n    if (!scheduledRefresh) {\n      teardownProvider();\n    } else {\n      clearRefreshTimer();\n    }\n    clearRetryTimer();\n    if (destroyed || !connectionEnabled || seq !== connectSeq) return;\n    let grant: CollabTokenResponse;\n    if (opts?.grant && opts.grant.expires_at_ms - Date.now() > MIN_REFRESH_DELAY_MS) {\n      grant = opts.grant;\n    } else {\n      try {\n        grant = await mint({ assetId: args.assetId, access });\n      } catch (err) {\n        if (destroyed || !connectionEnabled || seq !== connectSeq) return;\n        if (scheduledRefresh) {\n          refreshTimer = setTimeout(() => {\n            void connect({ scheduledRefresh: true });\n          }, MIN_REFRESH_DELAY_MS);\n          return;\n        }\n        if (retryMintError(err)) {\n          // Offline (or the mint's server is): keep the document and try again.\n          if (status !== 'disconnected') setStatus('disconnected');\n          scheduleRetry();\n          return;\n        }\n        // A denied mint is authoritative (revoked / not shared / not eligible).\n        setStatus('error', err instanceof Error ? err : new Error(String(err)));\n        return;\n      }\n    }\n    if (destroyed || !connectionEnabled || seq !== connectSeq) return;\n    mintRetries = 0;\n    accessType = grant.access_type;\n    const beforeConnect = localCopy?.beforeConnect;\n    if (beforeConnect && !scheduledRefresh && !opts?.skipGate) {\n      const firstConnection = !everConnected;\n      const offlineForMs = disconnectedSince === null ? null : Date.now() - disconnectedSince;\n      let decision: 'connect' | 'hold';\n      try {\n        decision = await beforeConnect({\n          grant,\n          firstConnection,\n          offlineForMs,\n          hasUnsyncedEdits: hasUnsyncedLocalEdits(),\n        });\n      } catch {\n        if (destroyed || !connectionEnabled || seq !== connectSeq) return;\n        if (status !== 'disconnected') setStatus('disconnected');\n        scheduleRetry();\n        return;\n      }\n      if (destroyed || !connectionEnabled || seq !== connectSeq) return;\n      if (decision === 'hold') {\n        held = true;\n        heldGrant = grant;\n        if (status !== 'disconnected') setStatus('disconnected');\n        else notify();\n        return;\n      }\n    }\n    if (scheduledRefresh) {\n      teardownProvider();\n    }\n    if (destroyed || !connectionEnabled || seq !== connectSeq) return;\n\n    const nextProvider = new WebsocketProvider(grant.ws_url, `${grant.org}/${grant.doc_id}`, doc, {\n      params: {\n        yauth: grant.token,\n        branch: grant.branch,\n        gc: 'true',\n      },\n      // BroadcastChannel would sync same-origin clients locally, bypassing the\n      // server's permission enforcement (a read-only tab could write into an\n      // editor tab's doc). Permissioned docs must round-trip the server.\n      disableBc: true,\n    });\n    provider = nextProvider;\n    nextProvider.unconfirmedUpdates = [...carriedUpdates, ...nextProvider.unconfirmedUpdates];\n    carriedUpdates = [];\n    refreshLocalChangesSynced();\n\n    nextProvider.on('sync-status', () => {\n      if (provider !== nextProvider) return;\n      refreshLocalChangesSynced();\n    });\n\n    nextProvider.on('status', (event: { status: 'connecting' | 'connected' | 'disconnected' }) => {\n      if (provider !== nextProvider) return;\n      if (\n        event.status === 'connected' &&\n        openingPastThreshold === nextProvider &&\n        hasUnsyncedLocalEdits()\n      ) {\n        // Opened after the threshold holding edits made meanwhile: before its handshake sends\n        // them (`@y/websocket` reports `connected` first), they go through the gate.\n        teardownProvider();\n        void connect();\n        return;\n      }\n      if (event.status === 'connected') {\n        consecutiveRemints = 0;\n      }\n      setStatus(event.status);\n      if (event.status === 'connected' && lastPresence !== null) {\n        nextProvider.awareness.setLocalState(lastPresence);\n      }\n      // `@y/websocket` reports `disconnected` only for a socket that had opened: one that never\n      // opens (the server unreachable while the mint goes through) only ever reports `connecting`,\n      // and is just as offline.\n      if (event.status !== 'connected') armOfflineTakeover();\n    });\n    // Its first `connecting` came from its constructor, before this listener existed.\n    if (!nextProvider.wsconnected) armOfflineTakeover();\n\n    nextProvider.on('sync', (state: boolean) => {\n      if (provider !== nextProvider) return;\n      if (synced !== state) {\n        synced = state;\n        transportChanged();\n        notify();\n      }\n    });\n\n    nextProvider.on('connection-close', (event: CloseEvent | null) => {\n      if (provider !== nextProvider) return;\n      const action = classifyClose(event?.code);\n      if (action === 'remint') {\n        // Revoked mid-session: a fresh mint re-runs the server-side permission\n        // check. If access is truly gone the mint 403s and we land in 'error'.\n        // Bounded: repeated 4401s without an intervening successful connect\n        // mean the server keeps rejecting freshly minted tokens — stop rather\n        // than loop mint→connect→kick.\n        consecutiveRemints += 1;\n        teardownProvider();\n        if (consecutiveRemints > MAX_CONSECUTIVE_REMINTS) {\n          setStatus(\n            'closed',\n            new Error('Access repeatedly revoked mid-session (4401); giving up.')\n          );\n          return;\n        }\n        void connect();\n      } else if (action === 'stop') {\n        teardownProvider();\n        setStatus(\n          'closed',\n          new Error(`Connection closed permanently (code ${event?.code ?? 'unknown'})`)\n        );\n      }\n      // 'retry': the provider's exponential backoff handles it, until the offline takeover.\n    });\n\n    nextProvider.awareness.on('change', () => {\n      if (provider !== nextProvider) return;\n      notify();\n    });\n\n    scheduleRefresh(grant);\n  };\n\n  const preparing: Promise<void> = localCopy\n    ? localCopy\n        .prepare({ doc, transport })\n        .catch(() => ({ unsyncedEdits: null }))\n        .then(({ unsyncedEdits }) => {\n          if (destroyed) return;\n          if (unsyncedEdits && !(unsyncedEdits.inserts.isEmpty() && unsyncedEdits.deletes.isEmpty())) {\n            carriedUpdates = [...carriedUpdates, { created: Date.now(), ids: unsyncedEdits }];\n          }\n          prepared = true;\n          refreshLocalChangesSynced();\n          notify();\n        })\n    : Promise.resolve();\n\n  void connect();\n\n  const waitForSync = (timeoutMs = 15_000): Promise<void> =>\n    new Promise<void>((resolve, reject) => {\n      const terminal = (): Error | null => {\n        if (destroyed) return new Error('Handle destroyed before initial sync');\n        if (status === 'closed' || status === 'error') {\n          return error ?? new Error(`Connection ${status} before initial sync`);\n        }\n        return null;\n      };\n      if (synced) {\n        resolve();\n        return;\n      }\n      const immediate = terminal();\n      if (immediate) {\n        reject(immediate);\n        return;\n      }\n      const cleanup = () => {\n        clearTimeout(timer);\n        listeners.delete(listener);\n      };\n      const timer = setTimeout(() => {\n        cleanup();\n        reject(new Error(`Timed out after ${timeoutMs}ms waiting for initial sync`));\n      }, timeoutMs);\n      const listener = () => {\n        if (synced) {\n          cleanup();\n          resolve();\n          return;\n        }\n        const err = terminal();\n        if (err) {\n          cleanup();\n          reject(err);\n        }\n      };\n      listeners.add(listener);\n    });\n\n  const waitForAcknowledged = (timeoutMs = 15_000): Promise<void> =>\n    new Promise<void>((resolve, reject) => {\n      let finished = false;\n      let checkQueued = false;\n      let timer: ReturnType<typeof setTimeout> | null = null;\n      const finish = (failure?: Error) => {\n        if (finished) return;\n        finished = true;\n        if (timer !== null) clearTimeout(timer);\n        listeners.delete(check);\n        if (failure) reject(failure);\n        else resolve();\n      };\n      const check = () => {\n        if (finished || checkQueued) return;\n        checkQueued = true;\n        // All synchronous transport hooks and change listeners finish before a save settles.\n        queueMicrotask(() => {\n          checkQueued = false;\n          if (finished) return;\n          if (destroyed) {\n            finish(new Error('Handle destroyed before local changes were acknowledged'));\n          } else if (!connectionEnabled) {\n            finish(new Error('Connection disabled before local changes were acknowledged'));\n          } else if (status === 'closed' || status === 'error') {\n            finish(error ?? new Error(`Connection ${status} before local changes were acknowledged`));\n          } else if (prepared && status === 'connected' && synced && localChangesSynced) {\n            finish();\n          }\n        });\n      };\n      timer = setTimeout(() => {\n        finish(new Error(`Timed out after ${timeoutMs}ms waiting for local changes to be acknowledged`));\n      }, timeoutMs);\n      listeners.add(check);\n      check();\n    });\n\n  return {\n    doc,\n    get status() {\n      return status;\n    },\n    get synced() {\n      return synced;\n    },\n    get localChangesSynced() {\n      return localChangesSynced;\n    },\n    get accessType() {\n      return accessType;\n    },\n    get error() {\n      return error;\n    },\n    get prepared() {\n      return prepared;\n    },\n    get connectionEnabled() {\n      return connectionEnabled;\n    },\n    get held() {\n      return held;\n    },\n    get version() {\n      return version;\n    },\n    waitForSync,\n    waitForAcknowledged,\n    getPresence: () => {\n      if (!provider) return [];\n      const entries: PresenceEntry[] = [];\n      provider.awareness.getStates().forEach((state, clientId) => {\n        entries.push({ clientId, state: state as Record<string, unknown> });\n      });\n      return entries;\n    },\n    setPresence: (state) => {\n      lastPresence = state;\n      provider?.awareness.setLocalState(state);\n    },\n    refreshNow: () => {\n      if (!connectionEnabled || held) return Promise.resolve();\n      return provider ? connect({ scheduledRefresh: true }) : connect();\n    },\n    setConnectionEnabled: (enabled) => {\n      if (destroyed || enabled === connectionEnabled) return;\n      connectionEnabled = enabled;\n      if (!enabled) {\n        // Invalidate every mint/gate already in flight before tearing down the live provider.\n        connectSeq += 1;\n        clearRetryTimer();\n        clearOfflineTimer();\n        teardownProvider();\n        setStatus('disconnected');\n        localCopy?.connectionPolicyChanged?.(false);\n        return;\n      }\n      localCopy?.connectionPolicyChanged?.(true);\n      held = false;\n      heldGrant = null;\n      setStatus('connecting');\n      void connect();\n    },\n    resume: () => {\n      if (!held || destroyed || !connectionEnabled) return;\n      held = false;\n      const grant = heldGrant;\n      heldGrant = null;\n      notify();\n      void connect({ skipGate: true, grant: grant ?? undefined });\n    },\n    unconfirmedEdits,\n    onChange: (listener) => {\n      listeners.add(listener);\n      return () => {\n        listeners.delete(listener);\n      };\n    },\n    destroy: () => {\n      if (destroyed) return;\n      destroyed = true;\n      teardownProvider();\n      clearRetryTimer();\n      clearOfflineTimer();\n      if (typeof window !== 'undefined') window.removeEventListener('online', onBrowserOnline);\n      status = 'closed';\n      // Final notification so pending waitForSync callers reject instead of\n      // hanging on listeners that are about to be dropped.\n      for (const listener of [...listeners]) listener();\n      listeners.clear();\n      doc.destroy();\n    },\n  };\n}\n\nexport { CollabTokenError };\nexport type { CollabAuth, CollabTokenResponse };\n"],"names":[],"mappings":"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"}

package/dist/diagnostics/athena-diagnostics.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"athena-diagnostics.cjs","sources":["../../src/diagnostics/athena-diagnostics.ts"],"sourcesContent":["/**\n * SDK diagnostics: one structured event bus for everything the SDK does that\n * can be slow or can fail — auth acquisition, thread-list fetches, statewire\n * attach/snapshot/connection changes, sends, first tokens, and every error.\n *\n * Design:\n * - Module-level singleton (one SDK, one bus), configured by `AthenaProvider`\n *   from its `debug` / `onDiagnostic` / `onError` props. Nothing here runs\n *   until something calls `emit`, and with defaults it costs a ring-buffer push.\n * - Every event carries `t` (ms since page navigation start via\n *   `performance.now()`) so the buffer reads as a waterfall. Timed spans use\n *   `performance.mark` / `performance.measure` too, so the browser Performance\n *   panel shows them as user timings without any extra tooling.\n * - Console output is opt-in (`debug` prop or `localStorage['athena:debug']`),\n *   prefixed `[AthenaSDK]`, and level-gated. Errors always reach `onError`.\n * - PostHog forwarding (opt-in) sends the timing events as\n *   `athena_sdk_<name>` with `duration_ms`, through the SDK's capture gate.\n *\n * Consumers read the buffer with `useAthenaDiagnostics()` or, in the browser\n * console, `window.__ATHENA_SDK__.diagnostics.snapshot()`.\n */\n\nimport { getPostHogInstance } from '../provider/PostHogProvider';\nimport { capturePosthogEvent, type PosthogCaptureClient } from '../lib/posthog/wrap-posthog-client';\nimport { ATHENA_REACT_SDK_VERSION } from '../version';\nimport { AthenaSdkError, isAthenaSdkError, toAthenaSdkError } from './errors';\n\nexport const ATHENA_DIAGNOSTIC_LEVELS = ['debug', 'info', 'warn', 'error'] as const;\nexport type AthenaDiagnosticLevel = (typeof ATHENA_DIAGNOSTIC_LEVELS)[number];\n\nconst LEVEL_RANK: Record<AthenaDiagnosticLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\n/**\n * Event names. Dotted `area.event` so a consumer can filter by prefix. Names\n * are part of the public contract: renaming one is a breaking change for\n * dashboards, so add new ones instead of repurposing.\n */\nexport type AthenaDiagnosticEventName =\n  // Provider / configuration\n  | 'sdk.init'\n  | 'sdk.transport'\n  | 'sdk.config.warning'\n  // Auth acquisition + lifecycle\n  | 'auth.bridge.start'\n  | 'auth.bridge.ready'\n  | 'auth.bridge.timeout'\n  | 'auth.bridge.absent'\n  | 'auth.bridge.error'\n  | 'auth.bridge.retry'\n  | 'auth.bridge.config_rejected'\n  | 'auth.token.acquired'\n  | 'auth.token.refreshed'\n  | 'auth.token.refresh_failed'\n  | 'auth.token.stale'\n  | 'auth.sso.userinfo.start'\n  | 'auth.sso.userinfo.done'\n  | 'auth.sso.userinfo.error'\n  // Thread list + history\n  | 'threads.list.start'\n  | 'threads.list.done'\n  | 'threads.list.error'\n  | 'threads.list.aborted'\n  | 'threads.history.start'\n  | 'threads.history.done'\n  | 'threads.history.error'\n  | 'threads.history.aborted'\n  // Statewire transport\n  | 'statewire.attach.start'\n  | 'statewire.snapshot'\n  | 'statewire.connection'\n  | 'statewire.parked'\n  | 'statewire.error'\n  | 'statewire.read_only'\n  // Runs\n  | 'run.send'\n  | 'run.first_token'\n  | 'run.done'\n  | 'run.error'\n  // Composer\n  | 'composer.attachment.error'\n  | 'composer.cancel.error'\n  | 'composer.dictation'\n  | 'composer.handoff'\n  // Tool UIs + frontend tools\n  | 'tools.schema.warning'\n  | 'tools.debug'\n  // Mention suggestions\n  | 'mentions.fetch.error'\n  // Catch-all\n  | 'sdk.error';\n\nexport interface AthenaDiagnosticEvent {\n  /** Monotonic sequence number within this page. */\n  seq: number;\n  /** `performance.now()` at emit time (ms since navigation start). */\n  t: number;\n  /** Wall-clock ISO timestamp, for exports. */\n  at: string;\n  name: AthenaDiagnosticEventName;\n  level: AthenaDiagnosticLevel;\n  /** Milliseconds for a completed span (set on `*.done` / `*.ready` / `run.first_token`). */\n  durationMs?: number;\n  /** Structured context. Never contains credentials — see `redact`. */\n  data?: Record<string, unknown>;\n  /** Present on error-level events. */\n  error?: AthenaSdkError;\n}\n\nexport interface AthenaDiagnosticsConfig {\n  /** Minimum level echoed to the console. `false` disables console output. */\n  console: AthenaDiagnosticLevel | false;\n  /** Forward timing + error events to PostHog as `athena_sdk_*` events. */\n  posthog: boolean;\n  /** Receives every event (already redacted). */\n  onEvent?: (event: AthenaDiagnosticEvent) => void;\n  /** Receives every error-level event's `AthenaSdkError`. */\n  onError?: (error: AthenaSdkError, event: AthenaDiagnosticEvent) => void;\n  /** Ring-buffer capacity. */\n  bufferSize: number;\n}\n\nexport interface AthenaDiagnosticsSnapshot {\n  sdkVersion: string;\n  config: Omit<AthenaDiagnosticsConfig, 'onEvent' | 'onError'>;\n  events: AthenaDiagnosticEvent[];\n  /** Latest value per gauge (connection status, transport, auth mode, …). */\n  gauges: Record<string, unknown>;\n  /** Named span durations, most recent per name (`auth.bridge`, `threads.list`, …). */\n  timings: Record<string, number>;\n}\n\nconst DEFAULT_CONFIG: AthenaDiagnosticsConfig = {\n  console: false,\n  posthog: false,\n  bufferSize: 300,\n};\n\nconst CONSOLE_PREFIX = '[AthenaSDK]';\nconst LOCAL_STORAGE_DEBUG_KEY = 'athena:debug';\nconst GLOBAL_KEY = '__ATHENA_SDK__';\n\n// Keys whose values must never enter the buffer, the console, or PostHog.\nconst REDACT_KEYS = /token|secret|api[-_]?key|authorization|cookie|password/i;\n\nfunction redact(data: Record<string, unknown> | undefined): Record<string, unknown> | undefined {\n  if (!data) return undefined;\n  const out: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (REDACT_KEYS.test(key)) {\n      out[key] = typeof value === 'string' && value.length > 0 ? `<redacted:${value.length}>` : '<redacted>';\n    } else {\n      out[key] = value;\n    }\n  }\n  return out;\n}\n\nfunction nowMs(): number {\n  return typeof performance !== 'undefined' && typeof performance.now === 'function'\n    ? performance.now()\n    : Date.now();\n}\n\nfunction readLocalDebugLevel(): AthenaDiagnosticLevel | null {\n  try {\n    if (typeof localStorage === 'undefined') return null;\n    const raw = localStorage.getItem(LOCAL_STORAGE_DEBUG_KEY);\n    if (!raw) return null;\n    if ((ATHENA_DIAGNOSTIC_LEVELS as readonly string[]).includes(raw)) {\n      return raw as AthenaDiagnosticLevel;\n    }\n    return raw === '1' || raw === 'true' ? 'debug' : null;\n  } catch {\n    return null;\n  }\n}\n\ntype Listener = (event: AthenaDiagnosticEvent) => void;\n\nclass AthenaDiagnosticsBus {\n  private config: AthenaDiagnosticsConfig = { ...DEFAULT_CONFIG };\n  private events: AthenaDiagnosticEvent[] = [];\n  private listeners = new Set<Listener>();\n  private snapshotListeners = new Set<() => void>();\n  private seq = 0;\n  private gauges: Record<string, unknown> = {};\n  private timings: Record<string, number> = {};\n  private spans = new Map<string, number>();\n  private cachedSnapshot: AthenaDiagnosticsSnapshot | null = null;\n\n  configure(partial: Partial<AthenaDiagnosticsConfig>): void {\n    this.config = { ...this.config, ...partial };\n    if (this.events.length > this.config.bufferSize) {\n      this.events = this.events.slice(-this.config.bufferSize);\n    }\n    this.invalidate();\n  }\n\n  getConfig(): AthenaDiagnosticsConfig {\n    return this.config;\n  }\n\n  /** Effective console level: the configured one, or `localStorage['athena:debug']`. */\n  private consoleLevel(): AthenaDiagnosticLevel | false {\n    if (this.config.console !== false) return this.config.console;\n    return readLocalDebugLevel() ?? false;\n  }\n\n  emit(\n    name: AthenaDiagnosticEventName,\n    options: {\n      level?: AthenaDiagnosticLevel;\n      data?: Record<string, unknown>;\n      durationMs?: number;\n      error?: unknown;\n    } = {},\n  ): AthenaDiagnosticEvent {\n    const level = options.level ?? (options.error !== undefined ? 'error' : 'info');\n    const error =\n      options.error === undefined\n        ? undefined\n        : toAthenaSdkError(options.error, {\n            code: 'unknown',\n            message: `Unexpected error during ${name}`,\n          });\n    const event: AthenaDiagnosticEvent = {\n      seq: ++this.seq,\n      t: Math.round(nowMs() * 10) / 10,\n      at: new Date().toISOString(),\n      name,\n      level,\n      ...(options.durationMs !== undefined && { durationMs: Math.round(options.durationMs) }),\n      ...(options.data && { data: redact(options.data) }),\n      ...(error && { error }),\n    };\n\n    this.events.push(event);\n    if (this.events.length > this.config.bufferSize) {\n      this.events.splice(0, this.events.length - this.config.bufferSize);\n    }\n    if (event.durationMs !== undefined) {\n      this.timings[name] = event.durationMs;\n    }\n    this.invalidate();\n\n    this.echoToConsole(event);\n    this.forwardToPostHog(event);\n    for (const listener of this.listeners) {\n      try {\n        listener(event);\n      } catch (listenerError) {\n        console.error(`${CONSOLE_PREFIX} diagnostics listener threw`, listenerError);\n      }\n    }\n    if (this.config.onEvent) {\n      try {\n        this.config.onEvent(event);\n      } catch (callbackError) {\n        console.error(`${CONSOLE_PREFIX} onDiagnostic callback threw`, callbackError);\n      }\n    }\n    if (error && this.config.onError) {\n      try {\n        this.config.onError(error, event);\n      } catch (callbackError) {\n        console.error(`${CONSOLE_PREFIX} onError callback threw`, callbackError);\n      }\n    }\n    for (const notify of this.snapshotListeners) notify();\n    return event;\n  }\n\n  /** Record an error-level event. Returns the normalized `AthenaSdkError`. */\n  error(\n    name: AthenaDiagnosticEventName,\n    error: unknown,\n    fallback: { code: AthenaSdkError['code']; message: string; hint?: string },\n    data?: Record<string, unknown>,\n  ): AthenaSdkError {\n    const normalized = toAthenaSdkError(error, fallback);\n    this.emit(name, { level: 'error', error: normalized, data });\n    return normalized;\n  }\n\n  /**\n   * Start a named span. Returns a function that ends it and emits `doneName`\n   * with `durationMs` (or `errorName` when passed an error). Also records a\n   * `performance.measure` so the span shows in the browser's Performance panel.\n   */\n  span(\n    spanName: string,\n    startName: AthenaDiagnosticEventName,\n    data?: Record<string, unknown>,\n  ): (\n    doneName: AthenaDiagnosticEventName,\n    doneOptions?: { data?: Record<string, unknown>; error?: unknown },\n  ) => number {\n    const startedAt = nowMs();\n    this.spans.set(spanName, startedAt);\n    this.mark(`${spanName}:start`);\n    this.emit(startName, { level: 'debug', data });\n    return (doneName, doneOptions = {}) => {\n      const durationMs = nowMs() - startedAt;\n      this.spans.delete(spanName);\n      this.mark(`${spanName}:end`);\n      this.measure(spanName);\n      this.emit(doneName, {\n        level: doneOptions.error !== undefined ? 'error' : 'info',\n        durationMs,\n        data: doneOptions.data,\n        error: doneOptions.error,\n      });\n      return durationMs;\n    };\n  }\n\n  /** Set a gauge (latest-value metric): connection status, transport, auth mode. */\n  gauge(name: string, value: unknown): void {\n    if (this.gauges[name] === value) return;\n    this.gauges[name] = value;\n    this.invalidate();\n    for (const notify of this.snapshotListeners) notify();\n  }\n\n  subscribe(listener: Listener): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  /**\n   * Additive consumer registration: every registered consumer receives every\n   * event (and every error), unlike the single `onEvent`/`onError` config\n   * slots which are last-writer-wins. `AthenaProvider` registers through this\n   * so two mounted providers never clobber each other's callbacks.\n   */\n  addConsumer(consumer: {\n    onEvent?: (event: AthenaDiagnosticEvent) => void;\n    onError?: (error: AthenaSdkError, event: AthenaDiagnosticEvent) => void;\n  }): () => void {\n    return this.subscribe((event) => {\n      try {\n        consumer.onEvent?.(event);\n      } catch (callbackError) {\n        console.error(`${CONSOLE_PREFIX} onDiagnostic consumer threw`, callbackError);\n      }\n      if (event.error) {\n        try {\n          consumer.onError?.(event.error, event);\n        } catch (callbackError) {\n          console.error(`${CONSOLE_PREFIX} onError consumer threw`, callbackError);\n        }\n      }\n    });\n  }\n\n  /** Subscribe to snapshot changes (for `useSyncExternalStore`). */\n  subscribeSnapshot(listener: () => void): () => void {\n    this.snapshotListeners.add(listener);\n    return () => {\n      this.snapshotListeners.delete(listener);\n    };\n  }\n\n  snapshot(): AthenaDiagnosticsSnapshot {\n    if (!this.cachedSnapshot) {\n      const { onEvent: _onEvent, onError: _onError, ...config } = this.config;\n      this.cachedSnapshot = {\n        sdkVersion: ATHENA_REACT_SDK_VERSION,\n        config,\n        events: [...this.events],\n        gauges: { ...this.gauges },\n        timings: { ...this.timings },\n      };\n    }\n    return this.cachedSnapshot;\n  }\n\n  /** Copy-paste-able JSON of the current snapshot (errors serialized). */\n  export(): string {\n    return JSON.stringify(\n      this.snapshot(),\n      (_key, value) => (isAthenaSdkError(value) ? value.toJSON() : value),\n      2,\n    );\n  }\n\n  clear(): void {\n    this.events = [];\n    this.timings = {};\n    this.invalidate();\n    for (const notify of this.snapshotListeners) notify();\n  }\n\n  private invalidate(): void {\n    this.cachedSnapshot = null;\n  }\n\n  private mark(name: string): void {\n    try {\n      if (typeof performance !== 'undefined' && typeof performance.mark === 'function') {\n        performance.mark(`athena-sdk:${name}`);\n      }\n    } catch {\n      // User Timing is best-effort.\n    }\n  }\n\n  private measure(spanName: string): void {\n    try {\n      if (typeof performance !== 'undefined' && typeof performance.measure === 'function') {\n        performance.measure(\n          `athena-sdk:${spanName}`,\n          `athena-sdk:${spanName}:start`,\n          `athena-sdk:${spanName}:end`,\n        );\n      }\n    } catch {\n      // A missing start mark (e.g. after `performance.clearMarks`) is not an error.\n    }\n  }\n\n  private echoToConsole(event: AthenaDiagnosticEvent): void {\n    const level = this.consoleLevel();\n    if (level === false) {\n      // Errors are never silent: with console output off they still log once,\n      // compactly, so a broken integration is visible without enabling debug.\n      if (event.level === 'error' && event.error) {\n        console.error(`${CONSOLE_PREFIX} ${event.name}: ${event.error.describe()}`, event.data ?? '');\n      }\n      return;\n    }\n    if (LEVEL_RANK[event.level] < LEVEL_RANK[level]) return;\n    const suffix = event.durationMs !== undefined ? ` (${event.durationMs}ms)` : '';\n    const line = `${CONSOLE_PREFIX} ${event.name}${suffix}`;\n    const payload = event.error ? { ...event.data, error: event.error.describe() } : event.data;\n    const method =\n      event.level === 'error'\n        ? console.error\n        : event.level === 'warn'\n          ? console.warn\n          : event.level === 'debug'\n            ? console.debug\n            : console.info;\n    method(line, payload ?? '');\n  }\n\n  private forwardToPostHog(event: AthenaDiagnosticEvent): void {\n    if (!this.config.posthog) return;\n    if (event.durationMs === undefined && event.level !== 'error') return;\n    try {\n      const client = getPostHogInstance<PosthogCaptureClient>();\n      capturePosthogEvent(client, `athena_sdk_${event.name.replace(/\\./g, '_')}`, {\n        sdk_version: ATHENA_REACT_SDK_VERSION,\n        level: event.level,\n        ...(event.durationMs !== undefined && { duration_ms: event.durationMs }),\n        ...(event.error && {\n          error_code: event.error.code,\n          error_message: event.error.message,\n          error_status: event.error.status,\n        }),\n        ...event.data,\n      });\n    } catch {\n      // Analytics must never break the chat.\n    }\n  }\n}\n\nexport const athenaDiagnostics = new AthenaDiagnosticsBus();\n\n/**\n * Expose the bus on `window.__ATHENA_SDK__` so an integrator can inspect the\n * waterfall from the console (`__ATHENA_SDK__.diagnostics.snapshot()`) or turn\n * console echo on without a rebuild (`localStorage.setItem('athena:debug','debug')`).\n */\nexport function installAthenaDiagnosticsGlobal(): void {\n  if (typeof window === 'undefined') return;\n  const globalWindow = window as unknown as Record<string, unknown>;\n  const existing = (globalWindow[GLOBAL_KEY] ?? {}) as Record<string, unknown>;\n  globalWindow[GLOBAL_KEY] = {\n    ...existing,\n    version: ATHENA_REACT_SDK_VERSION,\n    diagnostics: {\n      snapshot: () => athenaDiagnostics.snapshot(),\n      export: () => athenaDiagnostics.export(),\n      clear: () => athenaDiagnostics.clear(),\n      enableConsole: (level: AthenaDiagnosticLevel = 'debug') => {\n        try {\n          localStorage.setItem(LOCAL_STORAGE_DEBUG_KEY, level);\n        } catch {\n          // localStorage may be unavailable.\n        }\n        athenaDiagnostics.configure({ console: level });\n      },\n      disableConsole: () => {\n        try {\n          localStorage.removeItem(LOCAL_STORAGE_DEBUG_KEY);\n        } catch {\n          // localStorage may be unavailable.\n        }\n        athenaDiagnostics.configure({ console: false });\n      },\n    },\n  };\n}\n\n/** Normalize the provider's `debug` prop into a diagnostics config patch. */\nexport function debugPropToDiagnosticsConfig(\n  debug: boolean | AthenaDiagnosticLevel | Partial<AthenaDiagnosticsConfig> | undefined,\n): Partial<AthenaDiagnosticsConfig> {\n  if (debug === undefined) return {};\n  if (debug === true) return { console: 'debug' };\n  if (debug === false) return { console: false };\n  if (typeof debug === 'string') return { console: debug };\n  return debug;\n}\n"],"names":["toAthenaSdkError","ATHENA_REACT_SDK_VERSION","isAthenaSdkError","getPostHogInstance","capturePosthogEvent"],"mappings":"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"}
+{"version":3,"file":"athena-diagnostics.cjs","sources":["../../src/diagnostics/athena-diagnostics.ts"],"sourcesContent":["/**\n * SDK diagnostics: one structured event bus for everything the SDK does that\n * can be slow or can fail — auth acquisition, thread-list fetches, statewire\n * attach/snapshot/connection changes, sends, first tokens, and every error.\n *\n * Design:\n * - Module-level singleton (one SDK, one bus), configured by `AthenaProvider`\n *   from its `debug` / `onDiagnostic` / `onError` props. Nothing here runs\n *   until something calls `emit`, and with defaults it costs a ring-buffer push.\n * - Every event carries `t` (ms since page navigation start via\n *   `performance.now()`) so the buffer reads as a waterfall. Timed spans use\n *   `performance.mark` / `performance.measure` too, so the browser Performance\n *   panel shows them as user timings without any extra tooling.\n * - Console output is opt-in (`debug` prop or `localStorage['athena:debug']`),\n *   prefixed `[AthenaSDK]`, and level-gated. Errors always reach `onError`.\n * - PostHog forwarding (opt-in) sends the timing events as\n *   `athena_sdk_<name>` with `duration_ms`, through the SDK's capture gate.\n *\n * Consumers read the buffer with `useAthenaDiagnostics()` or, in the browser\n * console, `window.__ATHENA_SDK__.diagnostics.snapshot()`.\n */\n\nimport { getPostHogInstance } from '../provider/PostHogProvider';\nimport { capturePosthogEvent, type PosthogCaptureClient } from '../lib/posthog/wrap-posthog-client';\nimport { ATHENA_REACT_SDK_VERSION } from '../version';\nimport { AthenaSdkError, isAthenaSdkError, toAthenaSdkError } from './errors';\n\nexport const ATHENA_DIAGNOSTIC_LEVELS = ['debug', 'info', 'warn', 'error'] as const;\nexport type AthenaDiagnosticLevel = (typeof ATHENA_DIAGNOSTIC_LEVELS)[number];\n\nconst LEVEL_RANK: Record<AthenaDiagnosticLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\n/**\n * Event names. Dotted `area.event` so a consumer can filter by prefix. Names\n * are part of the public contract: renaming one is a breaking change for\n * dashboards, so add new ones instead of repurposing.\n */\nexport type AthenaDiagnosticEventName =\n  // Provider / configuration\n  | 'sdk.init'\n  | 'sdk.transport'\n  | 'sdk.config.warning'\n  // Auth acquisition + lifecycle\n  | 'auth.bridge.start'\n  | 'auth.bridge.ready'\n  | 'auth.bridge.timeout'\n  | 'auth.bridge.absent'\n  | 'auth.bridge.error'\n  | 'auth.bridge.retry'\n  | 'auth.bridge.config_rejected'\n  | 'auth.token.acquired'\n  | 'auth.token.refreshed'\n  | 'auth.token.refresh_failed'\n  | 'auth.token.stale'\n  | 'auth.sso.userinfo.start'\n  | 'auth.sso.userinfo.done'\n  | 'auth.sso.userinfo.error'\n  // Thread list + history\n  | 'threads.list.start'\n  | 'threads.list.done'\n  | 'threads.list.error'\n  | 'threads.list.aborted'\n  | 'threads.history.start'\n  | 'threads.history.done'\n  | 'threads.history.error'\n  | 'threads.history.aborted'\n  // Statewire transport\n  | 'statewire.attach.start'\n  | 'statewire.snapshot'\n  | 'statewire.connection'\n  | 'statewire.parked'\n  | 'statewire.error'\n  | 'statewire.read_only'\n  /** A write to the thread's server config lane (`config/patch`) was refused or dropped. */\n  | 'statewire.config'\n  // Runs\n  | 'run.send'\n  | 'run.first_token'\n  | 'run.done'\n  | 'run.error'\n  // Composer\n  | 'composer.attachment.error'\n  | 'composer.cancel.error'\n  | 'composer.dictation'\n  | 'composer.handoff'\n  // Tool UIs + frontend tools\n  | 'tools.schema.warning'\n  | 'tools.debug'\n  // Mention suggestions\n  | 'mentions.fetch.error'\n  // Catch-all\n  | 'sdk.error';\n\nexport interface AthenaDiagnosticEvent {\n  /** Monotonic sequence number within this page. */\n  seq: number;\n  /** `performance.now()` at emit time (ms since navigation start). */\n  t: number;\n  /** Wall-clock ISO timestamp, for exports. */\n  at: string;\n  name: AthenaDiagnosticEventName;\n  level: AthenaDiagnosticLevel;\n  /** Milliseconds for a completed span (set on `*.done` / `*.ready` / `run.first_token`). */\n  durationMs?: number;\n  /** Structured context. Never contains credentials — see `redact`. */\n  data?: Record<string, unknown>;\n  /** Present on error-level events. */\n  error?: AthenaSdkError;\n}\n\nexport interface AthenaDiagnosticsConfig {\n  /** Minimum level echoed to the console. `false` disables console output. */\n  console: AthenaDiagnosticLevel | false;\n  /** Forward timing + error events to PostHog as `athena_sdk_*` events. */\n  posthog: boolean;\n  /** Receives every event (already redacted). */\n  onEvent?: (event: AthenaDiagnosticEvent) => void;\n  /** Receives every error-level event's `AthenaSdkError`. */\n  onError?: (error: AthenaSdkError, event: AthenaDiagnosticEvent) => void;\n  /** Ring-buffer capacity. */\n  bufferSize: number;\n}\n\nexport interface AthenaDiagnosticsSnapshot {\n  sdkVersion: string;\n  config: Omit<AthenaDiagnosticsConfig, 'onEvent' | 'onError'>;\n  events: AthenaDiagnosticEvent[];\n  /** Latest value per gauge (connection status, transport, auth mode, …). */\n  gauges: Record<string, unknown>;\n  /** Named span durations, most recent per name (`auth.bridge`, `threads.list`, …). */\n  timings: Record<string, number>;\n}\n\nconst DEFAULT_CONFIG: AthenaDiagnosticsConfig = {\n  console: false,\n  posthog: false,\n  bufferSize: 300,\n};\n\nconst CONSOLE_PREFIX = '[AthenaSDK]';\nconst LOCAL_STORAGE_DEBUG_KEY = 'athena:debug';\nconst GLOBAL_KEY = '__ATHENA_SDK__';\n\n// Keys whose values must never enter the buffer, the console, or PostHog.\nconst REDACT_KEYS = /token|secret|api[-_]?key|authorization|cookie|password/i;\n\nfunction redact(data: Record<string, unknown> | undefined): Record<string, unknown> | undefined {\n  if (!data) return undefined;\n  const out: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (REDACT_KEYS.test(key)) {\n      out[key] = typeof value === 'string' && value.length > 0 ? `<redacted:${value.length}>` : '<redacted>';\n    } else {\n      out[key] = value;\n    }\n  }\n  return out;\n}\n\nfunction nowMs(): number {\n  return typeof performance !== 'undefined' && typeof performance.now === 'function'\n    ? performance.now()\n    : Date.now();\n}\n\nfunction readLocalDebugLevel(): AthenaDiagnosticLevel | null {\n  try {\n    if (typeof localStorage === 'undefined') return null;\n    const raw = localStorage.getItem(LOCAL_STORAGE_DEBUG_KEY);\n    if (!raw) return null;\n    if ((ATHENA_DIAGNOSTIC_LEVELS as readonly string[]).includes(raw)) {\n      return raw as AthenaDiagnosticLevel;\n    }\n    return raw === '1' || raw === 'true' ? 'debug' : null;\n  } catch {\n    return null;\n  }\n}\n\ntype Listener = (event: AthenaDiagnosticEvent) => void;\n\nclass AthenaDiagnosticsBus {\n  private config: AthenaDiagnosticsConfig = { ...DEFAULT_CONFIG };\n  private events: AthenaDiagnosticEvent[] = [];\n  private listeners = new Set<Listener>();\n  private snapshotListeners = new Set<() => void>();\n  private seq = 0;\n  private gauges: Record<string, unknown> = {};\n  private timings: Record<string, number> = {};\n  private spans = new Map<string, number>();\n  private cachedSnapshot: AthenaDiagnosticsSnapshot | null = null;\n\n  configure(partial: Partial<AthenaDiagnosticsConfig>): void {\n    this.config = { ...this.config, ...partial };\n    if (this.events.length > this.config.bufferSize) {\n      this.events = this.events.slice(-this.config.bufferSize);\n    }\n    this.invalidate();\n  }\n\n  getConfig(): AthenaDiagnosticsConfig {\n    return this.config;\n  }\n\n  /** Effective console level: the configured one, or `localStorage['athena:debug']`. */\n  private consoleLevel(): AthenaDiagnosticLevel | false {\n    if (this.config.console !== false) return this.config.console;\n    return readLocalDebugLevel() ?? false;\n  }\n\n  emit(\n    name: AthenaDiagnosticEventName,\n    options: {\n      level?: AthenaDiagnosticLevel;\n      data?: Record<string, unknown>;\n      durationMs?: number;\n      error?: unknown;\n    } = {},\n  ): AthenaDiagnosticEvent {\n    const level = options.level ?? (options.error !== undefined ? 'error' : 'info');\n    const error =\n      options.error === undefined\n        ? undefined\n        : toAthenaSdkError(options.error, {\n            code: 'unknown',\n            message: `Unexpected error during ${name}`,\n          });\n    const event: AthenaDiagnosticEvent = {\n      seq: ++this.seq,\n      t: Math.round(nowMs() * 10) / 10,\n      at: new Date().toISOString(),\n      name,\n      level,\n      ...(options.durationMs !== undefined && { durationMs: Math.round(options.durationMs) }),\n      ...(options.data && { data: redact(options.data) }),\n      ...(error && { error }),\n    };\n\n    this.events.push(event);\n    if (this.events.length > this.config.bufferSize) {\n      this.events.splice(0, this.events.length - this.config.bufferSize);\n    }\n    if (event.durationMs !== undefined) {\n      this.timings[name] = event.durationMs;\n    }\n    this.invalidate();\n\n    this.echoToConsole(event);\n    this.forwardToPostHog(event);\n    for (const listener of this.listeners) {\n      try {\n        listener(event);\n      } catch (listenerError) {\n        console.error(`${CONSOLE_PREFIX} diagnostics listener threw`, listenerError);\n      }\n    }\n    if (this.config.onEvent) {\n      try {\n        this.config.onEvent(event);\n      } catch (callbackError) {\n        console.error(`${CONSOLE_PREFIX} onDiagnostic callback threw`, callbackError);\n      }\n    }\n    if (error && this.config.onError) {\n      try {\n        this.config.onError(error, event);\n      } catch (callbackError) {\n        console.error(`${CONSOLE_PREFIX} onError callback threw`, callbackError);\n      }\n    }\n    for (const notify of this.snapshotListeners) notify();\n    return event;\n  }\n\n  /** Record an error-level event. Returns the normalized `AthenaSdkError`. */\n  error(\n    name: AthenaDiagnosticEventName,\n    error: unknown,\n    fallback: { code: AthenaSdkError['code']; message: string; hint?: string },\n    data?: Record<string, unknown>,\n  ): AthenaSdkError {\n    const normalized = toAthenaSdkError(error, fallback);\n    this.emit(name, { level: 'error', error: normalized, data });\n    return normalized;\n  }\n\n  /**\n   * Start a named span. Returns a function that ends it and emits `doneName`\n   * with `durationMs` (or `errorName` when passed an error). Also records a\n   * `performance.measure` so the span shows in the browser's Performance panel.\n   */\n  span(\n    spanName: string,\n    startName: AthenaDiagnosticEventName,\n    data?: Record<string, unknown>,\n  ): (\n    doneName: AthenaDiagnosticEventName,\n    doneOptions?: { data?: Record<string, unknown>; error?: unknown },\n  ) => number {\n    const startedAt = nowMs();\n    this.spans.set(spanName, startedAt);\n    this.mark(`${spanName}:start`);\n    this.emit(startName, { level: 'debug', data });\n    return (doneName, doneOptions = {}) => {\n      const durationMs = nowMs() - startedAt;\n      this.spans.delete(spanName);\n      this.mark(`${spanName}:end`);\n      this.measure(spanName);\n      this.emit(doneName, {\n        level: doneOptions.error !== undefined ? 'error' : 'info',\n        durationMs,\n        data: doneOptions.data,\n        error: doneOptions.error,\n      });\n      return durationMs;\n    };\n  }\n\n  /** Set a gauge (latest-value metric): connection status, transport, auth mode. */\n  gauge(name: string, value: unknown): void {\n    if (this.gauges[name] === value) return;\n    this.gauges[name] = value;\n    this.invalidate();\n    for (const notify of this.snapshotListeners) notify();\n  }\n\n  subscribe(listener: Listener): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  /**\n   * Additive consumer registration: every registered consumer receives every\n   * event (and every error), unlike the single `onEvent`/`onError` config\n   * slots which are last-writer-wins. `AthenaProvider` registers through this\n   * so two mounted providers never clobber each other's callbacks.\n   */\n  addConsumer(consumer: {\n    onEvent?: (event: AthenaDiagnosticEvent) => void;\n    onError?: (error: AthenaSdkError, event: AthenaDiagnosticEvent) => void;\n  }): () => void {\n    return this.subscribe((event) => {\n      try {\n        consumer.onEvent?.(event);\n      } catch (callbackError) {\n        console.error(`${CONSOLE_PREFIX} onDiagnostic consumer threw`, callbackError);\n      }\n      if (event.error) {\n        try {\n          consumer.onError?.(event.error, event);\n        } catch (callbackError) {\n          console.error(`${CONSOLE_PREFIX} onError consumer threw`, callbackError);\n        }\n      }\n    });\n  }\n\n  /** Subscribe to snapshot changes (for `useSyncExternalStore`). */\n  subscribeSnapshot(listener: () => void): () => void {\n    this.snapshotListeners.add(listener);\n    return () => {\n      this.snapshotListeners.delete(listener);\n    };\n  }\n\n  snapshot(): AthenaDiagnosticsSnapshot {\n    if (!this.cachedSnapshot) {\n      const { onEvent: _onEvent, onError: _onError, ...config } = this.config;\n      this.cachedSnapshot = {\n        sdkVersion: ATHENA_REACT_SDK_VERSION,\n        config,\n        events: [...this.events],\n        gauges: { ...this.gauges },\n        timings: { ...this.timings },\n      };\n    }\n    return this.cachedSnapshot;\n  }\n\n  /** Copy-paste-able JSON of the current snapshot (errors serialized). */\n  export(): string {\n    return JSON.stringify(\n      this.snapshot(),\n      (_key, value) => (isAthenaSdkError(value) ? value.toJSON() : value),\n      2,\n    );\n  }\n\n  clear(): void {\n    this.events = [];\n    this.timings = {};\n    this.invalidate();\n    for (const notify of this.snapshotListeners) notify();\n  }\n\n  private invalidate(): void {\n    this.cachedSnapshot = null;\n  }\n\n  private mark(name: string): void {\n    try {\n      if (typeof performance !== 'undefined' && typeof performance.mark === 'function') {\n        performance.mark(`athena-sdk:${name}`);\n      }\n    } catch {\n      // User Timing is best-effort.\n    }\n  }\n\n  private measure(spanName: string): void {\n    try {\n      if (typeof performance !== 'undefined' && typeof performance.measure === 'function') {\n        performance.measure(\n          `athena-sdk:${spanName}`,\n          `athena-sdk:${spanName}:start`,\n          `athena-sdk:${spanName}:end`,\n        );\n      }\n    } catch {\n      // A missing start mark (e.g. after `performance.clearMarks`) is not an error.\n    }\n  }\n\n  private echoToConsole(event: AthenaDiagnosticEvent): void {\n    const level = this.consoleLevel();\n    if (level === false) {\n      // Errors are never silent: with console output off they still log once,\n      // compactly, so a broken integration is visible without enabling debug.\n      if (event.level === 'error' && event.error) {\n        console.error(`${CONSOLE_PREFIX} ${event.name}: ${event.error.describe()}`, event.data ?? '');\n      }\n      return;\n    }\n    if (LEVEL_RANK[event.level] < LEVEL_RANK[level]) return;\n    const suffix = event.durationMs !== undefined ? ` (${event.durationMs}ms)` : '';\n    const line = `${CONSOLE_PREFIX} ${event.name}${suffix}`;\n    const payload = event.error ? { ...event.data, error: event.error.describe() } : event.data;\n    const method =\n      event.level === 'error'\n        ? console.error\n        : event.level === 'warn'\n          ? console.warn\n          : event.level === 'debug'\n            ? console.debug\n            : console.info;\n    method(line, payload ?? '');\n  }\n\n  private forwardToPostHog(event: AthenaDiagnosticEvent): void {\n    if (!this.config.posthog) return;\n    if (event.durationMs === undefined && event.level !== 'error') return;\n    try {\n      const client = getPostHogInstance<PosthogCaptureClient>();\n      capturePosthogEvent(client, `athena_sdk_${event.name.replace(/\\./g, '_')}`, {\n        sdk_version: ATHENA_REACT_SDK_VERSION,\n        level: event.level,\n        ...(event.durationMs !== undefined && { duration_ms: event.durationMs }),\n        ...(event.error && {\n          error_code: event.error.code,\n          error_message: event.error.message,\n          error_status: event.error.status,\n        }),\n        ...event.data,\n      });\n    } catch {\n      // Analytics must never break the chat.\n    }\n  }\n}\n\nexport const athenaDiagnostics = new AthenaDiagnosticsBus();\n\n/**\n * Expose the bus on `window.__ATHENA_SDK__` so an integrator can inspect the\n * waterfall from the console (`__ATHENA_SDK__.diagnostics.snapshot()`) or turn\n * console echo on without a rebuild (`localStorage.setItem('athena:debug','debug')`).\n */\nexport function installAthenaDiagnosticsGlobal(): void {\n  if (typeof window === 'undefined') return;\n  const globalWindow = window as unknown as Record<string, unknown>;\n  const existing = (globalWindow[GLOBAL_KEY] ?? {}) as Record<string, unknown>;\n  globalWindow[GLOBAL_KEY] = {\n    ...existing,\n    version: ATHENA_REACT_SDK_VERSION,\n    diagnostics: {\n      snapshot: () => athenaDiagnostics.snapshot(),\n      export: () => athenaDiagnostics.export(),\n      clear: () => athenaDiagnostics.clear(),\n      enableConsole: (level: AthenaDiagnosticLevel = 'debug') => {\n        try {\n          localStorage.setItem(LOCAL_STORAGE_DEBUG_KEY, level);\n        } catch {\n          // localStorage may be unavailable.\n        }\n        athenaDiagnostics.configure({ console: level });\n      },\n      disableConsole: () => {\n        try {\n          localStorage.removeItem(LOCAL_STORAGE_DEBUG_KEY);\n        } catch {\n          // localStorage may be unavailable.\n        }\n        athenaDiagnostics.configure({ console: false });\n      },\n    },\n  };\n}\n\n/** Normalize the provider's `debug` prop into a diagnostics config patch. */\nexport function debugPropToDiagnosticsConfig(\n  debug: boolean | AthenaDiagnosticLevel | Partial<AthenaDiagnosticsConfig> | undefined,\n): Partial<AthenaDiagnosticsConfig> {\n  if (debug === undefined) return {};\n  if (debug === true) return { console: 'debug' };\n  if (debug === false) return { console: false };\n  if (typeof debug === 'string') return { console: debug };\n  return debug;\n}\n"],"names":["toAthenaSdkError","ATHENA_REACT_SDK_VERSION","isAthenaSdkError","getPostHogInstance","capturePosthogEvent"],"mappings":"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"}

package/dist/diagnostics/athena-diagnostics.d.ts

@@ -27,7 +27,9 @@ export type AthenaDiagnosticLevel = (typeof ATHENA_DIAGNOSTIC_LEVELS)[number];
  * are part of the public contract: renaming one is a breaking change for
  * dashboards, so add new ones instead of repurposing.
  */
-export type AthenaDiagnosticEventName = 'sdk.init' | 'sdk.transport' | 'sdk.config.warning' | 'auth.bridge.start' | 'auth.bridge.ready' | 'auth.bridge.timeout' | 'auth.bridge.absent' | 'auth.bridge.error' | 'auth.bridge.retry' | 'auth.bridge.config_rejected' | 'auth.token.acquired' | 'auth.token.refreshed' | 'auth.token.refresh_failed' | 'auth.token.stale' | 'auth.sso.userinfo.start' | 'auth.sso.userinfo.done' | 'auth.sso.userinfo.error' | 'threads.list.start' | 'threads.list.done' | 'threads.list.error' | 'threads.list.aborted' | 'threads.history.start' | 'threads.history.done' | 'threads.history.error' | 'threads.history.aborted' | 'statewire.attach.start' | 'statewire.snapshot' | 'statewire.connection' | 'statewire.parked' | 'statewire.error' | 'statewire.read_only' | 'run.send' | 'run.first_token' | 'run.done' | 'run.error' | 'composer.attachment.error' | 'composer.cancel.error' | 'composer.dictation' | 'composer.handoff' | 'tools.schema.warning' | 'tools.debug' | 'mentions.fetch.error' | 'sdk.error';
+export type AthenaDiagnosticEventName = 'sdk.init' | 'sdk.transport' | 'sdk.config.warning' | 'auth.bridge.start' | 'auth.bridge.ready' | 'auth.bridge.timeout' | 'auth.bridge.absent' | 'auth.bridge.error' | 'auth.bridge.retry' | 'auth.bridge.config_rejected' | 'auth.token.acquired' | 'auth.token.refreshed' | 'auth.token.refresh_failed' | 'auth.token.stale' | 'auth.sso.userinfo.start' | 'auth.sso.userinfo.done' | 'auth.sso.userinfo.error' | 'threads.list.start' | 'threads.list.done' | 'threads.list.error' | 'threads.list.aborted' | 'threads.history.start' | 'threads.history.done' | 'threads.history.error' | 'threads.history.aborted' | 'statewire.attach.start' | 'statewire.snapshot' | 'statewire.connection' | 'statewire.parked' | 'statewire.error' | 'statewire.read_only'
+/** A write to the thread's server config lane (`config/patch`) was refused or dropped. */
+ | 'statewire.config' | 'run.send' | 'run.first_token' | 'run.done' | 'run.error' | 'composer.attachment.error' | 'composer.cancel.error' | 'composer.dictation' | 'composer.handoff' | 'tools.schema.warning' | 'tools.debug' | 'mentions.fetch.error' | 'sdk.error';
 export interface AthenaDiagnosticEvent {
     /** Monotonic sequence number within this page. */
     seq: number;

package/dist/diagnostics/athena-diagnostics.js.map

@@ -1 +1 @@
-{"version":3,"file":"athena-diagnostics.js","sources":["../../src/diagnostics/athena-diagnostics.ts"],"sourcesContent":["/**\n * SDK diagnostics: one structured event bus for everything the SDK does that\n * can be slow or can fail — auth acquisition, thread-list fetches, statewire\n * attach/snapshot/connection changes, sends, first tokens, and every error.\n *\n * Design:\n * - Module-level singleton (one SDK, one bus), configured by `AthenaProvider`\n *   from its `debug` / `onDiagnostic` / `onError` props. Nothing here runs\n *   until something calls `emit`, and with defaults it costs a ring-buffer push.\n * - Every event carries `t` (ms since page navigation start via\n *   `performance.now()`) so the buffer reads as a waterfall. Timed spans use\n *   `performance.mark` / `performance.measure` too, so the browser Performance\n *   panel shows them as user timings without any extra tooling.\n * - Console output is opt-in (`debug` prop or `localStorage['athena:debug']`),\n *   prefixed `[AthenaSDK]`, and level-gated. Errors always reach `onError`.\n * - PostHog forwarding (opt-in) sends the timing events as\n *   `athena_sdk_<name>` with `duration_ms`, through the SDK's capture gate.\n *\n * Consumers read the buffer with `useAthenaDiagnostics()` or, in the browser\n * console, `window.__ATHENA_SDK__.diagnostics.snapshot()`.\n */\n\nimport { getPostHogInstance } from '../provider/PostHogProvider';\nimport { capturePosthogEvent, type PosthogCaptureClient } from '../lib/posthog/wrap-posthog-client';\nimport { ATHENA_REACT_SDK_VERSION } from '../version';\nimport { AthenaSdkError, isAthenaSdkError, toAthenaSdkError } from './errors';\n\nexport const ATHENA_DIAGNOSTIC_LEVELS = ['debug', 'info', 'warn', 'error'] as const;\nexport type AthenaDiagnosticLevel = (typeof ATHENA_DIAGNOSTIC_LEVELS)[number];\n\nconst LEVEL_RANK: Record<AthenaDiagnosticLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\n/**\n * Event names. Dotted `area.event` so a consumer can filter by prefix. Names\n * are part of the public contract: renaming one is a breaking change for\n * dashboards, so add new ones instead of repurposing.\n */\nexport type AthenaDiagnosticEventName =\n  // Provider / configuration\n  | 'sdk.init'\n  | 'sdk.transport'\n  | 'sdk.config.warning'\n  // Auth acquisition + lifecycle\n  | 'auth.bridge.start'\n  | 'auth.bridge.ready'\n  | 'auth.bridge.timeout'\n  | 'auth.bridge.absent'\n  | 'auth.bridge.error'\n  | 'auth.bridge.retry'\n  | 'auth.bridge.config_rejected'\n  | 'auth.token.acquired'\n  | 'auth.token.refreshed'\n  | 'auth.token.refresh_failed'\n  | 'auth.token.stale'\n  | 'auth.sso.userinfo.start'\n  | 'auth.sso.userinfo.done'\n  | 'auth.sso.userinfo.error'\n  // Thread list + history\n  | 'threads.list.start'\n  | 'threads.list.done'\n  | 'threads.list.error'\n  | 'threads.list.aborted'\n  | 'threads.history.start'\n  | 'threads.history.done'\n  | 'threads.history.error'\n  | 'threads.history.aborted'\n  // Statewire transport\n  | 'statewire.attach.start'\n  | 'statewire.snapshot'\n  | 'statewire.connection'\n  | 'statewire.parked'\n  | 'statewire.error'\n  | 'statewire.read_only'\n  // Runs\n  | 'run.send'\n  | 'run.first_token'\n  | 'run.done'\n  | 'run.error'\n  // Composer\n  | 'composer.attachment.error'\n  | 'composer.cancel.error'\n  | 'composer.dictation'\n  | 'composer.handoff'\n  // Tool UIs + frontend tools\n  | 'tools.schema.warning'\n  | 'tools.debug'\n  // Mention suggestions\n  | 'mentions.fetch.error'\n  // Catch-all\n  | 'sdk.error';\n\nexport interface AthenaDiagnosticEvent {\n  /** Monotonic sequence number within this page. */\n  seq: number;\n  /** `performance.now()` at emit time (ms since navigation start). */\n  t: number;\n  /** Wall-clock ISO timestamp, for exports. */\n  at: string;\n  name: AthenaDiagnosticEventName;\n  level: AthenaDiagnosticLevel;\n  /** Milliseconds for a completed span (set on `*.done` / `*.ready` / `run.first_token`). */\n  durationMs?: number;\n  /** Structured context. Never contains credentials — see `redact`. */\n  data?: Record<string, unknown>;\n  /** Present on error-level events. */\n  error?: AthenaSdkError;\n}\n\nexport interface AthenaDiagnosticsConfig {\n  /** Minimum level echoed to the console. `false` disables console output. */\n  console: AthenaDiagnosticLevel | false;\n  /** Forward timing + error events to PostHog as `athena_sdk_*` events. */\n  posthog: boolean;\n  /** Receives every event (already redacted). */\n  onEvent?: (event: AthenaDiagnosticEvent) => void;\n  /** Receives every error-level event's `AthenaSdkError`. */\n  onError?: (error: AthenaSdkError, event: AthenaDiagnosticEvent) => void;\n  /** Ring-buffer capacity. */\n  bufferSize: number;\n}\n\nexport interface AthenaDiagnosticsSnapshot {\n  sdkVersion: string;\n  config: Omit<AthenaDiagnosticsConfig, 'onEvent' | 'onError'>;\n  events: AthenaDiagnosticEvent[];\n  /** Latest value per gauge (connection status, transport, auth mode, …). */\n  gauges: Record<string, unknown>;\n  /** Named span durations, most recent per name (`auth.bridge`, `threads.list`, …). */\n  timings: Record<string, number>;\n}\n\nconst DEFAULT_CONFIG: AthenaDiagnosticsConfig = {\n  console: false,\n  posthog: false,\n  bufferSize: 300,\n};\n\nconst CONSOLE_PREFIX = '[AthenaSDK]';\nconst LOCAL_STORAGE_DEBUG_KEY = 'athena:debug';\nconst GLOBAL_KEY = '__ATHENA_SDK__';\n\n// Keys whose values must never enter the buffer, the console, or PostHog.\nconst REDACT_KEYS = /token|secret|api[-_]?key|authorization|cookie|password/i;\n\nfunction redact(data: Record<string, unknown> | undefined): Record<string, unknown> | undefined {\n  if (!data) return undefined;\n  const out: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (REDACT_KEYS.test(key)) {\n      out[key] = typeof value === 'string' && value.length > 0 ? `<redacted:${value.length}>` : '<redacted>';\n    } else {\n      out[key] = value;\n    }\n  }\n  return out;\n}\n\nfunction nowMs(): number {\n  return typeof performance !== 'undefined' && typeof performance.now === 'function'\n    ? performance.now()\n    : Date.now();\n}\n\nfunction readLocalDebugLevel(): AthenaDiagnosticLevel | null {\n  try {\n    if (typeof localStorage === 'undefined') return null;\n    const raw = localStorage.getItem(LOCAL_STORAGE_DEBUG_KEY);\n    if (!raw) return null;\n    if ((ATHENA_DIAGNOSTIC_LEVELS as readonly string[]).includes(raw)) {\n      return raw as AthenaDiagnosticLevel;\n    }\n    return raw === '1' || raw === 'true' ? 'debug' : null;\n  } catch {\n    return null;\n  }\n}\n\ntype Listener = (event: AthenaDiagnosticEvent) => void;\n\nclass AthenaDiagnosticsBus {\n  private config: AthenaDiagnosticsConfig = { ...DEFAULT_CONFIG };\n  private events: AthenaDiagnosticEvent[] = [];\n  private listeners = new Set<Listener>();\n  private snapshotListeners = new Set<() => void>();\n  private seq = 0;\n  private gauges: Record<string, unknown> = {};\n  private timings: Record<string, number> = {};\n  private spans = new Map<string, number>();\n  private cachedSnapshot: AthenaDiagnosticsSnapshot | null = null;\n\n  configure(partial: Partial<AthenaDiagnosticsConfig>): void {\n    this.config = { ...this.config, ...partial };\n    if (this.events.length > this.config.bufferSize) {\n      this.events = this.events.slice(-this.config.bufferSize);\n    }\n    this.invalidate();\n  }\n\n  getConfig(): AthenaDiagnosticsConfig {\n    return this.config;\n  }\n\n  /** Effective console level: the configured one, or `localStorage['athena:debug']`. */\n  private consoleLevel(): AthenaDiagnosticLevel | false {\n    if (this.config.console !== false) return this.config.console;\n    return readLocalDebugLevel() ?? false;\n  }\n\n  emit(\n    name: AthenaDiagnosticEventName,\n    options: {\n      level?: AthenaDiagnosticLevel;\n      data?: Record<string, unknown>;\n      durationMs?: number;\n      error?: unknown;\n    } = {},\n  ): AthenaDiagnosticEvent {\n    const level = options.level ?? (options.error !== undefined ? 'error' : 'info');\n    const error =\n      options.error === undefined\n        ? undefined\n        : toAthenaSdkError(options.error, {\n            code: 'unknown',\n            message: `Unexpected error during ${name}`,\n          });\n    const event: AthenaDiagnosticEvent = {\n      seq: ++this.seq,\n      t: Math.round(nowMs() * 10) / 10,\n      at: new Date().toISOString(),\n      name,\n      level,\n      ...(options.durationMs !== undefined && { durationMs: Math.round(options.durationMs) }),\n      ...(options.data && { data: redact(options.data) }),\n      ...(error && { error }),\n    };\n\n    this.events.push(event);\n    if (this.events.length > this.config.bufferSize) {\n      this.events.splice(0, this.events.length - this.config.bufferSize);\n    }\n    if (event.durationMs !== undefined) {\n      this.timings[name] = event.durationMs;\n    }\n    this.invalidate();\n\n    this.echoToConsole(event);\n    this.forwardToPostHog(event);\n    for (const listener of this.listeners) {\n      try {\n        listener(event);\n      } catch (listenerError) {\n        console.error(`${CONSOLE_PREFIX} diagnostics listener threw`, listenerError);\n      }\n    }\n    if (this.config.onEvent) {\n      try {\n        this.config.onEvent(event);\n      } catch (callbackError) {\n        console.error(`${CONSOLE_PREFIX} onDiagnostic callback threw`, callbackError);\n      }\n    }\n    if (error && this.config.onError) {\n      try {\n        this.config.onError(error, event);\n      } catch (callbackError) {\n        console.error(`${CONSOLE_PREFIX} onError callback threw`, callbackError);\n      }\n    }\n    for (const notify of this.snapshotListeners) notify();\n    return event;\n  }\n\n  /** Record an error-level event. Returns the normalized `AthenaSdkError`. */\n  error(\n    name: AthenaDiagnosticEventName,\n    error: unknown,\n    fallback: { code: AthenaSdkError['code']; message: string; hint?: string },\n    data?: Record<string, unknown>,\n  ): AthenaSdkError {\n    const normalized = toAthenaSdkError(error, fallback);\n    this.emit(name, { level: 'error', error: normalized, data });\n    return normalized;\n  }\n\n  /**\n   * Start a named span. Returns a function that ends it and emits `doneName`\n   * with `durationMs` (or `errorName` when passed an error). Also records a\n   * `performance.measure` so the span shows in the browser's Performance panel.\n   */\n  span(\n    spanName: string,\n    startName: AthenaDiagnosticEventName,\n    data?: Record<string, unknown>,\n  ): (\n    doneName: AthenaDiagnosticEventName,\n    doneOptions?: { data?: Record<string, unknown>; error?: unknown },\n  ) => number {\n    const startedAt = nowMs();\n    this.spans.set(spanName, startedAt);\n    this.mark(`${spanName}:start`);\n    this.emit(startName, { level: 'debug', data });\n    return (doneName, doneOptions = {}) => {\n      const durationMs = nowMs() - startedAt;\n      this.spans.delete(spanName);\n      this.mark(`${spanName}:end`);\n      this.measure(spanName);\n      this.emit(doneName, {\n        level: doneOptions.error !== undefined ? 'error' : 'info',\n        durationMs,\n        data: doneOptions.data,\n        error: doneOptions.error,\n      });\n      return durationMs;\n    };\n  }\n\n  /** Set a gauge (latest-value metric): connection status, transport, auth mode. */\n  gauge(name: string, value: unknown): void {\n    if (this.gauges[name] === value) return;\n    this.gauges[name] = value;\n    this.invalidate();\n    for (const notify of this.snapshotListeners) notify();\n  }\n\n  subscribe(listener: Listener): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  /**\n   * Additive consumer registration: every registered consumer receives every\n   * event (and every error), unlike the single `onEvent`/`onError` config\n   * slots which are last-writer-wins. `AthenaProvider` registers through this\n   * so two mounted providers never clobber each other's callbacks.\n   */\n  addConsumer(consumer: {\n    onEvent?: (event: AthenaDiagnosticEvent) => void;\n    onError?: (error: AthenaSdkError, event: AthenaDiagnosticEvent) => void;\n  }): () => void {\n    return this.subscribe((event) => {\n      try {\n        consumer.onEvent?.(event);\n      } catch (callbackError) {\n        console.error(`${CONSOLE_PREFIX} onDiagnostic consumer threw`, callbackError);\n      }\n      if (event.error) {\n        try {\n          consumer.onError?.(event.error, event);\n        } catch (callbackError) {\n          console.error(`${CONSOLE_PREFIX} onError consumer threw`, callbackError);\n        }\n      }\n    });\n  }\n\n  /** Subscribe to snapshot changes (for `useSyncExternalStore`). */\n  subscribeSnapshot(listener: () => void): () => void {\n    this.snapshotListeners.add(listener);\n    return () => {\n      this.snapshotListeners.delete(listener);\n    };\n  }\n\n  snapshot(): AthenaDiagnosticsSnapshot {\n    if (!this.cachedSnapshot) {\n      const { onEvent: _onEvent, onError: _onError, ...config } = this.config;\n      this.cachedSnapshot = {\n        sdkVersion: ATHENA_REACT_SDK_VERSION,\n        config,\n        events: [...this.events],\n        gauges: { ...this.gauges },\n        timings: { ...this.timings },\n      };\n    }\n    return this.cachedSnapshot;\n  }\n\n  /** Copy-paste-able JSON of the current snapshot (errors serialized). */\n  export(): string {\n    return JSON.stringify(\n      this.snapshot(),\n      (_key, value) => (isAthenaSdkError(value) ? value.toJSON() : value),\n      2,\n    );\n  }\n\n  clear(): void {\n    this.events = [];\n    this.timings = {};\n    this.invalidate();\n    for (const notify of this.snapshotListeners) notify();\n  }\n\n  private invalidate(): void {\n    this.cachedSnapshot = null;\n  }\n\n  private mark(name: string): void {\n    try {\n      if (typeof performance !== 'undefined' && typeof performance.mark === 'function') {\n        performance.mark(`athena-sdk:${name}`);\n      }\n    } catch {\n      // User Timing is best-effort.\n    }\n  }\n\n  private measure(spanName: string): void {\n    try {\n      if (typeof performance !== 'undefined' && typeof performance.measure === 'function') {\n        performance.measure(\n          `athena-sdk:${spanName}`,\n          `athena-sdk:${spanName}:start`,\n          `athena-sdk:${spanName}:end`,\n        );\n      }\n    } catch {\n      // A missing start mark (e.g. after `performance.clearMarks`) is not an error.\n    }\n  }\n\n  private echoToConsole(event: AthenaDiagnosticEvent): void {\n    const level = this.consoleLevel();\n    if (level === false) {\n      // Errors are never silent: with console output off they still log once,\n      // compactly, so a broken integration is visible without enabling debug.\n      if (event.level === 'error' && event.error) {\n        console.error(`${CONSOLE_PREFIX} ${event.name}: ${event.error.describe()}`, event.data ?? '');\n      }\n      return;\n    }\n    if (LEVEL_RANK[event.level] < LEVEL_RANK[level]) return;\n    const suffix = event.durationMs !== undefined ? ` (${event.durationMs}ms)` : '';\n    const line = `${CONSOLE_PREFIX} ${event.name}${suffix}`;\n    const payload = event.error ? { ...event.data, error: event.error.describe() } : event.data;\n    const method =\n      event.level === 'error'\n        ? console.error\n        : event.level === 'warn'\n          ? console.warn\n          : event.level === 'debug'\n            ? console.debug\n            : console.info;\n    method(line, payload ?? '');\n  }\n\n  private forwardToPostHog(event: AthenaDiagnosticEvent): void {\n    if (!this.config.posthog) return;\n    if (event.durationMs === undefined && event.level !== 'error') return;\n    try {\n      const client = getPostHogInstance<PosthogCaptureClient>();\n      capturePosthogEvent(client, `athena_sdk_${event.name.replace(/\\./g, '_')}`, {\n        sdk_version: ATHENA_REACT_SDK_VERSION,\n        level: event.level,\n        ...(event.durationMs !== undefined && { duration_ms: event.durationMs }),\n        ...(event.error && {\n          error_code: event.error.code,\n          error_message: event.error.message,\n          error_status: event.error.status,\n        }),\n        ...event.data,\n      });\n    } catch {\n      // Analytics must never break the chat.\n    }\n  }\n}\n\nexport const athenaDiagnostics = new AthenaDiagnosticsBus();\n\n/**\n * Expose the bus on `window.__ATHENA_SDK__` so an integrator can inspect the\n * waterfall from the console (`__ATHENA_SDK__.diagnostics.snapshot()`) or turn\n * console echo on without a rebuild (`localStorage.setItem('athena:debug','debug')`).\n */\nexport function installAthenaDiagnosticsGlobal(): void {\n  if (typeof window === 'undefined') return;\n  const globalWindow = window as unknown as Record<string, unknown>;\n  const existing = (globalWindow[GLOBAL_KEY] ?? {}) as Record<string, unknown>;\n  globalWindow[GLOBAL_KEY] = {\n    ...existing,\n    version: ATHENA_REACT_SDK_VERSION,\n    diagnostics: {\n      snapshot: () => athenaDiagnostics.snapshot(),\n      export: () => athenaDiagnostics.export(),\n      clear: () => athenaDiagnostics.clear(),\n      enableConsole: (level: AthenaDiagnosticLevel = 'debug') => {\n        try {\n          localStorage.setItem(LOCAL_STORAGE_DEBUG_KEY, level);\n        } catch {\n          // localStorage may be unavailable.\n        }\n        athenaDiagnostics.configure({ console: level });\n      },\n      disableConsole: () => {\n        try {\n          localStorage.removeItem(LOCAL_STORAGE_DEBUG_KEY);\n        } catch {\n          // localStorage may be unavailable.\n        }\n        athenaDiagnostics.configure({ console: false });\n      },\n    },\n  };\n}\n\n/** Normalize the provider's `debug` prop into a diagnostics config patch. */\nexport function debugPropToDiagnosticsConfig(\n  debug: boolean | AthenaDiagnosticLevel | Partial<AthenaDiagnosticsConfig> | undefined,\n): Partial<AthenaDiagnosticsConfig> {\n  if (debug === undefined) return {};\n  if (debug === true) return { console: 'debug' };\n  if (debug === false) return { console: false };\n  if (typeof debug === 'string') return { console: debug };\n  return debug;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"athena-diagnostics.js","sources":["../../src/diagnostics/athena-diagnostics.ts"],"sourcesContent":["/**\n * SDK diagnostics: one structured event bus for everything the SDK does that\n * can be slow or can fail — auth acquisition, thread-list fetches, statewire\n * attach/snapshot/connection changes, sends, first tokens, and every error.\n *\n * Design:\n * - Module-level singleton (one SDK, one bus), configured by `AthenaProvider`\n *   from its `debug` / `onDiagnostic` / `onError` props. Nothing here runs\n *   until something calls `emit`, and with defaults it costs a ring-buffer push.\n * - Every event carries `t` (ms since page navigation start via\n *   `performance.now()`) so the buffer reads as a waterfall. Timed spans use\n *   `performance.mark` / `performance.measure` too, so the browser Performance\n *   panel shows them as user timings without any extra tooling.\n * - Console output is opt-in (`debug` prop or `localStorage['athena:debug']`),\n *   prefixed `[AthenaSDK]`, and level-gated. Errors always reach `onError`.\n * - PostHog forwarding (opt-in) sends the timing events as\n *   `athena_sdk_<name>` with `duration_ms`, through the SDK's capture gate.\n *\n * Consumers read the buffer with `useAthenaDiagnostics()` or, in the browser\n * console, `window.__ATHENA_SDK__.diagnostics.snapshot()`.\n */\n\nimport { getPostHogInstance } from '../provider/PostHogProvider';\nimport { capturePosthogEvent, type PosthogCaptureClient } from '../lib/posthog/wrap-posthog-client';\nimport { ATHENA_REACT_SDK_VERSION } from '../version';\nimport { AthenaSdkError, isAthenaSdkError, toAthenaSdkError } from './errors';\n\nexport const ATHENA_DIAGNOSTIC_LEVELS = ['debug', 'info', 'warn', 'error'] as const;\nexport type AthenaDiagnosticLevel = (typeof ATHENA_DIAGNOSTIC_LEVELS)[number];\n\nconst LEVEL_RANK: Record<AthenaDiagnosticLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\n/**\n * Event names. Dotted `area.event` so a consumer can filter by prefix. Names\n * are part of the public contract: renaming one is a breaking change for\n * dashboards, so add new ones instead of repurposing.\n */\nexport type AthenaDiagnosticEventName =\n  // Provider / configuration\n  | 'sdk.init'\n  | 'sdk.transport'\n  | 'sdk.config.warning'\n  // Auth acquisition + lifecycle\n  | 'auth.bridge.start'\n  | 'auth.bridge.ready'\n  | 'auth.bridge.timeout'\n  | 'auth.bridge.absent'\n  | 'auth.bridge.error'\n  | 'auth.bridge.retry'\n  | 'auth.bridge.config_rejected'\n  | 'auth.token.acquired'\n  | 'auth.token.refreshed'\n  | 'auth.token.refresh_failed'\n  | 'auth.token.stale'\n  | 'auth.sso.userinfo.start'\n  | 'auth.sso.userinfo.done'\n  | 'auth.sso.userinfo.error'\n  // Thread list + history\n  | 'threads.list.start'\n  | 'threads.list.done'\n  | 'threads.list.error'\n  | 'threads.list.aborted'\n  | 'threads.history.start'\n  | 'threads.history.done'\n  | 'threads.history.error'\n  | 'threads.history.aborted'\n  // Statewire transport\n  | 'statewire.attach.start'\n  | 'statewire.snapshot'\n  | 'statewire.connection'\n  | 'statewire.parked'\n  | 'statewire.error'\n  | 'statewire.read_only'\n  /** A write to the thread's server config lane (`config/patch`) was refused or dropped. */\n  | 'statewire.config'\n  // Runs\n  | 'run.send'\n  | 'run.first_token'\n  | 'run.done'\n  | 'run.error'\n  // Composer\n  | 'composer.attachment.error'\n  | 'composer.cancel.error'\n  | 'composer.dictation'\n  | 'composer.handoff'\n  // Tool UIs + frontend tools\n  | 'tools.schema.warning'\n  | 'tools.debug'\n  // Mention suggestions\n  | 'mentions.fetch.error'\n  // Catch-all\n  | 'sdk.error';\n\nexport interface AthenaDiagnosticEvent {\n  /** Monotonic sequence number within this page. */\n  seq: number;\n  /** `performance.now()` at emit time (ms since navigation start). */\n  t: number;\n  /** Wall-clock ISO timestamp, for exports. */\n  at: string;\n  name: AthenaDiagnosticEventName;\n  level: AthenaDiagnosticLevel;\n  /** Milliseconds for a completed span (set on `*.done` / `*.ready` / `run.first_token`). */\n  durationMs?: number;\n  /** Structured context. Never contains credentials — see `redact`. */\n  data?: Record<string, unknown>;\n  /** Present on error-level events. */\n  error?: AthenaSdkError;\n}\n\nexport interface AthenaDiagnosticsConfig {\n  /** Minimum level echoed to the console. `false` disables console output. */\n  console: AthenaDiagnosticLevel | false;\n  /** Forward timing + error events to PostHog as `athena_sdk_*` events. */\n  posthog: boolean;\n  /** Receives every event (already redacted). */\n  onEvent?: (event: AthenaDiagnosticEvent) => void;\n  /** Receives every error-level event's `AthenaSdkError`. */\n  onError?: (error: AthenaSdkError, event: AthenaDiagnosticEvent) => void;\n  /** Ring-buffer capacity. */\n  bufferSize: number;\n}\n\nexport interface AthenaDiagnosticsSnapshot {\n  sdkVersion: string;\n  config: Omit<AthenaDiagnosticsConfig, 'onEvent' | 'onError'>;\n  events: AthenaDiagnosticEvent[];\n  /** Latest value per gauge (connection status, transport, auth mode, …). */\n  gauges: Record<string, unknown>;\n  /** Named span durations, most recent per name (`auth.bridge`, `threads.list`, …). */\n  timings: Record<string, number>;\n}\n\nconst DEFAULT_CONFIG: AthenaDiagnosticsConfig = {\n  console: false,\n  posthog: false,\n  bufferSize: 300,\n};\n\nconst CONSOLE_PREFIX = '[AthenaSDK]';\nconst LOCAL_STORAGE_DEBUG_KEY = 'athena:debug';\nconst GLOBAL_KEY = '__ATHENA_SDK__';\n\n// Keys whose values must never enter the buffer, the console, or PostHog.\nconst REDACT_KEYS = /token|secret|api[-_]?key|authorization|cookie|password/i;\n\nfunction redact(data: Record<string, unknown> | undefined): Record<string, unknown> | undefined {\n  if (!data) return undefined;\n  const out: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (REDACT_KEYS.test(key)) {\n      out[key] = typeof value === 'string' && value.length > 0 ? `<redacted:${value.length}>` : '<redacted>';\n    } else {\n      out[key] = value;\n    }\n  }\n  return out;\n}\n\nfunction nowMs(): number {\n  return typeof performance !== 'undefined' && typeof performance.now === 'function'\n    ? performance.now()\n    : Date.now();\n}\n\nfunction readLocalDebugLevel(): AthenaDiagnosticLevel | null {\n  try {\n    if (typeof localStorage === 'undefined') return null;\n    const raw = localStorage.getItem(LOCAL_STORAGE_DEBUG_KEY);\n    if (!raw) return null;\n    if ((ATHENA_DIAGNOSTIC_LEVELS as readonly string[]).includes(raw)) {\n      return raw as AthenaDiagnosticLevel;\n    }\n    return raw === '1' || raw === 'true' ? 'debug' : null;\n  } catch {\n    return null;\n  }\n}\n\ntype Listener = (event: AthenaDiagnosticEvent) => void;\n\nclass AthenaDiagnosticsBus {\n  private config: AthenaDiagnosticsConfig = { ...DEFAULT_CONFIG };\n  private events: AthenaDiagnosticEvent[] = [];\n  private listeners = new Set<Listener>();\n  private snapshotListeners = new Set<() => void>();\n  private seq = 0;\n  private gauges: Record<string, unknown> = {};\n  private timings: Record<string, number> = {};\n  private spans = new Map<string, number>();\n  private cachedSnapshot: AthenaDiagnosticsSnapshot | null = null;\n\n  configure(partial: Partial<AthenaDiagnosticsConfig>): void {\n    this.config = { ...this.config, ...partial };\n    if (this.events.length > this.config.bufferSize) {\n      this.events = this.events.slice(-this.config.bufferSize);\n    }\n    this.invalidate();\n  }\n\n  getConfig(): AthenaDiagnosticsConfig {\n    return this.config;\n  }\n\n  /** Effective console level: the configured one, or `localStorage['athena:debug']`. */\n  private consoleLevel(): AthenaDiagnosticLevel | false {\n    if (this.config.console !== false) return this.config.console;\n    return readLocalDebugLevel() ?? false;\n  }\n\n  emit(\n    name: AthenaDiagnosticEventName,\n    options: {\n      level?: AthenaDiagnosticLevel;\n      data?: Record<string, unknown>;\n      durationMs?: number;\n      error?: unknown;\n    } = {},\n  ): AthenaDiagnosticEvent {\n    const level = options.level ?? (options.error !== undefined ? 'error' : 'info');\n    const error =\n      options.error === undefined\n        ? undefined\n        : toAthenaSdkError(options.error, {\n            code: 'unknown',\n            message: `Unexpected error during ${name}`,\n          });\n    const event: AthenaDiagnosticEvent = {\n      seq: ++this.seq,\n      t: Math.round(nowMs() * 10) / 10,\n      at: new Date().toISOString(),\n      name,\n      level,\n      ...(options.durationMs !== undefined && { durationMs: Math.round(options.durationMs) }),\n      ...(options.data && { data: redact(options.data) }),\n      ...(error && { error }),\n    };\n\n    this.events.push(event);\n    if (this.events.length > this.config.bufferSize) {\n      this.events.splice(0, this.events.length - this.config.bufferSize);\n    }\n    if (event.durationMs !== undefined) {\n      this.timings[name] = event.durationMs;\n    }\n    this.invalidate();\n\n    this.echoToConsole(event);\n    this.forwardToPostHog(event);\n    for (const listener of this.listeners) {\n      try {\n        listener(event);\n      } catch (listenerError) {\n        console.error(`${CONSOLE_PREFIX} diagnostics listener threw`, listenerError);\n      }\n    }\n    if (this.config.onEvent) {\n      try {\n        this.config.onEvent(event);\n      } catch (callbackError) {\n        console.error(`${CONSOLE_PREFIX} onDiagnostic callback threw`, callbackError);\n      }\n    }\n    if (error && this.config.onError) {\n      try {\n        this.config.onError(error, event);\n      } catch (callbackError) {\n        console.error(`${CONSOLE_PREFIX} onError callback threw`, callbackError);\n      }\n    }\n    for (const notify of this.snapshotListeners) notify();\n    return event;\n  }\n\n  /** Record an error-level event. Returns the normalized `AthenaSdkError`. */\n  error(\n    name: AthenaDiagnosticEventName,\n    error: unknown,\n    fallback: { code: AthenaSdkError['code']; message: string; hint?: string },\n    data?: Record<string, unknown>,\n  ): AthenaSdkError {\n    const normalized = toAthenaSdkError(error, fallback);\n    this.emit(name, { level: 'error', error: normalized, data });\n    return normalized;\n  }\n\n  /**\n   * Start a named span. Returns a function that ends it and emits `doneName`\n   * with `durationMs` (or `errorName` when passed an error). Also records a\n   * `performance.measure` so the span shows in the browser's Performance panel.\n   */\n  span(\n    spanName: string,\n    startName: AthenaDiagnosticEventName,\n    data?: Record<string, unknown>,\n  ): (\n    doneName: AthenaDiagnosticEventName,\n    doneOptions?: { data?: Record<string, unknown>; error?: unknown },\n  ) => number {\n    const startedAt = nowMs();\n    this.spans.set(spanName, startedAt);\n    this.mark(`${spanName}:start`);\n    this.emit(startName, { level: 'debug', data });\n    return (doneName, doneOptions = {}) => {\n      const durationMs = nowMs() - startedAt;\n      this.spans.delete(spanName);\n      this.mark(`${spanName}:end`);\n      this.measure(spanName);\n      this.emit(doneName, {\n        level: doneOptions.error !== undefined ? 'error' : 'info',\n        durationMs,\n        data: doneOptions.data,\n        error: doneOptions.error,\n      });\n      return durationMs;\n    };\n  }\n\n  /** Set a gauge (latest-value metric): connection status, transport, auth mode. */\n  gauge(name: string, value: unknown): void {\n    if (this.gauges[name] === value) return;\n    this.gauges[name] = value;\n    this.invalidate();\n    for (const notify of this.snapshotListeners) notify();\n  }\n\n  subscribe(listener: Listener): () => void {\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n    };\n  }\n\n  /**\n   * Additive consumer registration: every registered consumer receives every\n   * event (and every error), unlike the single `onEvent`/`onError` config\n   * slots which are last-writer-wins. `AthenaProvider` registers through this\n   * so two mounted providers never clobber each other's callbacks.\n   */\n  addConsumer(consumer: {\n    onEvent?: (event: AthenaDiagnosticEvent) => void;\n    onError?: (error: AthenaSdkError, event: AthenaDiagnosticEvent) => void;\n  }): () => void {\n    return this.subscribe((event) => {\n      try {\n        consumer.onEvent?.(event);\n      } catch (callbackError) {\n        console.error(`${CONSOLE_PREFIX} onDiagnostic consumer threw`, callbackError);\n      }\n      if (event.error) {\n        try {\n          consumer.onError?.(event.error, event);\n        } catch (callbackError) {\n          console.error(`${CONSOLE_PREFIX} onError consumer threw`, callbackError);\n        }\n      }\n    });\n  }\n\n  /** Subscribe to snapshot changes (for `useSyncExternalStore`). */\n  subscribeSnapshot(listener: () => void): () => void {\n    this.snapshotListeners.add(listener);\n    return () => {\n      this.snapshotListeners.delete(listener);\n    };\n  }\n\n  snapshot(): AthenaDiagnosticsSnapshot {\n    if (!this.cachedSnapshot) {\n      const { onEvent: _onEvent, onError: _onError, ...config } = this.config;\n      this.cachedSnapshot = {\n        sdkVersion: ATHENA_REACT_SDK_VERSION,\n        config,\n        events: [...this.events],\n        gauges: { ...this.gauges },\n        timings: { ...this.timings },\n      };\n    }\n    return this.cachedSnapshot;\n  }\n\n  /** Copy-paste-able JSON of the current snapshot (errors serialized). */\n  export(): string {\n    return JSON.stringify(\n      this.snapshot(),\n      (_key, value) => (isAthenaSdkError(value) ? value.toJSON() : value),\n      2,\n    );\n  }\n\n  clear(): void {\n    this.events = [];\n    this.timings = {};\n    this.invalidate();\n    for (const notify of this.snapshotListeners) notify();\n  }\n\n  private invalidate(): void {\n    this.cachedSnapshot = null;\n  }\n\n  private mark(name: string): void {\n    try {\n      if (typeof performance !== 'undefined' && typeof performance.mark === 'function') {\n        performance.mark(`athena-sdk:${name}`);\n      }\n    } catch {\n      // User Timing is best-effort.\n    }\n  }\n\n  private measure(spanName: string): void {\n    try {\n      if (typeof performance !== 'undefined' && typeof performance.measure === 'function') {\n        performance.measure(\n          `athena-sdk:${spanName}`,\n          `athena-sdk:${spanName}:start`,\n          `athena-sdk:${spanName}:end`,\n        );\n      }\n    } catch {\n      // A missing start mark (e.g. after `performance.clearMarks`) is not an error.\n    }\n  }\n\n  private echoToConsole(event: AthenaDiagnosticEvent): void {\n    const level = this.consoleLevel();\n    if (level === false) {\n      // Errors are never silent: with console output off they still log once,\n      // compactly, so a broken integration is visible without enabling debug.\n      if (event.level === 'error' && event.error) {\n        console.error(`${CONSOLE_PREFIX} ${event.name}: ${event.error.describe()}`, event.data ?? '');\n      }\n      return;\n    }\n    if (LEVEL_RANK[event.level] < LEVEL_RANK[level]) return;\n    const suffix = event.durationMs !== undefined ? ` (${event.durationMs}ms)` : '';\n    const line = `${CONSOLE_PREFIX} ${event.name}${suffix}`;\n    const payload = event.error ? { ...event.data, error: event.error.describe() } : event.data;\n    const method =\n      event.level === 'error'\n        ? console.error\n        : event.level === 'warn'\n          ? console.warn\n          : event.level === 'debug'\n            ? console.debug\n            : console.info;\n    method(line, payload ?? '');\n  }\n\n  private forwardToPostHog(event: AthenaDiagnosticEvent): void {\n    if (!this.config.posthog) return;\n    if (event.durationMs === undefined && event.level !== 'error') return;\n    try {\n      const client = getPostHogInstance<PosthogCaptureClient>();\n      capturePosthogEvent(client, `athena_sdk_${event.name.replace(/\\./g, '_')}`, {\n        sdk_version: ATHENA_REACT_SDK_VERSION,\n        level: event.level,\n        ...(event.durationMs !== undefined && { duration_ms: event.durationMs }),\n        ...(event.error && {\n          error_code: event.error.code,\n          error_message: event.error.message,\n          error_status: event.error.status,\n        }),\n        ...event.data,\n      });\n    } catch {\n      // Analytics must never break the chat.\n    }\n  }\n}\n\nexport const athenaDiagnostics = new AthenaDiagnosticsBus();\n\n/**\n * Expose the bus on `window.__ATHENA_SDK__` so an integrator can inspect the\n * waterfall from the console (`__ATHENA_SDK__.diagnostics.snapshot()`) or turn\n * console echo on without a rebuild (`localStorage.setItem('athena:debug','debug')`).\n */\nexport function installAthenaDiagnosticsGlobal(): void {\n  if (typeof window === 'undefined') return;\n  const globalWindow = window as unknown as Record<string, unknown>;\n  const existing = (globalWindow[GLOBAL_KEY] ?? {}) as Record<string, unknown>;\n  globalWindow[GLOBAL_KEY] = {\n    ...existing,\n    version: ATHENA_REACT_SDK_VERSION,\n    diagnostics: {\n      snapshot: () => athenaDiagnostics.snapshot(),\n      export: () => athenaDiagnostics.export(),\n      clear: () => athenaDiagnostics.clear(),\n      enableConsole: (level: AthenaDiagnosticLevel = 'debug') => {\n        try {\n          localStorage.setItem(LOCAL_STORAGE_DEBUG_KEY, level);\n        } catch {\n          // localStorage may be unavailable.\n        }\n        athenaDiagnostics.configure({ console: level });\n      },\n      disableConsole: () => {\n        try {\n          localStorage.removeItem(LOCAL_STORAGE_DEBUG_KEY);\n        } catch {\n          // localStorage may be unavailable.\n        }\n        athenaDiagnostics.configure({ console: false });\n      },\n    },\n  };\n}\n\n/** Normalize the provider's `debug` prop into a diagnostics config patch. */\nexport function debugPropToDiagnosticsConfig(\n  debug: boolean | AthenaDiagnosticLevel | Partial<AthenaDiagnosticsConfig> | undefined,\n): Partial<AthenaDiagnosticsConfig> {\n  if (debug === undefined) return {};\n  if (debug === true) return { console: 'debug' };\n  if (debug === false) return { console: false };\n  if (typeof debug === 'string') return { console: debug };\n  return debug;\n}\n"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -79,6 +79,7 @@ const sessionsQuery = require("./threads/sessions-query.cjs");
 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 api = require("./threads/api.cjs");
 const threadPrefetcher = require("./threads/thread-prefetcher.cjs");
 const useRestConversationHistory = require("./threads/use-rest-conversation-history.cjs");
@@ -160,10 +161,12 @@ exports.AthenaChatErrorBoundary = AthenaChatErrorBoundary.AthenaChatErrorBoundar
 exports.buildActivityTimeline = activityTimeline.buildActivityTimeline;
 exports.countActivityTools = activityTimeline.countActivityTools;
 exports.excludeFinalTextFromGroups = activityTimeline.excludeFinalTextFromGroups;
+exports.excludePartsFromGroups = activityTimeline.excludePartsFromGroups;
 exports.getActivityItemLabel = activityTimeline.getActivityItemLabel;
 exports.getActivitySummary = activityTimeline.getActivitySummary;
 exports.getActivityToolState = activityTimeline.getActivityToolState;
 exports.getFinalText = activityTimeline.getFinalText;
+exports.getFinalTextParts = activityTimeline.getFinalTextParts;
 exports.getReasoningLabel = activityTimeline.getReasoningLabel;
 exports.resolveActivityPhase = activityTimeline.resolveActivityPhase;
 exports.CollapsibleGroup = CollapsibleGroup.CollapsibleGroup;
@@ -369,6 +372,7 @@ exports.sessionSecondaryLine = sessionListModel.sessionSecondaryLine;
 exports.AthenaThreadIdContext = threadIdContext.AthenaThreadIdContext;
 exports.useAthenaStatewireThreadId = threadIdContext.useAthenaStatewireThreadId;
 exports.useAthenaThreadId = threadIdContext.useAthenaThreadId;
+exports.useAthenaThreadModel = useAthenaThreadModel.useAthenaThreadModel;
 exports.THREAD_TITLE_MAX_LENGTH = api.THREAD_TITLE_MAX_LENGTH;
 exports.archiveThread = api.archiveThread;
 exports.createThread = api.createThread;
@@ -412,6 +416,7 @@ exports.normalizeAgentCatalog = runtimeCatalog.normalizeAgentCatalog;
 exports.normalizeModelCatalog = runtimeCatalog.normalizeModelCatalog;
 exports.resolveCatalogModelId = runtimeCatalog.resolveCatalogModelId;
 exports.useAthenaAgentCatalog = runtimeCatalog.useAthenaAgentCatalog;
+exports.useAthenaAgentModelOptions = runtimeCatalog.useAthenaAgentModelOptions;
 exports.useAthenaModelCatalog = runtimeCatalog.useAthenaModelCatalog;
 exports.useFileUpload = useFileUpload.useFileUpload;
 exports.FileUploadButton = FileUploadButton.FileUploadButton;

package/dist/index.cjs.map

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

package/dist/index.d.ts

@@ -20,7 +20,7 @@ export { AthenaAssistantActionBar, AthenaAssistantMessage, AthenaChat, AthenaRea
 export type { AthenaAssistantActionBarProps, AthenaAssistantMessageProps, AthenaChatComponents, AthenaChatMessagePartComponents, AthenaChatProps, AthenaReasoningPartProps, AthenaUserMessageProps, } from './chat/AthenaChat';
 export type { WelcomeSuggestion } from './chat/athena-chat-welcome';
 export { AthenaChatErrorBoundary } from './chat/AthenaChatErrorBoundary';
-export { type ActivityItem, type ActivityPhase, type ActivityTimelineOptions, type ActivityToolState, buildActivityTimeline, CollapsibleGroup, type CollapsibleGroupProps, countActivityTools, createToolBasedGroupingFunction, DEFAULT_TOOLKIT_THEME, defaultGetToolGroupKey, excludeFinalTextFromGroups, type FinalTextPart, formatWorkDuration, getActivityItemLabel, getActivitySummary, getActivityToolState, getFinalText, getReasoningLabel, type GetToolGroupKey, type GroupablePart, type GroupingFunction, type MessagePartGroup, readTurnTiming, resetRememberedExpansionsForTests, resolveActivityPhase, splitTurnSegments, SuperGroupingCard, type SuperGroupingCardProps, SuperGroupingFinalText, SuperGroupingProvider, SuperGroupingTranscript, type SuperGroupingTranscriptProps, TOOLKIT_THEMES, type ToolGroupKeyOptions, type ToolkitTheme, type TurnSegment, type TurnTiming, useActivityExpansion, workedDurationMs, } from './chat/super-grouping';
+export { type ActivityItem, type ActivityPhase, type ActivityTimelineOptions, type ActivityToolState, buildActivityTimeline, CollapsibleGroup, type CollapsibleGroupProps, countActivityTools, createToolBasedGroupingFunction, DEFAULT_TOOLKIT_THEME, defaultGetToolGroupKey, excludeFinalTextFromGroups, excludePartsFromGroups, type FinalTextPart, type FinalTextSegment, formatWorkDuration, getActivityItemLabel, getActivitySummary, getActivityToolState, getFinalText, getFinalTextParts, getReasoningLabel, type GetToolGroupKey, type GroupablePart, type GroupingFunction, type MessagePartGroup, readTurnTiming, resetRememberedExpansionsForTests, resolveActivityPhase, splitTurnSegments, SuperGroupingCard, type SuperGroupingCardProps, SuperGroupingFinalText, SuperGroupingProvider, SuperGroupingTranscript, type SuperGroupingTranscriptProps, TOOLKIT_THEMES, type ToolGroupKeyOptions, type ToolkitTheme, type TurnSegment, type TurnTiming, useActivityExpansion, workedDurationMs, } from './chat/super-grouping';
 export { StatewireApprovalCard } from './chat/StatewireApprovalCard';
 export type { StatewireApprovalCardProps, StatewireApprovalEditorContext, StatewireApprovalRequestContext, } from './chat/StatewireApprovalCard';
 export { useStatewireApprovalRequest } from './chat/use-statewire-approval-request';
@@ -135,6 +135,8 @@ export type { ConversationAttention, ConversationAttentionSource, ConversationPu
 export type { ThreadFavoriteResponse, ThreadInboxDismissResponse, ThreadListFilterBody, ThreadListResponse, ThreadPullRequest, ThreadRenameResponse, ThreadSummary, ThreadWake, } from './threads/api';
 export { useRefreshThreadList } from './threads/statewire-thread-list';
 export { useAthenaThreadId, AthenaThreadIdContext, useAthenaStatewireThreadId, } from './threads/thread-id-context';
+export { useAthenaThreadModel } from './threads/use-athena-thread-model';
+export type { AthenaThreadModel } from './threads/use-athena-thread-model';
 export { listThreads, archiveThread, getThreadState, createThread, renameThread, setThreadReadState, setThreadFavorite, dismissThreadFromInbox, isThreadArchiveUnavailableError, isThreadFavoriteUnavailableError, isThreadRenameUnavailableError, THREAD_TITLE_MAX_LENGTH, } from './threads/api';
 export type { ThreadFavoriteTarget } from './threads/use-thread-favorite';
 export type { ThreadRenameTarget } from './threads/use-thread-rename';
@@ -164,8 +166,9 @@ export type { SendMessageOptions } from './composer/useSendMessage';
 export { useComposerAttachment } from './composer/useComposerAttachment';
 export { ChatAgentPicker, ChatModelPicker } from './catalog/chat-pickers';
 export type { ChatAgentPickerProps, ChatModelPickerProps } from './catalog/chat-pickers';
-export { credentialFingerprint, groupModelsByProvider, MODEL_PROVIDER_LABELS, normalizeAgentCatalog, normalizeModelCatalog, resolveCatalogModelId, useAthenaAgentCatalog, useAthenaModelCatalog, } from './catalog/runtime-catalog';
-export type { AthenaAgentOption, AthenaModelOption, AthenaModelStatus, } from './catalog/runtime-catalog';
+export { credentialFingerprint, groupModelsByProvider, MODEL_PROVIDER_LABELS, normalizeAgentCatalog, normalizeModelCatalog, resolveCatalogModelId, useAthenaAgentCatalog, useAthenaAgentModelOptions, useAthenaModelCatalog, } from './catalog/runtime-catalog';
+export type { AthenaAgentModelOptions, AthenaAgentModelOptionsStatus, AthenaAgentOption, AthenaModelOption, AthenaModelStatus, } from './catalog/runtime-catalog';
+export type { AthenaAgentModelOption } from './catalog/agent-model-options';
 export { useFileUpload } from './composer/useFileUpload';
 export type { UploadedAsset, UploadProgress, UseFileUploadReturn } from './composer/useFileUpload';
 export { FileUploadButton } from './composer/FileUploadButton';

package/dist/index.js

@@ -10,7 +10,7 @@ import { capturePosthogEvent, capturePosthogException, getPosthogCaptureGate, wr
 import { buildCoalescedCaptureProperties, isCriticalPosthogEvent, withCaptureGateBypass } from "./lib/posthog/capture-gate.js";
 import { AthenaAssistantActionBar, AthenaAssistantMessage, AthenaChat, AthenaReasoningPart, AthenaUserMessage } from "./chat/AthenaChat.js";
 import { AthenaChatErrorBoundary } from "./chat/AthenaChatErrorBoundary.js";
-import { buildActivityTimeline, countActivityTools, excludeFinalTextFromGroups, getActivityItemLabel, getActivitySummary, getActivityToolState, getFinalText, getReasoningLabel, resolveActivityPhase } from "./chat/super-grouping/activity-timeline.js";
+import { buildActivityTimeline, countActivityTools, excludeFinalTextFromGroups, excludePartsFromGroups, getActivityItemLabel, getActivitySummary, getActivityToolState, getFinalText, getFinalTextParts, getReasoningLabel, resolveActivityPhase } from "./chat/super-grouping/activity-timeline.js";
 import { CollapsibleGroup, DEFAULT_TOOLKIT_THEME, SuperGroupingProvider, TOOLKIT_THEMES } from "./chat/super-grouping/CollapsibleGroup.js";
 import { createToolBasedGroupingFunction } from "./chat/super-grouping/grouping-function.js";
 import { SuperGroupingCard, SuperGroupingFinalText, resetRememberedExpansionsForTests, useActivityExpansion } from "./chat/super-grouping/SuperGroupingCard.js";
@@ -77,6 +77,7 @@ import { DEFAULT_COLLAB_CHANNEL, SESSION_RUN_STATUSES, SESSION_SESSION_STATUSES,
 import { SESSIONS_COLUMNS, agentLabel, channelLabel, creatorLabel, groupSessionsBy, inboxStateChip, sessionStatusChip, sessionsCsv, sessionsFilterChips } from "./threads/sessions-page-model.js";
 import { WEB_APP_ORIGIN_LABEL, groupSessions, orderedPullRequests, pullRequestChip, pullRequestChipState, sessionIndicator, sessionListGroupOf, sessionOriginBadge, sessionOriginLabel, sessionSecondaryLine } from "./threads/session-list-model.js";
 import { AthenaThreadIdContext, useAthenaStatewireThreadId, useAthenaThreadId } from "./threads/thread-id-context.js";
+import { useAthenaThreadModel } from "./threads/use-athena-thread-model.js";
 import { THREAD_TITLE_MAX_LENGTH, archiveThread, createThread, dismissThreadFromInbox, getThreadState, isThreadArchiveUnavailableError, isThreadFavoriteUnavailableError, isThreadRenameUnavailableError, listThreads, renameThread, setThreadFavorite, setThreadReadState } from "./threads/api.js";
 import { THREAD_PREFETCH_HOVER_DELAY_MS, THREAD_PREFETCH_MAX_CONCURRENT } from "./threads/thread-prefetcher.js";
 import { conversationDisplayTitle, useRestConversationHistory } from "./threads/use-rest-conversation-history.js";
@@ -94,7 +95,7 @@ import { useReadComposerDraft } from "./composer/useReadComposerDraft.js";
 import { useSendMessage } from "./composer/useSendMessage.js";
 import { useComposerAttachment } from "./composer/useComposerAttachment.js";
 import { ChatAgentPicker, ChatModelPicker } from "./catalog/chat-pickers.js";
-import { MODEL_PROVIDER_LABELS, credentialFingerprint, groupModelsByProvider, normalizeAgentCatalog, normalizeModelCatalog, resolveCatalogModelId, useAthenaAgentCatalog, useAthenaModelCatalog } from "./catalog/runtime-catalog.js";
+import { MODEL_PROVIDER_LABELS, credentialFingerprint, groupModelsByProvider, normalizeAgentCatalog, normalizeModelCatalog, resolveCatalogModelId, useAthenaAgentCatalog, useAthenaAgentModelOptions, useAthenaModelCatalog } from "./catalog/runtime-catalog.js";
 import { useFileUpload } from "./composer/useFileUpload.js";
 import { FileUploadButton } from "./composer/FileUploadButton.js";
 import { ComposerDropZone } from "./composer/ComposerDropZone.js";
@@ -327,6 +328,7 @@ export {
   describeToolArgs,
   dismissThreadFromInbox,
   excludeFinalTextFromGroups,
+  excludePartsFromGroups,
   fetchComputerRuntimeStatus,
   fetchComputerSshAccess,
   fetchRepoSearch,
@@ -343,6 +345,7 @@ export {
   getActivityToolState,
   getAssetInfo,
   getFinalText,
+  getFinalTextParts,
   getPostHogInstance,
   getPosthogCaptureGate,
   getReasoningLabel,
@@ -437,6 +440,7 @@ export {
   useAssetEmbed,
   useAssetPanelStore,
   useAthenaAgentCatalog,
+  useAthenaAgentModelOptions,
   useAthenaCitationLinkHandler,
   useAthenaComputerSshAccess,
   useAthenaComputerStatus,
@@ -457,6 +461,7 @@ export {
   useAthenaStatewireThreadList,
   useAthenaThreadId,
   useAthenaThreadManager,
+  useAthenaThreadModel,
   useAttachments,
   useComposerAttachment,
   useComposerReady,