@athenaintel/react 0.28.1 → 0.32.0

package/dist/provider/AthenaProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"AthenaProvider.js","sources":["../../src/provider/AthenaProvider.tsx"],"sourcesContent":["import { AuiProvider, useAui } from '@assistant-ui/react';\nimport {\n  useCallback,\n  useContext,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useReducer,\n  useRef,\n  useState,\n  type ReactNode,\n} from 'react';\nimport type { AssistantClient, 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 { AthenaCredentialSourceContext } from '../auth/AthenaCredentialSourceContext';\nimport {\n  createAthenaCredentialSource,\n  type AthenaCredentialInputs,\n} from '../auth/credential-source';\nimport { useRestartAfterAuthRefusal } from '../runtime/auth-refusal-restart';\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 {\n  ComposerHandoffContext,\n  clearComposerHandoff,\n  createComposerHandoffStore,\n  drainComposerHandoff,\n  useComposerHandoffStore,\n  useComposerReady,\n} from '../composer/composer-handoff';\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 { AthenaSdkError } from '../diagnostics/errors';\nimport {\n  backendDeclaredFrontendToolIds,\n  resolveClientToolSurface,\n} from '../chat/statewire-client-tools';\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  useAthenaStatewireThreadId,\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 { AthenaThemeStyleContext } from './theme-style-context';\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  /** Ask the thread list for live pull-request state on each session\n   *  (`include_pull_requests`), which `SessionList` renders as chips.\n   *  Defaults to `true` in thread-list mode; turn it off in a host that never\n   *  shows them to spare the server the lookup. */\n  threadListIncludePullRequests?: 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  getToken,\n  enabledToolkits,\n  linkClicks,\n  citationLinks,\n}: {\n  backendUrl: string;\n  appUrl: string;\n  apiKey?: string;\n  token?: string | null;\n  getToken?: AthenaStatewireTokenGetter;\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  const getTokenRef = useRef(getToken);\n  getTokenRef.current = getToken;\n\n  return useMemo(\n    () => ({\n      backendUrl,\n      appUrl,\n      apiKey,\n      enabledToolkits,\n      get token() {\n        return tokenRef.current;\n      },\n      get getToken() {\n        return getTokenRef.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/**\n * Delivers composer writes that were made before this mount was ready\n * (`useAppendToComposer` / `useSendMessage` queue them in the provider-level\n * store, which outlives the keyed per-thread mount). Lives under the\n * `AuiProvider` so it can read the thread's own loading state.\n */\nfunction ComposerHandoffDrain(): null {\n  const aui = useAui();\n  const store = useComposerHandoffStore();\n  const threadId = useContext(AthenaStatewireThreadIdContext);\n  const ready = useComposerReady();\n  useEffect(() => {\n    if (!ready || !store) return;\n    // Writes bound to another thread are dropped here, not applied.\n    drainComposerHandoff({ store, target: aui, threadId });\n  }, [aui, ready, store, threadId]);\n  return null;\n}\n\n// ─── Standalone Mode ──────────────────────────────────────────────────\n\n/** Everything the per-thread runtime needs to attach and run a thread. */\ninterface AthenaStatewireRuntimeProps {\n  syncUrl: 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  /** 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}\n\ninterface AthenaStatewireStandaloneProps extends AthenaStatewireRuntimeProps {\n  children: ReactNode;\n  backendUrl: string;\n  appUrl: string;\n  threadId?: string;\n  /**\n   * Thread-list mode. The list owns the active id and alone knows whether the\n   * backend has listed it yet: `isNewChat` overrides the \"new chat\"\n   * derivation (the list mints ids for brand-new chats, which must still load\n   * as new), and the scope publishes `AthenaThreadIdContext` — the backend id,\n   * withheld while the chat is unpersisted. Absent outside thread-list mode,\n   * where that context stays untouched.\n   */\n  threadList?: { isNewChat: boolean };\n  linkClicks?: AthenaLinkClickOptions;\n  citationLinks?: AthenaCitationLinkOptions;\n}\n\n/**\n * What one per-thread runtime mount hands to the stable scope around the\n * host's children: the assistant client attached to `threadId` and the\n * transport lifecycle observed on that attach. Published as ONE value so the\n * scope can never pair a thread's id with another thread's client.\n */\ninterface AthenaStatewireRuntimeSnapshot {\n  threadId: string;\n  isNewChat: boolean;\n  client: AssistantClient;\n  lifecycle: AthenaStatewireLifecycleState;\n}\n\n/**\n * The per-thread half of the statewire lane: owns the runtime hook (statewire\n * client, pending-message lane, `useAui` client) and the lifecycle reducer\n * behind the connection/error banners, and renders nothing itself. Mounted\n * under `key={threadId}` so a switch — or a new chat — gets a fresh instance\n * of everything here, exactly as when the whole provider subtree was keyed,\n * without remounting the host's UI.\n *\n * An assistant client's readable state only advances when its tap fibers\n * commit (in effects), so an in-place `threadId` change on one mounted hook\n * would leave a commit in which the new id is published but `useAuiState`\n * still reads the previous thread's committed state; a fresh mount publishes\n * its own state on its first render. That is why the runtime is remounted per\n * thread rather than switched in place.\n *\n * The snapshot is published from a layout effect: React flushes the state\n * update a layout effect schedules synchronously, before the browser paints,\n * so the scope re-renders against this client in the same task as this\n * mount's commit — the previous client is never painted under the new id.\n */\nfunction AthenaStatewireRuntimeMount({\n  threadId,\n  isNewChat,\n  onPublish,\n  syncUrl,\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  snapshotCache,\n  toolOutputs,\n}: AthenaStatewireRuntimeProps & {\n  threadId: string;\n  isNewChat: boolean;\n  onPublish: (snapshot: AthenaStatewireRuntimeSnapshot) => void;\n}): null {\n  const [lifecycle, dispatchLifecycle] = useReducer(\n    statewireLifecycleReducer,\n    initialStatewireLifecycle,\n  );\n\n  const client = useAthenaStatewireRuntime({\n    syncUrl,\n    threadId,\n    isNewChat,\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  // A thread the host stopped for refusing its credential reconnects as soon\n  // as a new token exists, instead of waiting for a retry click.\n  useRestartAfterAuthRefusal({\n    connection: lifecycle.connection,\n    reconnect: lifecycle.reconnect,\n  });\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 snapshot = useMemo<AthenaStatewireRuntimeSnapshot>(\n    () => ({ threadId, isNewChat, client, lifecycle: lifecycleValue }),\n    [threadId, isNewChat, client, lifecycleValue],\n  );\n  useLayoutEffect(() => {\n    onPublish(snapshot);\n  }, [onPublish, snapshot]);\n\n  return null;\n}\n\n/**\n * The stable half of the statewire lane: the scope around the host's\n * `children`. It mounts one `AthenaStatewireRuntimeMount` per thread beside\n * them and provides whatever that mount last published — client, thread ids,\n * lifecycle — so a thread switch swaps the client under the host's UI instead\n * of remounting it. Until the first mount has published, the children are\n * withheld: they need a client, and the first publication lands in the same\n * task as the mount's commit.\n *\n * A server render runs no effects, so it would withhold the children too.\n * That changes nothing today: `AthenaProvider` renders `null` until the parent\n * bridge reports ready, which only ever happens in an effect (`useParentBridge`\n * starts `ready: false`), so the SDK has never server-rendered the host UI —\n * it hydrates it. A future SSR-ready bridge would need the first publication\n * to happen in render as well.\n */\nfunction AthenaStatewireStandalone({\n  children,\n  backendUrl,\n  appUrl,\n  threadId: threadIdProp,\n  threadList,\n  linkClicks,\n  citationLinks,\n  ...runtimeProps\n}: AthenaStatewireStandaloneProps) {\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  const isNewChat = threadList?.isNewChat ?? !threadIdProp;\n\n  const [published, setPublished] = useState<AthenaStatewireRuntimeSnapshot | null>(null);\n\n  const clientTools = useStatewireClientTools(runtimeProps.frontendTools);\n\n  // The runtime binds `client_tools` only for a recognised `app_id`; with none\n  // it drops every declaration without telling the client, and the model then\n  // sees \"not a valid tool\". Say so here, once per configuration, as an error\n  // so it reaches `onError` and the console even with diagnostics off.\n  const clientToolNamesKey = clientTools.map((tool) => tool.definition.name).join(',');\n  const clientToolAppId = runtimeProps.appId;\n  useEffect(() => {\n    if (clientTools.length === 0 || resolveClientToolSurface(clientToolAppId) !== null) return;\n    athenaDiagnostics.emit('sdk.config.warning', {\n      level: 'error',\n      error: new AthenaSdkError({\n        code: 'config_invalid',\n        message: `frontendTools with an execute() need a recognised appId; ${clientTools.length} tool(s) will not be bound.`,\n        hint:\n          \"Pass appId={publicAppId} on <AthenaProvider> (a computer-asset app reads it from athena-public-config.json as computer_asset_<uuid>). Without it the deep-agent runtime drops every client tool.\",\n        context: { appId: clientToolAppId ?? null, tools: clientToolNamesKey.split(',') },\n      }),\n      data: { appId: clientToolAppId ?? null, tools: clientToolNamesKey.split(',') },\n    });\n    // clientToolNamesKey is the value-stable form of the tool list.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [clientToolAppId, clientToolNamesKey]);\n\n  const athenaConfig = useAthenaConfigValue({\n    backendUrl,\n    appUrl,\n    apiKey: runtimeProps.apiKey,\n    token: runtimeProps.token,\n    getToken: runtimeProps.getToken,\n    enabledToolkits: runtimeProps.tools,\n    linkClicks,\n    citationLinks,\n  });\n\n  const scope = published && (\n    <AuiProvider value={published.client}>\n      <AthenaContext.Provider value={athenaConfig}>\n        <AthenaStatewireThreadIdContext.Provider value={published.threadId}>\n          <AthenaStatewireLifecycleContext.Provider value={published.lifecycle}>\n            <DeepAgentConnectionContext.Provider value={published.lifecycle.connection}>\n              <StatewireToolOutputsContext.Provider value={runtimeProps.toolOutputs}>\n                <TooltipProvider>\n                  <StatewireClientToolBridge tools={clientTools} threadId={published.threadId} />\n                  <ComposerHandoffDrain />\n                  {children}\n                </TooltipProvider>\n              </StatewireToolOutputsContext.Provider>\n            </DeepAgentConnectionContext.Provider>\n          </AthenaStatewireLifecycleContext.Provider>\n        </AthenaStatewireThreadIdContext.Provider>\n      </AthenaContext.Provider>\n    </AuiProvider>\n  );\n\n  return (\n    <>\n      <AthenaStatewireRuntimeMount\n        key={threadId}\n        threadId={threadId}\n        isNewChat={isNewChat}\n        onPublish={setPublished}\n        {...runtimeProps}\n      />\n      {/* The backend id rides the same snapshot as the client, so\n          history-gated UI (e.g. the loading overlay) never judges one thread\n          by another's state; it is undefined for a never-started chat, which\n          must not read as pending history. */}\n      {threadList && published ? (\n        <AthenaThreadIdContext.Provider\n          value={published.isNewChat ? undefined : published.threadId}\n        >\n          {scope}\n        </AthenaThreadIdContext.Provider>\n      ) : (\n        scope\n      )}\n    </>\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  includePullRequests,\n  ...standaloneProps\n}: Omit<AthenaStatewireStandaloneProps, 'threadId' | 'threadList'> & {\n  initialThreadId?: string;\n  includePullRequests?: boolean;\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      includePullRequests={includePullRequests}\n      // The list's hover prefetch warms the same cache the active-thread\n      // mount seeds from, so a hovered-then-selected session paints at once.\n      snapshotCache={standaloneProps.snapshotCache}\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<AthenaStatewireStandaloneProps, 'threadId' | 'threadList'>) {\n  const list = useAthenaStatewireThreadList();\n  if (!list) return null;\n\n  // Not keyed: the scope keeps the host's children mounted across a switch\n  // and remounts only its per-thread runtime against the new\n  // `…/v2/threads/{id}` URL (see `AthenaStatewireStandalone`).\n  return (\n    <AthenaStatewireStandalone\n      threadId={list.activeThreadId}\n      threadList={{ isNewChat: list.isNewChat }}\n      {...standaloneProps}\n    >\n      <StatewireThreadTitlePoller />\n      <AssetPanelThreadSync />\n      {children}\n    </AthenaStatewireStandalone>\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 attached thread'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. Read from the statewire scope (the\n * id published with its client) rather than the list's selection, which runs\n * one commit ahead of the client during a switch.\n */\nfunction AssetPanelThreadSync() {\n  const threadId = useAthenaStatewireThreadId();\n  const setCurrentThread = useAssetPanelStore((s) => s.setCurrentThread);\n\n  useEffect(() => {\n    setCurrentThread(threadId);\n  }, [threadId, 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  threadListIncludePullRequests = true,\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  // Only declarations WITHOUT a local `execute` ride `enabled_tools`: they name\n  // registry tools the backend binds itself. Executable tools are declared\n  // through `client_tools` instead — listing them here too would switch on a\n  // backend toolkit owning a tool of the same name, and the backend wins that\n  // collision (the client tool is silently dropped).\n  const frontendToolNames = useMemo(\n    () => backendDeclaredFrontendToolIds(frontendTools),\n    [frontendTools],\n  );\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  // Composer writes that arrive before the per-thread mount is ready wait\n  // here, above that mount, so a thread-list remount cannot drop them.\n  const [composerHandoff] = useState(createComposerHandoffStore);\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    // A draft or send queued under the previous identity must never land in\n    // this one's composer.\n    clearComposerHandoff({ store: composerHandoff, reason: 'the signed-in identity changed' });\n  }, [snapshotCache, toolOutputs, composerHandoff, principal, configuredApiKey]);\n  // Nothing drains after the provider is gone: settle what still waits so no\n  // `useSendMessage` caller hangs.\n  useEffect(\n    () => () => clearComposerHandoff({ store: composerHandoff, reason: 'the chat provider unmounted' }),\n    [composerHandoff],\n  );\n\n  const effectiveToken = configuredToken !== undefined\n    ? configuredToken\n    : authProviderToken ?? bridge.token;\n\n  // One credential source for every network path below: it presents the\n  // token chosen above and renews it the way its origin can. A host's own\n  // `getToken` owns renewal; a host's static `token` never renews; a sign-in\n  // provider's token renews through its getter (PropelAuth, SSO); a host\n  // bridge token through the bridge (a Marathon re-mint, or the parent\n  // window's next `athena-auth`).\n  const authProviderGetToken = authContext?.getToken;\n  const credentialInputsRef = useRef<AthenaCredentialInputs>({ token: null });\n  credentialInputsRef.current = {\n    hostGetToken: configuredGetToken,\n    token: effectiveToken,\n    renew:\n      configuredToken !== undefined\n        ? undefined\n        : authProviderToken !== null\n          ? authProviderGetToken\n            ? async ({ force }) => (await authProviderGetToken({ force })) ?? null\n            : undefined\n          : bridge.token !== null\n            ? bridge.renewToken\n            : undefined,\n  };\n  const [credentials] = useState(() =>\n    createAthenaCredentialSource(() => credentialInputsRef.current),\n  );\n  useEffect(() => {\n    credentials.notifyTokenChanged();\n  }, [credentials, effectiveToken]);\n  // Only a provider that holds a token (or a host getter) hands one out, so\n  // \"has credentials\" checks downstream keep meaning what they did.\n  const credentialGetToken =\n    configuredGetToken !== undefined || effectiveToken ? credentials.getToken : undefined;\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  // An iframe bridge falls back after a short timeout (2s) if no parent\n  // answers; a Marathon mint is ready once its bounded retry cycle ends.\n  if (!bridge.ready) {\n    return null;\n  }\n\n  // Fail closed when the host's mint gave up and nothing else can\n  // authenticate: the chat would otherwise attach with no credential (and to\n  // the environment preset, since no host minted a mount). The bridge has\n  // already reported the typed `auth_bridge_failed` / `auth_bridge_timeout`\n  // error to `onError`; remounting the provider starts a new bounded mint.\n  if (\n    bridge.error &&\n    !effectiveToken &&\n    configuredGetToken === undefined &&\n    !configuredApiKey\n  ) {\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: credentialGetToken,\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\n      {...statewireProps}\n      initialThreadId={threadIdProp}\n      includePullRequests={threadListIncludePullRequests}\n    >\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        <ComposerHandoffContext.Provider value={composerHandoff}>\n          <AthenaThemeStyleContext.Provider value={themeStyleVars}>\n            <AthenaCredentialSourceContext.Provider value={credentials}>\n              {inner}\n            </AthenaCredentialSourceContext.Provider>\n          </AthenaThemeStyleContext.Provider>\n        </ComposerHandoffContext.Provider>\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 { AuiConfig, AuiProvider, useAui } from '@assistant-ui/react';\nimport {\n  useCallback,\n  useContext,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useReducer,\n  useRef,\n  useState,\n  type ReactNode,\n} from 'react';\nimport type { AssistantClient, Toolkit } from '@assistant-ui/react';\nimport {\n  createDeepAgentThreadSnapshotCache,\n  createDeepAgentToolOutputStore,\n  DeepAgentConnectionContext,\n  type DeepAgentThreadSnapshotCache,\n  type DeepAgentToolOutputStore,\n  readServerConfig,\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 { AthenaCredentialSourceContext } from '../auth/AthenaCredentialSourceContext';\nimport {\n  createAthenaCredentialSource,\n  type AthenaCredentialInputs,\n} from '../auth/credential-source';\nimport { useRestartAfterAuthRefusal } from '../runtime/auth-refusal-restart';\nimport {\n  useAthenaStatewireRuntime,\n  useStatewireClientTools,\n} from '../runtime/useAthenaStatewireRuntime';\nimport {\n  athenaStatewireErrorNotice,\n  type AthenaStatewireLifecycleState,\n  initialStatewireLifecycle,\n  isStatewireChannelLive,\n  statewireLifecycleReducer,\n} from '../runtime/statewire-lifecycle';\nimport type { AthenaStatewireTokenGetter } from '../runtime/statewire-auth-headers';\nimport { effectiveStatewireModel, resolveAgentProp } from '../runtime/statewire-run-config';\nimport { mintThreadId } from '../threads/mint-thread-id';\nimport { AthenaStatewireLifecycleContext } from './statewire-lifecycle-context';\nimport {\n  ComposerHandoffContext,\n  clearComposerHandoff,\n  createComposerHandoffStore,\n  drainComposerHandoff,\n  useComposerHandoffStore,\n  useComposerReady,\n} from '../composer/composer-handoff';\nimport { StatewireToolOutputsContext } from './statewire-window-context';\nimport { StatewireClientToolBridge } from '../chat/StatewireClientToolBridge';\nimport { StatewireModelLaneSync } from '../runtime/StatewireModelLaneSync';\nimport {\n  type AthenaStatewireServerLane,\n  AthenaStatewireServerLaneContext,\n  nextServerLane,\n  STATEWIRE_SERVER_LANE_PENDING,\n} from '../runtime/statewire-server-lane-context';\nimport {\n  athenaDiagnostics,\n  debugPropToDiagnosticsConfig,\n  installAthenaDiagnosticsGlobal,\n  type AthenaDiagnosticEvent,\n  type AthenaDiagnosticLevel,\n  type AthenaDiagnosticsConfig,\n} from '../diagnostics/athena-diagnostics';\nimport { AthenaSdkError } from '../diagnostics/errors';\nimport {\n  backendDeclaredFrontendToolIds,\n  resolveClientToolSurface,\n} from '../chat/statewire-client-tools';\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  useAthenaStatewireThreadId,\n} from '../threads/thread-id-context';\nimport {\n  AthenaStatewireThreadListContext,\n  AthenaStatewireThreadListProvider,\n  StatewireThreadTitlePoller,\n  useAthenaStatewireThreadList,\n} from '../threads/statewire-thread-list';\nimport { type AssetOpener, useAssetPanelStore } from '../assets/asset-panel-store';\nimport { themeToStyleVars, type AthenaTheme } from '../theme';\nimport { AthenaThemeStyleContext } from './theme-style-context';\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   *\n   *  Changing it while a thread is open applies to that thread's next turn:\n   *  on a thread whose server config already exists the SDK writes the new\n   *  model there (`undefined` clears it, so the agent's model applies). The\n   *  value a thread is opened with is not written; read the thread's own\n   *  model with `useAthenaThreadModel`. */\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  /**\n   * With `threadId` and no thread list: the host minted that id\n   * (`mintThreadId`) for a chat that has not started, which attaches as a new\n   * chat until this turns false. Turn it false once the backend lists the\n   * thread (a host showing several chats keeps each one's id across a remount\n   * this way). Default `false`: a given `threadId` names an existing thread.\n   */\n  threadIsNew?: boolean;\n\n  /** Enable thread list management (sidebar thread switching). */\n  enableThreadList?: boolean;\n\n  /** Ask the thread list for live pull-request state on each session\n   *  (`include_pull_requests`), which `SessionList` renders as chips.\n   *  Defaults to `true` in thread-list mode; turn it off in a host that never\n   *  shows them to spare the server the lookup. */\n  threadListIncludePullRequests?: boolean;\n\n  /** Other client apps whose sessions the thread list shows beside this\n   *  provider's own (`appId`), e.g. a desktop app listing the sessions of the\n   *  desktop app it replaced. New sessions are still tagged `appId`. */\n  threadListAdditionalAppIds?: readonly string[];\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  /** Opens assets the host's own way (a desktop app's tabs, a route of its own). While set, every\n   *  request to open an asset goes here before the SDK's asset panel: a tool card's Open, an\n   *  Athena citation or asset link in a message (which the SDK then intercepts as it does with an\n   *  asset panel mounted), and the auto-open after a tool created or touched an asset\n   *  (`origin: 'auto'`). Return `false` to let the panel open it as before. */\n  onOpenAsset?: AssetOpener;\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  getToken,\n  enabledToolkits,\n  linkClicks,\n  citationLinks,\n}: {\n  backendUrl: string;\n  appUrl: string;\n  apiKey?: string;\n  token?: string | null;\n  getToken?: AthenaStatewireTokenGetter;\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  const getTokenRef = useRef(getToken);\n  getTokenRef.current = getToken;\n\n  return useMemo(\n    () => ({\n      backendUrl,\n      appUrl,\n      apiKey,\n      enabledToolkits,\n      get token() {\n        return tokenRef.current;\n      },\n      get getToken() {\n        return getTokenRef.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/**\n * Delivers composer writes that were made before this mount was ready\n * (`useAppendToComposer` / `useSendMessage` queue them in the provider-level\n * store, which outlives the keyed per-thread mount). Lives under the\n * `AuiProvider` so it can read the thread's own loading state.\n */\nfunction ComposerHandoffDrain(): null {\n  const aui = useAui();\n  const store = useComposerHandoffStore();\n  const threadId = useContext(AthenaStatewireThreadIdContext);\n  const ready = useComposerReady();\n  useEffect(() => {\n    if (!ready || !store) return;\n    // Writes bound to another thread are dropped here, not applied.\n    drainComposerHandoff({ store, target: aui, threadId });\n  }, [aui, ready, store, threadId]);\n  return null;\n}\n\n// ─── Standalone Mode ──────────────────────────────────────────────────\n\n/** Everything the per-thread runtime needs to attach and run a thread. */\ninterface AthenaStatewireRuntimeProps {\n  syncUrl: 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  /** 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}\n\ninterface AthenaStatewireStandaloneProps extends AthenaStatewireRuntimeProps {\n  children: ReactNode;\n  backendUrl: string;\n  appUrl: string;\n  threadId?: string;\n  /** `AthenaProviderProps.threadIsNew`. */\n  threadIsNew?: boolean;\n  /**\n   * Thread-list mode. The list owns the active id and alone knows whether the\n   * backend has listed it yet: `isNewChat` overrides the \"new chat\"\n   * derivation (the list mints ids for brand-new chats, which must still load\n   * as new), and the scope publishes `AthenaThreadIdContext` — the backend id,\n   * withheld while the chat is unpersisted. Absent outside thread-list mode,\n   * where that context stays untouched.\n   */\n  threadList?: { isNewChat: boolean };\n  linkClicks?: AthenaLinkClickOptions;\n  citationLinks?: AthenaCitationLinkOptions;\n}\n\n/**\n * What one per-thread runtime mount hands to the stable scope around the\n * host's children: the assistant client attached to `threadId` and the\n * transport lifecycle observed on that attach. Published as ONE value so the\n * scope can never pair a thread's id with another thread's client.\n */\ninterface AthenaStatewireRuntimeSnapshot {\n  threadId: string;\n  isNewChat: boolean;\n  client: AssistantClient;\n  lifecycle: AthenaStatewireLifecycleState;\n  /** The thread's server config lane as the host sent it on this attach. */\n  serverLane: AthenaStatewireServerLane;\n  /**\n   * The model this thread's sends carry (`model` under an `extraRunConfig`\n   * override), published with the thread it applies to: during a switch the\n   * scope still holds the outgoing thread for a render while the host's props\n   * already describe the incoming one, and pairing them would write the new\n   * pick into the session being left.\n   */\n  model: string | undefined;\n}\n\n/**\n * The per-thread half of the statewire lane: owns the runtime hook (statewire\n * client, pending-message lane, `useAui` client) and the lifecycle reducer\n * behind the connection/error banners, and renders nothing itself. Mounted\n * under `key={threadId}` so a switch — or a new chat — gets a fresh instance\n * of everything here, exactly as when the whole provider subtree was keyed,\n * without remounting the host's UI.\n *\n * An assistant client's readable state only advances when its tap fibers\n * commit (in effects), so an in-place `threadId` change on one mounted hook\n * would leave a commit in which the new id is published but `useAuiState`\n * still reads the previous thread's committed state; a fresh mount publishes\n * its own state on its first render. That is why the runtime is remounted per\n * thread rather than switched in place.\n *\n * The snapshot is published from a layout effect: React flushes the state\n * update a layout effect schedules synchronously, before the browser paints,\n * so the scope re-renders against this client in the same task as this\n * mount's commit — the previous client is never painted under the new id.\n */\nfunction AthenaStatewireRuntimeMount({\n  threadId,\n  isNewChat,\n  onPublish,\n  syncUrl,\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  snapshotCache,\n  toolOutputs,\n}: AthenaStatewireRuntimeProps & {\n  threadId: string;\n  isNewChat: boolean;\n  onPublish: (snapshot: AthenaStatewireRuntimeSnapshot) => void;\n}): null {\n  const [lifecycle, dispatchLifecycle] = useReducer(\n    statewireLifecycleReducer,\n    initialStatewireLifecycle,\n  );\n  const [serverLane, setServerLane] = useState<AthenaStatewireServerLane>(\n    STATEWIRE_SERVER_LANE_PENDING,\n  );\n\n  const client = useAthenaStatewireRuntime({\n    syncUrl,\n    threadId,\n    isNewChat,\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    // The lane as the host holds it: anything that decides from the lane waits\n    // for this, never the placeholder or remembered snapshot rendered before.\n    onServerState: (state) => {\n      const config = readServerConfig(state);\n      setServerLane((previous) => nextServerLane({ previous, config }));\n    },\n  });\n\n  // A thread the host stopped for refusing its credential reconnects as soon\n  // as a new token exists, instead of waiting for a retry click.\n  useRestartAfterAuthRefusal({\n    connection: lifecycle.connection,\n    reconnect: lifecycle.reconnect,\n  });\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 sendModel = effectiveStatewireModel({ model, extraRunConfig });\n  const snapshot = useMemo<AthenaStatewireRuntimeSnapshot>(\n    () => ({\n      threadId,\n      isNewChat,\n      client,\n      lifecycle: lifecycleValue,\n      serverLane,\n      model: sendModel,\n    }),\n    [threadId, isNewChat, client, lifecycleValue, serverLane, sendModel],\n  );\n  useLayoutEffect(() => {\n    onPublish(snapshot);\n  }, [onPublish, snapshot]);\n\n  return null;\n}\n\n/**\n * The stable half of the statewire lane: the scope around the host's\n * `children`. It mounts one `AthenaStatewireRuntimeMount` per thread beside\n * them and provides whatever that mount last published — client, thread ids,\n * lifecycle — so a thread switch swaps the client under the host's UI instead\n * of remounting it. Until the first mount has published, the children are\n * withheld: they need a client, and the first publication lands in the same\n * task as the mount's commit.\n *\n * A server render runs no effects, so it would withhold the children too.\n * That changes nothing today: `AthenaProvider` renders `null` until the parent\n * bridge reports ready, which only ever happens in an effect (`useParentBridge`\n * starts `ready: false`), so the SDK has never server-rendered the host UI —\n * it hydrates it. A future SSR-ready bridge would need the first publication\n * to happen in render as well.\n */\nfunction AthenaStatewireStandalone({\n  children,\n  backendUrl,\n  appUrl,\n  threadId: threadIdProp,\n  threadIsNew = false,\n  threadList,\n  linkClicks,\n  citationLinks,\n  ...runtimeProps\n}: AthenaStatewireStandaloneProps) {\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  const isNewChat = threadList?.isNewChat ?? (!threadIdProp || threadIsNew);\n\n  const [published, setPublished] = useState<AthenaStatewireRuntimeSnapshot | null>(null);\n\n  const clientTools = useStatewireClientTools(runtimeProps.frontendTools);\n\n  // The runtime binds `client_tools` only for a recognised `app_id`; with none\n  // it drops every declaration without telling the client, and the model then\n  // sees \"not a valid tool\". Say so here, once per configuration, as an error\n  // so it reaches `onError` and the console even with diagnostics off.\n  const clientToolNamesKey = clientTools.map((tool) => tool.definition.name).join(',');\n  const clientToolAppId = runtimeProps.appId;\n  useEffect(() => {\n    if (clientTools.length === 0 || resolveClientToolSurface(clientToolAppId) !== null) return;\n    athenaDiagnostics.emit('sdk.config.warning', {\n      level: 'error',\n      error: new AthenaSdkError({\n        code: 'config_invalid',\n        message: `frontendTools with an execute() need a recognised appId; ${clientTools.length} tool(s) will not be bound.`,\n        hint:\n          \"Pass appId={publicAppId} on <AthenaProvider> (a computer-asset app reads it from athena-public-config.json as computer_asset_<uuid>). Without it the deep-agent runtime drops every client tool.\",\n        context: { appId: clientToolAppId ?? null, tools: clientToolNamesKey.split(',') },\n      }),\n      data: { appId: clientToolAppId ?? null, tools: clientToolNamesKey.split(',') },\n    });\n    // clientToolNamesKey is the value-stable form of the tool list.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [clientToolAppId, clientToolNamesKey]);\n\n  const athenaConfig = useAthenaConfigValue({\n    backendUrl,\n    appUrl,\n    apiKey: runtimeProps.apiKey,\n    token: runtimeProps.token,\n    getToken: runtimeProps.getToken,\n    enabledToolkits: runtimeProps.tools,\n    linkClicks,\n    citationLinks,\n  });\n\n  const scope = published && (\n    <AuiProvider value={published.client}>\n      <AthenaContext.Provider value={athenaConfig}>\n        <AthenaStatewireThreadIdContext.Provider value={published.threadId}>\n          <AthenaStatewireLifecycleContext.Provider value={published.lifecycle}>\n            <DeepAgentConnectionContext.Provider value={published.lifecycle.connection}>\n              <AthenaStatewireServerLaneContext.Provider value={published.serverLane}>\n                <StatewireToolOutputsContext.Provider value={runtimeProps.toolOutputs}>\n                  <TooltipProvider>\n                    <StatewireClientToolBridge tools={clientTools} threadId={published.threadId} />\n                    {/* Keyed per thread: each attach starts with no pending lane write. */}\n                    <StatewireModelLaneSync\n                      key={published.threadId}\n                      threadId={published.threadId}\n                      model={published.model}\n                      lane={published.serverLane}\n                      channelLive={isStatewireChannelLive(published.lifecycle.connection)}\n                    />\n                    <ComposerHandoffDrain />\n                    {children}\n                  </TooltipProvider>\n                </StatewireToolOutputsContext.Provider>\n              </AthenaStatewireServerLaneContext.Provider>\n            </DeepAgentConnectionContext.Provider>\n          </AthenaStatewireLifecycleContext.Provider>\n        </AthenaStatewireThreadIdContext.Provider>\n      </AthenaContext.Provider>\n    </AuiProvider>\n  );\n\n  return (\n    <>\n      <AthenaStatewireRuntimeMount\n        key={threadId}\n        threadId={threadId}\n        isNewChat={isNewChat}\n        onPublish={setPublished}\n        {...runtimeProps}\n      />\n      {/* The backend id rides the same snapshot as the client, so\n          history-gated UI (e.g. the loading overlay) never judges one thread\n          by another's state; it is undefined for a never-started chat, which\n          must not read as pending history. */}\n      {threadList && published ? (\n        <AthenaThreadIdContext.Provider\n          value={published.isNewChat ? undefined : published.threadId}\n        >\n          {scope}\n        </AthenaThreadIdContext.Provider>\n      ) : (\n        scope\n      )}\n    </>\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  includePullRequests,\n  additionalListAppIds,\n  ...standaloneProps\n}: Omit<AthenaStatewireStandaloneProps, 'threadId' | 'threadList'> & {\n  initialThreadId?: string;\n  includePullRequests?: boolean;\n  additionalListAppIds?: readonly 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      additionalListAppIds={additionalListAppIds}\n      initialThreadId={initialThreadId}\n      includePullRequests={includePullRequests}\n      // The list's hover prefetch warms the same cache the active-thread\n      // mount seeds from, so a hovered-then-selected session paints at once.\n      snapshotCache={standaloneProps.snapshotCache}\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<AthenaStatewireStandaloneProps, 'threadId' | 'threadList'>) {\n  const list = useAthenaStatewireThreadList();\n  if (!list) return null;\n\n  // Not keyed: the scope keeps the host's children mounted across a switch\n  // and remounts only its per-thread runtime against the new\n  // `…/v2/threads/{id}` URL (see `AthenaStatewireStandalone`).\n  return (\n    <AthenaStatewireStandalone\n      threadId={list.activeThreadId}\n      threadList={{ isNewChat: list.isNewChat }}\n      {...standaloneProps}\n    >\n      <StatewireThreadTitlePoller />\n      <AssetPanelThreadSync />\n      {children}\n    </AthenaStatewireStandalone>\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 attached thread'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. Read from the statewire scope (the\n * id published with its client) rather than the list's selection, which runs\n * one commit ahead of the client during a switch.\n */\nfunction AssetPanelThreadSync() {\n  const threadId = useAthenaStatewireThreadId();\n  const setCurrentThread = useAssetPanelStore((s) => s.setCurrentThread);\n\n  useEffect(() => {\n    setCurrentThread(threadId);\n  }, [threadId, 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  threadIsNew,\n  enableThreadList = false,\n  threadListIncludePullRequests = true,\n  threadListAdditionalAppIds,\n  theme,\n  linkClicks,\n  citationLinks,\n  onOpenAsset,\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  // A host that opens assets its own way takes every request the SDK makes to open one, on the\n  // shared asset store. The callback rides a ref, so a new one each render does not re-register.\n  const onOpenAssetRef = useRef(onOpenAsset);\n  onOpenAssetRef.current = onOpenAsset;\n  const opensAssets = onOpenAsset !== undefined;\n  useEffect(() => {\n    if (!opensAssets) return;\n    // The host's answer as given: anything but `false` (a callback returning nothing included)\n    // means it opened the asset.\n    return useAssetPanelStore.getState().registerAssetOpener((request) => {\n      const open = onOpenAssetRef.current;\n      return open ? open(request) : false;\n    });\n  }, [opensAssets]);\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  // Only declarations WITHOUT a local `execute` ride `enabled_tools`: they name\n  // registry tools the backend binds itself. Executable tools are declared\n  // through `client_tools` instead — listing them here too would switch on a\n  // backend toolkit owning a tool of the same name, and the backend wins that\n  // collision (the client tool is silently dropped).\n  const frontendToolNames = useMemo(\n    () => backendDeclaredFrontendToolIds(frontendTools),\n    [frontendTools],\n  );\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  // Composer writes that arrive before the per-thread mount is ready wait\n  // here, above that mount, so a thread-list remount cannot drop them.\n  const [composerHandoff] = useState(createComposerHandoffStore);\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    // A draft or send queued under the previous identity must never land in\n    // this one's composer.\n    clearComposerHandoff({ store: composerHandoff, reason: 'the signed-in identity changed' });\n  }, [snapshotCache, toolOutputs, composerHandoff, principal, configuredApiKey]);\n  // Nothing drains after the provider is gone: settle what still waits so no\n  // `useSendMessage` caller hangs.\n  useEffect(\n    () => () => clearComposerHandoff({ store: composerHandoff, reason: 'the chat provider unmounted' }),\n    [composerHandoff],\n  );\n\n  const effectiveToken = configuredToken !== undefined\n    ? configuredToken\n    : authProviderToken ?? bridge.token;\n\n  // One credential source for every network path below: it presents the\n  // token chosen above and renews it the way its origin can. A host's own\n  // `getToken` owns renewal; a host's static `token` never renews; a sign-in\n  // provider's token renews through its getter (PropelAuth, SSO); a host\n  // bridge token through the bridge (a Marathon re-mint, or the parent\n  // window's next `athena-auth`).\n  const authProviderGetToken = authContext?.getToken;\n  const credentialInputsRef = useRef<AthenaCredentialInputs>({ token: null });\n  credentialInputsRef.current = {\n    hostGetToken: configuredGetToken,\n    token: effectiveToken,\n    renew:\n      configuredToken !== undefined\n        ? undefined\n        : authProviderToken !== null\n          ? authProviderGetToken\n            ? async ({ force }) => (await authProviderGetToken({ force })) ?? null\n            : undefined\n          : bridge.token !== null\n            ? bridge.renewToken\n            : undefined,\n  };\n  const [credentials] = useState(() =>\n    createAthenaCredentialSource(() => credentialInputsRef.current),\n  );\n  useEffect(() => {\n    credentials.notifyTokenChanged();\n  }, [credentials, effectiveToken]);\n  // Only a provider that holds a token (or a host getter) hands one out, so\n  // \"has credentials\" checks downstream keep meaning what they did.\n  const credentialGetToken =\n    configuredGetToken !== undefined || effectiveToken ? credentials.getToken : undefined;\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  // An iframe bridge falls back after a short timeout (2s) if no parent\n  // answers; a Marathon mint is ready once its bounded retry cycle ends.\n  if (!bridge.ready) {\n    return null;\n  }\n\n  // Fail closed when the host's mint gave up and nothing else can\n  // authenticate: the chat would otherwise attach with no credential (and to\n  // the environment preset, since no host minted a mount). The bridge has\n  // already reported the typed `auth_bridge_failed` / `auth_bridge_timeout`\n  // error to `onError`; remounting the provider starts a new bounded mint.\n  if (\n    bridge.error &&\n    !effectiveToken &&\n    configuredGetToken === undefined &&\n    !configuredApiKey\n  ) {\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: credentialGetToken,\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  // Each provider's assistant client is a root of its own (`extends={null}`): one mounted under\n  // another provider's (a host showing several chats side by side) would otherwise extend that\n  // client and define every tool a second time. The empty config is built per render (configs are\n  // identity-insensitive), never at import, which a host's test stub of assistant-ui could not take.\n  const inner: ReactNode = (\n    <AuiProvider extends={null} config={AuiConfig({})}>\n      {enableThreadList ? (\n        <AthenaStatewireWithThreadList\n          {...statewireProps}\n          initialThreadId={threadIdProp}\n          includePullRequests={threadListIncludePullRequests}\n          additionalListAppIds={threadListAdditionalAppIds}\n        >\n          {children}\n        </AthenaStatewireWithThreadList>\n      ) : (\n        // A provider without a thread list is its own chat: one nested under a thread-list\n        // provider (a host showing several chats side by side) must not read that list as its\n        // own, or its banners and composer would follow the other chat's thread.\n        <AthenaStatewireThreadListContext.Provider value={null}>\n          <AthenaStatewireStandalone\n            {...statewireProps}\n            threadId={threadIdProp}\n            threadIsNew={threadIsNew}\n          >\n            {children}\n          </AthenaStatewireStandalone>\n        </AthenaStatewireThreadListContext.Provider>\n      )}\n    </AuiProvider>\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        <ComposerHandoffContext.Provider value={composerHandoff}>\n          <AthenaThemeStyleContext.Provider value={themeStyleVars}>\n            <AthenaCredentialSourceContext.Provider value={credentials}>\n              {inner}\n            </AthenaCredentialSourceContext.Provider>\n          </AthenaThemeStyleContext.Provider>\n        </ComposerHandoffContext.Provider>\n      </PostHogProvider>\n    </div>\n  );\n}\n"],"names":["_a"],"mappings":"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"}

package/dist/provider/citation-links.d.ts

@@ -16,11 +16,19 @@ export interface AthenaLinkClickContext {
     url: URL;
     target: string | null;
     linkText: string | null;
+    /**
+     * Whether an Athena citation can open in place: an asset panel is mounted (`AthenaLayout`,
+     * `AssetPanel`), or the host opens assets itself (`AthenaProvider onOpenAsset`).
+     */
     isAssetPanelAvailable: boolean;
     kind: AthenaLinkKind;
     citation: AthenaCitationLinkMetadata | null;
     nativeEvent: MouseEvent | null;
-    openInAssetPanel?: () => void;
+    /**
+     * Opens the cited asset through the host's opener or in the asset panel; `false` when nothing
+     * showed it (the host declined and no panel is mounted).
+     */
+    openInAssetPanel?: () => boolean;
     openInBrowser: (target?: string | null) => void;
 }
 export interface AthenaLinkClickOptions {
@@ -41,7 +49,7 @@ export interface AthenaCitationLinkClickContext extends AthenaLinkClickContext {
     assetId: string;
     assetIds: string[];
     assetType: AssetType | null;
-    openInAssetPanel: () => void;
+    openInAssetPanel: () => boolean;
 }
 /**
  * @deprecated Prefer `AthenaLinkClickOptions`. This remains supported as a citation-only alias.

package/dist/{packages/react → react}/package.json.cjs

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

package/dist/{packages/react → react}/package.json.js

@@ -1,4 +1,4 @@
-const version = "0.28.1";
+const version = "0.32.0";
 const packageJson = {
   version
 };

package/dist/runtime/StatewireModelLaneSync.cjs

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const reactStatewire = require("@assistant-ui/react-statewire");
+const react = require("react");
+const athenaDiagnostics = require("../diagnostics/athena-diagnostics.cjs");
+const statewireModelLane = require("./statewire-model-lane.cjs");
+const useDeepAgentConfig = require("../agent-runtime/src/use-deep-agent-config.cjs");
+const errors = require("../agent-runtime/src/errors.cjs");
+const MAX_PATCH_ATTEMPTS_PER_CHANGE = 3;
+const RETRY_BACKOFF_MS = [1e3, 4e3];
+function StatewireModelLaneSync({
+  threadId,
+  model,
+  lane,
+  channelLive
+}) {
+  const send = reactStatewire.useStatewireSendCommand();
+  const sendCommand = (command) => Promise.resolve(send(command));
+  const { configVersion, custom, patchConfig } = useDeepAgentConfig.useDeepAgentConfigController({
+    serverConfig: lane.config,
+    sendCommand
+  });
+  const seenModelRef = react.useRef(model);
+  const pendingRef = react.useRef(false);
+  const attemptsRef = react.useRef(0);
+  const closedRef = react.useRef(false);
+  const patchConfigRef = react.useRef(patchConfig);
+  patchConfigRef.current = patchConfig;
+  const [retryTick, setRetryTick] = react.useState(0);
+  const retryTimerRef = react.useRef(null);
+  react.useEffect(
+    () => () => {
+      if (retryTimerRef.current !== null) clearTimeout(retryTimerRef.current);
+    },
+    []
+  );
+  const landed = lane.landed;
+  react.useEffect(() => {
+    if (model !== seenModelRef.current) {
+      seenModelRef.current = model;
+      pendingRef.current = true;
+      attemptsRef.current = 0;
+    }
+    if (!pendingRef.current || closedRef.current || !channelLive) return;
+    const decision = statewireModelLane.decideModelLanePatch({ desiredModel: model, landed, configVersion, custom });
+    if (decision.kind === "wait") return;
+    pendingRef.current = false;
+    if (decision.kind === "done") return;
+    const { patch } = decision;
+    const changeModel = model;
+    attemptsRef.current += 1;
+    patchConfigRef.current(patch).catch((error) => {
+      const data = { thread_id: threadId, model: patch.model };
+      if (useDeepAgentConfig.isConfigWriteForbiddenRejection(error) || useDeepAgentConfig.isConfigSyncUnavailableRejection(error)) {
+        closedRef.current = true;
+        athenaDiagnostics.athenaDiagnostics.emit("statewire.config", {
+          level: "warn",
+          data: {
+            ...data,
+            reason: useDeepAgentConfig.isConfigWriteForbiddenRejection(error) ? "config_write_forbidden" : "config_sync_unavailable"
+          }
+        });
+        return;
+      }
+      const outcome = errors.statewireTransportOutcome(error);
+      if (outcome !== null) {
+        athenaDiagnostics.athenaDiagnostics.emit("statewire.config", {
+          level: "debug",
+          data: { ...data, outcome }
+        });
+        if (outcome !== "unmount" && seenModelRef.current === changeModel && attemptsRef.current < MAX_PATCH_ATTEMPTS_PER_CHANGE) {
+          pendingRef.current = true;
+          const delay = RETRY_BACKOFF_MS[Math.min(attemptsRef.current - 1, RETRY_BACKOFF_MS.length - 1)];
+          retryTimerRef.current = setTimeout(() => {
+            retryTimerRef.current = null;
+            setRetryTick((tick) => tick + 1);
+          }, delay);
+        }
+        return;
+      }
+      athenaDiagnostics.athenaDiagnostics.error(
+        "statewire.config",
+        error,
+        {
+          code: "statewire_rejected",
+          message: "The statewire host refused the model change",
+          hint: "Inspect error.detail: agora rejections carry a structured {code, message}. The thread keeps running with the model its server config holds."
+        },
+        data
+      );
+    });
+  }, [model, landed, configVersion, custom, channelLive, retryTick, threadId]);
+  return null;
+}
+exports.StatewireModelLaneSync = StatewireModelLaneSync;
+//# sourceMappingURL=StatewireModelLaneSync.cjs.map

package/dist/runtime/StatewireModelLaneSync.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatewireModelLaneSync.cjs","sources":["../../src/runtime/StatewireModelLaneSync.tsx"],"sourcesContent":["import { useStatewireSendCommand } from '@assistant-ui/react-statewire';\nimport {\n  type DeepAgentConfigControllerInputs,\n  isConfigSyncUnavailableRejection,\n  isConfigWriteForbiddenRejection,\n  statewireTransportOutcome,\n  useDeepAgentConfigController,\n} from '@athenaintel/agent-runtime';\nimport { useEffect, useRef, useState } from 'react';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport { decideModelLanePatch } from './statewire-model-lane';\nimport type { AthenaStatewireServerLane } from './statewire-server-lane-context';\n\n/** Writes of one model change, the first included, before the sync gives up on it. */\nconst MAX_PATCH_ATTEMPTS_PER_CHANGE = 3;\n\n/** Wait before re-writing a change the channel dropped: 1 s, then 4 s. */\nconst RETRY_BACKOFF_MS = [1_000, 4_000] as const;\n\n/**\n * Writes the provider's `model` prop to the thread's server config lane when\n * the host changes it during an attach.\n *\n * Once a thread has a lane (version > 0), agora composes every run from the\n * lane and drops the thread-config keys a send carries, `model` included, so\n * a model picked after the thread's first turn would never apply. A change of\n * the prop therefore becomes `config/patch {model}` (`null` when the prop\n * becomes `undefined`: the collab agent's own model, or the default, applies).\n *\n * Only a CHANGE is written. The prop's value when the attach starts is never\n * written, even when the lane holds another model: that model is another\n * client's (or an earlier session's) choice for this thread, and an SDK app's\n * global pick must not overwrite it just by opening the thread. Hosts that\n * want the picker to follow the thread read `useAthenaThreadModel`.\n *\n * Decisions read the lane the host itself sent on this attach (`lane`, from\n * the transport), never the rendered thread state: before the attach snapshot\n * lands that state is a placeholder without a lane, or a remembered snapshot\n * with an older one, and comparing a change against either would write over\n * the session's real model. A change made before the snapshot lands waits for\n * it.\n *\n * A version-0 thread needs no write: the next send carries the model and\n * agora's deferral seed persists it. The change stays pending until the lane\n * exists, so a lane an earlier send seeds with the previous model is\n * corrected when it lands. A refusal that can never succeed (a view-only\n * collaborator, a workspace without server config) stops the sync for the\n * attach and is reported on the diagnostics bus. A write the channel dropped\n * (a lost stream, the host's expired verdict) stays pending and is written\n * again after a backoff once the channel is live, at most\n * {@link MAX_PATCH_ATTEMPTS_PER_CHANGE} times per change.\n *\n * Mounted under the runtime's `AuiProvider`, keyed by the thread, so each\n * attach starts with an empty pending set.\n */\nexport function StatewireModelLaneSync({\n  threadId,\n  model,\n  lane,\n  channelLive,\n}: {\n  threadId: string;\n  /** The model this thread's sends carry, published with the thread (see the provider). */\n  model: string | undefined;\n  lane: AthenaStatewireServerLane;\n  /** Whether the channel can take a command now; writes wait for it. */\n  channelLive: boolean;\n}): null {\n  const send = useStatewireSendCommand();\n  const sendCommand: DeepAgentConfigControllerInputs['sendCommand'] = (command) =>\n    Promise.resolve(send(command));\n  const { configVersion, custom, patchConfig } = useDeepAgentConfigController({\n    serverConfig: lane.config,\n    sendCommand,\n  });\n\n  const seenModelRef = useRef(model);\n  const pendingRef = useRef(false);\n  const attemptsRef = useRef(0);\n  const closedRef = useRef(false);\n  const patchConfigRef = useRef(patchConfig);\n  patchConfigRef.current = patchConfig;\n  // Bumped (after a backoff) to re-run the effect for a write the channel dropped.\n  const [retryTick, setRetryTick] = useState(0);\n  const retryTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  useEffect(\n    () => () => {\n      if (retryTimerRef.current !== null) clearTimeout(retryTimerRef.current);\n    },\n    [],\n  );\n  const landed = lane.landed;\n\n  useEffect(() => {\n    if (model !== seenModelRef.current) {\n      seenModelRef.current = model;\n      pendingRef.current = true;\n      attemptsRef.current = 0;\n    }\n    if (!pendingRef.current || closedRef.current || !channelLive) return;\n    const decision = decideModelLanePatch({ desiredModel: model, landed, configVersion, custom });\n    if (decision.kind === 'wait') return;\n    pendingRef.current = false;\n    if (decision.kind === 'done') return;\n\n    const { patch } = decision;\n    const changeModel = model;\n    attemptsRef.current += 1;\n    patchConfigRef.current(patch).catch((error: unknown) => {\n      const data = { thread_id: threadId, model: patch.model };\n      if (isConfigWriteForbiddenRejection(error) || isConfigSyncUnavailableRejection(error)) {\n        closedRef.current = true;\n        athenaDiagnostics.emit('statewire.config', {\n          level: 'warn',\n          data: {\n            ...data,\n            reason: isConfigWriteForbiddenRejection(error)\n              ? 'config_write_forbidden'\n              : 'config_sync_unavailable',\n          },\n        });\n        return;\n      }\n      const outcome = statewireTransportOutcome(error);\n      if (outcome !== null) {\n        // Channel weather (a dropped stream, the host's expired verdict): keep\n        // the change pending and write it again after a backoff, once the\n        // channel is live, unless the prop has moved on or the attach is gone.\n        athenaDiagnostics.emit('statewire.config', {\n          level: 'debug',\n          data: { ...data, outcome },\n        });\n        if (\n          outcome !== 'unmount' &&\n          seenModelRef.current === changeModel &&\n          attemptsRef.current < MAX_PATCH_ATTEMPTS_PER_CHANGE\n        ) {\n          pendingRef.current = true;\n          const delay =\n            RETRY_BACKOFF_MS[Math.min(attemptsRef.current - 1, RETRY_BACKOFF_MS.length - 1)];\n          retryTimerRef.current = setTimeout(() => {\n            retryTimerRef.current = null;\n            setRetryTick((tick) => tick + 1);\n          }, delay);\n        }\n        return;\n      }\n      athenaDiagnostics.error(\n        'statewire.config',\n        error,\n        {\n          code: 'statewire_rejected',\n          message: 'The statewire host refused the model change',\n          hint: 'Inspect error.detail: agora rejections carry a structured {code, message}. The thread keeps running with the model its server config holds.',\n        },\n        data,\n      );\n    });\n  }, [model, landed, configVersion, custom, channelLive, retryTick, threadId]);\n\n  return null;\n}\n"],"names":["useStatewireSendCommand","useDeepAgentConfigController","useRef","useState","useEffect","decideModelLanePatch","isConfigWriteForbiddenRejection","isConfigSyncUnavailableRejection","athenaDiagnostics","statewireTransportOutcome"],"mappings":"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"}

package/dist/runtime/StatewireModelLaneSync.d.ts

@@ -0,0 +1,45 @@
+import type { AthenaStatewireServerLane } from './statewire-server-lane-context';
+/**
+ * Writes the provider's `model` prop to the thread's server config lane when
+ * the host changes it during an attach.
+ *
+ * Once a thread has a lane (version > 0), agora composes every run from the
+ * lane and drops the thread-config keys a send carries, `model` included, so
+ * a model picked after the thread's first turn would never apply. A change of
+ * the prop therefore becomes `config/patch {model}` (`null` when the prop
+ * becomes `undefined`: the collab agent's own model, or the default, applies).
+ *
+ * Only a CHANGE is written. The prop's value when the attach starts is never
+ * written, even when the lane holds another model: that model is another
+ * client's (or an earlier session's) choice for this thread, and an SDK app's
+ * global pick must not overwrite it just by opening the thread. Hosts that
+ * want the picker to follow the thread read `useAthenaThreadModel`.
+ *
+ * Decisions read the lane the host itself sent on this attach (`lane`, from
+ * the transport), never the rendered thread state: before the attach snapshot
+ * lands that state is a placeholder without a lane, or a remembered snapshot
+ * with an older one, and comparing a change against either would write over
+ * the session's real model. A change made before the snapshot lands waits for
+ * it.
+ *
+ * A version-0 thread needs no write: the next send carries the model and
+ * agora's deferral seed persists it. The change stays pending until the lane
+ * exists, so a lane an earlier send seeds with the previous model is
+ * corrected when it lands. A refusal that can never succeed (a view-only
+ * collaborator, a workspace without server config) stops the sync for the
+ * attach and is reported on the diagnostics bus. A write the channel dropped
+ * (a lost stream, the host's expired verdict) stays pending and is written
+ * again after a backoff once the channel is live, at most
+ * {@link MAX_PATCH_ATTEMPTS_PER_CHANGE} times per change.
+ *
+ * Mounted under the runtime's `AuiProvider`, keyed by the thread, so each
+ * attach starts with an empty pending set.
+ */
+export declare function StatewireModelLaneSync({ threadId, model, lane, channelLive, }: {
+    threadId: string;
+    /** The model this thread's sends carry, published with the thread (see the provider). */
+    model: string | undefined;
+    lane: AthenaStatewireServerLane;
+    /** Whether the channel can take a command now; writes wait for it. */
+    channelLive: boolean;
+}): null;

package/dist/runtime/StatewireModelLaneSync.js

@@ -0,0 +1,96 @@
+import { useStatewireSendCommand } from "@assistant-ui/react-statewire";
+import { useRef, useState, useEffect } from "react";
+import { athenaDiagnostics } from "../diagnostics/athena-diagnostics.js";
+import { decideModelLanePatch } from "./statewire-model-lane.js";
+import { useDeepAgentConfigController, isConfigWriteForbiddenRejection, isConfigSyncUnavailableRejection } from "../agent-runtime/src/use-deep-agent-config.js";
+import { statewireTransportOutcome } from "../agent-runtime/src/errors.js";
+const MAX_PATCH_ATTEMPTS_PER_CHANGE = 3;
+const RETRY_BACKOFF_MS = [1e3, 4e3];
+function StatewireModelLaneSync({
+  threadId,
+  model,
+  lane,
+  channelLive
+}) {
+  const send = useStatewireSendCommand();
+  const sendCommand = (command) => Promise.resolve(send(command));
+  const { configVersion, custom, patchConfig } = useDeepAgentConfigController({
+    serverConfig: lane.config,
+    sendCommand
+  });
+  const seenModelRef = useRef(model);
+  const pendingRef = useRef(false);
+  const attemptsRef = useRef(0);
+  const closedRef = useRef(false);
+  const patchConfigRef = useRef(patchConfig);
+  patchConfigRef.current = patchConfig;
+  const [retryTick, setRetryTick] = useState(0);
+  const retryTimerRef = useRef(null);
+  useEffect(
+    () => () => {
+      if (retryTimerRef.current !== null) clearTimeout(retryTimerRef.current);
+    },
+    []
+  );
+  const landed = lane.landed;
+  useEffect(() => {
+    if (model !== seenModelRef.current) {
+      seenModelRef.current = model;
+      pendingRef.current = true;
+      attemptsRef.current = 0;
+    }
+    if (!pendingRef.current || closedRef.current || !channelLive) return;
+    const decision = decideModelLanePatch({ desiredModel: model, landed, configVersion, custom });
+    if (decision.kind === "wait") return;
+    pendingRef.current = false;
+    if (decision.kind === "done") return;
+    const { patch } = decision;
+    const changeModel = model;
+    attemptsRef.current += 1;
+    patchConfigRef.current(patch).catch((error) => {
+      const data = { thread_id: threadId, model: patch.model };
+      if (isConfigWriteForbiddenRejection(error) || isConfigSyncUnavailableRejection(error)) {
+        closedRef.current = true;
+        athenaDiagnostics.emit("statewire.config", {
+          level: "warn",
+          data: {
+            ...data,
+            reason: isConfigWriteForbiddenRejection(error) ? "config_write_forbidden" : "config_sync_unavailable"
+          }
+        });
+        return;
+      }
+      const outcome = statewireTransportOutcome(error);
+      if (outcome !== null) {
+        athenaDiagnostics.emit("statewire.config", {
+          level: "debug",
+          data: { ...data, outcome }
+        });
+        if (outcome !== "unmount" && seenModelRef.current === changeModel && attemptsRef.current < MAX_PATCH_ATTEMPTS_PER_CHANGE) {
+          pendingRef.current = true;
+          const delay = RETRY_BACKOFF_MS[Math.min(attemptsRef.current - 1, RETRY_BACKOFF_MS.length - 1)];
+          retryTimerRef.current = setTimeout(() => {
+            retryTimerRef.current = null;
+            setRetryTick((tick) => tick + 1);
+          }, delay);
+        }
+        return;
+      }
+      athenaDiagnostics.error(
+        "statewire.config",
+        error,
+        {
+          code: "statewire_rejected",
+          message: "The statewire host refused the model change",
+          hint: "Inspect error.detail: agora rejections carry a structured {code, message}. The thread keeps running with the model its server config holds."
+        },
+        data
+      );
+    });
+  }, [model, landed, configVersion, custom, channelLive, retryTick, threadId]);
+  return null;
+}
+export {
+  StatewireModelLaneSync
+};
+//# sourceMappingURL=StatewireModelLaneSync.js.map

package/dist/runtime/StatewireModelLaneSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatewireModelLaneSync.js","sources":["../../src/runtime/StatewireModelLaneSync.tsx"],"sourcesContent":["import { useStatewireSendCommand } from '@assistant-ui/react-statewire';\nimport {\n  type DeepAgentConfigControllerInputs,\n  isConfigSyncUnavailableRejection,\n  isConfigWriteForbiddenRejection,\n  statewireTransportOutcome,\n  useDeepAgentConfigController,\n} from '@athenaintel/agent-runtime';\nimport { useEffect, useRef, useState } from 'react';\nimport { athenaDiagnostics } from '../diagnostics/athena-diagnostics';\nimport { decideModelLanePatch } from './statewire-model-lane';\nimport type { AthenaStatewireServerLane } from './statewire-server-lane-context';\n\n/** Writes of one model change, the first included, before the sync gives up on it. */\nconst MAX_PATCH_ATTEMPTS_PER_CHANGE = 3;\n\n/** Wait before re-writing a change the channel dropped: 1 s, then 4 s. */\nconst RETRY_BACKOFF_MS = [1_000, 4_000] as const;\n\n/**\n * Writes the provider's `model` prop to the thread's server config lane when\n * the host changes it during an attach.\n *\n * Once a thread has a lane (version > 0), agora composes every run from the\n * lane and drops the thread-config keys a send carries, `model` included, so\n * a model picked after the thread's first turn would never apply. A change of\n * the prop therefore becomes `config/patch {model}` (`null` when the prop\n * becomes `undefined`: the collab agent's own model, or the default, applies).\n *\n * Only a CHANGE is written. The prop's value when the attach starts is never\n * written, even when the lane holds another model: that model is another\n * client's (or an earlier session's) choice for this thread, and an SDK app's\n * global pick must not overwrite it just by opening the thread. Hosts that\n * want the picker to follow the thread read `useAthenaThreadModel`.\n *\n * Decisions read the lane the host itself sent on this attach (`lane`, from\n * the transport), never the rendered thread state: before the attach snapshot\n * lands that state is a placeholder without a lane, or a remembered snapshot\n * with an older one, and comparing a change against either would write over\n * the session's real model. A change made before the snapshot lands waits for\n * it.\n *\n * A version-0 thread needs no write: the next send carries the model and\n * agora's deferral seed persists it. The change stays pending until the lane\n * exists, so a lane an earlier send seeds with the previous model is\n * corrected when it lands. A refusal that can never succeed (a view-only\n * collaborator, a workspace without server config) stops the sync for the\n * attach and is reported on the diagnostics bus. A write the channel dropped\n * (a lost stream, the host's expired verdict) stays pending and is written\n * again after a backoff once the channel is live, at most\n * {@link MAX_PATCH_ATTEMPTS_PER_CHANGE} times per change.\n *\n * Mounted under the runtime's `AuiProvider`, keyed by the thread, so each\n * attach starts with an empty pending set.\n */\nexport function StatewireModelLaneSync({\n  threadId,\n  model,\n  lane,\n  channelLive,\n}: {\n  threadId: string;\n  /** The model this thread's sends carry, published with the thread (see the provider). */\n  model: string | undefined;\n  lane: AthenaStatewireServerLane;\n  /** Whether the channel can take a command now; writes wait for it. */\n  channelLive: boolean;\n}): null {\n  const send = useStatewireSendCommand();\n  const sendCommand: DeepAgentConfigControllerInputs['sendCommand'] = (command) =>\n    Promise.resolve(send(command));\n  const { configVersion, custom, patchConfig } = useDeepAgentConfigController({\n    serverConfig: lane.config,\n    sendCommand,\n  });\n\n  const seenModelRef = useRef(model);\n  const pendingRef = useRef(false);\n  const attemptsRef = useRef(0);\n  const closedRef = useRef(false);\n  const patchConfigRef = useRef(patchConfig);\n  patchConfigRef.current = patchConfig;\n  // Bumped (after a backoff) to re-run the effect for a write the channel dropped.\n  const [retryTick, setRetryTick] = useState(0);\n  const retryTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  useEffect(\n    () => () => {\n      if (retryTimerRef.current !== null) clearTimeout(retryTimerRef.current);\n    },\n    [],\n  );\n  const landed = lane.landed;\n\n  useEffect(() => {\n    if (model !== seenModelRef.current) {\n      seenModelRef.current = model;\n      pendingRef.current = true;\n      attemptsRef.current = 0;\n    }\n    if (!pendingRef.current || closedRef.current || !channelLive) return;\n    const decision = decideModelLanePatch({ desiredModel: model, landed, configVersion, custom });\n    if (decision.kind === 'wait') return;\n    pendingRef.current = false;\n    if (decision.kind === 'done') return;\n\n    const { patch } = decision;\n    const changeModel = model;\n    attemptsRef.current += 1;\n    patchConfigRef.current(patch).catch((error: unknown) => {\n      const data = { thread_id: threadId, model: patch.model };\n      if (isConfigWriteForbiddenRejection(error) || isConfigSyncUnavailableRejection(error)) {\n        closedRef.current = true;\n        athenaDiagnostics.emit('statewire.config', {\n          level: 'warn',\n          data: {\n            ...data,\n            reason: isConfigWriteForbiddenRejection(error)\n              ? 'config_write_forbidden'\n              : 'config_sync_unavailable',\n          },\n        });\n        return;\n      }\n      const outcome = statewireTransportOutcome(error);\n      if (outcome !== null) {\n        // Channel weather (a dropped stream, the host's expired verdict): keep\n        // the change pending and write it again after a backoff, once the\n        // channel is live, unless the prop has moved on or the attach is gone.\n        athenaDiagnostics.emit('statewire.config', {\n          level: 'debug',\n          data: { ...data, outcome },\n        });\n        if (\n          outcome !== 'unmount' &&\n          seenModelRef.current === changeModel &&\n          attemptsRef.current < MAX_PATCH_ATTEMPTS_PER_CHANGE\n        ) {\n          pendingRef.current = true;\n          const delay =\n            RETRY_BACKOFF_MS[Math.min(attemptsRef.current - 1, RETRY_BACKOFF_MS.length - 1)];\n          retryTimerRef.current = setTimeout(() => {\n            retryTimerRef.current = null;\n            setRetryTick((tick) => tick + 1);\n          }, delay);\n        }\n        return;\n      }\n      athenaDiagnostics.error(\n        'statewire.config',\n        error,\n        {\n          code: 'statewire_rejected',\n          message: 'The statewire host refused the model change',\n          hint: 'Inspect error.detail: agora rejections carry a structured {code, message}. The thread keeps running with the model its server config holds.',\n        },\n        data,\n      );\n    });\n  }, [model, landed, configVersion, custom, channelLive, retryTick, threadId]);\n\n  return null;\n}\n"],"names":[],"mappings":";;;;;;AAcA,MAAM,gCAAgC;AAGtC,MAAM,mBAAmB,CAAC,KAAO,GAAK;AAsC/B,SAAS,uBAAuB;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAOS;AACP,QAAM,OAAO,wBAAA;AACb,QAAM,cAA8D,CAAC,YACnE,QAAQ,QAAQ,KAAK,OAAO,CAAC;AAC/B,QAAM,EAAE,eAAe,QAAQ,YAAA,IAAgB,6BAA6B;AAAA,IAC1E,cAAc,KAAK;AAAA,IACnB;AAAA,EAAA,CACD;AAED,QAAM,eAAe,OAAO,KAAK;AACjC,QAAM,aAAa,OAAO,KAAK;AAC/B,QAAM,cAAc,OAAO,CAAC;AAC5B,QAAM,YAAY,OAAO,KAAK;AAC9B,QAAM,iBAAiB,OAAO,WAAW;AACzC,iBAAe,UAAU;AAEzB,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,CAAC;AAC5C,QAAM,gBAAgB,OAA6C,IAAI;AACvE;AAAA,IACE,MAAM,MAAM;AACV,UAAI,cAAc,YAAY,KAAM,cAAa,cAAc,OAAO;AAAA,IACxE;AAAA,IACA,CAAA;AAAA,EAAC;AAEH,QAAM,SAAS,KAAK;AAEpB,YAAU,MAAM;AACd,QAAI,UAAU,aAAa,SAAS;AAClC,mBAAa,UAAU;AACvB,iBAAW,UAAU;AACrB,kBAAY,UAAU;AAAA,IACxB;AACA,QAAI,CAAC,WAAW,WAAW,UAAU,WAAW,CAAC,YAAa;AAC9D,UAAM,WAAW,qBAAqB,EAAE,cAAc,OAAO,QAAQ,eAAe,QAAQ;AAC5F,QAAI,SAAS,SAAS,OAAQ;AAC9B,eAAW,UAAU;AACrB,QAAI,SAAS,SAAS,OAAQ;AAE9B,UAAM,EAAE,UAAU;AAClB,UAAM,cAAc;AACpB,gBAAY,WAAW;AACvB,mBAAe,QAAQ,KAAK,EAAE,MAAM,CAAC,UAAmB;AACtD,YAAM,OAAO,EAAE,WAAW,UAAU,OAAO,MAAM,MAAA;AACjD,UAAI,gCAAgC,KAAK,KAAK,iCAAiC,KAAK,GAAG;AACrF,kBAAU,UAAU;AACpB,0BAAkB,KAAK,oBAAoB;AAAA,UACzC,OAAO;AAAA,UACP,MAAM;AAAA,YACJ,GAAG;AAAA,YACH,QAAQ,gCAAgC,KAAK,IACzC,2BACA;AAAA,UAAA;AAAA,QACN,CACD;AACD;AAAA,MACF;AACA,YAAM,UAAU,0BAA0B,KAAK;AAC/C,UAAI,YAAY,MAAM;AAIpB,0BAAkB,KAAK,oBAAoB;AAAA,UACzC,OAAO;AAAA,UACP,MAAM,EAAE,GAAG,MAAM,QAAA;AAAA,QAAQ,CAC1B;AACD,YACE,YAAY,aACZ,aAAa,YAAY,eACzB,YAAY,UAAU,+BACtB;AACA,qBAAW,UAAU;AACrB,gBAAM,QACJ,iBAAiB,KAAK,IAAI,YAAY,UAAU,GAAG,iBAAiB,SAAS,CAAC,CAAC;AACjF,wBAAc,UAAU,WAAW,MAAM;AACvC,0BAAc,UAAU;AACxB,yBAAa,CAAC,SAAS,OAAO,CAAC;AAAA,UACjC,GAAG,KAAK;AAAA,QACV;AACA;AAAA,MACF;AACA,wBAAkB;AAAA,QAChB;AAAA,QACA;AAAA,QACA;AAAA,UACE,MAAM;AAAA,UACN,SAAS;AAAA,UACT,MAAM;AAAA,QAAA;AAAA,QAER;AAAA,MAAA;AAAA,IAEJ,CAAC;AAAA,EACH,GAAG,CAAC,OAAO,QAAQ,eAAe,QAAQ,aAAa,WAAW,QAAQ,CAAC;AAE3E,SAAO;AACT;"}