@athenaintel/react 0.20.0 → 0.21.0

package/dist/provider/AthenaProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"AthenaProvider.js","sources":["../../src/provider/AthenaProvider.tsx"],"sourcesContent":["import { AuiProvider } from '@assistant-ui/react';\nimport {\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useReducer,\n  useRef,\n  useState,\n  type ReactNode,\n} from 'react';\nimport type { Toolkit } from '@assistant-ui/react';\nimport {\n  createDeepAgentThreadSnapshotCache,\n  createDeepAgentToolOutputStore,\n  DeepAgentConnectionContext,\n  type DeepAgentThreadSnapshotCache,\n  type DeepAgentToolOutputStore,\n} from '@athenaintel/agent-runtime';\nimport {\n  assertHostMintedStatewireMount,\n  deriveAthenaAppUrl,\n  getAthenaEnvironmentUrls,\n  resolveStatewireSyncUrl,\n  type AthenaEnvironment,\n} from '../lib/athena-urls';\nimport { getAthenaApiBaseUrl } from '../collab/mint';\nimport { useParentBridge } from '../runtime/auth';\nimport { AthenaAuthContext } from '../auth/AthenaAuthContext';\nimport {\n  useAthenaStatewireRuntime,\n  useStatewireClientTools,\n} from '../runtime/useAthenaStatewireRuntime';\nimport {\n  athenaStatewireErrorNotice,\n  type AthenaStatewireLifecycleState,\n  initialStatewireLifecycle,\n  statewireLifecycleReducer,\n} from '../runtime/statewire-lifecycle';\nimport type { AthenaStatewireTokenGetter } from '../runtime/statewire-auth-headers';\nimport { resolveAgentProp } from '../runtime/statewire-run-config';\nimport { mintThreadId } from '../threads/mint-thread-id';\nimport { AthenaStatewireLifecycleContext } from './statewire-lifecycle-context';\nimport { StatewireToolOutputsContext } from './statewire-window-context';\nimport { StatewireClientToolBridge } from '../chat/StatewireClientToolBridge';\nimport {\n  athenaDiagnostics,\n  debugPropToDiagnosticsConfig,\n  installAthenaDiagnosticsGlobal,\n  type AthenaDiagnosticEvent,\n  type AthenaDiagnosticLevel,\n  type AthenaDiagnosticsConfig,\n} from '../diagnostics/athena-diagnostics';\nimport type { AthenaSdkError } from '../diagnostics/errors';\nimport { TooltipProvider } from '../ui/tooltip';\nimport { DEFAULT_AUTO_OPEN_TOOLS } from '../tools/auto-open-tools';\nimport { AthenaContext, type AthenaConfig } from './AthenaContext';\nimport type { AthenaProviderConfig } from './config';\nimport type {\n  AthenaCitationLinkOptions,\n  AthenaLinkClickOptions,\n} from './citation-links';\nimport {\n  AthenaStatewireThreadIdContext,\n  AthenaThreadIdContext,\n} from '../threads/thread-id-context';\nimport {\n  AthenaStatewireThreadListProvider,\n  StatewireThreadTitlePoller,\n  useAthenaStatewireThreadList,\n} from '../threads/statewire-thread-list';\nimport { useAssetPanelStore } from '../assets/asset-panel-store';\nimport { themeToStyleVars, type AthenaTheme } from '../theme';\nimport { PostHogProvider, type PostHogConfig } from './PostHogProvider';\n\nexport interface AthenaProviderProps {\n  children: ReactNode;\n\n  /** Preferred structured config for auth and Athena endpoint settings. */\n  config?: AthenaProviderConfig;\n\n  /** @deprecated Prefer `config.apiKey`. API key for authentication in standalone mode. */\n  apiKey?: string;\n\n  /** @deprecated Prefer `config.token`. PropelAuth token. If provided, takes priority over apiKey. If omitted, the SDK\n   *  will automatically listen for a token from the parent window via PostMessage. */\n  token?: string | null;\n\n  /** Run the thread AS a published collab agent. The only accepted shape is\n   *  `collab_agent:<asset_id>`: the thread then uses that agent's prompt,\n   *  tools, and model default, and the caller must have view access to the\n   *  agent asset. Omit it (or pass a blank string) to run the Athena deep agent.\n   *\n   *  Any other non-blank value throws at render — the statewire host cannot\n   *  honour named agents, and a selector that is silently dropped would let a\n   *  misconfigured deployment answer as the wrong agent. */\n  agent?: string;\n\n  /** Collab-agent channel id — a built-in channel (`email`, `sms`, …) or a\n   *  user-defined custom channel id from the agent's Channels tab. Selects\n   *  that channel's configuration overrides and stamps the session's origin.\n   *  Only meaningful together with a `collab_agent:<asset_id>` `agent`; sent\n   *  as `collab_channel_id`. An unknown or disabled channel rejects the run\n   *  with a structured, teaching error. */\n  channel?: string;\n\n  /** LLM model identifier. Defaults to the deep-agent default model\n   *  (`DEFAULT_STATEWIRE_MODEL`) — or, when a collab agent is selected, to\n   *  the model its author configured. */\n  model?: string;\n\n  /** Backend toolkit IDs to enable (e.g. 'document_toolkit', 'web_search_browse_toolkit'). */\n  tools?: string[];\n\n  /** Frontend tools that execute in the browser. The agent can invoke these.\n   *  Merged on top of the SDK's default auto-open tools; entries here take\n   *  precedence over defaults with the same name. Tools with a local\n   *  `execute` are declared to the backend as `client_tools` and run through\n   *  the statewire client-tool bridge. */\n  frontendTools?: Toolkit;\n\n  /** Disable the SDK's default auto-open behavior for created/touched assets. */\n  disableAutoOpen?: boolean;\n\n  /** @deprecated Prefer `config.apiUrl`. URL on the Iris host fronting the\n   *  deployment; its origin derives the statewire sync mount when\n   *  `statewireSyncUrl` is not set. */\n  apiUrl?: string;\n\n  /** @deprecated Prefer `config.backendUrl`. URL for the Athena backend API. */\n  backendUrl?: string;\n\n  /** @deprecated Prefer `config.appUrl`. URL for the Athena frontend app origin. */\n  appUrl?: string;\n\n  /** @deprecated Prefer `config.environment`. Athena environment preset used when URLs are not explicitly provided. */\n  environment?: AthenaEnvironment;\n\n  /** Resolve the latest auth token immediately before a request (for\n   *  expiring clients). Takes priority over `token` when it resolves.\n   *  Prefer `config.getToken` (see its `force` contract for refused\n   *  credentials). */\n  getToken?: AthenaStatewireTokenGetter;\n\n  /** Additional fields merged into runConfig.custom. Prefer\n   *  `config.extraRunConfig`. */\n  extraRunConfig?: Record<string, unknown>;\n\n  /** Statewire sync base URL override (the `…/v2/threads` mount). Defaults to\n   *  the mount a Marathon host mints, then the effective `apiUrl` host +\n   *  `/v2/threads`. Prefer `config.statewireSyncUrl`. */\n  statewireSyncUrl?: string;\n\n  /** Asset IDs to include in the workbench. */\n  workbench?: string[];\n\n  /** Knowledge base IDs for RAG context. */\n  knowledgeBase?: string[];\n\n  /** System prompt override. */\n  systemPrompt?: string;\n\n  /** Client app identifier for session filtering.\n   *  Sessions created with this ID can be filtered in the thread list.\n   *  E.g. \"olympus\", \"athena-app\", or a computer asset ID like \"asset_<uuid>\". */\n  appId?: string;\n\n  /** Thread ID override. Auto-generated if not provided. */\n  threadId?: string;\n\n  /** Enable thread list management (sidebar thread switching). */\n  enableThreadList?: boolean;\n\n  /** Theme configuration. Pass a preset from `themes` or a custom `AthenaTheme` object.\n   *  Injects CSS variables on a wrapper element — no CSS files needed.\n   *\n   *  @example\n   *  import { themes } from '@athenaintel/react';\n   *  <AthenaProvider theme={themes.dark}>\n   *\n   *  @example\n   *  <AthenaProvider theme={{ primary: '#8b5cf6', radius: '1rem' }}>\n   *\n   *  @example\n   *  <AthenaProvider theme={{ ...themes.dark, primary: '#22c55e' }}>\n   */\n  theme?: AthenaTheme;\n\n  /** Customize how rendered chat links behave. */\n  linkClicks?: AthenaLinkClickOptions;\n\n  /** @deprecated Prefer `linkClicks`. Customize how Athena citation links rendered in chat messages behave. */\n  citationLinks?: AthenaCitationLinkOptions;\n\n  /** PostHog analytics configuration. When omitted or keys are missing, PostHog is silently disabled.\n   *  Prefer `config.posthog` for structured configuration. */\n  posthog?: PostHogConfig;\n\n  /** SDK diagnostics.\n   *\n   *  - `true` / a level: echo structured `[AthenaSDK]` events to the console\n   *    at that level (`true` = 'debug').\n   *  - An object: full diagnostics config (console level, PostHog timing\n   *    forwarding, buffer size).\n   *\n   *  Independent of the prop, `localStorage.setItem('athena:debug','debug')`\n   *  (or `window.__ATHENA_SDK__.diagnostics.enableConsole()`) turns console\n   *  echo on at runtime without a rebuild. Errors log once even when off. */\n  debug?: boolean | AthenaDiagnosticLevel | Partial<AthenaDiagnosticsConfig>;\n\n  /** Receives every diagnostics event (timings, warnings, errors) — the hook\n   *  for shipping SDK telemetry to the host app's own pipeline. */\n  onDiagnostic?: (event: AthenaDiagnosticEvent) => void;\n\n  /** Receives every SDK error as a typed `AthenaSdkError` (stable `code`,\n   *  `hint`, structured server `detail`). Fires in addition to the UI's own\n   *  error handling, so integrations never fail silently. */\n  onError?: (error: AthenaSdkError, event: AthenaDiagnosticEvent) => void;\n}\n\nconst resolveTokenOverride = ({\n  config,\n  token,\n}: {\n  config?: AthenaProviderConfig;\n  token?: string | null;\n}): string | null | undefined => {\n  if (config?.token !== undefined) {\n    return config.token;\n  }\n  return token;\n};\n\nconst useAthenaConfigValue = ({\n  backendUrl,\n  appUrl,\n  apiKey,\n  token,\n  enabledToolkits,\n  linkClicks,\n  citationLinks,\n}: {\n  backendUrl: string;\n  appUrl: string;\n  apiKey?: string;\n  token?: string | null;\n  enabledToolkits: string[];\n  linkClicks?: AthenaLinkClickOptions;\n  citationLinks?: AthenaCitationLinkOptions;\n}): AthenaConfig => {\n  const linkClicksRef = useRef(linkClicks);\n  linkClicksRef.current = linkClicks;\n  const citationLinksRef = useRef(citationLinks);\n  citationLinksRef.current = citationLinks;\n  // Keep token in a ref so its value can update without invalidating the\n  // config object identity. PropelAuth rotates tokens on window focus —\n  // if token were a memo dep, every rotation would publish a new config\n  // object to context and force every consumer (e.g. AssetIframe) to\n  // re-render, causing asset panel flicker.\n  const tokenRef = useRef(token);\n  tokenRef.current = token;\n\n  return useMemo(\n    () => ({\n      backendUrl,\n      appUrl,\n      apiKey,\n      enabledToolkits,\n      get token() {\n        return tokenRef.current;\n      },\n      get linkClicks() {\n        return linkClicksRef.current;\n      },\n      get citationLinks() {\n        return citationLinksRef.current;\n      },\n    }),\n    [backendUrl, appUrl, apiKey, enabledToolkits],\n  );\n};\n\n// ─── Standalone Mode ──────────────────────────────────────────────────\n\nfunction AthenaStatewireStandalone({\n  children,\n  syncUrl,\n  backendUrl,\n  appUrl,\n  apiKey,\n  token,\n  getToken,\n  model,\n  agent,\n  channel,\n  tools,\n  frontendToolIds,\n  frontendTools,\n  workbench,\n  knowledgeBase,\n  systemPrompt,\n  appId,\n  extraRunConfig,\n  threadId: threadIdProp,\n  isNewChatOverride,\n  snapshotCache,\n  toolOutputs,\n  linkClicks,\n  citationLinks,\n}: {\n  children: ReactNode;\n  syncUrl: string;\n  backendUrl: string;\n  appUrl: string;\n  apiKey?: string;\n  token?: string | null;\n  getToken?: AthenaStatewireTokenGetter;\n  model?: string;\n  agent?: string;\n  channel?: string;\n  tools: string[];\n  frontendToolIds: string[];\n  frontendTools: Toolkit;\n  workbench?: string[];\n  knowledgeBase?: string[];\n  systemPrompt?: string;\n  appId?: string;\n  extraRunConfig?: Record<string, unknown>;\n  threadId?: string;\n  /** Overrides the \"new chat\" derivation (thread-list mode mints ids for\n   *  brand-new chats, which must still load as new). */\n  isNewChatOverride?: boolean;\n  /** The provider-owned snapshot cache (see `AthenaProvider`). */\n  snapshotCache: DeepAgentThreadSnapshotCache;\n  /** The provider-owned store of fetched-back cut tool outputs (see `AthenaProvider`). */\n  toolOutputs: DeepAgentToolOutputStore;\n  linkClicks?: AthenaLinkClickOptions;\n  citationLinks?: AthenaCitationLinkOptions;\n}) {\n  // Statewire attaches to `${syncUrl}/${threadId}`, so a thread ID must exist\n  // up front. An auto-generated ID is by definition a never-started local chat.\n  const generatedIdRef = useRef<string | null>(null);\n  if (generatedIdRef.current === null) {\n    generatedIdRef.current = mintThreadId();\n  }\n  const threadId = threadIdProp ?? generatedIdRef.current;\n\n  const [lifecycle, dispatchLifecycle] = useReducer(\n    statewireLifecycleReducer,\n    initialStatewireLifecycle,\n  );\n\n  const aui = useAthenaStatewireRuntime({\n    syncUrl,\n    threadId,\n    isNewChat: isNewChatOverride ?? !threadIdProp,\n    apiKey,\n    token,\n    getToken,\n    model,\n    agent,\n    channel,\n    tools,\n    frontendToolIds,\n    frontendToolkit: frontendTools,\n    workbench,\n    knowledgeBase,\n    systemPrompt,\n    appId,\n    extraRunConfig,\n    snapshotCache,\n    toolOutputs,\n    // The runtime already records every transport error on the diagnostics\n    // bus (with the channel-teardown split), so this layer only maps it to\n    // the banner notice.\n    onError: (error) => {\n      const notice = athenaStatewireErrorNotice(error);\n      if (notice) dispatchLifecycle({ type: 'error', error: notice });\n    },\n    onConnectionChange: (connection) => {\n      dispatchLifecycle({ type: 'connection', connection });\n    },\n    onRawConnectionChange: (connection) => {\n      dispatchLifecycle({ type: 'raw-connection', reconnect: connection.reconnect });\n    },\n  });\n\n  const clientTools = useStatewireClientTools(frontendTools);\n\n  const dismissError = useCallback(\n    () => dispatchLifecycle({ type: 'error', error: null }),\n    [],\n  );\n  const lifecycleValue = useMemo<AthenaStatewireLifecycleState>(\n    () => ({\n      connection: lifecycle.connection,\n      error: lifecycle.error,\n      reconnect: lifecycle.reconnect,\n      dismissError,\n    }),\n    [lifecycle, dismissError],\n  );\n\n  const athenaConfig = useAthenaConfigValue({\n    backendUrl,\n    appUrl,\n    apiKey,\n    token,\n    enabledToolkits: tools,\n    linkClicks,\n    citationLinks,\n  });\n\n  return (\n    <AuiProvider value={aui}>\n      <AthenaContext.Provider value={athenaConfig}>\n        <AthenaStatewireThreadIdContext.Provider value={threadId}>\n          <AthenaStatewireLifecycleContext.Provider value={lifecycleValue}>\n            <DeepAgentConnectionContext.Provider value={lifecycleValue.connection}>\n              <StatewireToolOutputsContext.Provider value={toolOutputs}>\n                <TooltipProvider>\n                  <StatewireClientToolBridge tools={clientTools} threadId={threadId} />\n                  {children}\n                </TooltipProvider>\n              </StatewireToolOutputsContext.Provider>\n            </DeepAgentConnectionContext.Provider>\n          </AthenaStatewireLifecycleContext.Provider>\n        </AthenaStatewireThreadIdContext.Provider>\n      </AthenaContext.Provider>\n    </AuiProvider>\n  );\n}\n\n// ─── Thread List Mode ─────────────────────────────────────────────────\n\nfunction AthenaStatewireWithThreadList({\n  children,\n  backendUrl,\n  syncUrl,\n  appId,\n  apiKey,\n  token,\n  getToken,\n  initialThreadId,\n  ...standaloneProps\n}: Omit<\n  Parameters<typeof AthenaStatewireStandalone>[0],\n  'threadId' | 'isNewChatOverride'\n> & {\n  initialThreadId?: string;\n}) {\n  return (\n    <AthenaStatewireThreadListProvider\n      backendUrl={backendUrl}\n      syncUrl={syncUrl}\n      apiKey={apiKey}\n      token={token}\n      getToken={getToken}\n      appId={appId}\n      initialThreadId={initialThreadId}\n    >\n      <AthenaStatewireActiveThreadHost\n        backendUrl={backendUrl}\n        syncUrl={syncUrl}\n        appId={appId}\n        apiKey={apiKey}\n        token={token}\n        getToken={getToken}\n        {...standaloneProps}\n      >\n        {children}\n      </AthenaStatewireActiveThreadHost>\n    </AthenaStatewireThreadListProvider>\n  );\n}\n\nfunction AthenaStatewireActiveThreadHost({\n  children,\n  ...standaloneProps\n}: Omit<\n  Parameters<typeof AthenaStatewireStandalone>[0],\n  'threadId' | 'isNewChatOverride'\n>) {\n  const list = useAthenaStatewireThreadList();\n  if (!list) return null;\n\n  // Keyed by thread id: a switch remounts the statewire session against the\n  // new `…/v2/threads/{id}` URL instead of importing history in place. The\n  // thread-id context is undefined for a never-started chat, so\n  // history-gated UI (e.g. the loading overlay) does not treat an\n  // intentionally-empty new chat as pending history.\n  return (\n    <AthenaThreadIdContext.Provider\n      value={list.isNewChat ? undefined : list.activeThreadId}\n    >\n      <AthenaStatewireStandalone\n        key={list.activeThreadId}\n        threadId={list.activeThreadId}\n        isNewChatOverride={list.isNewChat}\n        {...standaloneProps}\n      >\n        <StatewireThreadTitlePoller />\n        <AssetPanelThreadSync />\n        {children}\n      </AthenaStatewireStandalone>\n    </AthenaThreadIdContext.Provider>\n  );\n}\n\n/**\n * Syncs the active thread ID into the asset panel store so that open asset\n * tabs are scoped per-thread automatically.\n *\n * Scoped by the thread list's minted id from creation onward — NOT by\n * `useAthenaThreadManager().activeThreadId`, which is deliberately `null`\n * while a new chat is unpersisted (so URL sync never names it). The minted id\n * is the id the thread persists under, so tabs opened in a brand-new chat\n * stay put when the backend first lists it instead of being left behind in a\n * `null` scope the store never restores.\n */\nfunction AssetPanelThreadSync() {\n  const list = useAthenaStatewireThreadList();\n  const setCurrentThread = useAssetPanelStore((s) => s.setCurrentThread);\n  const activeThreadId = list?.activeThreadId ?? null;\n\n  useEffect(() => {\n    setCurrentThread(activeThreadId);\n  }, [activeThreadId, setCurrentThread]);\n\n  return null;\n}\n\n// ─── Main Provider ────────────────────────────────────────────────────\n\nexport function AthenaProvider({\n  children,\n  config,\n  apiKey,\n  token: tokenProp,\n  agent,\n  channel,\n  model,\n  tools = [],\n  frontendTools = {},\n  disableAutoOpen = false,\n  apiUrl,\n  backendUrl,\n  appUrl,\n  environment,\n  statewireSyncUrl,\n  getToken,\n  extraRunConfig,\n  workbench,\n  knowledgeBase,\n  systemPrompt,\n  appId,\n  threadId: threadIdProp,\n  enableThreadList = false,\n  theme,\n  linkClicks,\n  citationLinks,\n  posthog: posthogProp,\n  debug,\n  onDiagnostic,\n  onError,\n}: AthenaProviderProps) {\n  // Fail loud before any effect, bridge wait, or network call: an `agent`\n  // outside the collab_agent namespace can never apply, so a misconfigured\n  // deployment must die at first render rather than answer as the wrong agent.\n  resolveAgentProp({ agent });\n\n  // Diagnostics wiring first, so everything below is observable. Callbacks\n  // ride refs: a per-render closure must not re-register the consumer. Each\n  // provider registers its OWN consumer (additive, cleaned up on unmount), so\n  // two mounted providers never clobber each other's onDiagnostic/onError —\n  // only the console/PostHog/buffer settings are global (last writer wins).\n  const onDiagnosticRef = useRef(onDiagnostic);\n  onDiagnosticRef.current = onDiagnostic;\n  const onErrorRef = useRef(onError);\n  onErrorRef.current = onError;\n  useEffect(() => {\n    installAthenaDiagnosticsGlobal();\n    return athenaDiagnostics.addConsumer({\n      onEvent: (event) => onDiagnosticRef.current?.(event),\n      onError: (error, event) => onErrorRef.current?.(error, event),\n    });\n  }, []);\n  const debugKey = JSON.stringify(debugPropToDiagnosticsConfig(debug));\n  useEffect(() => {\n    athenaDiagnostics.configure(debugPropToDiagnosticsConfig(debug));\n    // debugKey is the value-stable form of `debug` (consumers pass literals).\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [debugKey]);\n  const frontendToolNames = useMemo(() => Object.keys(frontendTools), [frontendTools]);\n  // Merge SDK auto-open defaults under the consumer's frontendTools. Consumer\n  // entries win on name collision; auto-open tool names are NOT added to\n  // frontendToolIds (they are already backend-advertised by their toolkits).\n  const effectiveFrontendTools = useMemo<Toolkit>(\n    () => (disableAutoOpen ? frontendTools : { ...DEFAULT_AUTO_OPEN_TOOLS, ...frontendTools }),\n    [disableAutoOpen, frontendTools],\n  );\n  const themeStyleVars = useMemo(() => theme ? themeToStyleVars(theme) : undefined, [theme]);\n  const configuredEnvironment = config?.environment ?? environment;\n  const environmentUrls = useMemo(\n    () => getAthenaEnvironmentUrls({ environment: configuredEnvironment }),\n    [configuredEnvironment],\n  );\n  const configuredApiKey = config?.apiKey ?? apiKey;\n  const configuredToken = resolveTokenOverride({ config, token: tokenProp });\n  const configuredApiUrl = config?.apiUrl ?? apiUrl;\n  const configuredBackendUrl = config?.backendUrl ?? backendUrl;\n  const configuredAppUrl = config?.appUrl ?? appUrl;\n  const configuredStatewireSyncUrl = config?.statewireSyncUrl ?? statewireSyncUrl;\n  const configuredGetToken = config?.getToken ?? getToken;\n  const configuredExtraRunConfig = config?.extraRunConfig ?? extraRunConfig;\n  const configuredTrustedParentOrigins = config?.trustedParentOrigins;\n  const posthogConfig: PostHogConfig | undefined = config?.posthog ?? posthogProp;\n\n  // Statewire is the SDK's only chat transport; the gauge/event stay on the\n  // diagnostics contract so dashboards keyed on them keep reading a value.\n  useEffect(() => {\n    athenaDiagnostics.gauge('sdk.transport', 'statewire');\n    athenaDiagnostics.emit('sdk.transport', {\n      level: 'debug',\n      data: { transport: 'statewire', thread_list: enableThreadList },\n    });\n  }, [enableThreadList]);\n\n  const bridge = useParentBridge({\n    trustedOrigins: configuredTrustedParentOrigins,\n  });\n\n  // If an AthenaAuthProvider is present above us, use its access token automatically.\n  const authContext = useContext(AthenaAuthContext);\n  const authProviderToken = authContext?.accessToken ?? null;\n\n  // Per-provider snapshot cache: a switch back to a recently-visited thread\n  // mounts with its last-known snapshot instead of a loading spinner. Owned\n  // here, above the per-thread keyed mount, so it survives switches; cleared\n  // when the acting identity changes so a snapshot captured under one account\n  // never seeds a mount under another.\n  const [snapshotCache] = useState(() => createDeepAgentThreadSnapshotCache());\n  // The windowed wire's fetched-back tool outputs, owned alongside the cache\n  // for the same reasons: shared across the provider's thread switches (a\n  // tool message id is unique across threads), dropped with the identity.\n  const [toolOutputs] = useState(() => createDeepAgentToolOutputStore());\n  const principal = authContext?.user?.userId ?? '';\n  useEffect(() => {\n    snapshotCache.clear();\n    toolOutputs.clear();\n  }, [snapshotCache, toolOutputs, principal, configuredApiKey]);\n\n  const effectiveToken = configuredToken !== undefined\n    ? configuredToken\n    : authProviderToken ?? bridge.token;\n  // Explicit config wins. A Marathon host mints the statewire mount, the bare\n  // Agora base and the app origin outright (`/_athena/auth`, or a trusted\n  // parent's `athena-config`); the environment preset is the last resort, and\n  // the sync mount derives from the `apiUrl` host when no host minted one.\n  const effectiveApiUrl = configuredApiUrl ?? environmentUrls.apiUrl;\n  // Published as the bare Agora base: a historical `…/api/assistant-ui` value\n  // is trimmed here once rather than by each REST helper.\n  const effectiveBackendUrl = getAthenaApiBaseUrl(\n    configuredBackendUrl ?? bridge.backendBaseUrl ?? environmentUrls.backendUrl,\n  );\n  const hostStatewireSyncUrl = configuredStatewireSyncUrl ?? bridge.statewireSyncUrl ?? undefined;\n  const effectiveAppUrl = configuredAppUrl\n    ?? bridge.appUrl\n    ?? deriveAthenaAppUrl({ apiUrl: effectiveApiUrl, backendUrl: effectiveBackendUrl })\n    ?? environmentUrls.appUrl;\n\n  // Wait for the parent bridge to deliver config/auth before rendering.\n  // This prevents the thread list from fetching with wrong URLs or no token.\n  // Falls back after a short timeout (2s) if no bridge responds.\n  if (!bridge.ready) {\n    return null;\n  }\n\n  // Both throw on an unresolvable configuration instead of falling back to an\n  // Athena default — a custom deployment's credentials must never be sent to\n  // a host the consumer didn't configure. A host that answered the bridge\n  // without minting the statewire mount is that case: its token would\n  // otherwise ride the environment preset.\n  assertHostMintedStatewireMount({\n    hostAnswered: bridge.hostAnswered,\n    hostStatewireSyncUrl: bridge.statewireSyncUrl,\n    statewireSyncUrl: configuredStatewireSyncUrl,\n    apiUrl: configuredApiUrl,\n  });\n  const effectiveStatewireSyncUrl = resolveStatewireSyncUrl({\n    statewireSyncUrl: hostStatewireSyncUrl,\n    apiUrl: effectiveApiUrl,\n  });\n\n  const statewireProps = {\n    syncUrl: effectiveStatewireSyncUrl,\n    backendUrl: effectiveBackendUrl,\n    appUrl: effectiveAppUrl,\n    apiKey: configuredApiKey,\n    token: effectiveToken,\n    getToken: configuredGetToken,\n    model,\n    agent,\n    channel,\n    tools,\n    frontendToolIds: frontendToolNames,\n    frontendTools: effectiveFrontendTools,\n    workbench,\n    knowledgeBase,\n    systemPrompt,\n    appId,\n    extraRunConfig: configuredExtraRunConfig,\n    snapshotCache,\n    toolOutputs,\n    linkClicks,\n    citationLinks,\n  };\n\n  const inner: ReactNode = enableThreadList ? (\n    <AthenaStatewireWithThreadList {...statewireProps} initialThreadId={threadIdProp}>\n      {children}\n    </AthenaStatewireWithThreadList>\n  ) : (\n    <AthenaStatewireStandalone {...statewireProps} threadId={threadIdProp}>\n      {children}\n    </AthenaStatewireStandalone>\n  );\n\n  // The .athena-sdk wrapper (display: contents) anchors the SDK's design\n  // tokens and scoped preflight from styles.css, so the stylesheet works\n  // in hosts without their own Tailwind build. PostHog gracefully no-ops\n  // when its config is missing.\n  return (\n    <div\n      className={themeStyleVars ? \"athena-sdk athena-themed\" : \"athena-sdk\"}\n      style={themeStyleVars as React.CSSProperties | undefined}\n    >\n      <PostHogProvider config={posthogConfig}>\n        {inner}\n      </PostHogProvider>\n    </div>\n  );\n}\n"],"names":["_a"],"mappings":"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"}
+{"version":3,"file":"AthenaProvider.js","sources":["../../src/provider/AthenaProvider.tsx"],"sourcesContent":["import { AuiProvider } from '@assistant-ui/react';\nimport {\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useReducer,\n  useRef,\n  useState,\n  type ReactNode,\n} from 'react';\nimport type { Toolkit } from '@assistant-ui/react';\nimport {\n  createDeepAgentThreadSnapshotCache,\n  createDeepAgentToolOutputStore,\n  DeepAgentConnectionContext,\n  type DeepAgentThreadSnapshotCache,\n  type DeepAgentToolOutputStore,\n} from '@athenaintel/agent-runtime';\nimport {\n  assertHostMintedStatewireMount,\n  deriveAthenaAppUrl,\n  getAthenaEnvironmentUrls,\n  resolveStatewireSyncUrl,\n  type AthenaEnvironment,\n} from '../lib/athena-urls';\nimport { getAthenaApiBaseUrl } from '../collab/mint';\nimport { useParentBridge } from '../runtime/auth';\nimport { AthenaAuthContext } from '../auth/AthenaAuthContext';\nimport {\n  useAthenaStatewireRuntime,\n  useStatewireClientTools,\n} from '../runtime/useAthenaStatewireRuntime';\nimport {\n  athenaStatewireErrorNotice,\n  type AthenaStatewireLifecycleState,\n  initialStatewireLifecycle,\n  statewireLifecycleReducer,\n} from '../runtime/statewire-lifecycle';\nimport type { AthenaStatewireTokenGetter } from '../runtime/statewire-auth-headers';\nimport { resolveAgentProp } from '../runtime/statewire-run-config';\nimport { mintThreadId } from '../threads/mint-thread-id';\nimport { AthenaStatewireLifecycleContext } from './statewire-lifecycle-context';\nimport { StatewireToolOutputsContext } from './statewire-window-context';\nimport { StatewireClientToolBridge } from '../chat/StatewireClientToolBridge';\nimport {\n  athenaDiagnostics,\n  debugPropToDiagnosticsConfig,\n  installAthenaDiagnosticsGlobal,\n  type AthenaDiagnosticEvent,\n  type AthenaDiagnosticLevel,\n  type AthenaDiagnosticsConfig,\n} from '../diagnostics/athena-diagnostics';\nimport type { AthenaSdkError } from '../diagnostics/errors';\nimport { TooltipProvider } from '../ui/tooltip';\nimport { DEFAULT_AUTO_OPEN_TOOLS } from '../tools/auto-open-tools';\nimport { AthenaContext, type AthenaConfig } from './AthenaContext';\nimport type { AthenaProviderConfig } from './config';\nimport type {\n  AthenaCitationLinkOptions,\n  AthenaLinkClickOptions,\n} from './citation-links';\nimport {\n  AthenaStatewireThreadIdContext,\n  AthenaThreadIdContext,\n} from '../threads/thread-id-context';\nimport {\n  AthenaStatewireThreadListProvider,\n  StatewireThreadTitlePoller,\n  useAthenaStatewireThreadList,\n} from '../threads/statewire-thread-list';\nimport { useAssetPanelStore } from '../assets/asset-panel-store';\nimport { themeToStyleVars, type AthenaTheme } from '../theme';\nimport { PostHogProvider, type PostHogConfig } from './PostHogProvider';\n\nexport interface AthenaProviderProps {\n  children: ReactNode;\n\n  /** Preferred structured config for auth and Athena endpoint settings. */\n  config?: AthenaProviderConfig;\n\n  /** @deprecated Prefer `config.apiKey`. API key for authentication in standalone mode. */\n  apiKey?: string;\n\n  /** @deprecated Prefer `config.token`. PropelAuth token. If provided, takes priority over apiKey. If omitted, the SDK\n   *  will automatically listen for a token from the parent window via PostMessage. */\n  token?: string | null;\n\n  /** Run the thread AS a published collab agent. The only accepted shape is\n   *  `collab_agent:<asset_id>`: the thread then uses that agent's prompt,\n   *  tools, and model default, and the caller must have view access to the\n   *  agent asset. Omit it (or pass a blank string) to run the Athena deep agent.\n   *\n   *  Any other non-blank value throws at render — the statewire host cannot\n   *  honour named agents, and a selector that is silently dropped would let a\n   *  misconfigured deployment answer as the wrong agent. */\n  agent?: string;\n\n  /** Collab-agent channel id — a built-in channel (`email`, `sms`, …) or a\n   *  user-defined custom channel id from the agent's Channels tab. Selects\n   *  that channel's configuration overrides and stamps the session's origin.\n   *  Only meaningful together with a `collab_agent:<asset_id>` `agent`; sent\n   *  as `collab_channel_id`. An unknown or disabled channel rejects the run\n   *  with a structured, teaching error. */\n  channel?: string;\n\n  /** LLM model identifier. Defaults to the deep-agent default model\n   *  (`DEFAULT_STATEWIRE_MODEL`) — or, when a collab agent is selected, to\n   *  the model its author configured. */\n  model?: string;\n\n  /** Backend toolkit IDs to enable (e.g. 'document_toolkit', 'web_search_browse_toolkit'). */\n  tools?: string[];\n\n  /** Frontend tools that execute in the browser. The agent can invoke these.\n   *  Merged on top of the SDK's default auto-open tools; entries here take\n   *  precedence over defaults with the same name. Tools with a local\n   *  `execute` are declared to the backend as `client_tools` and run through\n   *  the statewire client-tool bridge. */\n  frontendTools?: Toolkit;\n\n  /** Disable the SDK's default auto-open behavior for created/touched assets. */\n  disableAutoOpen?: boolean;\n\n  /** @deprecated Prefer `config.apiUrl`. URL on the Iris host fronting the\n   *  deployment; its origin derives the statewire sync mount when\n   *  `statewireSyncUrl` is not set. */\n  apiUrl?: string;\n\n  /** @deprecated Prefer `config.backendUrl`. URL for the Athena backend API. */\n  backendUrl?: string;\n\n  /** @deprecated Prefer `config.appUrl`. URL for the Athena frontend app origin. */\n  appUrl?: string;\n\n  /** @deprecated Prefer `config.environment`. Athena environment preset used when URLs are not explicitly provided. */\n  environment?: AthenaEnvironment;\n\n  /** Resolve the latest auth token immediately before a request (for\n   *  expiring clients). Takes priority over `token` when it resolves.\n   *  Prefer `config.getToken` (see its `force` contract for refused\n   *  credentials). */\n  getToken?: AthenaStatewireTokenGetter;\n\n  /** Additional fields merged into runConfig.custom. Prefer\n   *  `config.extraRunConfig`. */\n  extraRunConfig?: Record<string, unknown>;\n\n  /** Statewire sync base URL override (the `…/v2/threads` mount). Defaults to\n   *  the mount a Marathon host mints, then the effective `apiUrl` host +\n   *  `/v2/threads`. Prefer `config.statewireSyncUrl`. */\n  statewireSyncUrl?: string;\n\n  /** Asset IDs to include in the workbench. */\n  workbench?: string[];\n\n  /** Knowledge base IDs for RAG context. */\n  knowledgeBase?: string[];\n\n  /** System prompt override. */\n  systemPrompt?: string;\n\n  /** Client app identifier for session filtering.\n   *  Sessions created with this ID can be filtered in the thread list.\n   *  E.g. \"olympus\", \"athena-app\", or a computer asset ID like \"asset_<uuid>\". */\n  appId?: string;\n\n  /** Thread ID override. Auto-generated if not provided. */\n  threadId?: string;\n\n  /** Enable thread list management (sidebar thread switching). */\n  enableThreadList?: boolean;\n\n  /** Theme configuration. Pass a preset from `themes` or a custom `AthenaTheme` object.\n   *  Injects CSS variables on a wrapper element — no CSS files needed.\n   *\n   *  @example\n   *  import { themes } from '@athenaintel/react';\n   *  <AthenaProvider theme={themes.dark}>\n   *\n   *  @example\n   *  <AthenaProvider theme={{ primary: '#8b5cf6', radius: '1rem' }}>\n   *\n   *  @example\n   *  <AthenaProvider theme={{ ...themes.dark, primary: '#22c55e' }}>\n   */\n  theme?: AthenaTheme;\n\n  /** Customize how rendered chat links behave. */\n  linkClicks?: AthenaLinkClickOptions;\n\n  /** @deprecated Prefer `linkClicks`. Customize how Athena citation links rendered in chat messages behave. */\n  citationLinks?: AthenaCitationLinkOptions;\n\n  /** PostHog analytics configuration. When omitted or keys are missing, PostHog is silently disabled.\n   *  Prefer `config.posthog` for structured configuration. */\n  posthog?: PostHogConfig;\n\n  /** SDK diagnostics.\n   *\n   *  - `true` / a level: echo structured `[AthenaSDK]` events to the console\n   *    at that level (`true` = 'debug').\n   *  - An object: full diagnostics config (console level, PostHog timing\n   *    forwarding, buffer size).\n   *\n   *  Independent of the prop, `localStorage.setItem('athena:debug','debug')`\n   *  (or `window.__ATHENA_SDK__.diagnostics.enableConsole()`) turns console\n   *  echo on at runtime without a rebuild. Errors log once even when off. */\n  debug?: boolean | AthenaDiagnosticLevel | Partial<AthenaDiagnosticsConfig>;\n\n  /** Receives every diagnostics event (timings, warnings, errors) — the hook\n   *  for shipping SDK telemetry to the host app's own pipeline. */\n  onDiagnostic?: (event: AthenaDiagnosticEvent) => void;\n\n  /** Receives every SDK error as a typed `AthenaSdkError` (stable `code`,\n   *  `hint`, structured server `detail`). Fires in addition to the UI's own\n   *  error handling, so integrations never fail silently. */\n  onError?: (error: AthenaSdkError, event: AthenaDiagnosticEvent) => void;\n}\n\nconst resolveTokenOverride = ({\n  config,\n  token,\n}: {\n  config?: AthenaProviderConfig;\n  token?: string | null;\n}): string | null | undefined => {\n  if (config?.token !== undefined) {\n    return config.token;\n  }\n  return token;\n};\n\nconst useAthenaConfigValue = ({\n  backendUrl,\n  appUrl,\n  apiKey,\n  token,\n  enabledToolkits,\n  linkClicks,\n  citationLinks,\n}: {\n  backendUrl: string;\n  appUrl: string;\n  apiKey?: string;\n  token?: string | null;\n  enabledToolkits: string[];\n  linkClicks?: AthenaLinkClickOptions;\n  citationLinks?: AthenaCitationLinkOptions;\n}): AthenaConfig => {\n  const linkClicksRef = useRef(linkClicks);\n  linkClicksRef.current = linkClicks;\n  const citationLinksRef = useRef(citationLinks);\n  citationLinksRef.current = citationLinks;\n  // Keep token in a ref so its value can update without invalidating the\n  // config object identity. PropelAuth rotates tokens on window focus —\n  // if token were a memo dep, every rotation would publish a new config\n  // object to context and force every consumer (e.g. AssetIframe) to\n  // re-render, causing asset panel flicker.\n  const tokenRef = useRef(token);\n  tokenRef.current = token;\n\n  return useMemo(\n    () => ({\n      backendUrl,\n      appUrl,\n      apiKey,\n      enabledToolkits,\n      get token() {\n        return tokenRef.current;\n      },\n      get linkClicks() {\n        return linkClicksRef.current;\n      },\n      get citationLinks() {\n        return citationLinksRef.current;\n      },\n    }),\n    [backendUrl, appUrl, apiKey, enabledToolkits],\n  );\n};\n\n// ─── Standalone Mode ──────────────────────────────────────────────────\n\nfunction AthenaStatewireStandalone({\n  children,\n  syncUrl,\n  backendUrl,\n  appUrl,\n  apiKey,\n  token,\n  getToken,\n  model,\n  agent,\n  channel,\n  tools,\n  frontendToolIds,\n  frontendTools,\n  workbench,\n  knowledgeBase,\n  systemPrompt,\n  appId,\n  extraRunConfig,\n  threadId: threadIdProp,\n  isNewChatOverride,\n  snapshotCache,\n  toolOutputs,\n  linkClicks,\n  citationLinks,\n}: {\n  children: ReactNode;\n  syncUrl: string;\n  backendUrl: string;\n  appUrl: string;\n  apiKey?: string;\n  token?: string | null;\n  getToken?: AthenaStatewireTokenGetter;\n  model?: string;\n  agent?: string;\n  channel?: string;\n  tools: string[];\n  frontendToolIds: string[];\n  frontendTools: Toolkit;\n  workbench?: string[];\n  knowledgeBase?: string[];\n  systemPrompt?: string;\n  appId?: string;\n  extraRunConfig?: Record<string, unknown>;\n  threadId?: string;\n  /** Overrides the \"new chat\" derivation (thread-list mode mints ids for\n   *  brand-new chats, which must still load as new). */\n  isNewChatOverride?: boolean;\n  /** The provider-owned snapshot cache (see `AthenaProvider`). */\n  snapshotCache: DeepAgentThreadSnapshotCache;\n  /** The provider-owned store of fetched-back cut tool outputs (see `AthenaProvider`). */\n  toolOutputs: DeepAgentToolOutputStore;\n  linkClicks?: AthenaLinkClickOptions;\n  citationLinks?: AthenaCitationLinkOptions;\n}) {\n  // Statewire attaches to `${syncUrl}/${threadId}`, so a thread ID must exist\n  // up front. An auto-generated ID is by definition a never-started local chat.\n  const generatedIdRef = useRef<string | null>(null);\n  if (generatedIdRef.current === null) {\n    generatedIdRef.current = mintThreadId();\n  }\n  const threadId = threadIdProp ?? generatedIdRef.current;\n\n  const [lifecycle, dispatchLifecycle] = useReducer(\n    statewireLifecycleReducer,\n    initialStatewireLifecycle,\n  );\n\n  const aui = useAthenaStatewireRuntime({\n    syncUrl,\n    threadId,\n    isNewChat: isNewChatOverride ?? !threadIdProp,\n    apiKey,\n    token,\n    getToken,\n    model,\n    agent,\n    channel,\n    tools,\n    frontendToolIds,\n    frontendToolkit: frontendTools,\n    workbench,\n    knowledgeBase,\n    systemPrompt,\n    appId,\n    extraRunConfig,\n    snapshotCache,\n    toolOutputs,\n    // The runtime already records every transport error on the diagnostics\n    // bus (with the channel-teardown split), so this layer only maps it to\n    // the banner notice.\n    onError: (error) => {\n      const notice = athenaStatewireErrorNotice(error);\n      if (notice) dispatchLifecycle({ type: 'error', error: notice });\n    },\n    onConnectionChange: (connection) => {\n      dispatchLifecycle({ type: 'connection', connection });\n    },\n    onRawConnectionChange: (connection) => {\n      dispatchLifecycle({ type: 'raw-connection', reconnect: connection.reconnect });\n    },\n  });\n\n  const clientTools = useStatewireClientTools(frontendTools);\n\n  const dismissError = useCallback(\n    () => dispatchLifecycle({ type: 'error', error: null }),\n    [],\n  );\n  const lifecycleValue = useMemo<AthenaStatewireLifecycleState>(\n    () => ({\n      connection: lifecycle.connection,\n      error: lifecycle.error,\n      reconnect: lifecycle.reconnect,\n      dismissError,\n    }),\n    [lifecycle, dismissError],\n  );\n\n  const athenaConfig = useAthenaConfigValue({\n    backendUrl,\n    appUrl,\n    apiKey,\n    token,\n    enabledToolkits: tools,\n    linkClicks,\n    citationLinks,\n  });\n\n  return (\n    <AuiProvider value={aui}>\n      <AthenaContext.Provider value={athenaConfig}>\n        <AthenaStatewireThreadIdContext.Provider value={threadId}>\n          <AthenaStatewireLifecycleContext.Provider value={lifecycleValue}>\n            <DeepAgentConnectionContext.Provider value={lifecycleValue.connection}>\n              <StatewireToolOutputsContext.Provider value={toolOutputs}>\n                <TooltipProvider>\n                  <StatewireClientToolBridge tools={clientTools} threadId={threadId} />\n                  {children}\n                </TooltipProvider>\n              </StatewireToolOutputsContext.Provider>\n            </DeepAgentConnectionContext.Provider>\n          </AthenaStatewireLifecycleContext.Provider>\n        </AthenaStatewireThreadIdContext.Provider>\n      </AthenaContext.Provider>\n    </AuiProvider>\n  );\n}\n\n// ─── Thread List Mode ─────────────────────────────────────────────────\n\nfunction AthenaStatewireWithThreadList({\n  children,\n  backendUrl,\n  syncUrl,\n  appId,\n  apiKey,\n  token,\n  getToken,\n  initialThreadId,\n  ...standaloneProps\n}: Omit<\n  Parameters<typeof AthenaStatewireStandalone>[0],\n  'threadId' | 'isNewChatOverride'\n> & {\n  initialThreadId?: string;\n}) {\n  return (\n    <AthenaStatewireThreadListProvider\n      backendUrl={backendUrl}\n      syncUrl={syncUrl}\n      apiKey={apiKey}\n      token={token}\n      getToken={getToken}\n      appId={appId}\n      initialThreadId={initialThreadId}\n    >\n      <AthenaStatewireActiveThreadHost\n        backendUrl={backendUrl}\n        syncUrl={syncUrl}\n        appId={appId}\n        apiKey={apiKey}\n        token={token}\n        getToken={getToken}\n        {...standaloneProps}\n      >\n        {children}\n      </AthenaStatewireActiveThreadHost>\n    </AthenaStatewireThreadListProvider>\n  );\n}\n\nfunction AthenaStatewireActiveThreadHost({\n  children,\n  ...standaloneProps\n}: Omit<\n  Parameters<typeof AthenaStatewireStandalone>[0],\n  'threadId' | 'isNewChatOverride'\n>) {\n  const list = useAthenaStatewireThreadList();\n  if (!list) return null;\n\n  // Keyed by thread id: a switch remounts the statewire session against the\n  // new `…/v2/threads/{id}` URL instead of importing history in place. The\n  // thread-id context is undefined for a never-started chat, so\n  // history-gated UI (e.g. the loading overlay) does not treat an\n  // intentionally-empty new chat as pending history.\n  return (\n    <AthenaThreadIdContext.Provider\n      value={list.isNewChat ? undefined : list.activeThreadId}\n    >\n      <AthenaStatewireStandalone\n        key={list.activeThreadId}\n        threadId={list.activeThreadId}\n        isNewChatOverride={list.isNewChat}\n        {...standaloneProps}\n      >\n        <StatewireThreadTitlePoller />\n        <AssetPanelThreadSync />\n        {children}\n      </AthenaStatewireStandalone>\n    </AthenaThreadIdContext.Provider>\n  );\n}\n\n/**\n * Syncs the active thread ID into the asset panel store so that open asset\n * tabs are scoped per-thread automatically.\n *\n * Scoped by the thread list's minted id from creation onward — NOT by\n * `useAthenaThreadManager().activeThreadId`, which is deliberately `null`\n * while a new chat is unpersisted (so URL sync never names it). The minted id\n * is the id the thread persists under, so tabs opened in a brand-new chat\n * stay put when the backend first lists it instead of being left behind in a\n * `null` scope the store never restores.\n */\nfunction AssetPanelThreadSync() {\n  const list = useAthenaStatewireThreadList();\n  const setCurrentThread = useAssetPanelStore((s) => s.setCurrentThread);\n  const activeThreadId = list?.activeThreadId ?? null;\n\n  useEffect(() => {\n    setCurrentThread(activeThreadId);\n  }, [activeThreadId, setCurrentThread]);\n\n  return null;\n}\n\n// ─── Main Provider ────────────────────────────────────────────────────\n\nexport function AthenaProvider({\n  children,\n  config,\n  apiKey,\n  token: tokenProp,\n  agent,\n  channel,\n  model,\n  tools = [],\n  frontendTools = {},\n  disableAutoOpen = false,\n  apiUrl,\n  backendUrl,\n  appUrl,\n  environment,\n  statewireSyncUrl,\n  getToken,\n  extraRunConfig,\n  workbench,\n  knowledgeBase,\n  systemPrompt,\n  appId,\n  threadId: threadIdProp,\n  enableThreadList = false,\n  theme,\n  linkClicks,\n  citationLinks,\n  posthog: posthogProp,\n  debug,\n  onDiagnostic,\n  onError,\n}: AthenaProviderProps) {\n  // Fail loud before any effect, bridge wait, or network call: an `agent`\n  // outside the collab_agent namespace can never apply, so a misconfigured\n  // deployment must die at first render rather than answer as the wrong agent.\n  resolveAgentProp({ agent });\n\n  // Diagnostics wiring first, so everything below is observable. Callbacks\n  // ride refs: a per-render closure must not re-register the consumer. Each\n  // provider registers its OWN consumer (additive, cleaned up on unmount), so\n  // two mounted providers never clobber each other's onDiagnostic/onError —\n  // only the console/PostHog/buffer settings are global (last writer wins).\n  const onDiagnosticRef = useRef(onDiagnostic);\n  onDiagnosticRef.current = onDiagnostic;\n  const onErrorRef = useRef(onError);\n  onErrorRef.current = onError;\n  useEffect(() => {\n    installAthenaDiagnosticsGlobal();\n    return athenaDiagnostics.addConsumer({\n      onEvent: (event) => onDiagnosticRef.current?.(event),\n      onError: (error, event) => onErrorRef.current?.(error, event),\n    });\n  }, []);\n  const debugKey = JSON.stringify(debugPropToDiagnosticsConfig(debug));\n  useEffect(() => {\n    athenaDiagnostics.configure(debugPropToDiagnosticsConfig(debug));\n    // debugKey is the value-stable form of `debug` (consumers pass literals).\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [debugKey]);\n  const frontendToolNames = useMemo(() => Object.keys(frontendTools), [frontendTools]);\n  // Merge SDK auto-open defaults under the consumer's frontendTools. Consumer\n  // entries win on name collision; auto-open tool names are NOT added to\n  // frontendToolIds (they are already backend-advertised by their toolkits).\n  const effectiveFrontendTools = useMemo<Toolkit>(\n    () => (disableAutoOpen ? frontendTools : { ...DEFAULT_AUTO_OPEN_TOOLS, ...frontendTools }),\n    [disableAutoOpen, frontendTools],\n  );\n  const themeStyleVars = useMemo(() => theme ? themeToStyleVars(theme) : undefined, [theme]);\n  const configuredEnvironment = config?.environment ?? environment;\n  const environmentUrls = useMemo(\n    () => getAthenaEnvironmentUrls({ environment: configuredEnvironment }),\n    [configuredEnvironment],\n  );\n  const configuredApiKey = config?.apiKey ?? apiKey;\n  const configuredToken = resolveTokenOverride({ config, token: tokenProp });\n  const configuredApiUrl = config?.apiUrl ?? apiUrl;\n  const configuredBackendUrl = config?.backendUrl ?? backendUrl;\n  const configuredAppUrl = config?.appUrl ?? appUrl;\n  const configuredStatewireSyncUrl = config?.statewireSyncUrl ?? statewireSyncUrl;\n  const configuredGetToken = config?.getToken ?? getToken;\n  const configuredExtraRunConfig = config?.extraRunConfig ?? extraRunConfig;\n  const configuredTrustedParentOrigins = config?.trustedParentOrigins;\n  const posthogConfig: PostHogConfig | undefined = config?.posthog ?? posthogProp;\n\n  // Statewire is the SDK's only chat transport; the gauge/event stay on the\n  // diagnostics contract so dashboards keyed on them keep reading a value.\n  useEffect(() => {\n    athenaDiagnostics.gauge('sdk.transport', 'statewire');\n    athenaDiagnostics.emit('sdk.transport', {\n      level: 'debug',\n      data: { transport: 'statewire', thread_list: enableThreadList },\n    });\n  }, [enableThreadList]);\n\n  const bridge = useParentBridge({\n    trustedOrigins: configuredTrustedParentOrigins,\n  });\n\n  // If an AthenaAuthProvider is present above us, use its access token automatically.\n  const authContext = useContext(AthenaAuthContext);\n  const authProviderToken = authContext?.accessToken ?? null;\n\n  // Per-provider snapshot cache: a switch back to a recently-visited thread\n  // mounts with its last-known snapshot instead of a loading spinner. Owned\n  // here, above the per-thread keyed mount, so it survives switches; cleared\n  // when the acting identity changes so a snapshot captured under one account\n  // never seeds a mount under another.\n  const [snapshotCache] = useState(() => createDeepAgentThreadSnapshotCache());\n  // The windowed wire's fetched-back tool outputs, owned alongside the cache\n  // for the same reasons: shared across the provider's thread switches (a\n  // tool message id is unique across threads), dropped with the identity.\n  const [toolOutputs] = useState(() => createDeepAgentToolOutputStore());\n  const principal = authContext?.user?.userId ?? '';\n  useEffect(() => {\n    snapshotCache.clear();\n    toolOutputs.clear();\n  }, [snapshotCache, toolOutputs, principal, configuredApiKey]);\n\n  const effectiveToken = configuredToken !== undefined\n    ? configuredToken\n    : authProviderToken ?? bridge.token;\n  // Explicit config wins. A Marathon host mints the statewire mount, the bare\n  // Agora base and the app origin outright (`/_athena/auth`, or a trusted\n  // parent's `athena-config`); the environment preset is the last resort, and\n  // the sync mount derives from the `apiUrl` host when no host minted one.\n  const effectiveApiUrl = configuredApiUrl ?? environmentUrls.apiUrl;\n  // Published as the bare Agora base: a historical `…/api/assistant-ui` value\n  // is trimmed here once rather than by each REST helper.\n  const effectiveBackendUrl = getAthenaApiBaseUrl(\n    configuredBackendUrl ?? bridge.backendBaseUrl ?? environmentUrls.backendUrl,\n  );\n  const hostStatewireSyncUrl = configuredStatewireSyncUrl ?? bridge.statewireSyncUrl ?? undefined;\n  const effectiveAppUrl = configuredAppUrl\n    ?? bridge.appUrl\n    ?? deriveAthenaAppUrl({ apiUrl: effectiveApiUrl, backendUrl: effectiveBackendUrl })\n    ?? environmentUrls.appUrl;\n\n  // Wait for the parent bridge to deliver config/auth before rendering.\n  // This prevents the thread list from fetching with wrong URLs or no token.\n  // Falls back after a short timeout (2s) if no bridge responds.\n  if (!bridge.ready) {\n    return null;\n  }\n\n  // Both throw on an unresolvable configuration instead of falling back to an\n  // Athena default — a custom deployment's credentials must never be sent to\n  // a host the consumer didn't configure. A host that answered the bridge\n  // without minting the statewire mount is that case: its token would\n  // otherwise ride the environment preset.\n  assertHostMintedStatewireMount({\n    hostAnswered: bridge.hostAnswered,\n    hostStatewireSyncUrl: bridge.statewireSyncUrl,\n    statewireSyncUrl: configuredStatewireSyncUrl,\n    apiUrl: configuredApiUrl,\n  });\n  const effectiveStatewireSyncUrl = resolveStatewireSyncUrl({\n    statewireSyncUrl: hostStatewireSyncUrl,\n    apiUrl: effectiveApiUrl,\n  });\n\n  const statewireProps = {\n    syncUrl: effectiveStatewireSyncUrl,\n    backendUrl: effectiveBackendUrl,\n    appUrl: effectiveAppUrl,\n    apiKey: configuredApiKey,\n    token: effectiveToken,\n    getToken: configuredGetToken,\n    model,\n    agent,\n    channel,\n    tools,\n    frontendToolIds: frontendToolNames,\n    frontendTools: effectiveFrontendTools,\n    workbench,\n    knowledgeBase,\n    systemPrompt,\n    appId,\n    extraRunConfig: configuredExtraRunConfig,\n    snapshotCache,\n    toolOutputs,\n    linkClicks,\n    citationLinks,\n  };\n\n  const inner: ReactNode = enableThreadList ? (\n    <AthenaStatewireWithThreadList {...statewireProps} initialThreadId={threadIdProp}>\n      {children}\n    </AthenaStatewireWithThreadList>\n  ) : (\n    <AthenaStatewireStandalone {...statewireProps} threadId={threadIdProp}>\n      {children}\n    </AthenaStatewireStandalone>\n  );\n\n  // The .athena-sdk wrapper (display: contents) anchors the SDK's design\n  // tokens and scoped preflight from styles.css, so the stylesheet works\n  // in hosts without their own Tailwind build. PostHog gracefully no-ops\n  // when its config is missing.\n  return (\n    <div\n      className={themeStyleVars ? \"athena-sdk athena-themed\" : \"athena-sdk\"}\n      style={themeStyleVars as React.CSSProperties | undefined}\n    >\n      <PostHogProvider config={posthogConfig}>\n        {inner}\n      </PostHogProvider>\n    </div>\n  );\n}\n"],"names":["_a"],"mappings":"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"}

package/dist/runtime/statewire-lifecycle.cjs

@@ -11,10 +11,11 @@ require("../packages/agent-runtime/src/statewire-state.cjs");
 require("../packages/agent-runtime/src/messages.cjs");
 require("@assistant-ui/react-statewire");
 require("@assistant-ui/store");
-require("@assistant-ui/react-statewire/local-storage");
+require("../packages/agent-runtime/src/quota-safe-local-storage-session.cjs");
 require("../packages/agent-runtime/src/statewire-attach-observer.cjs");
 require("../packages/agent-runtime/src/thread-status.cjs");
 require("@assistant-ui/core");
+require("../packages/agent-runtime/src/thread-handoff.cjs");
 function athenaStatewireErrorNotice(error) {
   if (errors.isStatewireChannelTeardown(error)) return null;
   const rejection = errors.statewireRejectionPayload(error);

package/dist/runtime/statewire-lifecycle.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"statewire-lifecycle.cjs","sources":["../../src/runtime/statewire-lifecycle.ts"],"sourcesContent":["import {\n  isLegacyThreadReadOnlyRejection,\n  isStatewireChannelTeardown,\n  statewireRejectionDetailMessage,\n  statewireRejectionPayload,\n} from '@athenaintel/agent-runtime';\nimport type { DeepAgentConnectionState } from '@athenaintel/agent-runtime';\n\n/** A user-visible notice mapped from a statewire transport error. */\nexport interface AthenaStatewireErrorNotice {\n  kind: 'paywall' | 'read-only' | 'command';\n  title: string;\n  message: string;\n}\n\n/**\n * Map the statewire failure envelope to a concise, actionable notice.\n * Returns null for expected channel teardowns (thread switch, unmount),\n * which must not surface as errors.\n */\nexport function athenaStatewireErrorNotice(\n  error: unknown,\n): AthenaStatewireErrorNotice | null {\n  if (isStatewireChannelTeardown(error)) return null;\n  const rejection = statewireRejectionPayload(error);\n  // The server's own detail names the actionable reason; the Error message is\n  // generic client-side text like `command rejected (500)`.\n  const detail = statewireRejectionDetailMessage(error);\n\n  if (rejection?.status === 402) {\n    return {\n      kind: 'paywall',\n      title: 'Usage limit reached',\n      message:\n        detail ?? 'Athena could not start this run. Review usage or billing to continue.',\n    };\n  }\n\n  // Legacy-thread dispatch fence: an out-of-band run is writing this\n  // pre-cutover thread (or its adoption failed). A per-send failure, not a\n  // standing state — the server's detail names the actionable reason (wait\n  // for the run vs. start a new chat).\n  if (isLegacyThreadReadOnlyRejection(error)) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message:\n        detail ??\n        'This conversation cannot take new messages right now. Try again shortly, or start a new chat.',\n    };\n  }\n\n  return {\n    kind: 'command',\n    title: 'Message was not sent',\n    message:\n      detail ??\n      (error instanceof Error && error.message.length > 0\n        ? error.message\n        : 'The chat runtime rejected the command. Please try again.'),\n  };\n}\n\n/** Shared lifecycle state for the statewire transport, provided by\n *  `AthenaProvider` in statewire mode and read by the chat banners. */\nexport interface AthenaStatewireLifecycleState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n  dismissError: () => void;\n}\n\n/** The provider's reducer state behind {@link AthenaStatewireLifecycleState}. */\nexport interface StatewireLifecycleReducerState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n}\n\nexport type StatewireLifecycleAction =\n  | { type: 'connection'; connection: DeepAgentConnectionState | null }\n  | { type: 'error'; error: AthenaStatewireErrorNotice | null }\n  | { type: 'raw-connection'; reconnect: () => void };\n\nexport const initialStatewireLifecycle: StatewireLifecycleReducerState = {\n  connection: null,\n  error: null,\n  reconnect: null,\n};\n\n/**\n * Folds the runtime's lifecycle observations into the banner state. A healthy\n * channel — connected, or disconnected only because the instance is quiet\n * (`idle`) or the chat has not sent yet (`deferred`) — clears a stale\n * send/transport error: leaving it up tells the user the chat is broken after\n * it has come back.\n */\nexport function statewireLifecycleReducer(\n  state: StatewireLifecycleReducerState,\n  action: StatewireLifecycleAction,\n): StatewireLifecycleReducerState {\n  switch (action.type) {\n    case 'connection': {\n      const healthy =\n        action.connection?.status === 'connected' ||\n        action.connection?.status === 'standby';\n      return {\n        ...state,\n        connection: action.connection,\n        error: healthy ? null : state.error,\n      };\n    }\n    case 'error':\n      return { ...state, error: action.error };\n    case 'raw-connection':\n      return { ...state, reconnect: action.reconnect };\n  }\n}\n"],"names":["isStatewireChannelTeardown","statewireRejectionPayload","statewireRejectionDetailMessage","isLegacyThreadReadOnlyRejection"],"mappings":";;;;;;;;;;;;;;;;;AAoBO,SAAS,2BACd,OACmC;AACnC,MAAIA,OAAAA,2BAA2B,KAAK,EAAG,QAAO;AAC9C,QAAM,YAAYC,OAAAA,0BAA0B,KAAK;AAGjD,QAAM,SAASC,OAAAA,gCAAgC,KAAK;AAEpD,OAAI,uCAAW,YAAW,KAAK;AAC7B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UAAU;AAAA,IAAA;AAAA,EAEhB;AAMA,MAAIC,OAAAA,gCAAgC,KAAK,GAAG;AAC1C,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UACA;AAAA,IAAA;AAAA,EAEN;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SACE,WACC,iBAAiB,SAAS,MAAM,QAAQ,SAAS,IAC9C,MAAM,UACN;AAAA,EAAA;AAEV;AAuBO,MAAM,4BAA4D;AAAA,EACvE,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,WAAW;AACb;AASO,SAAS,0BACd,OACA,QACgC;;AAChC,UAAQ,OAAO,MAAA;AAAA,IACb,KAAK,cAAc;AACjB,YAAM,YACJ,YAAO,eAAP,mBAAmB,YAAW,iBAC9B,YAAO,eAAP,mBAAmB,YAAW;AAChC,aAAO;AAAA,QACL,GAAG;AAAA,QACH,YAAY,OAAO;AAAA,QACnB,OAAO,UAAU,OAAO,MAAM;AAAA,MAAA;AAAA,IAElC;AAAA,IACA,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,OAAO,OAAO,MAAA;AAAA,IACnC,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,WAAW,OAAO,UAAA;AAAA,EAAU;AAErD;;;;"}
+{"version":3,"file":"statewire-lifecycle.cjs","sources":["../../src/runtime/statewire-lifecycle.ts"],"sourcesContent":["import {\n  isLegacyThreadReadOnlyRejection,\n  isStatewireChannelTeardown,\n  statewireRejectionDetailMessage,\n  statewireRejectionPayload,\n} from '@athenaintel/agent-runtime';\nimport type { DeepAgentConnectionState } from '@athenaintel/agent-runtime';\n\n/** A user-visible notice mapped from a statewire transport error. */\nexport interface AthenaStatewireErrorNotice {\n  kind: 'paywall' | 'read-only' | 'command';\n  title: string;\n  message: string;\n}\n\n/**\n * Map the statewire failure envelope to a concise, actionable notice.\n * Returns null for expected channel teardowns (thread switch, unmount),\n * which must not surface as errors.\n */\nexport function athenaStatewireErrorNotice(\n  error: unknown,\n): AthenaStatewireErrorNotice | null {\n  if (isStatewireChannelTeardown(error)) return null;\n  const rejection = statewireRejectionPayload(error);\n  // The server's own detail names the actionable reason; the Error message is\n  // generic client-side text like `command rejected (500)`.\n  const detail = statewireRejectionDetailMessage(error);\n\n  if (rejection?.status === 402) {\n    return {\n      kind: 'paywall',\n      title: 'Usage limit reached',\n      message:\n        detail ?? 'Athena could not start this run. Review usage or billing to continue.',\n    };\n  }\n\n  // Legacy-thread dispatch fence: an out-of-band run is writing this\n  // pre-cutover thread (or its adoption failed). A per-send failure, not a\n  // standing state — the server's detail names the actionable reason (wait\n  // for the run vs. start a new chat).\n  if (isLegacyThreadReadOnlyRejection(error)) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message:\n        detail ??\n        'This conversation cannot take new messages right now. Try again shortly, or start a new chat.',\n    };\n  }\n\n  return {\n    kind: 'command',\n    title: 'Message was not sent',\n    message:\n      detail ??\n      (error instanceof Error && error.message.length > 0\n        ? error.message\n        : 'The chat runtime rejected the command. Please try again.'),\n  };\n}\n\n/** Shared lifecycle state for the statewire transport, provided by\n *  `AthenaProvider` in statewire mode and read by the chat banners. */\nexport interface AthenaStatewireLifecycleState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n  dismissError: () => void;\n}\n\n/** The provider's reducer state behind {@link AthenaStatewireLifecycleState}. */\nexport interface StatewireLifecycleReducerState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n}\n\nexport type StatewireLifecycleAction =\n  | { type: 'connection'; connection: DeepAgentConnectionState | null }\n  | { type: 'error'; error: AthenaStatewireErrorNotice | null }\n  | { type: 'raw-connection'; reconnect: () => void };\n\nexport const initialStatewireLifecycle: StatewireLifecycleReducerState = {\n  connection: null,\n  error: null,\n  reconnect: null,\n};\n\n/**\n * Folds the runtime's lifecycle observations into the banner state. A healthy\n * channel — connected, or disconnected only because the instance is quiet\n * (`idle`) or the chat has not sent yet (`deferred`) — clears a stale\n * send/transport error: leaving it up tells the user the chat is broken after\n * it has come back.\n */\nexport function statewireLifecycleReducer(\n  state: StatewireLifecycleReducerState,\n  action: StatewireLifecycleAction,\n): StatewireLifecycleReducerState {\n  switch (action.type) {\n    case 'connection': {\n      const healthy =\n        action.connection?.status === 'connected' ||\n        action.connection?.status === 'standby';\n      return {\n        ...state,\n        connection: action.connection,\n        error: healthy ? null : state.error,\n      };\n    }\n    case 'error':\n      return { ...state, error: action.error };\n    case 'raw-connection':\n      return { ...state, reconnect: action.reconnect };\n  }\n}\n"],"names":["isStatewireChannelTeardown","statewireRejectionPayload","statewireRejectionDetailMessage","isLegacyThreadReadOnlyRejection"],"mappings":";;;;;;;;;;;;;;;;;;AAoBO,SAAS,2BACd,OACmC;AACnC,MAAIA,OAAAA,2BAA2B,KAAK,EAAG,QAAO;AAC9C,QAAM,YAAYC,OAAAA,0BAA0B,KAAK;AAGjD,QAAM,SAASC,OAAAA,gCAAgC,KAAK;AAEpD,OAAI,uCAAW,YAAW,KAAK;AAC7B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UAAU;AAAA,IAAA;AAAA,EAEhB;AAMA,MAAIC,OAAAA,gCAAgC,KAAK,GAAG;AAC1C,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UACA;AAAA,IAAA;AAAA,EAEN;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SACE,WACC,iBAAiB,SAAS,MAAM,QAAQ,SAAS,IAC9C,MAAM,UACN;AAAA,EAAA;AAEV;AAuBO,MAAM,4BAA4D;AAAA,EACvE,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,WAAW;AACb;AASO,SAAS,0BACd,OACA,QACgC;;AAChC,UAAQ,OAAO,MAAA;AAAA,IACb,KAAK,cAAc;AACjB,YAAM,YACJ,YAAO,eAAP,mBAAmB,YAAW,iBAC9B,YAAO,eAAP,mBAAmB,YAAW;AAChC,aAAO;AAAA,QACL,GAAG;AAAA,QACH,YAAY,OAAO;AAAA,QACnB,OAAO,UAAU,OAAO,MAAM;AAAA,MAAA;AAAA,IAElC;AAAA,IACA,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,OAAO,OAAO,MAAA;AAAA,IACnC,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,WAAW,OAAO,UAAA;AAAA,EAAU;AAErD;;;;"}

package/dist/runtime/statewire-lifecycle.js

@@ -9,10 +9,11 @@ import "../packages/agent-runtime/src/statewire-state.js";
 import "../packages/agent-runtime/src/messages.js";
 import "@assistant-ui/react-statewire";
 import "@assistant-ui/store";
-import "@assistant-ui/react-statewire/local-storage";
+import "../packages/agent-runtime/src/quota-safe-local-storage-session.js";
 import "../packages/agent-runtime/src/statewire-attach-observer.js";
 import "../packages/agent-runtime/src/thread-status.js";
 import "@assistant-ui/core";
+import "../packages/agent-runtime/src/thread-handoff.js";
 function athenaStatewireErrorNotice(error) {
   if (isStatewireChannelTeardown(error)) return null;
   const rejection = statewireRejectionPayload(error);

package/dist/runtime/statewire-lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"statewire-lifecycle.js","sources":["../../src/runtime/statewire-lifecycle.ts"],"sourcesContent":["import {\n  isLegacyThreadReadOnlyRejection,\n  isStatewireChannelTeardown,\n  statewireRejectionDetailMessage,\n  statewireRejectionPayload,\n} from '@athenaintel/agent-runtime';\nimport type { DeepAgentConnectionState } from '@athenaintel/agent-runtime';\n\n/** A user-visible notice mapped from a statewire transport error. */\nexport interface AthenaStatewireErrorNotice {\n  kind: 'paywall' | 'read-only' | 'command';\n  title: string;\n  message: string;\n}\n\n/**\n * Map the statewire failure envelope to a concise, actionable notice.\n * Returns null for expected channel teardowns (thread switch, unmount),\n * which must not surface as errors.\n */\nexport function athenaStatewireErrorNotice(\n  error: unknown,\n): AthenaStatewireErrorNotice | null {\n  if (isStatewireChannelTeardown(error)) return null;\n  const rejection = statewireRejectionPayload(error);\n  // The server's own detail names the actionable reason; the Error message is\n  // generic client-side text like `command rejected (500)`.\n  const detail = statewireRejectionDetailMessage(error);\n\n  if (rejection?.status === 402) {\n    return {\n      kind: 'paywall',\n      title: 'Usage limit reached',\n      message:\n        detail ?? 'Athena could not start this run. Review usage or billing to continue.',\n    };\n  }\n\n  // Legacy-thread dispatch fence: an out-of-band run is writing this\n  // pre-cutover thread (or its adoption failed). A per-send failure, not a\n  // standing state — the server's detail names the actionable reason (wait\n  // for the run vs. start a new chat).\n  if (isLegacyThreadReadOnlyRejection(error)) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message:\n        detail ??\n        'This conversation cannot take new messages right now. Try again shortly, or start a new chat.',\n    };\n  }\n\n  return {\n    kind: 'command',\n    title: 'Message was not sent',\n    message:\n      detail ??\n      (error instanceof Error && error.message.length > 0\n        ? error.message\n        : 'The chat runtime rejected the command. Please try again.'),\n  };\n}\n\n/** Shared lifecycle state for the statewire transport, provided by\n *  `AthenaProvider` in statewire mode and read by the chat banners. */\nexport interface AthenaStatewireLifecycleState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n  dismissError: () => void;\n}\n\n/** The provider's reducer state behind {@link AthenaStatewireLifecycleState}. */\nexport interface StatewireLifecycleReducerState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n}\n\nexport type StatewireLifecycleAction =\n  | { type: 'connection'; connection: DeepAgentConnectionState | null }\n  | { type: 'error'; error: AthenaStatewireErrorNotice | null }\n  | { type: 'raw-connection'; reconnect: () => void };\n\nexport const initialStatewireLifecycle: StatewireLifecycleReducerState = {\n  connection: null,\n  error: null,\n  reconnect: null,\n};\n\n/**\n * Folds the runtime's lifecycle observations into the banner state. A healthy\n * channel — connected, or disconnected only because the instance is quiet\n * (`idle`) or the chat has not sent yet (`deferred`) — clears a stale\n * send/transport error: leaving it up tells the user the chat is broken after\n * it has come back.\n */\nexport function statewireLifecycleReducer(\n  state: StatewireLifecycleReducerState,\n  action: StatewireLifecycleAction,\n): StatewireLifecycleReducerState {\n  switch (action.type) {\n    case 'connection': {\n      const healthy =\n        action.connection?.status === 'connected' ||\n        action.connection?.status === 'standby';\n      return {\n        ...state,\n        connection: action.connection,\n        error: healthy ? null : state.error,\n      };\n    }\n    case 'error':\n      return { ...state, error: action.error };\n    case 'raw-connection':\n      return { ...state, reconnect: action.reconnect };\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;AAoBO,SAAS,2BACd,OACmC;AACnC,MAAI,2BAA2B,KAAK,EAAG,QAAO;AAC9C,QAAM,YAAY,0BAA0B,KAAK;AAGjD,QAAM,SAAS,gCAAgC,KAAK;AAEpD,OAAI,uCAAW,YAAW,KAAK;AAC7B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UAAU;AAAA,IAAA;AAAA,EAEhB;AAMA,MAAI,gCAAgC,KAAK,GAAG;AAC1C,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UACA;AAAA,IAAA;AAAA,EAEN;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SACE,WACC,iBAAiB,SAAS,MAAM,QAAQ,SAAS,IAC9C,MAAM,UACN;AAAA,EAAA;AAEV;AAuBO,MAAM,4BAA4D;AAAA,EACvE,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,WAAW;AACb;AASO,SAAS,0BACd,OACA,QACgC;;AAChC,UAAQ,OAAO,MAAA;AAAA,IACb,KAAK,cAAc;AACjB,YAAM,YACJ,YAAO,eAAP,mBAAmB,YAAW,iBAC9B,YAAO,eAAP,mBAAmB,YAAW;AAChC,aAAO;AAAA,QACL,GAAG;AAAA,QACH,YAAY,OAAO;AAAA,QACnB,OAAO,UAAU,OAAO,MAAM;AAAA,MAAA;AAAA,IAElC;AAAA,IACA,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,OAAO,OAAO,MAAA;AAAA,IACnC,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,WAAW,OAAO,UAAA;AAAA,EAAU;AAErD;"}
+{"version":3,"file":"statewire-lifecycle.js","sources":["../../src/runtime/statewire-lifecycle.ts"],"sourcesContent":["import {\n  isLegacyThreadReadOnlyRejection,\n  isStatewireChannelTeardown,\n  statewireRejectionDetailMessage,\n  statewireRejectionPayload,\n} from '@athenaintel/agent-runtime';\nimport type { DeepAgentConnectionState } from '@athenaintel/agent-runtime';\n\n/** A user-visible notice mapped from a statewire transport error. */\nexport interface AthenaStatewireErrorNotice {\n  kind: 'paywall' | 'read-only' | 'command';\n  title: string;\n  message: string;\n}\n\n/**\n * Map the statewire failure envelope to a concise, actionable notice.\n * Returns null for expected channel teardowns (thread switch, unmount),\n * which must not surface as errors.\n */\nexport function athenaStatewireErrorNotice(\n  error: unknown,\n): AthenaStatewireErrorNotice | null {\n  if (isStatewireChannelTeardown(error)) return null;\n  const rejection = statewireRejectionPayload(error);\n  // The server's own detail names the actionable reason; the Error message is\n  // generic client-side text like `command rejected (500)`.\n  const detail = statewireRejectionDetailMessage(error);\n\n  if (rejection?.status === 402) {\n    return {\n      kind: 'paywall',\n      title: 'Usage limit reached',\n      message:\n        detail ?? 'Athena could not start this run. Review usage or billing to continue.',\n    };\n  }\n\n  // Legacy-thread dispatch fence: an out-of-band run is writing this\n  // pre-cutover thread (or its adoption failed). A per-send failure, not a\n  // standing state — the server's detail names the actionable reason (wait\n  // for the run vs. start a new chat).\n  if (isLegacyThreadReadOnlyRejection(error)) {\n    return {\n      kind: 'read-only',\n      title: 'Message was not sent',\n      message:\n        detail ??\n        'This conversation cannot take new messages right now. Try again shortly, or start a new chat.',\n    };\n  }\n\n  return {\n    kind: 'command',\n    title: 'Message was not sent',\n    message:\n      detail ??\n      (error instanceof Error && error.message.length > 0\n        ? error.message\n        : 'The chat runtime rejected the command. Please try again.'),\n  };\n}\n\n/** Shared lifecycle state for the statewire transport, provided by\n *  `AthenaProvider` in statewire mode and read by the chat banners. */\nexport interface AthenaStatewireLifecycleState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n  dismissError: () => void;\n}\n\n/** The provider's reducer state behind {@link AthenaStatewireLifecycleState}. */\nexport interface StatewireLifecycleReducerState {\n  connection: DeepAgentConnectionState | null;\n  error: AthenaStatewireErrorNotice | null;\n  reconnect: (() => void) | null;\n}\n\nexport type StatewireLifecycleAction =\n  | { type: 'connection'; connection: DeepAgentConnectionState | null }\n  | { type: 'error'; error: AthenaStatewireErrorNotice | null }\n  | { type: 'raw-connection'; reconnect: () => void };\n\nexport const initialStatewireLifecycle: StatewireLifecycleReducerState = {\n  connection: null,\n  error: null,\n  reconnect: null,\n};\n\n/**\n * Folds the runtime's lifecycle observations into the banner state. A healthy\n * channel — connected, or disconnected only because the instance is quiet\n * (`idle`) or the chat has not sent yet (`deferred`) — clears a stale\n * send/transport error: leaving it up tells the user the chat is broken after\n * it has come back.\n */\nexport function statewireLifecycleReducer(\n  state: StatewireLifecycleReducerState,\n  action: StatewireLifecycleAction,\n): StatewireLifecycleReducerState {\n  switch (action.type) {\n    case 'connection': {\n      const healthy =\n        action.connection?.status === 'connected' ||\n        action.connection?.status === 'standby';\n      return {\n        ...state,\n        connection: action.connection,\n        error: healthy ? null : state.error,\n      };\n    }\n    case 'error':\n      return { ...state, error: action.error };\n    case 'raw-connection':\n      return { ...state, reconnect: action.reconnect };\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAoBO,SAAS,2BACd,OACmC;AACnC,MAAI,2BAA2B,KAAK,EAAG,QAAO;AAC9C,QAAM,YAAY,0BAA0B,KAAK;AAGjD,QAAM,SAAS,gCAAgC,KAAK;AAEpD,OAAI,uCAAW,YAAW,KAAK;AAC7B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UAAU;AAAA,IAAA;AAAA,EAEhB;AAMA,MAAI,gCAAgC,KAAK,GAAG;AAC1C,WAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SACE,UACA;AAAA,IAAA;AAAA,EAEN;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO;AAAA,IACP,SACE,WACC,iBAAiB,SAAS,MAAM,QAAQ,SAAS,IAC9C,MAAM,UACN;AAAA,EAAA;AAEV;AAuBO,MAAM,4BAA4D;AAAA,EACvE,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,WAAW;AACb;AASO,SAAS,0BACd,OACA,QACgC;;AAChC,UAAQ,OAAO,MAAA;AAAA,IACb,KAAK,cAAc;AACjB,YAAM,YACJ,YAAO,eAAP,mBAAmB,YAAW,iBAC9B,YAAO,eAAP,mBAAmB,YAAW;AAChC,aAAO;AAAA,QACL,GAAG;AAAA,QACH,YAAY,OAAO;AAAA,QACnB,OAAO,UAAU,OAAO,MAAM;AAAA,MAAA;AAAA,IAElC;AAAA,IACA,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,OAAO,OAAO,MAAA;AAAA,IACnC,KAAK;AACH,aAAO,EAAE,GAAG,OAAO,WAAW,OAAO,UAAA;AAAA,EAAU;AAErD;"}

package/dist/runtime/useAthenaStatewireRuntime.cjs

@@ -12,11 +12,12 @@ require("../packages/agent-runtime/src/statewire-state.cjs");
 require("../packages/agent-runtime/src/messages.cjs");
 require("@assistant-ui/react-statewire");
 require("@assistant-ui/store");
-require("@assistant-ui/react-statewire/local-storage");
+require("../packages/agent-runtime/src/quota-safe-local-storage-session.cjs");
 require("../packages/agent-runtime/src/statewire-attach-observer.cjs");
 require("../packages/agent-runtime/src/thread-status.cjs");
 const useDeepAgentRuntime = require("../packages/agent-runtime/src/use-deep-agent-runtime.cjs");
 require("@assistant-ui/core");
+require("../packages/agent-runtime/src/thread-handoff.cjs");
 const AthenaAuthContext = require("../auth/AthenaAuthContext.cjs");
 const statewireClientTools = require("../chat/statewire-client-tools.cjs");
 const athenaDiagnostics = require("../diagnostics/athena-diagnostics.cjs");

package/dist/runtime/useAthenaStatewireRuntime.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"useAthenaStatewireRuntime.cjs","sources":["../../src/runtime/useAthenaStatewireRuntime.ts"],"sourcesContent":["import type { AssistantClient, Toolkit } from '@assistant-ui/react';\nimport { Tools, useAui } from '@assistant-ui/react';\nimport {\n  DEEP_AGENT_DEFAULT_MESSAGE_WINDOW,\n  type DeepAgentMessageWindowDeclaration,\n  type DeepAgentThreadElement,\n  type DeepAgentThreadSnapshotCache,\n  type DeepAgentToolOutputStore,\n  isStatewireChannelTeardown,\n  logUnhandledStatewireError,\n  type RegisteredClientTool,\n  useDeepAgentRuntime,\n  type UseDeepAgentThreadOptions,\n} from '@athenaintel/agent-runtime';\nimport { useContext, useMemo, useRef } from 'react';\nimport { AthenaAuthContext } from '../auth/AthenaAuthContext';\nimport {\n  collectStatewireClientTools,\n  statewireClientToolWireEntries,\n} from '../chat/statewire-client-tools';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport {\n  type AthenaStatewireTokenGetter,\n  resolveStatewireAuthHeaders,\n} from './statewire-auth-headers';\nimport { statewireSessionKey } from './statewire-session-key';\n\ntype AthenaDiagnosticsSpanStarter = typeof athenaDiagnostics.span;\nimport {\n  buildStatewireRunConfig,\n  DEFAULT_STATEWIRE_MODEL,\n  resolveAgentProp,\n} from './statewire-run-config';\n\nexport { DEFAULT_STATEWIRE_MODEL };\n\n/**\n * The message window every SDK attach declares (`x-athena-deep-agent-window`):\n * the hello carries the transcript's tail plus the `messagesWindow` lane\n * instead of every message — megabytes on long threads, over the 1 MiB frame\n * limit of stock websocket clients. Older pages load from the\n * `StatewireHistoryEdge` row the chat UI mounts above the messages, and cut\n * tool outputs are fetched back for the cards that show them.\n */\nexport const ATHENA_SDK_MESSAGE_WINDOW: DeepAgentMessageWindowDeclaration = {\n  size: DEEP_AGENT_DEFAULT_MESSAGE_WINDOW,\n};\n\nexport interface AthenaStatewireRuntimeConfig {\n  /** Base URL of the statewire sync host (the `…/v2/threads` mount). */\n  syncUrl: string;\n  /** Thread ID the statewire session attaches to. */\n  threadId: string;\n  /** True only for a never-started local chat. Existing (or pre-assigned)\n   *  threads load until their server snapshot arrives. */\n  isNewChat?: boolean;\n  /** API key for authentication. Used when no auth token is provided. */\n  apiKey?: string;\n  /** Auth token. Takes priority over apiKey. */\n  token?: string | null;\n  /** Resolve the latest token immediately before a request (for expiring\n   *  clients). Called with `{ force: true }` right after the host refused the\n   *  previous credential (the transport's `staleAuth`), so a caching getter\n   *  mints a fresh token instead of returning the refused one. */\n  getToken?: AthenaStatewireTokenGetter;\n  /**\n   * Per-provider LRU of each thread's last wire state. A switch back to a\n   * remembered thread mounts with that snapshot and projects ready on the\n   * first frame instead of a loading treatment; the attach snapshot then\n   * replaces it. Owned above the per-thread mount so it survives switches.\n   */\n  snapshotCache?: DeepAgentThreadSnapshotCache;\n  /**\n   * The message window declared on the attach (see\n   * {@link ATHENA_SDK_MESSAGE_WINDOW}, the default). `false` keeps the full\n   * snapshot for a host that renders no history loader.\n   */\n  messageWindow?: DeepAgentMessageWindowDeclaration | false;\n  /**\n   * Full tool outputs fetched back for a windowed wire's cut tool messages;\n   * the thread re-converts when one lands. `AthenaProvider` owns one per\n   * provider and hands the same store to `StatewireHistoryEdge`.\n   */\n  toolOutputs?: DeepAgentToolOutputStore;\n  /** LLM model identifier. Defaults to the deep-agent default model. */\n  model?: string;\n  /** Agent selector: only `collab_agent:<asset_id>` refs are accepted (the run\n   *  executes AS that published collab agent). Any other non-empty value\n   *  throws — see `resolveAgentProp`. */\n  agent?: string;\n  /** Collab-agent channel id selecting that channel's overrides. */\n  channel?: string;\n  /** Backend toolkit IDs to enable. */\n  tools?: string[];\n  /** Frontend tool IDs to include in enabled_tools. */\n  frontendToolIds?: string[];\n  /** Frontend tools registered on the assistant client. Tools with a local\n   *  `execute` are also declared as `client_tools` and executed through the\n   *  statewire client-tool bridge. */\n  frontendToolkit?: Toolkit;\n  /** Asset IDs to include in the workbench. */\n  workbench?: string[];\n  /** Knowledge base IDs for RAG context. */\n  knowledgeBase?: string[];\n  /** System prompt override. */\n  systemPrompt?: string;\n  /** Client app identifier for session filtering. Sent as app_id in runConfig.custom. */\n  appId?: string;\n  /** Additional fields merged into runConfig.custom. */\n  extraRunConfig?: Record<string, unknown>;\n  /** Called on statewire transport errors (send rejections, stream failures). */\n  onError?: (error: Error) => void;\n  /** Projected connection status changes (deduped; null on unmount). */\n  onConnectionChange?: UseDeepAgentThreadOptions['onConnectionChange'];\n  /** Raw connection observer — carries the transport's reconnect handle. */\n  onRawConnectionChange?: UseDeepAgentThreadOptions['onRawConnectionChange'];\n  /** Notified when a run starts/stops. */\n  onRunningChange?: UseDeepAgentThreadOptions['onRunningChange'];\n}\n\nconst EMPTY_TOOLKIT: Toolkit = {};\nconst EMPTY_TOOL_IDS: string[] = [];\n\n/** The client tools derived from the runtime's frontend toolkit — exposed so\n *  the provider can mount the client-tool bridge with the same set. */\nexport function useStatewireClientTools(\n  frontendToolkit: Toolkit | undefined,\n): RegisteredClientTool[] {\n  return useMemo(\n    () => collectStatewireClientTools(frontendToolkit ?? EMPTY_TOOLKIT),\n    [frontendToolkit],\n  );\n}\n\n/**\n * Statewire runtime for the Athena SDK — a thin shim over the shared\n * `@athenaintel/agent-runtime` `useDeepAgentRuntime`: it attaches to the\n * agora-hosted deep-agent thread at `${syncUrl}/${threadId}` and returns the\n * `AssistantClient` to mount via `AuiProvider` — the same integration shape as\n * the Olympus, Chrome extension, Office, and mobile statewire hosts.\n *\n * Auth: a token (resolved live through `getToken` when provided) rides\n * `Authorization: Bearer`, and an API key falls back to `X-API-KEY` — both\n * accepted by the statewire host.\n */\nexport function useAthenaStatewireRuntime(\n  config: AthenaStatewireRuntimeConfig,\n): AssistantClient {\n  const {\n    syncUrl,\n    threadId,\n    isNewChat = false,\n    apiKey,\n    token,\n    getToken,\n    model,\n    agent,\n    channel,\n    tools = EMPTY_TOOL_IDS,\n    frontendToolIds = EMPTY_TOOL_IDS,\n    frontendToolkit = EMPTY_TOOLKIT,\n    workbench,\n    knowledgeBase,\n    systemPrompt,\n    appId,\n    extraRunConfig,\n    snapshotCache,\n    messageWindow = ATHENA_SDK_MESSAGE_WINDOW,\n    toolOutputs,\n    onError,\n    onConnectionChange,\n    onRawConnectionChange,\n    onRunningChange,\n  } = config;\n\n  // Fail loud at mount, not at first send: the statewire host always runs the\n  // Athena deep agent, so an `agent` outside the collab_agent namespace can\n  // never apply. Throwing here (render time) is what makes a misconfigured\n  // integration visible instead of quietly answering as the wrong agent.\n  resolveAgentProp({ agent });\n\n  const clientTools = useStatewireClientTools(frontendToolkit);\n\n  // The persisted command lane is keyed by WHO is signed in as well as by host\n  // and thread (see `statewireSessionKey`).\n  const authContext = useContext(AthenaAuthContext);\n  const principal = authContext?.user?.userId ?? '';\n\n  // Attach → first server snapshot span, keyed per thread attach.\n  const attachSpanRef = useRef<ReturnType<AthenaDiagnosticsSpanStarter> | null>(null);\n  const attachThreadRef = useRef<string | null>(null);\n  if (attachThreadRef.current !== threadId) {\n    attachThreadRef.current = threadId;\n    attachSpanRef.current = athenaDiagnostics.span(\n      `statewire.attach:${threadId}`,\n      'statewire.attach.start',\n      { thread_id: threadId, is_new_chat: isNewChat },\n    );\n  }\n\n  const auiTools = useMemo(() => Tools({ toolkit: frontendToolkit }), [frontendToolkit]);\n  // Web client for the shared runtime core (a `use*` name so the\n  // rules-of-hooks lint sees the `useAui` call inside a custom hook; the core\n  // invokes it unconditionally every render).\n  const useSdkClient = (thread: DeepAgentThreadElement) => useAui({ thread, tools: auiTools });\n\n  return useDeepAgentRuntime({\n    surface: 'AthenaSDK',\n    threadId,\n    baseUrl: syncUrl,\n    // Option closures are re-read per render by the core, so credential\n    // rotation (new `token`/`getToken`/`apiKey` props) reaches the next\n    // request without remounting the thread. The transport's `staleAuth`\n    // (true right after a refused credential) is forwarded as `force`.\n    headers: (ctx) => resolveStatewireAuthHeaders({ apiKey, token, getToken }, ctx),\n    isNewChat,\n    // Queued entries render in the SDK's queue panel, so only the steer lane\n    // projects into the message tail.\n    laneProjection: 'steer-only',\n    // Durable session: a reload resumes the lane and resends whatever the\n    // server has not marked durable. Scoped by host AND principal — a thread\n    // id is only meaningful against the backend that minted it, and a stored\n    // lane must never resend against another signed-in user. (Consumers\n    // server-render this SDK; the core's availability probe keeps those\n    // sessions process-local, as before the seam existed.)\n    session: {\n      kind: 'local-storage',\n      key: (id) => statewireSessionKey({ syncUrl, principal, threadId: id }),\n    },\n    snapshotCache,\n    // Windowed hello (see `ATHENA_SDK_MESSAGE_WINDOW`): the tail of the\n    // transcript instead of every message; the chat UI's history edge pages\n    // older ranges in and fetches cut tool outputs into `toolOutputs`.\n    messageWindow,\n    toolOutputs,\n    capabilities: { edit: true, reload: true, continue: true },\n    useClient: useSdkClient,\n    onStateChange: () => {\n      // First snapshot for this attach ends the attach span (time-to-history).\n      const endSpan = attachSpanRef.current;\n      if (endSpan) {\n        attachSpanRef.current = null;\n        endSpan('statewire.snapshot', { data: { thread_id: threadId } });\n      }\n    },\n    onConnectionChange: (connection) => {\n      athenaDiagnostics.gauge('statewire.connection', connection?.status ?? null);\n      if (connection?.status === 'stopped') {\n        athenaDiagnostics.emit('statewire.connection', {\n          level: 'warn',\n          data: {\n            status: connection.status,\n            reason: connection.reason,\n            message: connection.message,\n          },\n        });\n      }\n      onConnectionChange?.(connection);\n    },\n    onRawConnectionChange,\n    onRunningChange,\n    // The runConfig getter is pulled at command-send time through the core's\n    // per-render ref, so it reads the latest props — consumers commonly pass\n    // fresh array literals per render, which must not thrash the registration\n    // (no `key`: the provider registers once per client).\n    runConfig: {\n      get: () =>\n        buildStatewireRunConfig({\n          model,\n          agent,\n          channel,\n          tools,\n          frontendToolIds,\n          workbench,\n          knowledgeBase,\n          systemPrompt,\n          appId,\n          extraRunConfig,\n          clientTools: statewireClientToolWireEntries(clientTools),\n        }),\n    },\n    onError: (error) => {\n      if (!isStatewireChannelTeardown(error)) {\n        athenaDiagnostics.error(\n          'statewire.error',\n          error,\n          {\n            code: 'statewire_rejected',\n            message: 'The statewire host rejected a command',\n            hint: 'Inspect error.detail — agora rejections carry a structured {code, message}.',\n          },\n          { thread_id: threadId },\n        );\n      }\n      if (onError) {\n        onError(error);\n        return;\n      }\n      logUnhandledStatewireError('AthenaSDK', error);\n    },\n  });\n}\n"],"names":["DEEP_AGENT_DEFAULT_MESSAGE_WINDOW","useMemo","collectStatewireClientTools","resolveAgentProp","useContext","AthenaAuthContext","useRef","athenaDiagnostics","Tools","useAui","useDeepAgentRuntime","resolveStatewireAuthHeaders","statewireSessionKey","buildStatewireRunConfig","statewireClientToolWireEntries","isStatewireChannelTeardown","logUnhandledStatewireError"],"mappings":"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"}
+{"version":3,"file":"useAthenaStatewireRuntime.cjs","sources":["../../src/runtime/useAthenaStatewireRuntime.ts"],"sourcesContent":["import type { AssistantClient, Toolkit } from '@assistant-ui/react';\nimport { Tools, useAui } from '@assistant-ui/react';\nimport {\n  DEEP_AGENT_DEFAULT_MESSAGE_WINDOW,\n  type DeepAgentMessageWindowDeclaration,\n  type DeepAgentThreadElement,\n  type DeepAgentThreadSnapshotCache,\n  type DeepAgentToolOutputStore,\n  isStatewireChannelTeardown,\n  logUnhandledStatewireError,\n  type RegisteredClientTool,\n  useDeepAgentRuntime,\n  type UseDeepAgentThreadOptions,\n} from '@athenaintel/agent-runtime';\nimport { useContext, useMemo, useRef } from 'react';\nimport { AthenaAuthContext } from '../auth/AthenaAuthContext';\nimport {\n  collectStatewireClientTools,\n  statewireClientToolWireEntries,\n} from '../chat/statewire-client-tools';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport {\n  type AthenaStatewireTokenGetter,\n  resolveStatewireAuthHeaders,\n} from './statewire-auth-headers';\nimport { statewireSessionKey } from './statewire-session-key';\n\ntype AthenaDiagnosticsSpanStarter = typeof athenaDiagnostics.span;\nimport {\n  buildStatewireRunConfig,\n  DEFAULT_STATEWIRE_MODEL,\n  resolveAgentProp,\n} from './statewire-run-config';\n\nexport { DEFAULT_STATEWIRE_MODEL };\n\n/**\n * The message window every SDK attach declares (`x-athena-deep-agent-window`):\n * the hello carries the transcript's tail plus the `messagesWindow` lane\n * instead of every message — megabytes on long threads, over the 1 MiB frame\n * limit of stock websocket clients. Older pages load from the\n * `StatewireHistoryEdge` row the chat UI mounts above the messages, and cut\n * tool outputs are fetched back for the cards that show them.\n */\nexport const ATHENA_SDK_MESSAGE_WINDOW: DeepAgentMessageWindowDeclaration = {\n  size: DEEP_AGENT_DEFAULT_MESSAGE_WINDOW,\n};\n\nexport interface AthenaStatewireRuntimeConfig {\n  /** Base URL of the statewire sync host (the `…/v2/threads` mount). */\n  syncUrl: string;\n  /** Thread ID the statewire session attaches to. */\n  threadId: string;\n  /** True only for a never-started local chat. Existing (or pre-assigned)\n   *  threads load until their server snapshot arrives. */\n  isNewChat?: boolean;\n  /** API key for authentication. Used when no auth token is provided. */\n  apiKey?: string;\n  /** Auth token. Takes priority over apiKey. */\n  token?: string | null;\n  /** Resolve the latest token immediately before a request (for expiring\n   *  clients). Called with `{ force: true }` right after the host refused the\n   *  previous credential (the transport's `staleAuth`), so a caching getter\n   *  mints a fresh token instead of returning the refused one. */\n  getToken?: AthenaStatewireTokenGetter;\n  /**\n   * Per-provider LRU of each thread's last wire state. A switch back to a\n   * remembered thread mounts with that snapshot and projects ready on the\n   * first frame instead of a loading treatment; the attach snapshot then\n   * replaces it. Owned above the per-thread mount so it survives switches.\n   */\n  snapshotCache?: DeepAgentThreadSnapshotCache;\n  /**\n   * The message window declared on the attach (see\n   * {@link ATHENA_SDK_MESSAGE_WINDOW}, the default). `false` keeps the full\n   * snapshot for a host that renders no history loader.\n   */\n  messageWindow?: DeepAgentMessageWindowDeclaration | false;\n  /**\n   * Full tool outputs fetched back for a windowed wire's cut tool messages;\n   * the thread re-converts when one lands. `AthenaProvider` owns one per\n   * provider and hands the same store to `StatewireHistoryEdge`.\n   */\n  toolOutputs?: DeepAgentToolOutputStore;\n  /** LLM model identifier. Defaults to the deep-agent default model. */\n  model?: string;\n  /** Agent selector: only `collab_agent:<asset_id>` refs are accepted (the run\n   *  executes AS that published collab agent). Any other non-empty value\n   *  throws — see `resolveAgentProp`. */\n  agent?: string;\n  /** Collab-agent channel id selecting that channel's overrides. */\n  channel?: string;\n  /** Backend toolkit IDs to enable. */\n  tools?: string[];\n  /** Frontend tool IDs to include in enabled_tools. */\n  frontendToolIds?: string[];\n  /** Frontend tools registered on the assistant client. Tools with a local\n   *  `execute` are also declared as `client_tools` and executed through the\n   *  statewire client-tool bridge. */\n  frontendToolkit?: Toolkit;\n  /** Asset IDs to include in the workbench. */\n  workbench?: string[];\n  /** Knowledge base IDs for RAG context. */\n  knowledgeBase?: string[];\n  /** System prompt override. */\n  systemPrompt?: string;\n  /** Client app identifier for session filtering. Sent as app_id in runConfig.custom. */\n  appId?: string;\n  /** Additional fields merged into runConfig.custom. */\n  extraRunConfig?: Record<string, unknown>;\n  /** Called on statewire transport errors (send rejections, stream failures). */\n  onError?: (error: Error) => void;\n  /** Projected connection status changes (deduped; null on unmount). */\n  onConnectionChange?: UseDeepAgentThreadOptions['onConnectionChange'];\n  /** Raw connection observer — carries the transport's reconnect handle. */\n  onRawConnectionChange?: UseDeepAgentThreadOptions['onRawConnectionChange'];\n  /** Notified when a run starts/stops. */\n  onRunningChange?: UseDeepAgentThreadOptions['onRunningChange'];\n}\n\nconst EMPTY_TOOLKIT: Toolkit = {};\nconst EMPTY_TOOL_IDS: string[] = [];\n\n/** The client tools derived from the runtime's frontend toolkit — exposed so\n *  the provider can mount the client-tool bridge with the same set. */\nexport function useStatewireClientTools(\n  frontendToolkit: Toolkit | undefined,\n): RegisteredClientTool[] {\n  return useMemo(\n    () => collectStatewireClientTools(frontendToolkit ?? EMPTY_TOOLKIT),\n    [frontendToolkit],\n  );\n}\n\n/**\n * Statewire runtime for the Athena SDK — a thin shim over the shared\n * `@athenaintel/agent-runtime` `useDeepAgentRuntime`: it attaches to the\n * agora-hosted deep-agent thread at `${syncUrl}/${threadId}` and returns the\n * `AssistantClient` to mount via `AuiProvider` — the same integration shape as\n * the Olympus, Chrome extension, Office, and mobile statewire hosts.\n *\n * Auth: a token (resolved live through `getToken` when provided) rides\n * `Authorization: Bearer`, and an API key falls back to `X-API-KEY` — both\n * accepted by the statewire host.\n */\nexport function useAthenaStatewireRuntime(\n  config: AthenaStatewireRuntimeConfig,\n): AssistantClient {\n  const {\n    syncUrl,\n    threadId,\n    isNewChat = false,\n    apiKey,\n    token,\n    getToken,\n    model,\n    agent,\n    channel,\n    tools = EMPTY_TOOL_IDS,\n    frontendToolIds = EMPTY_TOOL_IDS,\n    frontendToolkit = EMPTY_TOOLKIT,\n    workbench,\n    knowledgeBase,\n    systemPrompt,\n    appId,\n    extraRunConfig,\n    snapshotCache,\n    messageWindow = ATHENA_SDK_MESSAGE_WINDOW,\n    toolOutputs,\n    onError,\n    onConnectionChange,\n    onRawConnectionChange,\n    onRunningChange,\n  } = config;\n\n  // Fail loud at mount, not at first send: the statewire host always runs the\n  // Athena deep agent, so an `agent` outside the collab_agent namespace can\n  // never apply. Throwing here (render time) is what makes a misconfigured\n  // integration visible instead of quietly answering as the wrong agent.\n  resolveAgentProp({ agent });\n\n  const clientTools = useStatewireClientTools(frontendToolkit);\n\n  // The persisted command lane is keyed by WHO is signed in as well as by host\n  // and thread (see `statewireSessionKey`).\n  const authContext = useContext(AthenaAuthContext);\n  const principal = authContext?.user?.userId ?? '';\n\n  // Attach → first server snapshot span, keyed per thread attach.\n  const attachSpanRef = useRef<ReturnType<AthenaDiagnosticsSpanStarter> | null>(null);\n  const attachThreadRef = useRef<string | null>(null);\n  if (attachThreadRef.current !== threadId) {\n    attachThreadRef.current = threadId;\n    attachSpanRef.current = athenaDiagnostics.span(\n      `statewire.attach:${threadId}`,\n      'statewire.attach.start',\n      { thread_id: threadId, is_new_chat: isNewChat },\n    );\n  }\n\n  const auiTools = useMemo(() => Tools({ toolkit: frontendToolkit }), [frontendToolkit]);\n  // Web client for the shared runtime core (a `use*` name so the\n  // rules-of-hooks lint sees the `useAui` call inside a custom hook; the core\n  // invokes it unconditionally every render).\n  const useSdkClient = (thread: DeepAgentThreadElement) => useAui({ thread, tools: auiTools });\n\n  return useDeepAgentRuntime({\n    surface: 'AthenaSDK',\n    threadId,\n    baseUrl: syncUrl,\n    // Option closures are re-read per render by the core, so credential\n    // rotation (new `token`/`getToken`/`apiKey` props) reaches the next\n    // request without remounting the thread. The transport's `staleAuth`\n    // (true right after a refused credential) is forwarded as `force`.\n    headers: (ctx) => resolveStatewireAuthHeaders({ apiKey, token, getToken }, ctx),\n    isNewChat,\n    // Queued entries render in the SDK's queue panel, so only the steer lane\n    // projects into the message tail.\n    laneProjection: 'steer-only',\n    // Durable session: a reload resumes the lane and resends whatever the\n    // server has not marked durable. Scoped by host AND principal — a thread\n    // id is only meaningful against the backend that minted it, and a stored\n    // lane must never resend against another signed-in user. (Consumers\n    // server-render this SDK; the core's availability probe keeps those\n    // sessions process-local, as before the seam existed.)\n    session: {\n      kind: 'local-storage',\n      key: (id) => statewireSessionKey({ syncUrl, principal, threadId: id }),\n    },\n    snapshotCache,\n    // Windowed hello (see `ATHENA_SDK_MESSAGE_WINDOW`): the tail of the\n    // transcript instead of every message; the chat UI's history edge pages\n    // older ranges in and fetches cut tool outputs into `toolOutputs`.\n    messageWindow,\n    toolOutputs,\n    capabilities: { edit: true, reload: true, continue: true },\n    useClient: useSdkClient,\n    onStateChange: () => {\n      // First snapshot for this attach ends the attach span (time-to-history).\n      const endSpan = attachSpanRef.current;\n      if (endSpan) {\n        attachSpanRef.current = null;\n        endSpan('statewire.snapshot', { data: { thread_id: threadId } });\n      }\n    },\n    onConnectionChange: (connection) => {\n      athenaDiagnostics.gauge('statewire.connection', connection?.status ?? null);\n      if (connection?.status === 'stopped') {\n        athenaDiagnostics.emit('statewire.connection', {\n          level: 'warn',\n          data: {\n            status: connection.status,\n            reason: connection.reason,\n            message: connection.message,\n          },\n        });\n      }\n      onConnectionChange?.(connection);\n    },\n    onRawConnectionChange,\n    onRunningChange,\n    // The runConfig getter is pulled at command-send time through the core's\n    // per-render ref, so it reads the latest props — consumers commonly pass\n    // fresh array literals per render, which must not thrash the registration\n    // (no `key`: the provider registers once per client).\n    runConfig: {\n      get: () =>\n        buildStatewireRunConfig({\n          model,\n          agent,\n          channel,\n          tools,\n          frontendToolIds,\n          workbench,\n          knowledgeBase,\n          systemPrompt,\n          appId,\n          extraRunConfig,\n          clientTools: statewireClientToolWireEntries(clientTools),\n        }),\n    },\n    onError: (error) => {\n      if (!isStatewireChannelTeardown(error)) {\n        athenaDiagnostics.error(\n          'statewire.error',\n          error,\n          {\n            code: 'statewire_rejected',\n            message: 'The statewire host rejected a command',\n            hint: 'Inspect error.detail — agora rejections carry a structured {code, message}.',\n          },\n          { thread_id: threadId },\n        );\n      }\n      if (onError) {\n        onError(error);\n        return;\n      }\n      logUnhandledStatewireError('AthenaSDK', error);\n    },\n  });\n}\n"],"names":["DEEP_AGENT_DEFAULT_MESSAGE_WINDOW","useMemo","collectStatewireClientTools","resolveAgentProp","useContext","AthenaAuthContext","useRef","athenaDiagnostics","Tools","useAui","useDeepAgentRuntime","resolveStatewireAuthHeaders","statewireSessionKey","buildStatewireRunConfig","statewireClientToolWireEntries","isStatewireChannelTeardown","logUnhandledStatewireError"],"mappings":"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"}

package/dist/runtime/useAthenaStatewireRuntime.js

@@ -10,11 +10,12 @@ import "../packages/agent-runtime/src/statewire-state.js";
 import "../packages/agent-runtime/src/messages.js";
 import "@assistant-ui/react-statewire";
 import "@assistant-ui/store";
-import "@assistant-ui/react-statewire/local-storage";
+import "../packages/agent-runtime/src/quota-safe-local-storage-session.js";
 import "../packages/agent-runtime/src/statewire-attach-observer.js";
 import "../packages/agent-runtime/src/thread-status.js";
 import { useDeepAgentRuntime, logUnhandledStatewireError } from "../packages/agent-runtime/src/use-deep-agent-runtime.js";
 import "@assistant-ui/core";
+import "../packages/agent-runtime/src/thread-handoff.js";
 import { AthenaAuthContext } from "../auth/AthenaAuthContext.js";
 import { collectStatewireClientTools, statewireClientToolWireEntries } from "../chat/statewire-client-tools.js";
 import { athenaDiagnostics } from "../diagnostics/athena-diagnostics.js";

package/dist/runtime/useAthenaStatewireRuntime.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAthenaStatewireRuntime.js","sources":["../../src/runtime/useAthenaStatewireRuntime.ts"],"sourcesContent":["import type { AssistantClient, Toolkit } from '@assistant-ui/react';\nimport { Tools, useAui } from '@assistant-ui/react';\nimport {\n  DEEP_AGENT_DEFAULT_MESSAGE_WINDOW,\n  type DeepAgentMessageWindowDeclaration,\n  type DeepAgentThreadElement,\n  type DeepAgentThreadSnapshotCache,\n  type DeepAgentToolOutputStore,\n  isStatewireChannelTeardown,\n  logUnhandledStatewireError,\n  type RegisteredClientTool,\n  useDeepAgentRuntime,\n  type UseDeepAgentThreadOptions,\n} from '@athenaintel/agent-runtime';\nimport { useContext, useMemo, useRef } from 'react';\nimport { AthenaAuthContext } from '../auth/AthenaAuthContext';\nimport {\n  collectStatewireClientTools,\n  statewireClientToolWireEntries,\n} from '../chat/statewire-client-tools';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport {\n  type AthenaStatewireTokenGetter,\n  resolveStatewireAuthHeaders,\n} from './statewire-auth-headers';\nimport { statewireSessionKey } from './statewire-session-key';\n\ntype AthenaDiagnosticsSpanStarter = typeof athenaDiagnostics.span;\nimport {\n  buildStatewireRunConfig,\n  DEFAULT_STATEWIRE_MODEL,\n  resolveAgentProp,\n} from './statewire-run-config';\n\nexport { DEFAULT_STATEWIRE_MODEL };\n\n/**\n * The message window every SDK attach declares (`x-athena-deep-agent-window`):\n * the hello carries the transcript's tail plus the `messagesWindow` lane\n * instead of every message — megabytes on long threads, over the 1 MiB frame\n * limit of stock websocket clients. Older pages load from the\n * `StatewireHistoryEdge` row the chat UI mounts above the messages, and cut\n * tool outputs are fetched back for the cards that show them.\n */\nexport const ATHENA_SDK_MESSAGE_WINDOW: DeepAgentMessageWindowDeclaration = {\n  size: DEEP_AGENT_DEFAULT_MESSAGE_WINDOW,\n};\n\nexport interface AthenaStatewireRuntimeConfig {\n  /** Base URL of the statewire sync host (the `…/v2/threads` mount). */\n  syncUrl: string;\n  /** Thread ID the statewire session attaches to. */\n  threadId: string;\n  /** True only for a never-started local chat. Existing (or pre-assigned)\n   *  threads load until their server snapshot arrives. */\n  isNewChat?: boolean;\n  /** API key for authentication. Used when no auth token is provided. */\n  apiKey?: string;\n  /** Auth token. Takes priority over apiKey. */\n  token?: string | null;\n  /** Resolve the latest token immediately before a request (for expiring\n   *  clients). Called with `{ force: true }` right after the host refused the\n   *  previous credential (the transport's `staleAuth`), so a caching getter\n   *  mints a fresh token instead of returning the refused one. */\n  getToken?: AthenaStatewireTokenGetter;\n  /**\n   * Per-provider LRU of each thread's last wire state. A switch back to a\n   * remembered thread mounts with that snapshot and projects ready on the\n   * first frame instead of a loading treatment; the attach snapshot then\n   * replaces it. Owned above the per-thread mount so it survives switches.\n   */\n  snapshotCache?: DeepAgentThreadSnapshotCache;\n  /**\n   * The message window declared on the attach (see\n   * {@link ATHENA_SDK_MESSAGE_WINDOW}, the default). `false` keeps the full\n   * snapshot for a host that renders no history loader.\n   */\n  messageWindow?: DeepAgentMessageWindowDeclaration | false;\n  /**\n   * Full tool outputs fetched back for a windowed wire's cut tool messages;\n   * the thread re-converts when one lands. `AthenaProvider` owns one per\n   * provider and hands the same store to `StatewireHistoryEdge`.\n   */\n  toolOutputs?: DeepAgentToolOutputStore;\n  /** LLM model identifier. Defaults to the deep-agent default model. */\n  model?: string;\n  /** Agent selector: only `collab_agent:<asset_id>` refs are accepted (the run\n   *  executes AS that published collab agent). Any other non-empty value\n   *  throws — see `resolveAgentProp`. */\n  agent?: string;\n  /** Collab-agent channel id selecting that channel's overrides. */\n  channel?: string;\n  /** Backend toolkit IDs to enable. */\n  tools?: string[];\n  /** Frontend tool IDs to include in enabled_tools. */\n  frontendToolIds?: string[];\n  /** Frontend tools registered on the assistant client. Tools with a local\n   *  `execute` are also declared as `client_tools` and executed through the\n   *  statewire client-tool bridge. */\n  frontendToolkit?: Toolkit;\n  /** Asset IDs to include in the workbench. */\n  workbench?: string[];\n  /** Knowledge base IDs for RAG context. */\n  knowledgeBase?: string[];\n  /** System prompt override. */\n  systemPrompt?: string;\n  /** Client app identifier for session filtering. Sent as app_id in runConfig.custom. */\n  appId?: string;\n  /** Additional fields merged into runConfig.custom. */\n  extraRunConfig?: Record<string, unknown>;\n  /** Called on statewire transport errors (send rejections, stream failures). */\n  onError?: (error: Error) => void;\n  /** Projected connection status changes (deduped; null on unmount). */\n  onConnectionChange?: UseDeepAgentThreadOptions['onConnectionChange'];\n  /** Raw connection observer — carries the transport's reconnect handle. */\n  onRawConnectionChange?: UseDeepAgentThreadOptions['onRawConnectionChange'];\n  /** Notified when a run starts/stops. */\n  onRunningChange?: UseDeepAgentThreadOptions['onRunningChange'];\n}\n\nconst EMPTY_TOOLKIT: Toolkit = {};\nconst EMPTY_TOOL_IDS: string[] = [];\n\n/** The client tools derived from the runtime's frontend toolkit — exposed so\n *  the provider can mount the client-tool bridge with the same set. */\nexport function useStatewireClientTools(\n  frontendToolkit: Toolkit | undefined,\n): RegisteredClientTool[] {\n  return useMemo(\n    () => collectStatewireClientTools(frontendToolkit ?? EMPTY_TOOLKIT),\n    [frontendToolkit],\n  );\n}\n\n/**\n * Statewire runtime for the Athena SDK — a thin shim over the shared\n * `@athenaintel/agent-runtime` `useDeepAgentRuntime`: it attaches to the\n * agora-hosted deep-agent thread at `${syncUrl}/${threadId}` and returns the\n * `AssistantClient` to mount via `AuiProvider` — the same integration shape as\n * the Olympus, Chrome extension, Office, and mobile statewire hosts.\n *\n * Auth: a token (resolved live through `getToken` when provided) rides\n * `Authorization: Bearer`, and an API key falls back to `X-API-KEY` — both\n * accepted by the statewire host.\n */\nexport function useAthenaStatewireRuntime(\n  config: AthenaStatewireRuntimeConfig,\n): AssistantClient {\n  const {\n    syncUrl,\n    threadId,\n    isNewChat = false,\n    apiKey,\n    token,\n    getToken,\n    model,\n    agent,\n    channel,\n    tools = EMPTY_TOOL_IDS,\n    frontendToolIds = EMPTY_TOOL_IDS,\n    frontendToolkit = EMPTY_TOOLKIT,\n    workbench,\n    knowledgeBase,\n    systemPrompt,\n    appId,\n    extraRunConfig,\n    snapshotCache,\n    messageWindow = ATHENA_SDK_MESSAGE_WINDOW,\n    toolOutputs,\n    onError,\n    onConnectionChange,\n    onRawConnectionChange,\n    onRunningChange,\n  } = config;\n\n  // Fail loud at mount, not at first send: the statewire host always runs the\n  // Athena deep agent, so an `agent` outside the collab_agent namespace can\n  // never apply. Throwing here (render time) is what makes a misconfigured\n  // integration visible instead of quietly answering as the wrong agent.\n  resolveAgentProp({ agent });\n\n  const clientTools = useStatewireClientTools(frontendToolkit);\n\n  // The persisted command lane is keyed by WHO is signed in as well as by host\n  // and thread (see `statewireSessionKey`).\n  const authContext = useContext(AthenaAuthContext);\n  const principal = authContext?.user?.userId ?? '';\n\n  // Attach → first server snapshot span, keyed per thread attach.\n  const attachSpanRef = useRef<ReturnType<AthenaDiagnosticsSpanStarter> | null>(null);\n  const attachThreadRef = useRef<string | null>(null);\n  if (attachThreadRef.current !== threadId) {\n    attachThreadRef.current = threadId;\n    attachSpanRef.current = athenaDiagnostics.span(\n      `statewire.attach:${threadId}`,\n      'statewire.attach.start',\n      { thread_id: threadId, is_new_chat: isNewChat },\n    );\n  }\n\n  const auiTools = useMemo(() => Tools({ toolkit: frontendToolkit }), [frontendToolkit]);\n  // Web client for the shared runtime core (a `use*` name so the\n  // rules-of-hooks lint sees the `useAui` call inside a custom hook; the core\n  // invokes it unconditionally every render).\n  const useSdkClient = (thread: DeepAgentThreadElement) => useAui({ thread, tools: auiTools });\n\n  return useDeepAgentRuntime({\n    surface: 'AthenaSDK',\n    threadId,\n    baseUrl: syncUrl,\n    // Option closures are re-read per render by the core, so credential\n    // rotation (new `token`/`getToken`/`apiKey` props) reaches the next\n    // request without remounting the thread. The transport's `staleAuth`\n    // (true right after a refused credential) is forwarded as `force`.\n    headers: (ctx) => resolveStatewireAuthHeaders({ apiKey, token, getToken }, ctx),\n    isNewChat,\n    // Queued entries render in the SDK's queue panel, so only the steer lane\n    // projects into the message tail.\n    laneProjection: 'steer-only',\n    // Durable session: a reload resumes the lane and resends whatever the\n    // server has not marked durable. Scoped by host AND principal — a thread\n    // id is only meaningful against the backend that minted it, and a stored\n    // lane must never resend against another signed-in user. (Consumers\n    // server-render this SDK; the core's availability probe keeps those\n    // sessions process-local, as before the seam existed.)\n    session: {\n      kind: 'local-storage',\n      key: (id) => statewireSessionKey({ syncUrl, principal, threadId: id }),\n    },\n    snapshotCache,\n    // Windowed hello (see `ATHENA_SDK_MESSAGE_WINDOW`): the tail of the\n    // transcript instead of every message; the chat UI's history edge pages\n    // older ranges in and fetches cut tool outputs into `toolOutputs`.\n    messageWindow,\n    toolOutputs,\n    capabilities: { edit: true, reload: true, continue: true },\n    useClient: useSdkClient,\n    onStateChange: () => {\n      // First snapshot for this attach ends the attach span (time-to-history).\n      const endSpan = attachSpanRef.current;\n      if (endSpan) {\n        attachSpanRef.current = null;\n        endSpan('statewire.snapshot', { data: { thread_id: threadId } });\n      }\n    },\n    onConnectionChange: (connection) => {\n      athenaDiagnostics.gauge('statewire.connection', connection?.status ?? null);\n      if (connection?.status === 'stopped') {\n        athenaDiagnostics.emit('statewire.connection', {\n          level: 'warn',\n          data: {\n            status: connection.status,\n            reason: connection.reason,\n            message: connection.message,\n          },\n        });\n      }\n      onConnectionChange?.(connection);\n    },\n    onRawConnectionChange,\n    onRunningChange,\n    // The runConfig getter is pulled at command-send time through the core's\n    // per-render ref, so it reads the latest props — consumers commonly pass\n    // fresh array literals per render, which must not thrash the registration\n    // (no `key`: the provider registers once per client).\n    runConfig: {\n      get: () =>\n        buildStatewireRunConfig({\n          model,\n          agent,\n          channel,\n          tools,\n          frontendToolIds,\n          workbench,\n          knowledgeBase,\n          systemPrompt,\n          appId,\n          extraRunConfig,\n          clientTools: statewireClientToolWireEntries(clientTools),\n        }),\n    },\n    onError: (error) => {\n      if (!isStatewireChannelTeardown(error)) {\n        athenaDiagnostics.error(\n          'statewire.error',\n          error,\n          {\n            code: 'statewire_rejected',\n            message: 'The statewire host rejected a command',\n            hint: 'Inspect error.detail — agora rejections carry a structured {code, message}.',\n          },\n          { thread_id: threadId },\n        );\n      }\n      if (onError) {\n        onError(error);\n        return;\n      }\n      logUnhandledStatewireError('AthenaSDK', error);\n    },\n  });\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA4CO,MAAM,4BAA+D;AAAA,EAC1E,MAAM;AACR;AA0EA,MAAM,gBAAyB,CAAA;AAC/B,MAAM,iBAA2B,CAAA;AAI1B,SAAS,wBACd,iBACwB;AACxB,SAAO;AAAA,IACL,MAAM,4BAA4B,mBAAmB,aAAa;AAAA,IAClE,CAAC,eAAe;AAAA,EAAA;AAEpB;AAaO,SAAS,0BACd,QACiB;;AACjB,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA,YAAY;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,QAAQ;AAAA,IACR,kBAAkB;AAAA,IAClB,kBAAkB;AAAA,IAClB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,gBAAgB;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA,IACE;AAMJ,mBAAiB,EAAE,OAAO;AAE1B,QAAM,cAAc,wBAAwB,eAAe;AAI3D,QAAM,cAAc,WAAW,iBAAiB;AAChD,QAAM,cAAY,gDAAa,SAAb,mBAAmB,WAAU;AAG/C,QAAM,gBAAgB,OAAwD,IAAI;AAClF,QAAM,kBAAkB,OAAsB,IAAI;AAClD,MAAI,gBAAgB,YAAY,UAAU;AACxC,oBAAgB,UAAU;AAC1B,kBAAc,UAAU,kBAAkB;AAAA,MACxC,oBAAoB,QAAQ;AAAA,MAC5B;AAAA,MACA,EAAE,WAAW,UAAU,aAAa,UAAA;AAAA,IAAU;AAAA,EAElD;AAEA,QAAM,WAAW,QAAQ,MAAM,MAAM,EAAE,SAAS,gBAAA,CAAiB,GAAG,CAAC,eAAe,CAAC;AAIrF,QAAM,eAAe,CAAC,WAAmC,OAAO,EAAE,QAAQ,OAAO,UAAU;AAE3F,SAAO,oBAAoB;AAAA,IACzB,SAAS;AAAA,IACT;AAAA,IACA,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA,IAKT,SAAS,CAAC,QAAQ,4BAA4B,EAAE,QAAQ,OAAO,SAAA,GAAY,GAAG;AAAA,IAC9E;AAAA;AAAA;AAAA,IAGA,gBAAgB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOhB,SAAS;AAAA,MACP,MAAM;AAAA,MACN,KAAK,CAAC,OAAO,oBAAoB,EAAE,SAAS,WAAW,UAAU,GAAA,CAAI;AAAA,IAAA;AAAA,IAEvE;AAAA;AAAA;AAAA;AAAA,IAIA;AAAA,IACA;AAAA,IACA,cAAc,EAAE,MAAM,MAAM,QAAQ,MAAM,UAAU,KAAA;AAAA,IACpD,WAAW;AAAA,IACX,eAAe,MAAM;AAEnB,YAAM,UAAU,cAAc;AAC9B,UAAI,SAAS;AACX,sBAAc,UAAU;AACxB,gBAAQ,sBAAsB,EAAE,MAAM,EAAE,WAAW,SAAA,GAAY;AAAA,MACjE;AAAA,IACF;AAAA,IACA,oBAAoB,CAAC,eAAe;AAClC,wBAAkB,MAAM,yBAAwB,yCAAY,WAAU,IAAI;AAC1E,WAAI,yCAAY,YAAW,WAAW;AACpC,0BAAkB,KAAK,wBAAwB;AAAA,UAC7C,OAAO;AAAA,UACP,MAAM;AAAA,YACJ,QAAQ,WAAW;AAAA,YACnB,QAAQ,WAAW;AAAA,YACnB,SAAS,WAAW;AAAA,UAAA;AAAA,QACtB,CACD;AAAA,MACH;AACA,+DAAqB;AAAA,IACvB;AAAA,IACA;AAAA,IACA;AAAA;AAAA;AAAA;AAAA;AAAA,IAKA,WAAW;AAAA,MACT,KAAK,MACH,wBAAwB;AAAA,QACtB;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,aAAa,+BAA+B,WAAW;AAAA,MAAA,CACxD;AAAA,IAAA;AAAA,IAEL,SAAS,CAAC,UAAU;AAClB,UAAI,CAAC,2BAA2B,KAAK,GAAG;AACtC,0BAAkB;AAAA,UAChB;AAAA,UACA;AAAA,UACA;AAAA,YACE,MAAM;AAAA,YACN,SAAS;AAAA,YACT,MAAM;AAAA,UAAA;AAAA,UAER,EAAE,WAAW,SAAA;AAAA,QAAS;AAAA,MAE1B;AACA,UAAI,SAAS;AACX,gBAAQ,KAAK;AACb;AAAA,MACF;AACA,iCAA2B,aAAa,KAAK;AAAA,IAC/C;AAAA,EAAA,CACD;AACH;"}
+{"version":3,"file":"useAthenaStatewireRuntime.js","sources":["../../src/runtime/useAthenaStatewireRuntime.ts"],"sourcesContent":["import type { AssistantClient, Toolkit } from '@assistant-ui/react';\nimport { Tools, useAui } from '@assistant-ui/react';\nimport {\n  DEEP_AGENT_DEFAULT_MESSAGE_WINDOW,\n  type DeepAgentMessageWindowDeclaration,\n  type DeepAgentThreadElement,\n  type DeepAgentThreadSnapshotCache,\n  type DeepAgentToolOutputStore,\n  isStatewireChannelTeardown,\n  logUnhandledStatewireError,\n  type RegisteredClientTool,\n  useDeepAgentRuntime,\n  type UseDeepAgentThreadOptions,\n} from '@athenaintel/agent-runtime';\nimport { useContext, useMemo, useRef } from 'react';\nimport { AthenaAuthContext } from '../auth/AthenaAuthContext';\nimport {\n  collectStatewireClientTools,\n  statewireClientToolWireEntries,\n} from '../chat/statewire-client-tools';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport {\n  type AthenaStatewireTokenGetter,\n  resolveStatewireAuthHeaders,\n} from './statewire-auth-headers';\nimport { statewireSessionKey } from './statewire-session-key';\n\ntype AthenaDiagnosticsSpanStarter = typeof athenaDiagnostics.span;\nimport {\n  buildStatewireRunConfig,\n  DEFAULT_STATEWIRE_MODEL,\n  resolveAgentProp,\n} from './statewire-run-config';\n\nexport { DEFAULT_STATEWIRE_MODEL };\n\n/**\n * The message window every SDK attach declares (`x-athena-deep-agent-window`):\n * the hello carries the transcript's tail plus the `messagesWindow` lane\n * instead of every message — megabytes on long threads, over the 1 MiB frame\n * limit of stock websocket clients. Older pages load from the\n * `StatewireHistoryEdge` row the chat UI mounts above the messages, and cut\n * tool outputs are fetched back for the cards that show them.\n */\nexport const ATHENA_SDK_MESSAGE_WINDOW: DeepAgentMessageWindowDeclaration = {\n  size: DEEP_AGENT_DEFAULT_MESSAGE_WINDOW,\n};\n\nexport interface AthenaStatewireRuntimeConfig {\n  /** Base URL of the statewire sync host (the `…/v2/threads` mount). */\n  syncUrl: string;\n  /** Thread ID the statewire session attaches to. */\n  threadId: string;\n  /** True only for a never-started local chat. Existing (or pre-assigned)\n   *  threads load until their server snapshot arrives. */\n  isNewChat?: boolean;\n  /** API key for authentication. Used when no auth token is provided. */\n  apiKey?: string;\n  /** Auth token. Takes priority over apiKey. */\n  token?: string | null;\n  /** Resolve the latest token immediately before a request (for expiring\n   *  clients). Called with `{ force: true }` right after the host refused the\n   *  previous credential (the transport's `staleAuth`), so a caching getter\n   *  mints a fresh token instead of returning the refused one. */\n  getToken?: AthenaStatewireTokenGetter;\n  /**\n   * Per-provider LRU of each thread's last wire state. A switch back to a\n   * remembered thread mounts with that snapshot and projects ready on the\n   * first frame instead of a loading treatment; the attach snapshot then\n   * replaces it. Owned above the per-thread mount so it survives switches.\n   */\n  snapshotCache?: DeepAgentThreadSnapshotCache;\n  /**\n   * The message window declared on the attach (see\n   * {@link ATHENA_SDK_MESSAGE_WINDOW}, the default). `false` keeps the full\n   * snapshot for a host that renders no history loader.\n   */\n  messageWindow?: DeepAgentMessageWindowDeclaration | false;\n  /**\n   * Full tool outputs fetched back for a windowed wire's cut tool messages;\n   * the thread re-converts when one lands. `AthenaProvider` owns one per\n   * provider and hands the same store to `StatewireHistoryEdge`.\n   */\n  toolOutputs?: DeepAgentToolOutputStore;\n  /** LLM model identifier. Defaults to the deep-agent default model. */\n  model?: string;\n  /** Agent selector: only `collab_agent:<asset_id>` refs are accepted (the run\n   *  executes AS that published collab agent). Any other non-empty value\n   *  throws — see `resolveAgentProp`. */\n  agent?: string;\n  /** Collab-agent channel id selecting that channel's overrides. */\n  channel?: string;\n  /** Backend toolkit IDs to enable. */\n  tools?: string[];\n  /** Frontend tool IDs to include in enabled_tools. */\n  frontendToolIds?: string[];\n  /** Frontend tools registered on the assistant client. Tools with a local\n   *  `execute` are also declared as `client_tools` and executed through the\n   *  statewire client-tool bridge. */\n  frontendToolkit?: Toolkit;\n  /** Asset IDs to include in the workbench. */\n  workbench?: string[];\n  /** Knowledge base IDs for RAG context. */\n  knowledgeBase?: string[];\n  /** System prompt override. */\n  systemPrompt?: string;\n  /** Client app identifier for session filtering. Sent as app_id in runConfig.custom. */\n  appId?: string;\n  /** Additional fields merged into runConfig.custom. */\n  extraRunConfig?: Record<string, unknown>;\n  /** Called on statewire transport errors (send rejections, stream failures). */\n  onError?: (error: Error) => void;\n  /** Projected connection status changes (deduped; null on unmount). */\n  onConnectionChange?: UseDeepAgentThreadOptions['onConnectionChange'];\n  /** Raw connection observer — carries the transport's reconnect handle. */\n  onRawConnectionChange?: UseDeepAgentThreadOptions['onRawConnectionChange'];\n  /** Notified when a run starts/stops. */\n  onRunningChange?: UseDeepAgentThreadOptions['onRunningChange'];\n}\n\nconst EMPTY_TOOLKIT: Toolkit = {};\nconst EMPTY_TOOL_IDS: string[] = [];\n\n/** The client tools derived from the runtime's frontend toolkit — exposed so\n *  the provider can mount the client-tool bridge with the same set. */\nexport function useStatewireClientTools(\n  frontendToolkit: Toolkit | undefined,\n): RegisteredClientTool[] {\n  return useMemo(\n    () => collectStatewireClientTools(frontendToolkit ?? EMPTY_TOOLKIT),\n    [frontendToolkit],\n  );\n}\n\n/**\n * Statewire runtime for the Athena SDK — a thin shim over the shared\n * `@athenaintel/agent-runtime` `useDeepAgentRuntime`: it attaches to the\n * agora-hosted deep-agent thread at `${syncUrl}/${threadId}` and returns the\n * `AssistantClient` to mount via `AuiProvider` — the same integration shape as\n * the Olympus, Chrome extension, Office, and mobile statewire hosts.\n *\n * Auth: a token (resolved live through `getToken` when provided) rides\n * `Authorization: Bearer`, and an API key falls back to `X-API-KEY` — both\n * accepted by the statewire host.\n */\nexport function useAthenaStatewireRuntime(\n  config: AthenaStatewireRuntimeConfig,\n): AssistantClient {\n  const {\n    syncUrl,\n    threadId,\n    isNewChat = false,\n    apiKey,\n    token,\n    getToken,\n    model,\n    agent,\n    channel,\n    tools = EMPTY_TOOL_IDS,\n    frontendToolIds = EMPTY_TOOL_IDS,\n    frontendToolkit = EMPTY_TOOLKIT,\n    workbench,\n    knowledgeBase,\n    systemPrompt,\n    appId,\n    extraRunConfig,\n    snapshotCache,\n    messageWindow = ATHENA_SDK_MESSAGE_WINDOW,\n    toolOutputs,\n    onError,\n    onConnectionChange,\n    onRawConnectionChange,\n    onRunningChange,\n  } = config;\n\n  // Fail loud at mount, not at first send: the statewire host always runs the\n  // Athena deep agent, so an `agent` outside the collab_agent namespace can\n  // never apply. Throwing here (render time) is what makes a misconfigured\n  // integration visible instead of quietly answering as the wrong agent.\n  resolveAgentProp({ agent });\n\n  const clientTools = useStatewireClientTools(frontendToolkit);\n\n  // The persisted command lane is keyed by WHO is signed in as well as by host\n  // and thread (see `statewireSessionKey`).\n  const authContext = useContext(AthenaAuthContext);\n  const principal = authContext?.user?.userId ?? '';\n\n  // Attach → first server snapshot span, keyed per thread attach.\n  const attachSpanRef = useRef<ReturnType<AthenaDiagnosticsSpanStarter> | null>(null);\n  const attachThreadRef = useRef<string | null>(null);\n  if (attachThreadRef.current !== threadId) {\n    attachThreadRef.current = threadId;\n    attachSpanRef.current = athenaDiagnostics.span(\n      `statewire.attach:${threadId}`,\n      'statewire.attach.start',\n      { thread_id: threadId, is_new_chat: isNewChat },\n    );\n  }\n\n  const auiTools = useMemo(() => Tools({ toolkit: frontendToolkit }), [frontendToolkit]);\n  // Web client for the shared runtime core (a `use*` name so the\n  // rules-of-hooks lint sees the `useAui` call inside a custom hook; the core\n  // invokes it unconditionally every render).\n  const useSdkClient = (thread: DeepAgentThreadElement) => useAui({ thread, tools: auiTools });\n\n  return useDeepAgentRuntime({\n    surface: 'AthenaSDK',\n    threadId,\n    baseUrl: syncUrl,\n    // Option closures are re-read per render by the core, so credential\n    // rotation (new `token`/`getToken`/`apiKey` props) reaches the next\n    // request without remounting the thread. The transport's `staleAuth`\n    // (true right after a refused credential) is forwarded as `force`.\n    headers: (ctx) => resolveStatewireAuthHeaders({ apiKey, token, getToken }, ctx),\n    isNewChat,\n    // Queued entries render in the SDK's queue panel, so only the steer lane\n    // projects into the message tail.\n    laneProjection: 'steer-only',\n    // Durable session: a reload resumes the lane and resends whatever the\n    // server has not marked durable. Scoped by host AND principal — a thread\n    // id is only meaningful against the backend that minted it, and a stored\n    // lane must never resend against another signed-in user. (Consumers\n    // server-render this SDK; the core's availability probe keeps those\n    // sessions process-local, as before the seam existed.)\n    session: {\n      kind: 'local-storage',\n      key: (id) => statewireSessionKey({ syncUrl, principal, threadId: id }),\n    },\n    snapshotCache,\n    // Windowed hello (see `ATHENA_SDK_MESSAGE_WINDOW`): the tail of the\n    // transcript instead of every message; the chat UI's history edge pages\n    // older ranges in and fetches cut tool outputs into `toolOutputs`.\n    messageWindow,\n    toolOutputs,\n    capabilities: { edit: true, reload: true, continue: true },\n    useClient: useSdkClient,\n    onStateChange: () => {\n      // First snapshot for this attach ends the attach span (time-to-history).\n      const endSpan = attachSpanRef.current;\n      if (endSpan) {\n        attachSpanRef.current = null;\n        endSpan('statewire.snapshot', { data: { thread_id: threadId } });\n      }\n    },\n    onConnectionChange: (connection) => {\n      athenaDiagnostics.gauge('statewire.connection', connection?.status ?? null);\n      if (connection?.status === 'stopped') {\n        athenaDiagnostics.emit('statewire.connection', {\n          level: 'warn',\n          data: {\n            status: connection.status,\n            reason: connection.reason,\n            message: connection.message,\n          },\n        });\n      }\n      onConnectionChange?.(connection);\n    },\n    onRawConnectionChange,\n    onRunningChange,\n    // The runConfig getter is pulled at command-send time through the core's\n    // per-render ref, so it reads the latest props — consumers commonly pass\n    // fresh array literals per render, which must not thrash the registration\n    // (no `key`: the provider registers once per client).\n    runConfig: {\n      get: () =>\n        buildStatewireRunConfig({\n          model,\n          agent,\n          channel,\n          tools,\n          frontendToolIds,\n          workbench,\n          knowledgeBase,\n          systemPrompt,\n          appId,\n          extraRunConfig,\n          clientTools: statewireClientToolWireEntries(clientTools),\n        }),\n    },\n    onError: (error) => {\n      if (!isStatewireChannelTeardown(error)) {\n        athenaDiagnostics.error(\n          'statewire.error',\n          error,\n          {\n            code: 'statewire_rejected',\n            message: 'The statewire host rejected a command',\n            hint: 'Inspect error.detail — agora rejections carry a structured {code, message}.',\n          },\n          { thread_id: threadId },\n        );\n      }\n      if (onError) {\n        onError(error);\n        return;\n      }\n      logUnhandledStatewireError('AthenaSDK', error);\n    },\n  });\n}\n"],"names":[],"mappings":"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"}