@athenaintel/react 0.3.0 → 0.4.1

package/dist/index.d.ts

@@ -94,7 +94,7 @@ export declare interface AthenaLayoutProps {
     minPercent?: number;
 }
 
-export declare function AthenaProvider({ children, apiKey, token: tokenProp, agent, model, tools, frontendTools, apiUrl, backendUrl, workbench, knowledgeBase, systemPrompt, threadId, }: AthenaProviderProps): JSX.Element;
+export declare function AthenaProvider({ children, apiKey, token: tokenProp, agent, model, tools, frontendTools, apiUrl, backendUrl, workbench, knowledgeBase, systemPrompt, threadId: threadIdProp, enableThreadList, }: AthenaProviderProps): JSX.Element;
 
 export declare interface AthenaProviderProps {
     children: ReactNode;
@@ -123,6 +123,8 @@ export declare interface AthenaProviderProps {
     systemPrompt?: string;
     /** Thread ID override. Auto-generated if not provided. */
     threadId?: string;
+    /** Enable thread list management (list, switch, create threads). Defaults to false. */
+    enableThreadList?: boolean;
 }
 
 export declare interface AthenaRuntimeConfig {
@@ -181,6 +183,8 @@ export declare const CreatePresentationToolUI: ToolCallMessagePartComponent;
 
 export declare const CreateSheetToolUI: ToolCallMessagePartComponent;
 
+export declare function createThreadListStore(config: StoreConfig): UseBoundStore<StoreApi<ThreadListStore>>;
+
 export declare const DEFAULT_BACKEND_URL = "https://api.athenaintel.com/api/assistant-ui";
 
 export declare const EmailSearchToolUI: ToolCallMessagePartComponent;
@@ -263,6 +267,52 @@ declare interface SourceResult {
     };
 }
 
+declare interface StoreConfig {
+    backendUrl: string;
+    apiKey?: string;
+    token?: string | null;
+}
+
+export declare function ThreadList({ className }: ThreadListProps): JSX.Element;
+
+export declare interface ThreadListActions {
+    /** Fetch threads from Agora. */
+    fetchThreads: () => Promise<void>;
+    /** Switch to an existing thread. */
+    switchThread: (threadId: string) => void;
+    /** Create a new thread and switch to it. */
+    newThread: () => Promise<string>;
+    /** Archive a thread. If it's active, switch to the most recent thread. */
+    archiveThread: (threadId: string) => Promise<void>;
+}
+
+export declare interface ThreadListProps {
+    className?: string;
+}
+
+export declare interface ThreadListState {
+    threads: ThreadSummary[];
+    activeThreadId: string | null;
+    isLoading: boolean;
+    error: string | null;
+}
+
+export declare type ThreadListStore = ThreadListState & ThreadListActions;
+
+/**
+ * Agora thread API client.
+ * Calls existing REST endpoints for thread CRUD.
+ */
+export declare interface ThreadSummary {
+    thread_id: string;
+    title: string;
+    created_at: string;
+    updated_at: string;
+    last_message: string | null;
+    message_count: number;
+    state: string | null;
+}
+
 export declare const TiptapComposer: FC<TiptapComposerProps>;
 
 export declare interface TiptapComposerProps {
@@ -334,6 +384,21 @@ export declare function TooltipTrigger({ ...props }: React_2.ComponentProps<type
 
 export declare function tryParseJson(text: string): Record<string, unknown> | null;
 
+/** Hook to get just the active thread ID. */
+export declare function useActiveThreadId(): string | null;
+
+/**
+ * Hook to programmatically append text to the composer.
+ *
+ * Usage:
+ *   const append = useAppendToComposer();
+ *   append("some text to add");
+ *   append("quoted text", { replace: true }); // replaces existing text
+ */
+export declare function useAppendToComposer(): (text: string, opts?: {
+    replace?: boolean;
+}) => void;
+
 /**
  * Hook to generate an embed URL for rendering an asset in an iframe.
  * Calls the Agora `/api/embed/generate-token` endpoint.
@@ -361,6 +426,21 @@ export declare function useAthenaConfig(): AthenaConfig;
 
 export declare const useAthenaRuntime: (config: AthenaRuntimeConfig) => AssistantRuntime;
 
+/**
+ * Hook for programmatic composer file attachment control.
+ *
+ * Usage:
+ *   const { addFile, addContent, clear } = useComposerAttachment();
+ *   addFile(fileObject);
+ *   addContent("data.csv", "col1,col2\n1,2");
+ *   clear();
+ */
+export declare function useComposerAttachment(): {
+    addFile: (file: File) => void;
+    addContent: (name: string, content: string) => void;
+    clear: () => void;
+};
+
 export declare function useMentionSuggestions(tools: MentionTool[]): MentionSuggestionsStore;
 
 /**
@@ -378,6 +458,9 @@ export declare function useMentionSuggestions(tools: MentionTool[]): MentionSugg
  */
 export declare function useParentAuth(): string | null;
 
+/** Hook to access thread list state and actions. */
+export declare function useThreadList(): ThreadListState & ThreadListActions;
+
 export declare type ViewMode = 'tabs' | 'tiled';
 
 export declare const WebSearchToolUI: ToolCallMessagePartComponent;