@athenaintel/react 0.2.0 → 0.4.0

package/dist/index.d.ts

@@ -30,6 +30,10 @@ export declare interface AssetPanelState {
     activeTabId: string | null;
     viewMode: ViewMode;
     isFullscreen: boolean;
+    /** Generation counter for auto-open tracking — incremented on reset */
+    autoOpenGeneration: number;
+    /** Tracks which assets have been auto-opened in the current generation */
+    autoOpenedAssets: Map<string, number>;
     openAsset: (assetId: string, meta?: {
         name?: string;
         type?: AssetType;
@@ -39,6 +43,10 @@ export declare interface AssetPanelState {
     setViewMode: (mode: ViewMode) => void;
     closePanel: () => void;
     toggleFullscreen: () => void;
+    /** Reset auto-open tracking (increments generation so new assets can auto-open) */
+    resetAutoOpen: () => void;
+    /** Check if an asset should auto-open, and mark it as opened if so */
+    markAutoOpened: (assetId: string) => boolean;
 }
 
 export declare interface AssetTab {
@@ -86,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;
@@ -115,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 {
@@ -173,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;
@@ -255,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 {
@@ -326,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.
@@ -353,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;
 
 /**
@@ -370,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;