@athenaintel/react 0.10.27 → 0.10.30

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AssistantRuntime } from '@assistant-ui/core';
+import { AssistantRuntime } from '@assistant-ui/react';
 import { ClassProp } from 'class-variance-authority/types';
 import { ClassValue } from 'clsx';
 import { Collapsible as Collapsible_2 } from 'radix-ui';
@@ -19,6 +19,7 @@ import { ReactNode } from 'react';
 import { ReasoningMessagePartComponent } from '@assistant-ui/react';
 import { ReasoningMessagePartProps } from '@assistant-ui/react';
 import { RefAttributes } from 'react';
+import { RemoteThreadListAdapter } from '@assistant-ui/react';
 import { Store } from '@tanstack/react-store';
 import { StoreApi } from 'zustand';
 import { TextMessagePartComponent } from '@assistant-ui/react';
@@ -27,7 +28,6 @@ import { ToolCallMessagePartComponent } from '@assistant-ui/react';
 import { ToolCallMessagePartStatus } from '@assistant-ui/react';
 import { Toolkit } from '@assistant-ui/react';
 import { Tooltip as Tooltip_2 } from 'radix-ui';
-import { unstable_RemoteThreadListAdapter } from '@assistant-ui/react';
 import { UseBoundStore } from 'zustand';
 import { VariantProps } from 'class-variance-authority';
 
@@ -113,6 +113,8 @@ export declare interface AthenaAssistantMessageProps {
     ReasoningComponent?: ReasoningMessagePartComponent;
     EmptyComponent?: EmptyMessagePartComponent;
     ActionBarComponent?: FC<AthenaAssistantActionBarProps>;
+    /** Collapse adjacent tool calls into a single expandable group. Defaults to `false`. */
+    groupToolCalls?: boolean;
 }
 
 /**
@@ -167,6 +169,8 @@ export declare interface AthenaChatProps {
     welcomeSuggestions?: WelcomeSuggestion[];
     /** Optional component overrides for message containers and key message parts. */
     components?: AthenaChatComponents;
+    /** Collapse adjacent tool calls into a single expandable group. Defaults to `false`. */
+    groupToolCalls?: boolean;
 }
 
 export declare interface AthenaCitationLinkClickContext extends AthenaLinkClickContext {
@@ -276,7 +280,7 @@ export declare interface AthenaOrg {
     urlSafeOrgName: string;
 }
 
-export declare function AthenaProvider({ children, config, apiKey, token: tokenProp, agent, model, tools, frontendTools, apiUrl, backendUrl, appUrl, environment, workbench, knowledgeBase, systemPrompt, customToolConfigs, appId, threadId: threadIdProp, enableThreadList, theme, linkClicks, citationLinks, posthog: posthogProp, }: AthenaProviderProps): ReactElement<unknown, string | JSXElementConstructor<any>> | null;
+export declare function AthenaProvider({ children, config, apiKey, token: tokenProp, agent, model, tools, frontendTools, disableAutoOpen, apiUrl, backendUrl, appUrl, environment, workbench, knowledgeBase, systemPrompt, customToolConfigs, appId, threadId: threadIdProp, enableThreadList, theme, linkClicks, citationLinks, posthog: posthogProp, }: AthenaProviderProps): ReactElement<unknown, string | JSXElementConstructor<any>> | null;
 
 export declare interface AthenaProviderConfig {
     /** API key for standalone authentication when no token is provided. */
@@ -312,8 +316,12 @@ export declare interface AthenaProviderProps {
     model?: string;
     /** Backend toolkit IDs to enable (e.g. 'document_toolkit', 'web_search_browse_toolkit'). */
     tools?: string[];
-    /** Frontend tools that execute in the browser. The agent can invoke these. */
+    /** Frontend tools that execute in the browser. The agent can invoke these.
+     *  Merged on top of the SDK's default auto-open tools; entries here take
+     *  precedence over defaults with the same name. */
     frontendTools?: Toolkit;
+    /** Disable the SDK's default auto-open behavior for created/touched assets. */
+    disableAutoOpen?: boolean;
     /** @deprecated Prefer `config.apiUrl`. URL for the chat streaming endpoint. */
     apiUrl?: string;
     /** @deprecated Prefer `config.backendUrl`. URL for the Athena backend API. */
@@ -544,14 +552,6 @@ declare interface AthenaThreadListAdapterConfig {
     appId?: string;
 }
 
-/**
- * Public hook for managing thread state and navigation.
- *
- * Wraps the underlying runtime to provide a clean, Athena-branded API
- * for reading the active thread, listing threads, and switching between them.
- *
- * Must be used inside `<AthenaProvider enableThreadList>`.
- */
 export declare interface AthenaThreadManagerState {
     /** The backend thread ID of the currently active thread, or null if not yet synced. */
     activeThreadId: string | null;
@@ -598,7 +598,7 @@ export declare function Button({ className, variant, size, asChild, ...props }:
 }): JSX.Element;
 
 export declare const buttonVariants: (props?: ({
-    variant?: "link" | "default" | "secondary" | "destructive" | "outline" | "ghost" | null | undefined;
+    variant?: "default" | "link" | "secondary" | "destructive" | "outline" | "ghost" | null | undefined;
     size?: "default" | "icon" | "xs" | "sm" | "lg" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
 } & ClassProp) | undefined) => string;
 
@@ -667,6 +667,14 @@ export declare const DEFAULT_API_URL: string;
 
 export declare const DEFAULT_APP_URL: string;
 
+/**
+ * Default frontend tools that auto-open the asset a tool just created or
+ * touched. Registered automatically by `AthenaProvider` / `AthenaChat`; pass
+ * `disableAutoOpen` to turn off, or override individual entries via
+ * `frontendTools`.
+ */
+export declare const DEFAULT_AUTO_OPEN_TOOLS: Toolkit;
+
 export declare const DEFAULT_BACKEND_URL: string;
 
 export declare const DescribeDatabaseToolUI: ToolCallMessagePartComponent;
@@ -1283,6 +1291,7 @@ export declare function useAppendToComposer(): (text: string, opts?: {
  */
 export declare function useAssetEmbed(assetId: string | null, options?: UseAssetEmbedOptions & {
     backendUrl: string;
+    appUrl?: string;
     apiKey?: string;
     token?: string | null;
 }): UseAssetEmbedResult;
@@ -1327,7 +1336,7 @@ 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): unstable_RemoteThreadListAdapter;
+export declare function useAthenaThreadListAdapter(config: AthenaThreadListAdapterConfig): RemoteThreadListAdapter;
 
 export declare function useAthenaThreadManager(): AthenaThreadManagerState | null;
 
@@ -1382,20 +1391,22 @@ declare interface UseMentionSuggestionsOptions {
 export declare function useParentAuth(): string | null;
 
 /**
- * Listens for auth tokens AND environment config sent from a parent window
- * via PostMessage.
+ * Listens for auth tokens AND environment config from the host environment.
+ *
+ * Two transport modes, picked automatically:
  *
- * When the app runs inside a Marathon wrapper, the wrapper sends:
- *   1. { type: 'athena-config', apiUrl, backendUrl, appUrl } — correct URLs for the environment
- *   2. { type: 'athena-auth', token } — relayed from the Olympus token-bridge iframe
+ * 1. **Iframe (legacy / Olympus inline preview)**: a parent window posts
+ *    `athena-config` and `athena-auth` via PostMessage. The hook also posts
+ *    `athena-auth-ready` so the parent knows when to (re-)send.
  *
- * When running inside an Olympus inline preview, only athena-auth is sent.
- * When running standalone (no parent), returns defaults immediately.
+ * 2. **Standalone (Marathon-served deploy URL)**: top-level navigation, no
+ *    parent. The hook fetches `/_athena/auth` on its own origin. Marathon
+ *    validates its session cookie (sent by the browser automatically) and
+ *    returns `{ token, apiUrl, backendUrl, appUrl }`. A 404 means we're not
+ *    on a Marathon origin — the hook falls through with empty state.
  *
- * Protocol:
- *   Parent -> iframe: { type: 'athena-config', apiUrl: string, backendUrl: string, appUrl?: string }
- *   Parent -> iframe: { type: 'athena-auth', token: '<propel-access-token>' }
- *   iframe -> Parent: { type: 'athena-auth-ready' }
+ * In both modes a timeout safety net flips `ready: true` so the app never
+ * blocks indefinitely.
  */
 export declare function useParentBridge({ trustedOrigins, }?: ParentBridgeOptions): ParentBridgeState;