@athenaintel/react 0.10.41-rc.2 → 0.11.0

package/dist/provider/AthenaContext.d.ts

@@ -5,9 +5,9 @@ export interface AthenaConfig extends Pick<AthenaProviderConfig, 'apiKey' | 'tok
     backendUrl: string;
     appUrl: string;
     enabledToolkits: string[];
-    /** Effective chat transport. Statewire supports mid-run sends (the server
-     *  queues them), so composer gating differs per transport. */
-    transport: AthenaTransport;
+    /** Effective chat transport; absent means `legacy`. Optional so existing
+     *  `AthenaConfig` object literals keep compiling. */
+    transport?: AthenaTransport;
     linkClicks?: AthenaLinkClickOptions;
     citationLinks?: AthenaCitationLinkOptions;
 }

package/dist/provider/AthenaProvider.d.ts

@@ -1,6 +1,8 @@
 import { type ReactNode } from 'react';
 import type { Toolkit } from '@assistant-ui/react';
 import { type AthenaEnvironment } from '../lib/athena-urls';
+import { type AthenaDiagnosticEvent, type AthenaDiagnosticLevel, type AthenaDiagnosticsConfig } from '../diagnostics/athena-diagnostics';
+import type { AthenaSdkError } from '../diagnostics/errors';
 import { type AthenaTransport } from '../runtime/transport';
 import type { AthenaProviderConfig } from './config';
 import type { AthenaCitationLinkOptions, AthenaLinkClickOptions } from './citation-links';
@@ -15,8 +17,24 @@ export interface AthenaProviderProps {
     /** @deprecated Prefer `config.token`. PropelAuth token. If provided, takes priority over apiKey. If omitted, the SDK
      *  will automatically listen for a token from the parent window via PostMessage. */
     token?: string | null;
-    /** Agent name to use. Defaults to 'athena_assist_agent'. */
+    /** Agent selector.
+     *
+     *  - `legacy` transport: any agent name (defaults to 'athena_assist_agent'),
+     *    including `collab_agent:<asset_id>` refs.
+     *  - `statewire` transport: only `collab_agent:<asset_id>` refs apply — the
+     *    thread then runs AS that published collab agent (its prompt, tools, and
+     *    model default), and the caller must have view access to the agent
+     *    asset. Any other value is ignored with a `sdk.config.warning`
+     *    diagnostic, because the statewire host always runs the Athena deep
+     *    agent. */
     agent?: string;
+    /** Collab-agent channel id — a built-in channel (`email`, `sms`, …) or a
+     *  user-defined custom channel id from the agent's Channels tab. Selects
+     *  that channel's configuration overrides and stamps the session's origin.
+     *  Only meaningful with a `collab_agent:<asset_id>` `agent` on the
+     *  `statewire` transport; sent as `collab_channel_id`. An unknown or
+     *  disabled channel rejects the run with a structured, teaching error. */
+    channel?: string;
     /** LLM model identifier. Defaults to 'claude-opus-4-6-thinking-max-fast'. */
     model?: string;
     /** Backend toolkit IDs to enable (e.g. 'document_toolkit', 'web_search_browse_toolkit'). */
@@ -47,9 +65,11 @@ export interface AthenaProviderProps {
      *  model in this mode. */
     transport?: AthenaTransport;
     /** Resolve the latest auth token immediately before a request (for
-     *  expiring clients). Takes priority over `token` when it resolves. */
+     *  expiring clients). Takes priority over `token` when it resolves.
+     *  Only used when `transport` is 'statewire'. Prefer `config.getToken`. */
     getToken?: () => string | null | Promise<string | null>;
-    /** Additional fields merged into runConfig.custom (statewire transport). */
+    /** Additional fields merged into runConfig.custom. Only used when
+     *  `transport` is 'statewire'. Prefer `config.extraRunConfig`. */
     extraRunConfig?: Record<string, unknown>;
     /** Statewire sync base URL override (the `…/v2/threads` mount). Defaults to
      *  the effective `apiUrl` host + `/v2/threads`. Only used when `transport`
@@ -103,5 +123,23 @@ export interface AthenaProviderProps {
     /** PostHog analytics configuration. When omitted or keys are missing, PostHog is silently disabled.
      *  Prefer `config.posthog` for structured configuration. */
     posthog?: PostHogConfig;
+    /** SDK diagnostics.
+     *
+     *  - `true` / a level: echo structured `[AthenaSDK]` events to the console
+     *    at that level (`true` = 'debug').
+     *  - An object: full diagnostics config (console level, PostHog timing
+     *    forwarding, buffer size).
+     *
+     *  Independent of the prop, `localStorage.setItem('athena:debug','debug')`
+     *  (or `window.__ATHENA_SDK__.diagnostics.enableConsole()`) turns console
+     *  echo on at runtime without a rebuild. Errors log once even when off. */
+    debug?: boolean | AthenaDiagnosticLevel | Partial<AthenaDiagnosticsConfig>;
+    /** Receives every diagnostics event (timings, warnings, errors) — the hook
+     *  for shipping SDK telemetry to the host app's own pipeline. */
+    onDiagnostic?: (event: AthenaDiagnosticEvent) => void;
+    /** Receives every SDK error as a typed `AthenaSdkError` (stable `code`,
+     *  `hint`, structured server `detail`). Fires in addition to the UI's own
+     *  error handling, so integrations never fail silently. */
+    onError?: (error: AthenaSdkError, event: AthenaDiagnosticEvent) => void;
 }
-export declare function AthenaProvider({ children, config, apiKey, token: tokenProp, agent, model, tools, frontendTools, disableAutoOpen, apiUrl, backendUrl, appUrl, environment, transport, statewireSyncUrl, getToken, extraRunConfig, workbench, knowledgeBase, systemPrompt, customToolConfigs, appId, threadId: threadIdProp, enableThreadList, theme, linkClicks, citationLinks, posthog: posthogProp, }: AthenaProviderProps): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | null;
+export declare function AthenaProvider({ children, config, apiKey, token: tokenProp, agent, channel, model, tools, frontendTools, disableAutoOpen, apiUrl, backendUrl, appUrl, environment, transport, statewireSyncUrl, getToken, extraRunConfig, workbench, knowledgeBase, systemPrompt, customToolConfigs, appId, threadId: threadIdProp, enableThreadList, theme, linkClicks, citationLinks, posthog: posthogProp, debug, onDiagnostic, onError, }: AthenaProviderProps): import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | null;

package/dist/provider/config.d.ts

@@ -2,6 +2,12 @@ import type { AthenaEnvironment } from '../lib/athena-urls';
 import type { AthenaTransport } from '../runtime/transport';
 import type { PostHogConfig } from './PostHogProvider';
 export interface AthenaProviderConfig {
+    /** Resolve the latest auth token immediately before a request (for expiring
+     *  clients). Only used when `transport` is 'statewire'. */
+    getToken?: () => string | null | Promise<string | null>;
+    /** Additional fields merged into runConfig.custom. Only used when
+     *  `transport` is 'statewire'. */
+    extraRunConfig?: Record<string, unknown>;
     /** API key for standalone authentication when no token is provided. */
     apiKey?: string;
     /** PropelAuth token. Takes priority over apiKey when provided. */

package/dist/runtime/statewire-run-config.d.ts

@@ -1,9 +1,24 @@
 /** Deep-agent default model — matches the Olympus and mobile statewire hosts.
  *  The legacy transport keeps its own default model. */
 export declare const DEFAULT_STATEWIRE_MODEL = "claude-sonnet-5";
+/** Agent-id namespace for collab agents (`collab_agent:<asset_id>`). */
+export declare const COLLAB_AGENT_REF_PREFIX = "collab_agent:";
+/** The asset id when `agent` is a `collab_agent:<asset_id>` ref, else null. */
+export declare function parseCollabAgentRef(agent: string | undefined | null): string | null;
 export interface StatewireRunConfigOptions {
-    /** LLM model identifier. Defaults to the deep-agent default model. */
+    /** LLM model identifier. Defaults to the deep-agent default model — unless a
+     *  collab agent is selected and its author set one (the backend overlay
+     *  applies the agent's model when the run sends none), in which case no
+     *  model is sent so the agent's choice wins. */
     model?: string;
+    /** Agent selector. On statewire only the `collab_agent:<asset_id>` namespace
+     *  is meaningful: the run executes AS that published collab agent (prompt,
+     *  tools, model default). Any other value is ignored by the host. */
+    agent?: string;
+    /** Collab-agent channel id (built-in like `email`/`sms`, or a user-defined
+     *  custom channel id) selecting that channel's configuration overrides.
+     *  Sent as `collab_channel_id`; only meaningful with a collab `agent`. */
+    channel?: string;
     /** Backend toolkit IDs to enable. */
     tools?: string[];
     /** Frontend tool IDs to include in enabled_tools. */

package/dist/runtime/transport.d.ts

@@ -24,3 +24,11 @@ export declare function resolveAthenaTransport({ transport, }: {
     transport?: AthenaTransport;
     enableThreadList?: boolean;
 }): ResolvedAthenaTransport;
+/**
+ * Whether a send may be dispatched while a run is already active.
+ *
+ * Statewire hosts the queue server-side, so a mid-run send is queued behind
+ * the live run. The legacy transport has no queue: a second dispatch would
+ * orphan the in-flight run and duplicate its pending placeholder.
+ */
+export declare function allowsMidRunSend(transport: AthenaTransport | undefined): boolean;

package/dist/runtime/useAthenaStatewireRuntime.d.ts

@@ -19,6 +19,11 @@ export interface AthenaStatewireRuntimeConfig {
     getToken?: () => string | null | Promise<string | null>;
     /** LLM model identifier. Defaults to the deep-agent default model. */
     model?: string;
+    /** Agent selector: only `collab_agent:<asset_id>` refs are meaningful here
+     *  (the run executes AS that published collab agent). Other values warn. */
+    agent?: string;
+    /** Collab-agent channel id selecting that channel's overrides. */
+    channel?: string;
     /** Backend toolkit IDs to enable. */
     tools?: string[];
     /** Frontend tool IDs to include in enabled_tools. */

package/dist/version.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The SDK's own version, inlined at build time. Surfaced in diagnostics, on
+ * `window.__ATHENA_SDK__.version`, and available to consumers so a host app
+ * can show "what SDK am I running" without reading node_modules.
+ */
+export declare const ATHENA_REACT_SDK_VERSION: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@athenaintel/react",
-  "version": "0.10.41-rc.2",
+  "version": "0.11.0",
   "description": "Athena React SDK — Build AI-powered chat applications with the Athena platform",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -49,7 +49,7 @@
     "@assistant-ui/core": "0.3.15",
     "@assistant-ui/react": "0.15.16",
     "@assistant-ui/react-langgraph": "0.14.24",
-    "@assistant-ui/react-statewire": "^0.18.0",
+    "@assistant-ui/react-statewire": "^0.21.0",
     "@assistant-ui/tap": "0.9.14",
     "@floating-ui/react": "^0.27.7",
     "@tanstack/react-query": "5.99.2",
@@ -70,7 +70,7 @@
     "cnfast": "0.0.8",
     "lucide-react": "^0.575.0",
     "radix-ui": "^1.4.3",
-    "statewire": "^0.10.0",
+    "statewire": "^0.12.0",
     "tiptap-markdown": "^0.9.0",
     "zod": "^3.24.0",
     "zustand": "^5.0.11"