@athenaintel/react 0.17.0 → 0.19.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@athenaintel/react",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "description": "Athena React SDK \u2014 Build AI-powered chat applications with the Athena platform",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -28,6 +28,21 @@
       "import": "./dist/chat-ui.js",
       "require": "./dist/chat-ui.cjs"
     },
+    "./chat-ui/statewire": {
+      "types": "./dist/chat-ui/statewire.d.ts",
+      "import": "./dist/chat-ui-statewire.js",
+      "require": "./dist/chat-ui-statewire.cjs"
+    },
+    "./tools": {
+      "types": "./dist/tools/index.d.ts",
+      "import": "./dist/tools.js",
+      "require": "./dist/tools.cjs"
+    },
+    "./super-grouping": {
+      "types": "./dist/chat/super-grouping/index.d.ts",
+      "import": "./dist/super-grouping.js",
+      "require": "./dist/super-grouping.cjs"
+    },
     "./src/chat-ui/styles/theme.css": "./src/chat-ui/styles/theme.css",
     "./chat-ui/tailwind-preset": "./src/chat-ui/tailwind-preset.js"
   },
@@ -39,8 +54,9 @@
   "scripts": {
     "dev": "bun run build:css && vite build --watch",
     "build": "vite build && tsc -p tsconfig.build.json && bun run build:css",
+    "prepare": "test ! -f src/index.ts || bun run build",
     "build:css": "tailwindcss -i src/styles.entry.css -o dist/styles.css --minify",
-    "test": "bun test src",
+    "test": "bun test mount-tests && bun test src",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "bun run build",
     "preinstall": "node -e \"if(!(process.env.npm_config_user_agent||'').startsWith('bun/')){console.error('\\n\u2717 This monorepo requires bun. Run \\`bun install\\` at the repo root.\\n  https://bun.com/docs/installation\\n');process.exit(1)}\""
@@ -60,12 +76,13 @@
     }
   },
   "dependencies": {
-    "@assistant-ui/core": "0.3.15",
-    "@assistant-ui/react": "0.15.16",
-    "@assistant-ui/react-langgraph": "0.14.24",
-    "@assistant-ui/react-markdown": "0.14.8",
-    "@assistant-ui/react-statewire": "^0.23.0",
-    "@assistant-ui/tap": "0.9.14",
+    "@assistant-ui/core": "0.3.17",
+    "@assistant-ui/react": "0.15.17",
+    "@assistant-ui/react-langgraph": "0.14.26",
+    "@assistant-ui/react-markdown": "0.14.14",
+    "@assistant-ui/react-statewire": "0.24.0",
+    "@assistant-ui/store": "0.3.12",
+    "@assistant-ui/tap": "0.9.16",
     "@floating-ui/react": "^0.27.7",
     "@tailwindcss/typography": "^0.5.19",
     "@tanstack/react-query": "5.99.2",
@@ -84,19 +101,20 @@
     "@tiptap/suggestion": "^2.11",
     "@y/websocket": "4.0.0-rc.2",
     "@y/y": "14.0.0-rc.24",
-    "assistant-stream": "0.3.39",
+    "assistant-stream": "0.3.41",
     "class-variance-authority": "^0.7.1",
     "cnfast": "0.0.8",
     "lucide-react": "^0.575.0",
     "radix-ui": "^1.4.3",
     "remark-gfm": "^4.0.0",
-    "statewire": "^0.13.0",
+    "statewire": "0.14.0",
     "tiptap-markdown": "^0.9.0",
-    "zod": "^3.24.0",
+    "zod": "^4.4.3",
     "zustand": "^5.0.11"
   },
   "devDependencies": {
     "@athenaintel/agent-runtime": "workspace:*",
+    "@happy-dom/global-registrator": "^20.10.6",
     "@propelauth/react": "^2.1.1",
     "@tailwindcss/cli": "^4.2.1",
     "@types/react": "^19.0.0",

package/dist/chat/super-grouping/tool-status-labels.d.ts

@@ -1 +0,0 @@
-export declare function getToolStatusLabel(toolName: string, status: 'running' | 'complete' | 'error' | 'incomplete' | undefined): string;

package/dist/runtime/converter.d.ts

@@ -1,5 +0,0 @@
-import type { ThreadMessage } from '@assistant-ui/react';
-import { type AthenaLangChainMessage } from './schemas';
-export declare const PTC_SUBCALL_DID_NOT_COMPLETE_MESSAGE = "Sub-call did not complete before the parent tool returned.";
-export declare const autoCloseInFlightSubgraphMessages: (msgs: readonly unknown[]) => unknown[];
-export declare const convertLangChainToThreadMessages: (messages: AthenaLangChainMessage[], isRunning?: boolean, metadata?: {}) => ThreadMessage[];

package/dist/runtime/external-message-converter.d.ts

@@ -1,21 +0,0 @@
-import { type ThreadMessage, type ThreadMessageLike, type ToolExecutionStatus } from '@assistant-ui/react';
-export declare namespace useExternalMessageConverter {
-    type Message = (ThreadMessageLike & {
-        readonly convertConfig?: {
-            readonly joinStrategy?: 'concat-content' | 'none';
-        };
-    }) | {
-        role: 'tool';
-        toolCallId: string;
-        toolName?: string | undefined;
-        result: any;
-        artifact?: any;
-        isError?: boolean;
-        messages?: readonly ThreadMessage[];
-    };
-    type Metadata = {
-        readonly toolStatuses?: Record<string, ToolExecutionStatus>;
-    };
-    type Callback<T> = (message: T, metadata: Metadata) => Message | Message[] | null | undefined;
-}
-export declare const convertExternalMessages: <T extends WeakKey>(messages: T[], callback: useExternalMessageConverter.Callback<T>, isRunning: boolean, metadata: useExternalMessageConverter.Metadata) => ThreadMessage[];

package/dist/runtime/schemas.d.ts

@@ -1,24 +0,0 @@
-import type { LangChainMessage } from '@assistant-ui/react-langgraph';
-export type AthenaAiLangChainMessage = Extract<LangChainMessage, {
-    type: 'ai';
-}> & {
-    usage_metadata?: Record<string, unknown>;
-    response_metadata?: Record<string, unknown>;
-};
-export type AthenaLangChainMessage = Exclude<LangChainMessage, {
-    type: 'ai';
-}> | AthenaAiLangChainMessage;
-export declare const parseLangChainMessage: (msg: unknown) => AthenaLangChainMessage | null;
-export declare const parseMessages: (messages: unknown) => AthenaLangChainMessage[];
-export declare const parseInterrupt: (interrupt: unknown) => {
-    value: unknown;
-    resumable: boolean;
-} | null;
-export declare const parseLangGraphState: (state: unknown) => {
-    messages: AthenaLangChainMessage[];
-    __interrupt__: {
-        value?: unknown;
-        resumable: boolean;
-    } | null;
-    [key: string]: unknown;
-};

package/dist/runtime/transport.d.ts

@@ -1,39 +0,0 @@
-export declare const ATHENA_TRANSPORTS: {
-    readonly legacy: 'legacy';
-    readonly statewire: 'statewire';
-};
-/** Chat transport mode: `legacy` (Iris `/api/chat` assistant-transport) or
- *  `statewire` (Iris `/v2/threads` deep-agent statewire sync). */
-export type AthenaTransport = (typeof ATHENA_TRANSPORTS)[keyof typeof ATHENA_TRANSPORTS];
-/** Statewire is the default as of 0.12.0: it is the maintained transport
- *  (server-hosted threads, mid-run queueing, HITL, client tools for
- *  recognized SDK hosts) and was validated live across SDK hosts on
- *  2026-08-27. Pass `transport: 'legacy'` to opt a deployment back out;
- *  note that threads created on one transport are read-only from the other. */
-export declare const DEFAULT_ATHENA_TRANSPORT: AthenaTransport;
-export interface ResolvedAthenaTransport {
-    transport: AthenaTransport;
-    /**
-     * @deprecated Always `null`. Both provider modes (standalone and thread
-     * list) run both transports, so a requested transport is never overridden.
-     * Kept on the type so existing consumers keep compiling.
-     */
-    fallbackReason: string | null;
-}
-/**
- * Resolve the effective chat transport for a provider configuration: the
- * requested transport, or {@link DEFAULT_ATHENA_TRANSPORT} when unset.
- */
-export declare function resolveAthenaTransport({ transport, }: {
-    transport?: AthenaTransport;
-    /** @deprecated Ignored — the thread list runs on both transports. */
-    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/useAthenaRuntime.d.ts

@@ -1,47 +0,0 @@
-import type { AssistantRuntime } from '@assistant-ui/react';
-export { DEFAULT_API_URL, DEFAULT_BACKEND_URL } from '../lib/athena-urls';
-export interface AthenaRuntimeConfig {
-    /** URL for the chat streaming endpoint. Defaults to Athena production sync server. */
-    apiUrl?: string;
-    /** URL for the sync server resume endpoint. Derived from apiUrl if not provided. */
-    resumeApiUrl?: string;
-    /** URL for the Athena backend API. Defaults to Athena production API. */
-    backendUrl?: string;
-    /** API key for authentication. Used when no auth token is provided. */
-    apiKey?: string;
-    /** PropelAuth token from parent window. Takes priority over apiKey. */
-    token?: string | null;
-    /** Resolve the latest token immediately before a request (for expiring clients). */
-    getToken?: () => string | null | Promise<string | null>;
-    /** Called when the transport reports an authentication failure. */
-    onUnauthorized?: () => void | Promise<void>;
-    /** LLM model identifier. */
-    model?: string;
-    /** Agent name to use. */
-    agent?: string;
-    /** Backend toolkit IDs to enable. */
-    tools?: string[];
-    /** Frontend tool IDs to include in enabled_tools. */
-    frontendToolIds?: string[];
-    /** Asset IDs to include in the workbench. */
-    workbench?: string[];
-    /** Knowledge base IDs for RAG context. */
-    knowledgeBase?: string[];
-    /** System prompt override. */
-    systemPrompt?: string;
-    /** Custom tool configurations (e.g. MCP servers). Passed as custom_tool_configs in runConfig. */
-    customToolConfigs?: Record<string, unknown>;
-    /** Client app identifier for session filtering. Sent as app_id in runConfig.custom. */
-    appId?: string;
-    /** Thread ID override. Auto-generated if not provided. */
-    threadId?: string;
-    /** Request channel. Defaults to "web". Use "chrome_extension" for the browser extension. */
-    channel?: string;
-    /** Device ID for device tunnel routing (chrome extension). */
-    deviceId?: string;
-    /** Additional fields merged into the request body. */
-    extraBody?: Record<string, unknown>;
-    /** Additional fields merged into runConfig.custom. */
-    extraRunConfig?: Record<string, unknown>;
-}
-export declare const useAthenaRuntime: (config: AthenaRuntimeConfig) => AssistantRuntime;

package/dist/threads/adapter.d.ts

@@ -1,42 +0,0 @@
-/**
- * RemoteThreadListAdapter implementation for Athena/Agora backend.
- * Maps our Agora API to the assistant-ui RemoteThreadListAdapter interface.
- *
- * Message loading for existing threads happens via the sync server's resume API
- * (triggered by useAthenaRuntime), NOT via a ThreadHistoryAdapter.
- */
-import type { RemoteThreadListAdapter } from '@assistant-ui/react';
-interface AthenaThreadListAdapterConfig {
-    backendUrl: string;
-    apiKey?: string;
-    token?: string | null;
-    appId?: string;
-}
-/**
- * Context for passing the current thread's remoteId from the unstable_Provider
- * down to the runtimeHook, without requiring useAui() in the hook.
- */
-export declare const AthenaThreadIdContext: import("react").Context<string | undefined>;
-/**
- * Read the current assistant-ui thread item's remote ID.
- *
- * This must be used inside assistant-ui's ThreadListItemRuntimeProvider.
- * It is available before `unstable_Provider` renders its children, so the
- * per-thread runtime hook can use it to hydrate existing threads.
- */
-export declare function useAthenaAuiThreadRemoteId(): string | undefined;
-/** Read the current thread's remote ID (set by the adapter's unstable_Provider). */
-export declare function useAthenaThreadId(): string | undefined;
-/**
- * Hook that returns a RemoteThreadListAdapter for the Athena platform.
- * Integrates with our Agora REST API for thread CRUD.
- */
-export declare function useAthenaThreadListAdapter(config: AthenaThreadListAdapterConfig): RemoteThreadListAdapter;
-/**
- * Context for exposing a thread list refresh callback.
- * Provided by AthenaWithThreadList, consumed by ThreadList.
- */
-export declare const ThreadListRefreshContext: import("react").Context<(() => void) | null>;
-/** Trigger a re-fetch of the thread list. No-op outside of thread list mode. */
-export declare function useRefreshThreadList(): (() => void) | null;
-export {};

package/dist/threads/useActiveThreadStateHydration.d.ts

@@ -1,12 +0,0 @@
-interface ActiveThreadStateHydrationConfig {
-    backendUrl: string;
-    apiKey?: string;
-    token?: string | null;
-}
-type HydratableThreadListItemState = {
-    remoteId?: string | undefined;
-    id: string;
-};
-export declare const selectHydratableThreadId: (state: HydratableThreadListItemState) => string | null;
-export declare function useActiveThreadStateHydration({ backendUrl, apiKey, token, }: ActiveThreadStateHydrationConfig): void;
-export {};

package/dist/threads/useThreadTitlePolling.d.ts

@@ -1,14 +0,0 @@
-/**
- * Internal hook that polls the thread list to pick up a freshly-generated
- * title after the user sends the first message in a new thread.
- *
- * The Agora backend generates thread titles asynchronously from the first
- * user message, so the title usually isn't available at the moment the
- * thread is created. Without this, new threads show as "New conversation"
- * in the sidebar until the user manually refreshes.
- *
- * Triggers when the active thread has messages but no title yet, then
- * polls every second (after a 5s initial delay) until a title appears
- * or a max duration elapses.
- */
-export declare function useThreadTitlePolling(refresh: () => void): void;