@athenaintel/react 0.10.19 → 0.10.21

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import { ClassProp } from 'class-variance-authority/types';
 import { ClassValue } from 'clsx';
 import { Collapsible as Collapsible_2 } from 'radix-ui';
 import { ComponentPropsWithRef } from 'react';
+import { Context } from 'react';
 import { EmptyMessagePartComponent } from '@assistant-ui/react';
 import { FC } from 'react';
 import { ForwardRefExoticComponent } from 'react';
@@ -22,11 +23,14 @@ 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';
 
 export declare const AppendDocumentToolUI: ToolCallMessagePartComponent;
 
+export declare function archiveThread(backendUrl: string, auth: AuthConfig, threadId: string): Promise<void>;
+
 declare type AssetIconType = "doc" | "pdf" | "sheet";
 
 export declare const AssetPanel: FC<AssetPanelProps>;
@@ -254,7 +258,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, 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, 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. */
@@ -319,6 +323,10 @@ export declare interface AthenaProviderProps {
      *  }}>
      */
     customToolConfigs?: Record<string, unknown>;
+    /** Client app identifier for session filtering.
+     *  Sessions created with this ID can be filtered in the thread list.
+     *  E.g. "olympus", "athena-app", or a computer asset ID like "asset_<uuid>". */
+    appId?: string;
     /** Thread ID override. Auto-generated if not provided. */
     threadId?: string;
     /** Enable thread list management (sidebar thread switching). */
@@ -379,8 +387,18 @@ export declare interface AthenaRuntimeConfig {
     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>;
 }
 
 /**
@@ -495,6 +513,19 @@ export declare interface AthenaTheme {
     threadMaxWidth?: 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: Context<string | undefined>;
+
+declare interface AthenaThreadListAdapterConfig {
+    backendUrl: string;
+    apiKey?: string;
+    token?: string | null;
+    appId?: string;
+}
+
 /**
  * Public hook for managing thread state and navigation.
  *
@@ -535,6 +566,11 @@ export declare interface AthenaUserMessageProps {
     TextComponent?: TextMessagePartComponent;
 }
 
+declare interface AuthConfig {
+    apiKey?: string;
+    token?: string | null;
+}
+
 export declare const BrowseToolUI: ToolCallMessagePartComponent;
 
 export declare function Button({ className, variant, size, asChild, ...props }: React_2.ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {
@@ -599,6 +635,12 @@ export declare const CreatePresentationToolUI: ToolCallMessagePartComponent;
 
 export declare const CreateSheetToolUI: ToolCallMessagePartComponent;
 
+export declare function createThread(backendUrl: string, auth: AuthConfig, opts?: {
+    systemPrompt?: string;
+    enabledTools?: string[];
+    appId?: string;
+}): Promise<ThreadCreateResponse>;
+
 export declare const DEFAULT_API_URL: string;
 
 export declare const DEFAULT_APP_URL: string;
@@ -649,6 +691,9 @@ export declare const GetDatabaseTableSchemaToolUI: ToolCallMessagePartComponent;
 
 export declare function getPostHogInstance<TClient = unknown>(): TClient | null;
 
+/** Fetch thread state (messages) from the LangGraph-compatible endpoint. */
+export declare function getThreadState(backendUrl: string, auth: AuthConfig, threadId: string): Promise<ThreadStateResponse>;
+
 export declare const isAthenaCitationUrl: ({ href, appUrl, }: {
     href: string;
     appUrl?: string | null;
@@ -661,6 +706,13 @@ declare interface ItemCache {
 
 export declare const ListDatabaseTablesToolUI: ToolCallMessagePartComponent;
 
+export declare function listThreads(backendUrl: string, auth: AuthConfig, opts?: {
+    limit?: number;
+    offset?: number;
+    exclude_triggered?: boolean;
+    app_id?: string;
+}): Promise<ThreadListResponse>;
+
 declare interface MentionSuggestionsState {
     registry: ScopeRegistry;
     cache: ItemCache;
@@ -943,12 +995,26 @@ declare interface ThreadAssetState {
     isOpen: boolean;
 }
 
+declare interface ThreadCreateResponse {
+    thread_id: string;
+}
+
 export declare function ThreadList({ className }: ThreadListProps): JSX.Element;
 
 export declare interface ThreadListProps {
     className?: string;
 }
 
+declare interface ThreadListResponse {
+    threads: ThreadSummary[];
+}
+
+declare interface ThreadStateResponse {
+    thread_id: string;
+    messages: unknown[];
+    status?: string;
+}
+
 /**
  * Athena thread API client.
  * Calls existing REST endpoints for thread CRUD.
@@ -1048,8 +1114,6 @@ export declare const Toolkits: {
     readonly WEB_SEARCH: "web_search_browse_toolkit";
     /** SQL query execution. */
     readonly SQL: "sql_toolkit";
-    /** Athena Code development environment. */
-    readonly ATHENA_CODE: "athena_code_toolkit";
     /** Document comments and collaboration. */
     readonly COMMENTS: "comments_toolkit";
     /** Visual canvas creation. */
@@ -1214,6 +1278,15 @@ export declare const useAthenaLinkClickHandler: () => AthenaLinkClickHandler;
 
 export declare const useAthenaRuntime: (config: AthenaRuntimeConfig) => AssistantRuntime;
 
+/** 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): unstable_RemoteThreadListAdapter;
+
 export declare function useAthenaThreadManager(): AthenaThreadManagerState | null;
 
 /**