@arbidocs/react 0.4.5 → 0.4.6

package/dist/index.js

@@ -1,11 +1,11 @@
-import { useDocuments, useAssistantQuery, arbiQueryKeys, useWorkspaces, useParsedDocument, useTags, useActivity, useThumbnails } from './chunk-ZY53R6I4.js';
-export { DEFAULT_USD_PER_CREDIT, arbiQueryKeys, creditsToUsd, formatCredits, isUsageMetered, useActivity, useAgents, useAssistantQuery, useConfigs, useConversations, useDeleteAgents, useDocuments, useFacts, useHealth, useParsedDocument, useProjectInvoices, useProjectUsage, useProjects, useProjectsUsage, useSessions, useTags, useTasks, useThumbnails, useUserUsageToday, useWorkspaces } from './chunk-ZY53R6I4.js';
+import { useDocuments, useConversations, useAssistantQuery, useConversationThreads, arbiQueryKeys, useWorkspaces, useParsedDocument, useTags, useActivity, useThumbnails } from './chunk-KWCHIAQ5.js';
+export { DEFAULT_USD_PER_CREDIT, arbiQueryKeys, creditsToUsd, formatCredits, isUsageMetered, useActivity, useAgents, useAssistantQuery, useConfigs, useConversationThreads, useConversations, useDeleteAgents, useDocuments, useFacts, useHealth, useParsedDocument, useProjectInvoices, useProjectUsage, useProjects, useProjectsUsage, useSessions, useTags, useTasks, useThumbnails, useUserUsageToday, useWorkspaces } from './chunk-KWCHIAQ5.js';
+import { MarkMenu, AiMarkdown, Card, Button, Badge, TagEntity, Input, FILE_TYPE_COLORS, getEntityIcon, UserEntity, getEntityColorStyles, AgentBadge, Textarea, Label, Slider, Dialog, DialogContent, DialogHeader, DialogTitle, DialogFooter, DocumentEntity, DocumentCard, useAudioRecorder, MicWaveformIndicator, IconToggle, classifyMediaError, formatElapsed, PassageCard } from './chunk-2ACHNDO6.js';
+export { AgentBadge, AiMarkdown, ArbiBotHeadIcon, AudIcon, Avatar, AvatarFallback, AvatarImage, BASE_COLORS, Badge, Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DictateProvider, DocumentCard, DocumentEntity, ENTITY_MAPPINGS, EmlIcon, EntityIcon, EntityPill, FILE_TYPE_COLORS, HoverCard, HoverCardContent, HoverCardTrigger, IconToggle, ImgIcon, InlineMicButton, Input, Label, MarkMenu, MicRecordingOverlay, MicWaveformIndicator, NEUTRAL_GRAY, PLACEHOLDER_COLOR, PassageCard, PdfIcon, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, PresenceLabel, Progress, ProjectEntity, RadioGroup, RadioGroupItem, RagDot, RelevanceDot, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Slider, StatusPill, Switch, TAG_TYPE_ICONS, TAG_TYPE_LABELS, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, TagEntity, Textarea, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UserEntity, UserMenu, VISIBILITY_ICONS, VidIcon, VisibilityIcon, badgeVariants, buttonVariants, cardVariants, configureEntityRegistry, configureRagLabels, configureStatusRegistry, formatElapsed, getDocIcon, getEntityColor, getEntityColorStyles, getEntityIcon, getEntityLabel, getStatusVariant, getTagTypeIcon, getTagTypeLabel, getWorkspaceColor, toggleVariants, useAudioRecorder } from './chunk-2ACHNDO6.js';
+import { normalizeCitationMarkup, MarkdownRenderer } from './chunk-RIHMIEXM.js';
+export { MarkdownRenderer, MarkdownStreamingContext, markdownBaseComponents, normalizeCitationMarkup, splitMarkdownBlocks, trimOpenCitation } from './chunk-RIHMIEXM.js';
 import { formatRelativeTime } from './chunk-FSMIN5VX.js';
 export { DEFAULT_NOTIFY_TONE, NotificationBell, Toaster, formatRelativeTime, notify, seedNotifications, selectUnread, toast, useNotify } from './chunk-FSMIN5VX.js';
-import { MarkMenu, AiMarkdown, Card, Button, Badge, TagEntity, Input, FILE_TYPE_COLORS, getEntityIcon, UserEntity, getEntityColorStyles, AgentBadge, Textarea, Label, Slider, Dialog, DialogContent, DialogHeader, DialogTitle, DialogFooter, DocumentEntity, DocumentCard, useAudioRecorder, MicWaveformIndicator, IconToggle, classifyMediaError, formatElapsed, PassageCard } from './chunk-DVRJFLE7.js';
-export { AgentBadge, AiMarkdown, ArbiBotHeadIcon, AudIcon, Avatar, AvatarFallback, AvatarImage, BASE_COLORS, Badge, Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DictateProvider, DocumentCard, DocumentEntity, ENTITY_MAPPINGS, EmlIcon, EntityIcon, EntityPill, FILE_TYPE_COLORS, HoverCard, HoverCardContent, HoverCardTrigger, IconToggle, ImgIcon, InlineMicButton, Input, Label, MarkMenu, MicRecordingOverlay, MicWaveformIndicator, NEUTRAL_GRAY, PLACEHOLDER_COLOR, PassageCard, PdfIcon, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, PresenceLabel, Progress, ProjectEntity, RadioGroup, RadioGroupItem, RagDot, RelevanceDot, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Slider, StatusPill, Switch, TAG_TYPE_ICONS, TAG_TYPE_LABELS, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, TagEntity, Textarea, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UserEntity, UserMenu, VISIBILITY_ICONS, VidIcon, VisibilityIcon, badgeVariants, buttonVariants, cardVariants, configureEntityRegistry, configureRagLabels, configureStatusRegistry, formatElapsed, getDocIcon, getEntityColor, getEntityColorStyles, getEntityIcon, getEntityLabel, getStatusVariant, getTagTypeIcon, getTagTypeLabel, getWorkspaceColor, toggleVariants, useAudioRecorder } from './chunk-DVRJFLE7.js';
-import { normalizeCitationMarkup, MarkdownRenderer } from './chunk-H7ZZQ4ZV.js';
-export { MarkdownRenderer, MarkdownStreamingContext, markdownBaseComponents, normalizeCitationMarkup, splitMarkdownBlocks } from './chunk-H7ZZQ4ZV.js';
 import { ScrollArea, DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator } from './chunk-N5SVBDLC.js';
 export { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ScrollArea, ScrollBar } from './chunk-N5SVBDLC.js';
 import { cn } from './chunk-SN5YV6FF.js';
@@ -14,11 +14,11 @@ import { AudioViewer, ImageViewer, VideoViewer } from './chunk-HDCRPPBW.js';
 import { useArbi } from './chunk-J4MX2W4H.js';
 export { ArbiProvider, useArbi } from './chunk-J4MX2W4H.js';
 import React, { memo, useState, createContext, useMemo, useCallback, useEffect, useRef, useLayoutEffect, useContext, useId, Fragment as Fragment$1 } from 'react';
+import { resolveCitations, summarizeCitations, connectWithReconnect } from '@arbidocs/sdk/browser';
+export { Arbi, ArbiError } from '@arbidocs/sdk/browser';
 import { Link, Trash2, CheckCheck, Check, Loader2, AlertTriangle, ShieldCheck, Copy, Sparkles, FileText, GitCompareArrows, Download, Image as Image$1, Search, CornerDownLeft, X, ArrowLeft, Send, Tags, Crown, Info, Activity, Gauge, Gift, PartyPopper, UserCheck, MessageCircleMore, FileX2, FileCheck2, Pencil, FolderPlus, SquareArrowOutUpRight, MessagesSquare, ArrowRight, MoreHorizontal, SquarePen, Mic, Pause, Play, Square, RotateCcw, Camera, Circle } from 'lucide-react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
-import { connectWithReconnect } from '@arbidocs/sdk/browser';
-export { Arbi, ArbiError } from '@arbidocs/sdk/browser';
-import { isMessageType } from '@arbidocs/client';
+import { isMessageType, passwordChangeErrorMessage } from '@arbidocs/client';
 export { isMessageType } from '@arbidocs/client';
 import { create } from 'zustand';
 import { useQueryClient, useMutation, useQuery } from '@tanstack/react-query';
@@ -30,14 +30,67 @@ import Cropper from 'react-easy-crop';
 import { AgGridReact } from 'ag-grid-react';
 import { ModuleRegistry, AllCommunityModule } from 'ag-grid-community';
 
+function previewText(content) {
+  return content.replace(/\s+/g, " ").trim().replace(/^(?:(?:[-*•>]|#{1,6})\s+)+/, "");
+}
+function toChatCitations(source) {
+  if (!source?.tools) return [];
+  const resolved = resolveCitations(source);
+  const summaries = summarizeCitations(resolved);
+  return resolved.map((r, i) => {
+    const summary = summaries[i];
+    return {
+      num: r.citationNum,
+      statement: summary.statement,
+      documentTitle: summary.docTitle,
+      page: summary.pageNumber,
+      passages: r.chunks.map((chunk) => ({
+        id: chunk.metadata.chunk_ext_id,
+        documentId: chunk.metadata.doc_ext_id ?? null,
+        documentTitle: chunk.metadata.doc_title ?? summary.docTitle,
+        page: chunk.metadata.page_number ?? null,
+        text: previewText(chunk.content)
+      }))
+    };
+  });
+}
+
+// src/chat/useArbiChat.ts
 var counter = 0;
 var nextId = (prefix) => `${prefix}-${Date.now().toString(36)}-${(counter++).toString(36)}`;
 var emptyThread = () => ({
-  id: nextId("thread"),
+  key: nextId("thread"),
+  conversationId: null,
+  title: "",
+  messages: [],
+  responseId: null,
+  isLoaded: true
+});
+var storedThread = (conversationId) => ({
+  key: conversationId,
+  conversationId,
   title: "",
   messages: [],
-  responseId: null
+  responseId: null,
+  isLoaded: false
 });
+var publicId = (t) => t.conversationId ?? t.key;
+function messagesFromHistory(history) {
+  return history.filter((m) => m.role !== "system" && m.content.trim() !== "").map((m) => {
+    if (m.role === "user") {
+      return { id: m.external_id, role: "user", content: m.content, status: "complete" };
+    }
+    const citations = toChatCitations({ tools: m.tools });
+    return {
+      id: m.external_id,
+      role: "assistant",
+      content: m.content,
+      status: m.status === "failed" ? "error" : "complete",
+      ...m.status === "failed" ? { error: "The assistant request failed." } : {},
+      ...citations.length > 0 ? { citations } : {}
+    };
+  });
+}
 function titleFromQuestion(question, maxLength = 48) {
   const flat = question.replace(/\s+/g, " ").trim();
   if (flat.length <= maxLength) return flat;
@@ -47,29 +100,88 @@ function titleFromQuestion(question, maxLength = 48) {
   return `${words.replace(/[\s,;:.\-–—]+$/, "")}\u2026`;
 }
 var messageOf = (e, fallback) => e instanceof Error ? e.message : fallback;
+var isAbort = (e) => e instanceof DOMException && e.name === "AbortError";
+var TITLE_REFRESH_DELAYS_MS = [2500, 6e3, 12e3];
 function useArbiChat(options = {}) {
   const { workspaceId, model, titleLength = 48 } = options;
   const arbi = useArbi();
   const { data: docs = [], isLoading: isLoadingDocuments, refetch } = useDocuments(workspaceId);
+  const {
+    data: stored = [],
+    isLoading: isLoadingThreads,
+    refetch: refetchConversations
+  } = useConversations(workspaceId);
   const query = useAssistantQuery();
   const { mutateAsync } = query;
   const [threads, setThreads] = useState(() => [emptyThread()]);
-  const [activeId, setActiveId] = useState(() => threads[0].id);
+  const [activeKey, setActiveKey] = useState(() => threads[0].key);
   const [deselected, setDeselected] = useState(/* @__PURE__ */ new Set());
   const [isRunning, setIsRunning] = useState(false);
   const [isUploading, setIsUploading] = useState(false);
   const [uploadError, setUploadError] = useState(null);
+  const [historyError, setHistoryError] = useState(null);
+  const abortRef = useRef(null);
+  const timersRef = useRef([]);
+  useEffect(() => {
+    const timers = timersRef.current;
+    return () => timers.forEach(clearTimeout);
+  }, []);
   const scopeRef = useRef(workspaceId);
   useEffect(() => {
     if (scopeRef.current === workspaceId) return;
     scopeRef.current = workspaceId;
     const fresh = emptyThread();
     setThreads([fresh]);
-    setActiveId(fresh.id);
+    setActiveKey(fresh.key);
     setDeselected(/* @__PURE__ */ new Set());
     setUploadError(null);
+    setHistoryError(null);
   }, [workspaceId]);
-  const active = threads.find((t) => t.id === activeId) ?? threads[0];
+  const active = threads.find((t) => t.key === activeKey) ?? threads[0];
+  const threadEntries = useMemo(() => {
+    const storedIds = new Set(stored.map((c) => c.external_id));
+    const byConversation = new Map(
+      threads.filter((t) => t.conversationId).map((t) => [t.conversationId, t])
+    );
+    const fresh = threads.filter((t) => !t.conversationId);
+    const justSaved = threads.filter((t) => t.conversationId && !storedIds.has(t.conversationId));
+    const persisted = [...stored].filter((c) => c.message_count > 0 || byConversation.has(c.external_id)).sort((a, b) => b.updated_at.localeCompare(a.updated_at)).map((c) => {
+      const local = byConversation.get(c.external_id);
+      return {
+        key: local?.key ?? c.external_id,
+        id: c.external_id,
+        title: c.title || local?.title || ""
+      };
+    });
+    return [
+      ...fresh.map((t) => ({ key: t.key, id: publicId(t), title: t.title })),
+      ...justSaved.map((t) => ({ key: t.key, id: publicId(t), title: t.title })),
+      ...persisted
+    ];
+  }, [threads, stored]);
+  const needsLoad = !!active.conversationId && !active.isLoaded;
+  const loaded = useConversationThreads(workspaceId, active.conversationId ?? void 0, {
+    enabled: needsLoad
+  });
+  useEffect(() => {
+    const data = loaded.data;
+    if (!needsLoad || !data || data.conversation_ext_id !== active.conversationId) return;
+    const primary = [...data.threads].sort((a, b) => b.history.length - a.history.length)[0];
+    setThreads(
+      (all) => all.map(
+        (t) => t.key === active.key ? {
+          ...t,
+          isLoaded: true,
+          messages: messagesFromHistory(primary?.history ?? []),
+          responseId: primary?.leaf_message_ext_id ?? null
+        } : t
+      )
+    );
+  }, [loaded.data, needsLoad, active.conversationId, active.key]);
+  useEffect(() => {
+    if (loaded.error)
+      setHistoryError(messageOf(loaded.error, "The conversation could not be loaded."));
+  }, [loaded.error]);
   const selectedIds = useMemo(
     () => docs.map((d) => d.external_id).filter((id) => !!id && !deselected.has(id)),
     [docs, deselected]
@@ -83,16 +195,23 @@ function useArbiChat(options = {}) {
     [docs, deselected]
   );
   const patchThread = useCallback(
-    (id, patch) => setThreads((all) => all.map((t) => t.id === id ? patch(t) : t)),
+    (key, patch) => setThreads((all) => all.map((t) => t.key === key ? patch(t) : t)),
     []
   );
   const patchMessage = useCallback(
-    (threadId, messageId, patch) => patchThread(threadId, (t) => ({
+    (threadKey, messageId, patch) => patchThread(threadKey, (t) => ({
       ...t,
       messages: t.messages.map((m) => m.id === messageId ? { ...m, ...patch } : m)
     })),
     [patchThread]
   );
+  const refreshTitles = useCallback(() => {
+    void refetchConversations();
+    timersRef.current.forEach(clearTimeout);
+    timersRef.current = TITLE_REFRESH_DELAYS_MS.map(
+      (delay) => setTimeout(() => void refetchConversations(), delay)
+    );
+  }, [refetchConversations]);
   const ask = useCallback(
     async (thread, text) => {
       const userMessage = {
@@ -107,11 +226,13 @@ function useArbiChat(options = {}) {
         content: "",
         status: "streaming"
       };
-      patchThread(thread.id, (t) => ({
+      patchThread(thread.key, (t) => ({
         ...t,
         title: t.title || titleFromQuestion(text, titleLength),
         messages: [...t.messages, userMessage, answer]
       }));
+      const controller = new AbortController();
+      abortRef.current = controller;
       setIsRunning(true);
       let buffer = "";
       let steps = 0;
@@ -122,15 +243,34 @@ function useArbiChat(options = {}) {
           docIds: selectedIds,
           previousResponseId: thread.responseId,
           model,
+          signal: controller.signal,
+          onStreamStart: (data) => {
+            if (data.assistant_message_ext_id) {
+              patchThread(thread.key, (t) => ({
+                ...t,
+                responseId: data.assistant_message_ext_id ?? t.responseId
+              }));
+            }
+          },
+          onUserMessage: (ev) => {
+            patchThread(thread.key, (t) => ({
+              ...t,
+              conversationId: t.conversationId ?? ev.conversation_ext_id
+            }));
+          },
+          onMetadata: (meta) => {
+            const citations = toChatCitations(meta);
+            if (citations.length > 0) patchMessage(thread.key, answer.id, { citations });
+          },
           onToken: (token) => {
             buffer += token;
-            patchMessage(thread.id, answer.id, { content: buffer });
+            patchMessage(thread.key, answer.id, { content: buffer });
           },
           onOutputItemDone: (ev) => {
             const type = ev.item.type;
             if (type === "function_call" || type === "reasoning") {
               steps += 1;
-              patchMessage(thread.id, answer.id, { stepCount: steps });
+              patchMessage(thread.key, answer.id, { stepCount: steps });
             }
           },
           onError: (message) => {
@@ -140,37 +280,50 @@ function useArbiChat(options = {}) {
         const finalText = result.text || buffer;
         const failure = streamError || result.errors[0] || null;
         if (failure && !finalText) {
-          patchMessage(thread.id, answer.id, { status: "error", error: failure });
+          patchMessage(thread.key, answer.id, { status: "error", error: failure });
         } else {
-          patchMessage(thread.id, answer.id, {
+          const citations = toChatCitations(result.metadata);
+          patchMessage(thread.key, answer.id, {
             status: "complete",
             content: finalText,
-            stepCount: result.agentSteps.length || steps || void 0
+            stepCount: result.agentSteps.length || steps || void 0,
+            ...citations.length > 0 ? { citations } : {}
           });
-          patchThread(thread.id, (t) => ({
+          patchThread(thread.key, (t) => ({
             ...t,
             responseId: result.assistantMessageExtId ?? t.responseId
           }));
         }
       } catch (e) {
-        patchMessage(thread.id, answer.id, {
-          status: "error",
-          error: messageOf(e, "The assistant request failed.")
-        });
+        if (controller.signal.aborted || isAbort(e)) {
+          patchMessage(thread.key, answer.id, {
+            status: "complete",
+            content: buffer,
+            stopped: true
+          });
+        } else {
+          patchMessage(thread.key, answer.id, {
+            status: "error",
+            error: messageOf(e, "The assistant request failed.")
+          });
+        }
       } finally {
+        if (abortRef.current === controller) abortRef.current = null;
         setIsRunning(false);
+        refreshTitles();
       }
     },
-    [mutateAsync, patchMessage, patchThread, selectedIds, model, titleLength]
+    [mutateAsync, patchMessage, patchThread, refreshTitles, selectedIds, model, titleLength]
   );
   const send = useCallback(
     async (text) => {
       const trimmed = text.trim();
-      if (!trimmed || isRunning) return;
+      if (!trimmed || isRunning || !active.isLoaded) return;
       await ask(active, trimmed);
     },
     [active, ask, isRunning]
   );
+  const stop = useCallback(() => abortRef.current?.abort(), []);
   const lastMessage = active.messages[active.messages.length - 1];
   const error = lastMessage?.status === "error" ? lastMessage.error ?? null : null;
   const retry = useCallback(async () => {
@@ -180,23 +333,54 @@ function useArbiChat(options = {}) {
     const question = messages[messages.length - 2];
     if (failed?.status !== "error" || question?.role !== "user") return;
     const trimmed = { ...active, messages: messages.slice(0, -2) };
-    patchThread(active.id, () => trimmed);
+    patchThread(active.key, () => trimmed);
     await ask(trimmed, question.content);
   }, [active, ask, isRunning, patchThread]);
   const newThread = useCallback(() => {
-    if (active.messages.length === 0) return;
+    setHistoryError(null);
+    const blank = threads.find((t) => !t.conversationId && t.messages.length === 0);
+    if (blank) {
+      setActiveKey(blank.key);
+      return;
+    }
     const fresh = emptyThread();
     setThreads((all) => [fresh, ...all]);
-    setActiveId(fresh.id);
-  }, [active.messages.length]);
+    setActiveKey(fresh.key);
+  }, [threads]);
+  const selectThread = useCallback(
+    (id) => {
+      const entry = threadEntries.find((e) => e.id === id);
+      if (!entry) return;
+      setHistoryError(null);
+      setThreads((all) => all.some((t) => t.key === entry.key) ? all : [...all, storedThread(id)]);
+      setActiveKey(entry.key);
+    },
+    [threadEntries]
+  );
   const deleteThread = useCallback(
     (id) => {
-      const rest = threads.filter((t) => t.id !== id);
-      const next = rest.length > 0 ? rest : [emptyThread()];
-      setThreads(next);
-      if (id === activeId) setActiveId(next[0].id);
+      const entry = threadEntries.find((e) => e.id === id);
+      if (!entry) return;
+      const remove = () => {
+        const rest = threads.filter((t) => t.key !== entry.key);
+        const next = rest.length > 0 ? rest : [emptyThread()];
+        setThreads(next);
+        if (entry.key === active.key) setActiveKey(next[0].key);
+      };
+      const local = threads.find((t) => t.key === entry.key);
+      const conversationId = local ? local.conversationId : id;
+      if (!conversationId) return remove();
+      void (async () => {
+        try {
+          await arbi.conversations.delete(conversationId);
+          remove();
+          await refetchConversations();
+        } catch (e) {
+          setHistoryError(messageOf(e, "The conversation could not be deleted."));
+        }
+      })();
     },
-    [threads, activeId]
+    [threadEntries, threads, active.key, arbi, refetchConversations]
   );
   const toggleDocument = useCallback((id) => {
     setDeselected((prev) => {
@@ -224,18 +408,22 @@ function useArbiChat(options = {}) {
     [arbi, refetch]
   );
   return {
-    threads: threads.map(({ id, title }) => ({ id, title })),
-    activeThreadId: active.id,
+    threads: threadEntries.map(({ id, title }) => ({ id, title })),
+    activeThreadId: publicId(active),
     messages: active.messages,
     isRunning,
     error,
+    isLoadingThread: needsLoad && !historyError,
+    isLoadingThreads,
+    historyError,
     documents,
     isLoadingDocuments,
     isUploading,
     uploadError,
     send,
     retry,
-    selectThread: setActiveId,
+    stop,
+    selectThread,
     newThread,
     deleteThread,
     toggleDocument,
@@ -842,6 +1030,418 @@ function useRemoveContacts() {
     onSuccess: () => qc.invalidateQueries({ queryKey: arbiQueryKeys.contacts() })
   });
 }
+function toProfileView(profile) {
+  return {
+    ...profile,
+    fullName: [profile.givenName, profile.familyName].map((part) => part?.trim()).filter(Boolean).join(" ")
+  };
+}
+function useProfile(options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys.profile(),
+    queryFn: () => {
+      const profile = arbi.user.profile();
+      return profile ? toProfileView(profile) : null;
+    },
+    enabled: (options?.enabled ?? true) && arbi.isLoggedIn,
+    staleTime: Infinity
+  });
+}
+function useUpdateProfile() {
+  const arbi = useArbi();
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: async (vars) => {
+      await arbi.profile.update({
+        ...vars.givenName !== void 0 && { given_name: vars.givenName.trim() },
+        ...vars.familyName !== void 0 && { family_name: vars.familyName.trim() },
+        ...vars.picture !== void 0 && { picture: vars.picture }
+      });
+      const profile = arbi.user.profile();
+      return profile ? toProfileView(profile) : null;
+    },
+    onSuccess: (profile) => {
+      qc.setQueryData(arbiQueryKeys.profile(), profile);
+      return qc.invalidateQueries({ queryKey: arbiQueryKeys.workspaces() });
+    }
+  });
+}
+function useNameEditor({ givenName, familyName, save }) {
+  const [isEditing, setIsEditing] = useState(false);
+  const [given, setGiven] = useState("");
+  const [family, setFamily] = useState("");
+  const [isSaving, setIsSaving] = useState(false);
+  const [error, setError] = useState(null);
+  const onStartEdit = useCallback(() => {
+    setGiven(givenName ?? "");
+    setFamily(familyName ?? "");
+    setError(null);
+    setIsEditing(true);
+  }, [givenName, familyName]);
+  const onSave = useCallback(() => {
+    const trimmedGiven = given.trim();
+    if (!trimmedGiven) return;
+    setIsSaving(true);
+    setError(null);
+    void Promise.resolve().then(() => save({ givenName: trimmedGiven, familyName: family.trim() })).then(() => setIsEditing(false)).catch((e) => setError(e)).finally(() => setIsSaving(false));
+  }, [given, family, save]);
+  return {
+    isEditing,
+    givenName: given,
+    familyName: family,
+    onGivenNameChange: setGiven,
+    onFamilyNameChange: setFamily,
+    onStartEdit,
+    onSave,
+    onCancel: () => setIsEditing(false),
+    isSaving,
+    error
+  };
+}
+var MAX_AVATAR_FILE_BYTES = 5 * 1024 * 1024;
+function useAvatarCrop({
+  upload,
+  onProblem,
+  maxBytes = MAX_AVATAR_FILE_BYTES
+}) {
+  const [pendingImage, setPendingImage] = useState(null);
+  const [isUploading, setIsUploading] = useState(false);
+  const onFileChosen = useCallback(
+    (file) => {
+      if (!file.type.startsWith("image/")) return onProblem?.("not-image");
+      if (file.size > maxBytes) return onProblem?.("too-large");
+      const reader = new FileReader();
+      reader.onload = () => setPendingImage(reader.result);
+      reader.onerror = () => onProblem?.("unreadable");
+      reader.readAsDataURL(file);
+    },
+    [maxBytes, onProblem]
+  );
+  const onCropComplete = useCallback(
+    (result) => {
+      setPendingImage(null);
+      setIsUploading(true);
+      void Promise.resolve().then(() => upload(result.dataUrl)).catch(() => {
+      }).finally(() => setIsUploading(false));
+    },
+    [upload]
+  );
+  return {
+    onFileChosen,
+    pendingImage,
+    onCropComplete,
+    onCropCancel: () => setPendingImage(null),
+    isUploading
+  };
+}
+function useRequestEmailChange() {
+  const arbi = useArbi();
+  return useMutation({
+    mutationFn: (newEmail) => arbi.account.requestEmailChange(newEmail)
+  });
+}
+function useConfirmEmailChange() {
+  const arbi = useArbi();
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: ({ newEmail, code }) => arbi.account.confirmEmailChange(newEmail, code),
+    onSuccess: () => {
+      const profile = arbi.user.profile();
+      qc.setQueryData(arbiQueryKeys.profile(), profile ? toProfileView(profile) : null);
+    }
+  });
+}
+function useEmailChange({
+  requestCode,
+  confirm,
+  cooldownSeconds: cooldownLength = 30
+}) {
+  const [isOpen, setIsOpen] = useState(false);
+  const [step, setStep] = useState("enter");
+  const [newEmail, setNewEmail] = useState("");
+  const [code, setCode] = useState("");
+  const [cooldown, setCooldown] = useState(0);
+  const [isSending, setIsSending] = useState(false);
+  const [isConfirming, setIsConfirming] = useState(false);
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    if (cooldown <= 0) return;
+    const timer = setTimeout(() => setCooldown((c) => c - 1), 1e3);
+    return () => clearTimeout(timer);
+  }, [cooldown]);
+  const reset = useCallback(() => {
+    setIsOpen(false);
+    setStep("enter");
+    setNewEmail("");
+    setCode("");
+    setError(null);
+  }, []);
+  const onSendCode = useCallback(() => {
+    const email = newEmail.trim();
+    if (!email) return;
+    setIsSending(true);
+    setError(null);
+    void Promise.resolve().then(() => requestCode(email)).then(() => {
+      setStep("verify");
+      setCooldown(cooldownLength);
+    }).catch((e) => setError(e)).finally(() => setIsSending(false));
+  }, [newEmail, requestCode, cooldownLength]);
+  const onConfirm = useCallback(() => {
+    const email = newEmail.trim();
+    const entered = code.trim();
+    if (!email || !entered) return;
+    setIsConfirming(true);
+    setError(null);
+    void Promise.resolve().then(() => confirm({ newEmail: email, code: entered })).then(reset).catch((e) => setError(e)).finally(() => setIsConfirming(false));
+  }, [newEmail, code, confirm, reset]);
+  return {
+    isOpen,
+    onStart: () => setIsOpen(true),
+    step,
+    newEmail,
+    onNewEmailChange: setNewEmail,
+    onSendCode,
+    isSending,
+    code,
+    onCodeChange: setCode,
+    onConfirm,
+    isConfirming,
+    cooldownSeconds: cooldown,
+    onCancel: reset,
+    error
+  };
+}
+function usePasswordChange() {
+  const arbi = useArbi();
+  return useMutation({
+    mutationFn: (vars) => arbi.account.changePassword(vars)
+  });
+}
+var DEFAULT_PASSWORD_CHANGE_FORM_MESSAGES = {
+  required: "All fields are required",
+  mismatch: "New passwords do not match",
+  sameAsCurrent: "New password must be different from current password",
+  wrongCurrent: "Current password is incorrect.",
+  wrongRecoveryKey: "Recovery key did not match this account. Try a different recovery file."
+};
+function usePasswordChangeForm({
+  recoveryMode = false,
+  getUnmetRequirement,
+  submit,
+  onClose,
+  onRecoveryComplete,
+  messages
+}) {
+  const m = useMemo(() => ({ ...DEFAULT_PASSWORD_CHANGE_FORM_MESSAGES, ...messages }), [messages]);
+  const [currentPassword, setCurrentPassword] = useState("");
+  const [newPassword, setNewPassword] = useState("");
+  const [confirmPassword, setConfirmPassword] = useState("");
+  const [error, setError] = useState(null);
+  const [isProcessing, setIsProcessing] = useState(false);
+  const [result, setResult] = useState(null);
+  const clear = useCallback(() => {
+    setCurrentPassword("");
+    setNewPassword("");
+    setConfirmPassword("");
+  }, []);
+  const isSubmitDisabled = isProcessing || !recoveryMode && !currentPassword || !newPassword || !confirmPassword || getUnmetRequirement(newPassword) !== null || newPassword !== confirmPassword;
+  const onSubmit = useCallback(() => {
+    setError(null);
+    if (!recoveryMode && !currentPassword || !newPassword || !confirmPassword) {
+      return setError(m.required);
+    }
+    if (newPassword !== confirmPassword) return setError(m.mismatch);
+    const unmet = getUnmetRequirement(newPassword);
+    if (unmet !== null) return setError(unmet);
+    if (!recoveryMode && currentPassword === newPassword) return setError(m.sameAsCurrent);
+    setIsProcessing(true);
+    void submit({ newPassword, currentPassword: recoveryMode ? void 0 : currentPassword }).then((outcome) => {
+      clear();
+      if (recoveryMode) {
+        onClose();
+        onRecoveryComplete?.();
+      } else {
+        setResult(outcome);
+      }
+    }).catch((e) => {
+      const message = passwordChangeErrorMessage(e);
+      const wrongCurrent = /invalid signature|current password|401/i.test(message);
+      setError(wrongCurrent ? recoveryMode ? m.wrongRecoveryKey : m.wrongCurrent : message);
+    }).finally(() => setIsProcessing(false));
+  }, [
+    recoveryMode,
+    currentPassword,
+    newPassword,
+    confirmPassword,
+    getUnmetRequirement,
+    submit,
+    clear,
+    onClose,
+    onRecoveryComplete,
+    m
+  ]);
+  return {
+    currentPassword,
+    onCurrentPasswordChange: setCurrentPassword,
+    newPassword,
+    onNewPasswordChange: setNewPassword,
+    confirmPassword,
+    onConfirmPasswordChange: setConfirmPassword,
+    error,
+    isProcessing,
+    isSubmitDisabled,
+    onSubmit,
+    result,
+    onCancel: () => {
+      clear();
+      setError(null);
+      setResult(null);
+      onClose();
+    },
+    onDone: () => {
+      setResult(null);
+      onClose();
+    }
+  };
+}
+function toNotificationPreferences(stored, keys) {
+  const checked = Object.fromEntries(keys.map((key) => [key, stored?.[key] ?? true]));
+  return {
+    masterChecked: keys.some((key) => checked[key]),
+    checked,
+    masterPatch: (value) => Object.fromEntries(keys.map((key) => [key, value])),
+    categoryPatch: (key, value) => ({ [key]: value })
+  };
+}
+function useUserSettings(options) {
+  const arbi = useArbi();
+  return useQuery({
+    queryKey: arbiQueryKeys.userSettings(),
+    queryFn: () => arbi.settings.get(),
+    enabled: (options?.enabled ?? true) && arbi.isLoggedIn
+  });
+}
+function useNotificationPreferences(keys, options) {
+  const arbi = useArbi();
+  const qc = useQueryClient();
+  const settings = useUserSettings(options);
+  const stored = settings.data?.email_notifications;
+  const save = useMutation({
+    mutationFn: (patch) => arbi.settings.update({ email_notifications: patch }),
+    onMutate: async (patch) => {
+      await qc.cancelQueries({ queryKey: arbiQueryKeys.userSettings() });
+      const previous = qc.getQueryData(arbiQueryKeys.userSettings());
+      qc.setQueryData(
+        arbiQueryKeys.userSettings(),
+        (old) => old ? { ...old, email_notifications: { ...old.email_notifications, ...patch } } : old
+      );
+      return { previous };
+    },
+    onError: (_err, _patch, context) => {
+      qc.setQueryData(arbiQueryKeys.userSettings(), context?.previous);
+    },
+    onSettled: () => qc.invalidateQueries({ queryKey: arbiQueryKeys.userSettings() })
+  });
+  const model = useMemo(() => toNotificationPreferences(stored, keys), [stored, keys]);
+  const setAll = useCallback(
+    (value) => save.mutate(model.masterPatch(value)),
+    [save, model]
+  );
+  const setCategory = useCallback(
+    (key, value) => save.mutate(model.categoryPatch(key, value)),
+    [save, model]
+  );
+  return {
+    ...model,
+    isLoading: settings.isLoading,
+    isSaving: save.isPending,
+    /** The master switch handler: every category on or off. */
+    setAll,
+    /** One category's handler. */
+    setCategory
+  };
+}
+function useTerminateSession() {
+  const arbi = useArbi();
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: (sessionId) => arbi.sessions.terminate(sessionId),
+    onSuccess: () => qc.invalidateQueries({ queryKey: arbiQueryKeys.sessions() })
+  });
+}
+function useLogoutAllSessions() {
+  const arbi = useArbi();
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: () => arbi.sessions.logoutAll(),
+    onSuccess: () => qc.clear()
+  });
+}
+function useCurrentSessionId() {
+  return useArbi().sessions.currentId();
+}
+function parseDeleteAccountBlockers(error) {
+  const body = error?.apiError ?? error;
+  const detail = body?.detail;
+  if (detail === "active_subscription") return [{ type: "active_subscription" }];
+  if (detail && typeof detail === "object") {
+    const d = detail;
+    if (d.reason === "workspace_members" && Array.isArray(d.workspaces)) {
+      return [{ type: "workspace_members", workspaces: d.workspaces.map(String) }];
+    }
+  }
+  return [];
+}
+function useDeleteAccount() {
+  const arbi = useArbi();
+  return useMutation({ mutationFn: () => arbi.account.requestDeletion() });
+}
+function useDeleteAccountFlow({
+  userEmail,
+  remove,
+  onClose,
+  onDeleted,
+  onError
+}) {
+  const [step, setStep] = useState("warning");
+  const [confirmEmail, setConfirmEmail] = useState("");
+  const [blockers, setBlockers] = useState([]);
+  const [isDeleting, setIsDeleting] = useState(false);
+  const close = useCallback(() => {
+    setStep("warning");
+    setConfirmEmail("");
+    setBlockers([]);
+    onClose();
+  }, [onClose]);
+  const onSubmit = useCallback(() => {
+    if (confirmEmail.toLowerCase() !== userEmail.toLowerCase()) return;
+    setIsDeleting(true);
+    void Promise.resolve().then(remove).then(() => {
+      close();
+      onDeleted();
+    }).catch((error) => {
+      const found = parseDeleteAccountBlockers(error);
+      if (found.length > 0) {
+        setBlockers(found);
+        setStep("warning");
+      } else {
+        onError?.(error);
+      }
+    }).finally(() => setIsDeleting(false));
+  }, [confirmEmail, userEmail, remove, close, onDeleted, onError]);
+  return {
+    step,
+    blockers,
+    confirmEmail,
+    onConfirmEmailChange: setConfirmEmail,
+    onContinue: () => setStep("confirm"),
+    onBack: () => setStep("warning"),
+    isDeleting,
+    onSubmit,
+    onClose: close
+  };
+}
 function useWorkspaceDocs(workspaceId) {
   const { data: docs = [], isLoading, isError } = useDocuments(workspaceId);
   const docIds = useMemo(
@@ -5067,6 +5667,6 @@ function hasVideoTrack(blob) {
   });
 }
 
-export { ActivityFeed, AiActionCard, AiAnswer, AppleIcon, ArbiBotIcon, ArbiIcon, ArbiWebSocketProvider, ArtifactCanvas, ChatBubble, CitationRenderer, ClaudeIcon, CommandPalette, CommandPaletteProvider, ConversationList, DEFAULT_ASPECT_OPTIONS, DEFAULT_START_BY_EMAIL_LABELS, DateSeparator, DirectMessages, DmAvatar, DmComposer, DocIcon, DocQaPanel, DocSearch, DocumentCardMenu, DocumentGallery, DocumentReview, DocumentTable, DraftTitleControls, FileIcon, FireworksIcon, GeminiIcon, GitHubIcon, GoogleIcon, HtmlIcon, ImageCropModal, ImageCropper, LinkedInIcon, MessageArtifactCard, MessageBubble, MessageThread, OpenAIIcon, PhotoCapture, ProviderIcon, RUN_WINDOW_MS, SemanticSearch, StartByEmail, TxtIcon, TypingIndicator, VideoCapture, VoiceNoteRecorder, XlsIcon, annotateThread, captureFrameAsBlob, cropImage, dayKey, describeActivity, getNotificationTypeMeta, getWorkspaceActionText, getWorkspaceKind, getWorkspaceSentPhrase, hasVideoTrack, isWorkspaceNotificationType, parseActivityContent, pickRecentWorkspaces, redlineStats, resolveActiveWorkspace, textToArtifact, titleFromQuestion, toRedlineMarkdown, toShellWorkspace, useAddContacts, useAgentConfig, useAgentModels, useAgentWorkspaces, useAiTask, useArbiChat, useArbiConnected, useArbiDocumentSync, useArbiShellWorkspaces, useArbiUiStore, useArbiWebSocket, useArbiWsContext, useArbiWsMessage, useArbiWsStatus, useArbiWsStore, useArbiWsTask, useArbiWsTasks, useCameraStream, useCommandPalette, useContacts, useCreateAgent, useCreateTask, useDeleteTask, useDirectMessages, useGrantAgentAccess, usePendingContacts, useRemoveContacts, useRevokeAgentAccess, useRunTask, useSaveAgentConfig, useSemanticSearch, useShellWorkspaces, useSkills, useTaskRuns, useUpdateTask, useVideoRecorder, useWorkspaceDocs, userDisplayName, userInitials };
+export { ActivityFeed, AiActionCard, AiAnswer, AppleIcon, ArbiBotIcon, ArbiIcon, ArbiWebSocketProvider, ArtifactCanvas, ChatBubble, CitationRenderer, ClaudeIcon, CommandPalette, CommandPaletteProvider, ConversationList, DEFAULT_ASPECT_OPTIONS, DEFAULT_PASSWORD_CHANGE_FORM_MESSAGES, DEFAULT_START_BY_EMAIL_LABELS, DateSeparator, DirectMessages, DmAvatar, DmComposer, DocIcon, DocQaPanel, DocSearch, DocumentCardMenu, DocumentGallery, DocumentReview, DocumentTable, DraftTitleControls, FileIcon, FireworksIcon, GeminiIcon, GitHubIcon, GoogleIcon, HtmlIcon, ImageCropModal, ImageCropper, LinkedInIcon, MAX_AVATAR_FILE_BYTES, MessageArtifactCard, MessageBubble, MessageThread, OpenAIIcon, PhotoCapture, ProviderIcon, RUN_WINDOW_MS, SemanticSearch, StartByEmail, TxtIcon, TypingIndicator, VideoCapture, VoiceNoteRecorder, XlsIcon, annotateThread, captureFrameAsBlob, cropImage, dayKey, describeActivity, getNotificationTypeMeta, getWorkspaceActionText, getWorkspaceKind, getWorkspaceSentPhrase, hasVideoTrack, isWorkspaceNotificationType, parseActivityContent, parseDeleteAccountBlockers, pickRecentWorkspaces, redlineStats, resolveActiveWorkspace, textToArtifact, titleFromQuestion, toChatCitations, toNotificationPreferences, toProfileView, toRedlineMarkdown, toShellWorkspace, useAddContacts, useAgentConfig, useAgentModels, useAgentWorkspaces, useAiTask, useArbiChat, useArbiConnected, useArbiDocumentSync, useArbiShellWorkspaces, useArbiUiStore, useArbiWebSocket, useArbiWsContext, useArbiWsMessage, useArbiWsStatus, useArbiWsStore, useArbiWsTask, useArbiWsTasks, useAvatarCrop, useCameraStream, useCommandPalette, useConfirmEmailChange, useContacts, useCreateAgent, useCreateTask, useCurrentSessionId, useDeleteAccount, useDeleteAccountFlow, useDeleteTask, useDirectMessages, useEmailChange, useGrantAgentAccess, useLogoutAllSessions, useNameEditor, useNotificationPreferences, usePasswordChange, usePasswordChangeForm, usePendingContacts, useProfile, useRemoveContacts, useRequestEmailChange, useRevokeAgentAccess, useRunTask, useSaveAgentConfig, useSemanticSearch, useShellWorkspaces, useSkills, useTaskRuns, useTerminateSession, useUpdateProfile, useUpdateTask, useUserSettings, useVideoRecorder, useWorkspaceDocs, userDisplayName, userInitials };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map