@athenaintel/react 0.14.0 → 0.15.1

package/dist/threads/use-statewire-conversation-history.d.ts

@@ -0,0 +1,71 @@
+import { type ConversationIndexEntry, type ConversationSummary, type UseConversationIndexOptions } from "@athenaintel/agent-runtime";
+import { type RestConversationAuth } from "./use-rest-conversation-history";
+export interface UseStatewireConversationHistoryOptions {
+    backendUrl: string;
+    conversationIndexBaseUrl: string;
+    principalId: string;
+    getAuth: () => RestConversationAuth | Promise<RestConversationAuth>;
+    headers: UseConversationIndexOptions["headers"];
+    search?: string;
+    enabled?: boolean;
+    sse?: boolean;
+}
+/** Convert the replicated wire row into the shared cross-surface contract. */
+export declare function conversationSummaryFromIndexEntry(entry: ConversationIndexEntry): ConversationSummary;
+export declare function conversationHistorySource({ indexEntries, restConversations, supportsStatewirePaging, hasSearch, }: {
+    indexEntries: readonly ConversationIndexEntry[] | null;
+    restConversations: readonly ConversationSummary[];
+    supportsStatewirePaging: boolean;
+    hasSearch: boolean;
+}): ConversationSummary[];
+export declare function shouldUseRestConversationHistory({ hasSearch, indexEntries, supportsStatewirePaging, connectionStatus, }: {
+    hasSearch: boolean;
+    indexEntries: readonly ConversationIndexEntry[] | null;
+    supportsStatewirePaging: boolean;
+    connectionStatus: string;
+}): boolean;
+/**
+ * Inclusive satellite conversation history backed by the user's Pinned
+ * Statewire instance. The replicated window is the render source; refreshes,
+ * pagination, thread creation, lifecycle changes, and title changes arrive on
+ * that same channel. A non-empty search deliberately uses the authorized REST
+ * list endpoint so matches are not limited to the replicated newest window.
+ */
+export declare function useStatewireConversationHistory({ backendUrl, conversationIndexBaseUrl, principalId, getAuth, headers, search, enabled, sse, }: UseStatewireConversationHistoryOptions): {
+    conversations: {
+        threadId: string;
+        title: string;
+        updatedAt: string;
+        createdAt: string | null;
+        state: string | null;
+        runtime: string | null;
+        sourceChannel: string | null;
+        assetType: string | null;
+        assetId: string | null;
+        appId: string | null;
+        triggerType: string | null;
+        preview: string | null;
+        messageCount: number | null;
+        isUnread: boolean;
+    }[];
+    totalCount: number | null;
+    isLoading: boolean;
+    isFetching: boolean;
+    isRefreshing: boolean;
+    hasResolvedFirstPage: boolean;
+    hasNextPage: boolean;
+    isFetchingNextPage: boolean;
+    fetchNextPage: () => Promise<unknown>;
+    refresh: () => Promise<unknown>;
+    archiveConversation: import("@tanstack/react-query").UseMutateFunction<string, Error, string, void>;
+    archivePending: boolean;
+    setConversationReadState: import("@tanstack/react-query").UseMutateFunction<import("./api").ThreadReadStateResponse, Error, {
+        threadId: string;
+        isUnread: boolean;
+    }, {
+        previous: boolean;
+        threadId: string;
+    }>;
+    readStatePending: boolean;
+    connection: import("statewire").StatewireClient.Connection;
+};