@athenaintel/react 0.15.0 → 0.16.0

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;
+};

package/dist/tools/file-tool-uis.d.ts

@@ -0,0 +1,8 @@
+import type { ToolCallMessagePartComponent } from "@assistant-ui/react";
+/** Human label for an agent-workspace path (never surface scratch-file garble). */
+export declare function friendlyWorkspacePath(value: unknown): string | undefined;
+export declare const ReadFileToolUI: ToolCallMessagePartComponent;
+export declare const ListFilesToolUI: ToolCallMessagePartComponent;
+export declare const WriteFileToolUI: ToolCallMessagePartComponent;
+export declare const EditFileToolUI: ToolCallMessagePartComponent;
+export declare const SearchFilesToolUI: ToolCallMessagePartComponent;

package/dist/tools/todo-plan-store.d.ts

@@ -0,0 +1,29 @@
+import type { TodoPlan } from "./write-todos-tool-ui";
+/** Allocate a mount-ordered sequence number (pure counter — safe to discard). */
+export declare function allocatePlanSeq(): number;
+export declare function registerPlanCard(scope: string, seq: number, plan: TodoPlan, isWriting: boolean): void;
+export declare function updatePlanCard(scope: string, seq: number, plan: TodoPlan, isWriting: boolean): void;
+export declare function unregisterPlanCard(scope: string, seq: number): void;
+export declare function latestPlanSeq(scope: string): number | null;
+/** The plan scope for the calling component's chat (its thread id). */
+export declare function usePlanScope(): string;
+/**
+ * Whether the card with this sequence number is the newest mounted plan card
+ * in its scope. On the server (and before client effects have registered any
+ * card) every card reports latest, so static renders still show the plan.
+ */
+export declare function useIsLatestPlanCard(scope: string, seq: number): boolean;
+export interface LatestTodoPlan {
+    plan: TodoPlan;
+    /** True while the newest plan card's tool call is still streaming. */
+    isWriting: boolean;
+}
+/**
+ * The newest mounted plan for the calling chat, for hosts building their own
+ * pinned plan UI. Pair with `toolUIs={{ write_todos: HiddenWriteTodosToolUI }}`
+ * — that component keeps feeding this registry while rendering nothing inline
+ * (a bare `() => null` override would starve it).
+ */
+export declare function useLatestTodoPlan(): LatestTodoPlan | null;
+/** Test-only: reset module state between cases. */
+export declare function resetTodoPlanStoreForTests(): void;

package/dist/tools/write-todos-tool-ui.d.ts

@@ -14,4 +14,5 @@ export declare function parseTodoPlan({ args, argsText, result, }: {
     argsText?: string;
     result?: unknown;
 }): TodoPlan;
+export declare const HiddenWriteTodosToolUI: ToolCallMessagePartComponent;
 export declare const WriteTodosToolUI: ToolCallMessagePartComponent;