@athenaintel/react 0.10.41 → 0.11.1

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'). */
@@ -105,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/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/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/tools/tool-uis.d.ts

@@ -24,7 +24,24 @@ export declare function ExpandableSection({ label, children, defaultOpen, }: {
 }): import("react/jsx-runtime").JSX.Element;
 export declare const WebSearchToolUI: ToolCallMessagePartComponent;
 export declare const BrowseToolUI: ToolCallMessagePartComponent;
+/** Short human date for an email row: "Aug 24" this year, "Aug 24, 2025"
+ *  otherwise, time-of-day for today. Unparseable input passes through. */
+export declare function formatEmailDate(raw: string | undefined): string | undefined;
+/** Turn a raw search query ("received:2026-08-24..2026-08-26 from:kim budget")
+ *  into a readable phrase ("Aug 24 – Aug 26 · from kim · “budget”"). */
+export declare function humanizeEmailQuery(query: string): string;
 export declare const EmailSearchToolUI: ToolCallMessagePartComponent;
+interface EmailAccount {
+    address?: string;
+    provider?: string;
+    name?: string;
+    isDefault?: boolean;
+}
+/** Lenient decode of the unified `list accounts` payload
+ *  (`{accounts: [{email_address, provider, account_name, is_default}]}`,
+ *  with older field spellings tolerated). */
+export declare function parseEmailAccounts(data: Record<string, unknown>): EmailAccount[];
+export declare const EmailAccountsToolUI: ToolCallMessagePartComponent;
 export declare function resetAssetAutoOpen(): void;
 export declare const CreateDocumentToolUI: ToolCallMessagePartComponent;
 export declare const CreateSheetToolUI: ToolCallMessagePartComponent;
@@ -68,3 +85,4 @@ export declare const CaptureMomentToolUI: ToolCallMessagePartComponent;
 export declare const CaptureSlideScreenshotToolUI: ToolCallMessagePartComponent;
 export declare const OpenBrowserToolUI: ToolCallMessagePartComponent;
 export declare const TOOL_UI_REGISTRY: Record<string, ToolCallMessagePartComponent>;
+export {};

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",
+  "version": "0.11.1",
   "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.22.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.13.0",
     "tiptap-markdown": "^0.9.0",
     "zod": "^3.24.0",
     "zustand": "^5.0.11"