@arbidocs/react 0.4.2 → 0.4.4

package/dist/index.d.cts

@@ -1,11 +1,12 @@
 import * as React$1 from 'react';
 import React__default, { ReactNode, ComponentType } from 'react';
-import { ArbiOptions, Arbi, SSEStreamResult, SSEStreamStartData, ResponseOutputItemDoneEvent, ArtifactEvent } from '@arbidocs/sdk/browser';
-export { AgentStepEvent, Arbi, ArbiError, ArbiOptions, ArtifactEvent, CreateFactRequest, CreateTaskRequest, FactResponse, FactSearchRequest, FactSearchResponse, MessageMetadataPayload, OutputTokensDetails, ProjectInvoicesResponse, ProjectUsageResponse, QueryOptions, ResponseCompletedEvent, ResponseContentPartAddedEvent, ResponseCreatedEvent, ResponseFailedEvent, ResponseOutputItemAddedEvent, ResponseOutputItemDoneEvent, ResponseOutputTextDeltaEvent, ResponseOutputTextDoneEvent, ResponseUsage, SSEStreamCallbacks, SSEStreamResult, SSEStreamStartData, TaskResponse, UpdateTaskRequest, UserDailyUsageResponse, UserInputRequestEvent, UserMessageEvent } from '@arbidocs/sdk/browser';
+import { ArbiOptions, Arbi, SSEStreamResult, SSEStreamStartData, ResponseOutputItemDoneEvent, ArtifactEvent, UpdateTaskRequest } from '@arbidocs/sdk/browser';
+export { AgentStepEvent, Arbi, ArbiError, ArbiOptions, ArtifactEvent, CreateFactRequest, CreateTaskRequest, FactResponse, FactSearchRequest, FactSearchResponse, MessageMetadataPayload, OutputTokensDetails, ProjectInvoicesResponse, ProjectUsageResponse, QueryOptions, ResponseCompletedEvent, ResponseContentPartAddedEvent, ResponseCreatedEvent, ResponseFailedEvent, ResponseOutputItemAddedEvent, ResponseOutputItemDoneEvent, ResponseOutputTextDeltaEvent, ResponseOutputTextDoneEvent, ResponseUsage, SSEStreamCallbacks, SSEStreamResult, SSEStreamStartData, SkillSummary, TaskResponse, UpdateTaskRequest, UserDailyUsageResponse, UserInputRequestEvent, UserMessageEvent } from '@arbidocs/sdk/browser';
 import * as _arbidocs_client from '@arbidocs/client';
 import { WebSocketServerMessage, WsTaskUpdateMessage, WsPresenceUpdateMessage, components } from '@arbidocs/client';
 export { WebSocketServerMessage, WsBatchCompleteMessage, WsNotificationResponse, WsPresenceUpdateMessage, WsResponseCompleteMessage, WsTaskUpdateMessage, isMessageType } from '@arbidocs/client';
 import * as zustand from 'zustand';
+import * as _tanstack_query_core from '@tanstack/query-core';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { EntityIconComponent } from './ui/index.cjs';
 export { AgentBadge, AiMarkdown, Avatar, AvatarFallback, AvatarImage, BASE_COLORS, Badge, BadgeProps, Button, ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, CardProps, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogPresentation, DialogTitle, DialogTrigger, DictateContextValue, DictateProvider, DocumentCard, DocumentCardProps, DocumentEntity, DocumentEntityProps, DocumentLike, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ENTITY_MAPPINGS, EntityIcon, EntityPill, EntityRegistryOverride, EntityType, HoverCard, HoverCardContent, HoverCardTrigger, IconToggle, IconToggleProps, Input, InputProps, Label, MarkMenu, MarkMenuItem, MarkMenuProps, MarkdownRenderer, MarkdownRendererProps, MarkdownStreamingContext, NEUTRAL_GRAY, PLACEHOLDER_COLOR, PassageCard, PassageCardProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, PresenceDisplayStatus, PresenceLabel, Progress, ProjectEntity, ProjectEntityProps, ProjectRelation, RadioGroup, RadioGroupItem, Rag, RagDot, RelevanceDot, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Slider, StatusBadgeComponent, StatusBadgeProps, StatusPill, StatusPillProps, StatusVariant, Switch, TAG_TYPE_ICONS, TAG_TYPE_LABELS, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, TagEntity, TagEntityProps, TagLike, Textarea, TextareaProps, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UserEntity, UserEntityProps, UserMenu, UserMenuItem, UserMenuProps, UserMenuStatus, VISIBILITY_ICONS, VisibilityIcon, badgeVariants, buttonVariants, cardVariants, cn, configureEntityRegistry, configureRagLabels, configureStatusRegistry, getDocIcon, getEntityColor, getEntityColorStyles, getEntityIcon, getEntityLabel, getStatusVariant, getTagTypeIcon, getTagTypeLabel, getWorkspaceColor, markdownBaseComponents, splitMarkdownBlocks, toggleVariants } from './ui/index.cjs';
@@ -40,149 +41,62 @@ interface ArbiProviderProps extends ArbiOptions {
 }
 declare function ArbiProvider({ children, ...options }: ArbiProviderProps): React$1.JSX.Element;
 
-interface ArbiChatTheme {
-    /** Primary action color — buttons, links (default: '#00adef' ARBI cyan) */
-    primaryColor: string;
-    /** Widget background (default: '#ffffff') */
-    backgroundColor: string;
-    /** Surface / muted background (default: '#f9fafb') */
-    surfaceColor: string;
-    /** Primary text color (default: '#111827') */
-    textColor: string;
-    /** Secondary / muted text (default: '#6b7280') */
-    mutedColor: string;
-    /** Border color (default: '#e5e7eb') */
-    borderColor: string;
-    /** User message bubble background (default: '#f3f4f6') */
-    userBubbleColor: string;
-    /** User message text color (default: '#111827') */
-    userBubbleTextColor: string;
-    /** Assistant message bubble background (default: 'rgba(0, 173, 239, 0.08)') */
-    assistantBubbleColor: string;
-    /** Assistant message text color (default: '#111827') */
-    assistantBubbleTextColor: string;
-    /** Border radius for the outer container (default: '8px') */
-    borderRadius: string;
-    /** Font family stack (default: system fonts) */
-    fontFamily: string;
-}
-interface ArbiChatLabels {
-    /** Header title (default: 'Chat') */
-    title?: string;
-    /** Email field label (default: 'Email') */
-    email?: string;
-    /** Password field label (default: 'Password') */
-    password?: string;
-    /** Login button text (default: 'Log in') */
-    loginButton?: string;
-    /** Logging in button text (default: 'Logging in...') */
-    loginButtonLoading?: string;
-    /** Register button text (default: 'Create account') */
-    registerButton?: string;
-    /** Send verification code button text (default: 'Email me a code') */
-    sendCodeButton?: string;
-    /** Already have a code button text (default: 'I have an invitation code') */
-    haveCodeButton?: string;
-    /** Verification code field label (default: 'Verification code') */
-    verificationCode?: string;
-    /** Confirm password field label (default: 'Confirm password') */
-    confirmPassword?: string;
-    /** First name field label (default: 'First name') */
-    firstName?: string;
-    /** Last name field label (default: 'Last name') */
-    lastName?: string;
-    /** Link to switch to register view (default: 'Create account') */
-    switchToRegister?: string;
-    /** Link to switch back to login view (default: 'Back to login') */
-    switchToLogin?: string;
-    /** Workspace selector label (default: 'Select a workspace') */
-    selectWorkspace?: string;
-    /** Workspace selector placeholder (default: 'Choose...') */
-    workspacePlaceholder?: string;
-    /** Continue button after workspace select (default: 'Continue') */
-    continueButton?: string;
-    /** Create workspace button label (default: 'Create new workspace') */
-    createWorkspace?: string;
-    /** Workspace name field label (default: 'Workspace name') */
-    workspaceName?: string;
-    /** Generic create button text (default: 'Create') */
-    createButton?: string;
-    /** Change workspace link text (default: 'Change workspace') */
-    changeWorkspace?: string;
-    /** Documents section label (default: 'Documents') */
-    documents?: string;
-    /** Send button text (default: 'Send') */
-    sendButton?: string;
-    /** Input placeholder (default: 'Ask a question...') */
-    placeholder?: string;
-    /** Upload button text (default: 'Upload') */
-    uploadButton?: string;
-    /** Uploading state text (default: 'Uploading...') */
-    uploading?: string;
-    /** Empty state when no documents (default: 'No documents found in this workspace.') */
-    emptyNoDocs?: string;
-    /** Empty state when no docs selected (default: 'Select at least one document to start chatting.') */
-    emptyNoSelection?: string;
-    /** Empty state ready to chat (default: 'Ask a question about your documents.') */
-    emptyReady?: string;
-}
-interface ArbiChatProps {
-    /** Backend URL (required) */
-    url: string;
-    /** Skip workspace selection — go straight to chat */
-    workspaceId?: string;
-    /** Customize colors and appearance */
-    theme?: Partial<ArbiChatTheme>;
-    /** Customize text labels */
-    labels?: ArbiChatLabels;
-    /** Widget width (default: '400px') */
-    width?: string | number;
-    /** Widget height (default: '600px') */
-    height?: string | number;
-}
-
-/** Props for {@link ArbiChatPanel} — the provider-less embeddable panel. */
-interface ArbiChatPanelProps {
-    /** Skip workspace selection — go straight to chat */
-    workspaceId?: string;
-    /** Customize colors and appearance */
-    theme?: Partial<ArbiChatTheme>;
-    /** Customize text labels */
-    labels?: ArbiChatLabels;
-    /** Widget width (default: '100%') */
-    width?: string | number;
-    /** Widget height (default: '100%') */
-    height?: string | number;
+type ArbiChatRole = 'user' | 'assistant';
+type ArbiChatMessageStatus = 'streaming' | 'complete' | 'error';
+interface ArbiChatMessage {
+    id: string;
+    role: ArbiChatRole;
+    /** Markdown for an assistant message, plain text for a user message. */
+    content: string;
+    status: ArbiChatMessageStatus;
+    /** Why an assistant message failed. */
+    error?: string;
+    /** Agent steps (tool calls, reasoning) the answer took. */
+    stepCount?: number;
 }
-/**
- * The ARBI chat panel **without** its own providers.
- *
- * Drop it inside an app that already renders `<ArbiProvider>` and a
- * `<QueryClientProvider>` to reuse the host's authenticated session — no second
- * login. When the ambient session is already signed in, the panel skips the
- * login screen and opens straight into chat.
- *
- * ```tsx
- * // inside your authenticated app tree
- * <ArbiChatPanel workspaceId="wrk-…" theme={myTheme} />
- * ```
- *
- * For a fully self-contained widget (its own providers + login), use {@link ArbiChat}.
- */
-declare function ArbiChatPanel({ workspaceId, theme: themeOverrides, labels: labelOverrides, width, height, }: ArbiChatPanelProps): React$1.JSX.Element;
-/**
- * Self-contained ARBI chat widget.
- *
- * Wraps its own QueryClientProvider and ArbiProvider so it works
- * anywhere — no setup required from the host app.
- *
- * ```tsx
- * import { ArbiChat } from '@arbidocs/react'
- *
- * <ArbiChat url="https://www.arbidocs.com" />
- * ```
- */
-declare function ArbiChat({ url, workspaceId, theme: themeOverrides, labels: labelOverrides, width, height, }: ArbiChatProps): React$1.JSX.Element;
+interface ArbiChatThread {
+    id: string;
+    /** Auto-titled from the first question; empty until there is one. */
+    title: string;
+}
+interface ArbiChatDocument {
+    id: string;
+    name: string;
+    isSelected: boolean;
+}
+interface UseArbiChatOptions {
+    /** The workspace to chat in. Threads and the document selection reset when it changes. */
+    workspaceId?: string;
+    /** Assistant configuration or model id passed to every query. */
+    model?: string;
+    /** Longest auto-title in characters. Default 48. */
+    titleLength?: number;
+}
+interface ArbiChat {
+    threads: ArbiChatThread[];
+    activeThreadId: string;
+    messages: ArbiChatMessage[];
+    /** An answer is streaming. */
+    isRunning: boolean;
+    /** The last turn failed (the message list also carries the failed message). */
+    error: string | null;
+    documents: ArbiChatDocument[];
+    isLoadingDocuments: boolean;
+    isUploading: boolean;
+    uploadError: string | null;
+    send: (text: string) => Promise<void>;
+    /** Re-ask the question whose answer failed. */
+    retry: () => Promise<void>;
+    selectThread: (id: string) => void;
+    newThread: () => void;
+    deleteThread: (id: string) => void;
+    toggleDocument: (id: string) => void;
+    selectAllDocuments: () => void;
+    upload: (files: File[]) => Promise<void>;
+}
+/** First words of a question as a title: whole words, no trailing punctuation, ellipsis when cut. */
+declare function titleFromQuestion(question: string, maxLength?: number): string;
+declare function useArbiChat(options?: UseArbiChatOptions): ArbiChat;
 
 /** Animated typing indicator (three bouncing dots) */
 declare const TypingIndicator: React$1.NamedExoticComponent<object>;
@@ -336,6 +250,161 @@ declare function useArbiWsTask(docId: string): {
  */
 declare function useArbiDocumentSync(workspaceId: string | undefined): void;
 
+/**
+ * Pure workspace adapters: an SDK `WorkspaceResponse` (or the host's own copy of it) to the view
+ * models the shell and the workspaces gallery show. No React state, no SDK calls, so a host that
+ * does not mount an `<ArbiProvider>` can use them too.
+ */
+
+/** Workspace visibility: public = common, several members = shared, else private. */
+type ShellWorkspaceKind = 'private' | 'shared' | 'common';
+/** One face on a workspace card. */
+interface ShellWorkspaceMember {
+    name: string;
+    picture?: string | null;
+}
+/**
+ * The fields of an SDK workspace the adapters read. Every field but the id and the name is
+ * optional, so the SDK's `WorkspaceResponse` and a host's own copy of it are both assignable.
+ */
+interface ShellWorkspaceSource {
+    external_id: string;
+    name: string;
+    description?: string | null;
+    is_public?: boolean;
+    project_name?: string | null;
+    updated_at?: string;
+    shared_document_count?: number;
+    private_document_count?: number;
+    users?: ReadonlyArray<{
+        user?: {
+            given_name?: string | null;
+            family_name?: string | null;
+            email?: string | null;
+            picture?: string | null;
+        };
+        /** Set when the member is an agent: agents are not people and are left off the faces. */
+        agent_ext_id?: string | null;
+    }>;
+}
+/**
+ * A workspace as the shell and the gallery see it. Structurally a superset of blocks'
+ * `ShellWorkspace` and `WorkspaceSummary`, so it is passed to both unchanged.
+ */
+interface ShellWorkspaceItem {
+    id: string;
+    name: string;
+    kind: ShellWorkspaceKind;
+    description?: string | null;
+    projectName?: string | null;
+    /** A rendered project pill; the host supplies it (see `decorate`). */
+    projectLine?: ReactNode;
+    /** Shared plus private documents. */
+    docCount: number;
+    /** People in the workspace (agents excluded). */
+    memberCount: number;
+    members: ShellWorkspaceMember[];
+    /** ISO timestamp. */
+    updatedAt?: string;
+}
+/** A workspace offered in the switcher menu. */
+interface ShellRecentWorkspaceItem extends ShellWorkspaceItem {
+    /** Pre-formatted "last seen" text, when the host supplies `formatLastSeen`. */
+    lastSeen?: string;
+}
+/** Public, several members: shared. Otherwise private. */
+declare function getWorkspaceKind(workspace: Pick<ShellWorkspaceSource, 'is_public' | 'users'>): ShellWorkspaceKind;
+/** Adapt one SDK workspace to the shell and gallery view model. */
+declare function toShellWorkspace(workspace: ShellWorkspaceSource): ShellWorkspaceItem;
+/**
+ * The workspace the app is in. Order: the host's selection if it is in the list; else the first
+ * workspace of a live list; else the seed's active one; else the first workspace.
+ */
+declare function resolveActiveWorkspace(items: readonly ShellWorkspaceItem[], selectedId: string | null | undefined, options?: {
+    isSeed?: boolean;
+    seedActiveId?: string;
+}): ShellWorkspaceItem | undefined;
+/** The other workspaces for the quick-switch menu, most recently opened first, capped. */
+declare function pickRecentWorkspaces(items: readonly ShellWorkspaceItem[], activeId: string | undefined, options?: {
+    limit?: number;
+    lastOpened?: Readonly<Record<string, number>>;
+    formatLastSeen?: (timestamp: number) => string;
+}): ShellRecentWorkspaceItem[];
+
+/**
+ * `useShellWorkspaces`: the user's workspaces as the shell's switcher and the workspaces gallery
+ * show them, the one the app is in, and `open(workspace)`.
+ *
+ * Source-agnostic on purpose: the host hands in the list and the selection mechanism it already
+ * has (ARBI-frontend its React Query hook and workspace store, a connected app `useWorkspaces`
+ * plus the connection's `setWorkspace`). `useArbiShellWorkspaces` is the same hook wired to an
+ * `<ArbiProvider>`.
+ */
+
+/** Workspaces to show while the account has none (a demo); the host owns the data. */
+interface ShellWorkspaceSeed {
+    workspaces: readonly ShellWorkspaceItem[];
+    /** The seed workspace that counts as the current one when nothing is selected. */
+    activeId?: string;
+}
+interface UseShellWorkspacesOptions<S extends ShellWorkspaceSource = ShellWorkspaceSource> {
+    /** The account's workspaces (SDK shape). `undefined` while loading. */
+    workspaces: readonly S[] | undefined;
+    isLoading?: boolean;
+    /** The list query's error, passed through as `error`. */
+    loadError?: unknown;
+    /** The workspace the host says the app is in (the connection's selection). */
+    selectedId?: string | null;
+    /**
+     * Make the workspace the app's current one: open it on the server and record the selection.
+     * Throw (reject) to report failure. Called for EVERY open, including the current workspace, so
+     * a click on the current card still re-opens it and then navigates.
+     */
+    select: (workspace: ShellWorkspaceItem) => Promise<unknown> | unknown;
+    /** After a successful select: navigate, toast, close a menu. The "switch, then navigate" hook. */
+    onOpened?: (workspace: ShellWorkspaceItem) => void;
+    /** When select rejects. The active workspace is unchanged. Without it the error is in `error`. */
+    onOpenError?: (error: unknown, workspace: ShellWorkspaceItem) => void;
+    /** Demo list for an account that has no workspaces (never while loading). */
+    seed?: ShellWorkspaceSeed;
+    /** Host decoration per workspace, e.g. a rendered project pill. Merged over the adapter. */
+    decorate?: (item: ShellWorkspaceItem, source: S) => Partial<ShellWorkspaceItem>;
+    /** How many recent workspaces the switcher offers. Default 4. */
+    recentLimit?: number;
+    /** `workspace id -> epoch ms` last opened here; orders `recent`, falling back to `updatedAt`. */
+    lastOpened?: Readonly<Record<string, number>>;
+    /** Format a recency timestamp into `recent[].lastSeen`. */
+    formatLastSeen?: (timestamp: number) => string;
+}
+interface UseShellWorkspacesResult {
+    /** All workspaces: the account's, or the seed when it has none. */
+    items: ShellWorkspaceItem[];
+    /** The single current workspace; undefined only when there are no workspaces at all. */
+    active: ShellWorkspaceItem | undefined;
+    /** The other workspaces, most recently opened first, for the quick-switch menu. */
+    recent: ShellRecentWorkspaceItem[];
+    /** The account's own workspaces: false while `items` is the seed. */
+    isLive: boolean;
+    isLoading: boolean;
+    /** The list query's error or the last failed open; cleared by the next open. */
+    error: unknown;
+    /** Id of the workspace being opened, else null (for a spinner on its card). */
+    openingId: string | null;
+    /** Select the workspace (always, even the current one), then `onOpened`. False if select threw. */
+    open: (workspace: Pick<ShellWorkspaceItem, 'id'> | string) => Promise<boolean>;
+}
+declare function useShellWorkspaces<S extends ShellWorkspaceSource = ShellWorkspaceSource>(options: UseShellWorkspacesOptions<S>): UseShellWorkspacesResult;
+interface UseArbiShellWorkspacesOptions extends Omit<UseShellWorkspacesOptions, 'workspaces' | 'isLoading' | 'loadError' | 'select'> {
+    /**
+     * Override how a workspace is made current. Default: `arbi.selectWorkspace(id)`, which opens it
+     * on the server for the session. A host with its own selection state (the connection layer's
+     * `setWorkspace`) passes it here.
+     */
+    select?: UseShellWorkspacesOptions['select'];
+}
+/** `useShellWorkspaces` over the `<ArbiProvider>`'s workspace list and `selectWorkspace`. */
+declare function useArbiShellWorkspaces(options?: UseArbiShellWorkspacesOptions): UseShellWorkspacesResult;
+
 /**
  * Types for a document's parsed content (`GET /v1/document/{id}/parsed-{stage}`).
  *
@@ -391,6 +460,13 @@ declare const arbiQueryKeys: {
     projectUsage: (projectExtId: string, monthsBack: number) => readonly ["arbi", "projectUsage", string, number];
     projectInvoices: (projectExtId: string) => readonly ["arbi", "projectInvoices", string];
     userUsageToday: () => readonly ["arbi", "userUsageToday"];
+    contacts: () => readonly ["arbi", "contacts"];
+    skills: () => readonly ["arbi", "skills"];
+    taskRuns: (taskId: string) => readonly ["arbi", "taskRuns", string];
+    /** An agent's pinned config; `undefined` = the library default config. */
+    agentConfig: (agentExtId?: string) => readonly ["arbi", "agentConfig", string];
+    agentWorkspaces: (agentExtId: string) => readonly ["arbi", "agentWorkspaces", string];
+    models: () => readonly ["arbi", "models"];
 };
 /** List the logged-in user's workspaces. */
 declare function useWorkspaces(options?: {
@@ -680,32 +756,1501 @@ declare function useConfigs(options?: {
         title: string | null;
         created_at: string;
     }[];
-}>, Error>;
+}>, Error>;
+/**
+ * List the caller's durable activity feed, newest first.
+ *
+ * Activity entries are backend-originated, to-self log lines that are always
+ * read — they are deliberately kept out of the normal notifications/DM feed and
+ * never affect the unread badge, so this is a separate, opt-in query.
+ */
+declare function useActivity(options?: {
+    enabled?: boolean;
+    limit?: number;
+    offset?: number;
+}): _tanstack_react_query.UseQueryResult<NoInfer<{
+    type: _arbidocs_client.components["schemas"]["NotificationType"];
+    external_id: string;
+    sender: {
+        external_id: string;
+        parent_ext_id?: string | null | undefined;
+        email: string;
+        given_name: string;
+        family_name?: string | null | undefined;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+        is_sso: boolean;
+    };
+    recipient: {
+        external_id: string;
+        parent_ext_id?: string | null | undefined;
+        email: string;
+        given_name: string;
+        family_name?: string | null | undefined;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+        is_sso: boolean;
+    };
+    workspace_ext_id?: string | null | undefined;
+    content?: string | null | undefined;
+    conversation_ext_id?: string | null | undefined;
+    task_ext_id?: string | null | undefined;
+    read: boolean;
+    created_at: string;
+    updated_at: string;
+}[]>, Error>;
+/** List the logged-in user's projects (billing accounts). */
+declare function useProjects(options?: {
+    enabled?: boolean;
+}): _tanstack_react_query.UseQueryResult<NoInfer<{
+    external_id: string;
+    name: string;
+    created_by: string;
+    packs: number;
+    subscription: string;
+    created_at: string;
+    quotas: {
+        storage_gb: {
+            used: number;
+            limit: number;
+        };
+        ai_credits: {
+            used: number;
+            limit: number;
+        };
+        collaborators: {
+            used: number;
+            limit: number;
+        };
+        budget_reset_at?: number | null | undefined;
+    };
+    daily_cap_per_user?: number | null | undefined;
+    price_id?: string | null | undefined;
+    plan?: string | null | undefined;
+    amount?: number | null | undefined;
+    currency?: string | null | undefined;
+    current_period_end?: number | null | undefined;
+    cancel_at_period_end?: boolean | null | undefined;
+    portal_url?: string | null | undefined;
+}[]>, Error>;
+/**
+ * AI usage breakdown for a project's billing period. `monthsBack` selects the period (0 =
+ * current, 1 = previous month, …).
+ *
+ * The response's `total_spend` / `spend` fields are CREDITS, not dollars (see `formatCredits`).
+ * `metered` is `false` when the deployment does not record usage (a `dev`-plan project with all
+ * zeros): show "usage is not metered here" instead of zeros. It is `undefined` until the usage
+ * has loaded.
+ */
+declare function useProjectUsage(projectExtId: string | undefined, monthsBack?: number, options?: {
+    enabled?: boolean;
+}): {
+    metered: boolean | undefined;
+    data: NoInfer<{
+        project_ext_id: string;
+        period_start: string;
+        period_end: string;
+        total_spend: number;
+        total_tokens: number;
+        total_requests: number;
+        daily: _arbidocs_client.components["schemas"]["DailyUsage"][];
+        model_groups: {
+            [key: string]: _arbidocs_client.components["schemas"]["ModelGroupUsage"];
+        };
+        by_workspace: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_user: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_feature: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        invoice_pdf?: string | null;
+    }>;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        project_ext_id: string;
+        period_start: string;
+        period_end: string;
+        total_spend: number;
+        total_tokens: number;
+        total_requests: number;
+        daily: _arbidocs_client.components["schemas"]["DailyUsage"][];
+        model_groups: {
+            [key: string]: _arbidocs_client.components["schemas"]["ModelGroupUsage"];
+        };
+        by_workspace: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_user: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_feature: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        invoice_pdf?: string | null;
+    }>, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<NoInfer<{
+        project_ext_id: string;
+        period_start: string;
+        period_end: string;
+        total_spend: number;
+        total_tokens: number;
+        total_requests: number;
+        daily: _arbidocs_client.components["schemas"]["DailyUsage"][];
+        model_groups: {
+            [key: string]: _arbidocs_client.components["schemas"]["ModelGroupUsage"];
+        };
+        by_workspace: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_user: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_feature: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        invoice_pdf?: string | null;
+    }>>;
+} | {
+    metered: boolean | undefined;
+    data: NoInfer<{
+        project_ext_id: string;
+        period_start: string;
+        period_end: string;
+        total_spend: number;
+        total_tokens: number;
+        total_requests: number;
+        daily: _arbidocs_client.components["schemas"]["DailyUsage"][];
+        model_groups: {
+            [key: string]: _arbidocs_client.components["schemas"]["ModelGroupUsage"];
+        };
+        by_workspace: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_user: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_feature: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        invoice_pdf?: string | null;
+    }>;
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        project_ext_id: string;
+        period_start: string;
+        period_end: string;
+        total_spend: number;
+        total_tokens: number;
+        total_requests: number;
+        daily: _arbidocs_client.components["schemas"]["DailyUsage"][];
+        model_groups: {
+            [key: string]: _arbidocs_client.components["schemas"]["ModelGroupUsage"];
+        };
+        by_workspace: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_user: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_feature: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        invoice_pdf?: string | null;
+    }>, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<NoInfer<{
+        project_ext_id: string;
+        period_start: string;
+        period_end: string;
+        total_spend: number;
+        total_tokens: number;
+        total_requests: number;
+        daily: _arbidocs_client.components["schemas"]["DailyUsage"][];
+        model_groups: {
+            [key: string]: _arbidocs_client.components["schemas"]["ModelGroupUsage"];
+        };
+        by_workspace: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_user: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_feature: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        invoice_pdf?: string | null;
+    }>>;
+} | {
+    metered: boolean | undefined;
+    data: undefined;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: true;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        project_ext_id: string;
+        period_start: string;
+        period_end: string;
+        total_spend: number;
+        total_tokens: number;
+        total_requests: number;
+        daily: _arbidocs_client.components["schemas"]["DailyUsage"][];
+        model_groups: {
+            [key: string]: _arbidocs_client.components["schemas"]["ModelGroupUsage"];
+        };
+        by_workspace: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_user: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_feature: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        invoice_pdf?: string | null;
+    }>, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<NoInfer<{
+        project_ext_id: string;
+        period_start: string;
+        period_end: string;
+        total_spend: number;
+        total_tokens: number;
+        total_requests: number;
+        daily: _arbidocs_client.components["schemas"]["DailyUsage"][];
+        model_groups: {
+            [key: string]: _arbidocs_client.components["schemas"]["ModelGroupUsage"];
+        };
+        by_workspace: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_user: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_feature: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        invoice_pdf?: string | null;
+    }>>;
+} | {
+    metered: boolean | undefined;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoading: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        project_ext_id: string;
+        period_start: string;
+        period_end: string;
+        total_spend: number;
+        total_tokens: number;
+        total_requests: number;
+        daily: _arbidocs_client.components["schemas"]["DailyUsage"][];
+        model_groups: {
+            [key: string]: _arbidocs_client.components["schemas"]["ModelGroupUsage"];
+        };
+        by_workspace: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_user: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_feature: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        invoice_pdf?: string | null;
+    }>, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<NoInfer<{
+        project_ext_id: string;
+        period_start: string;
+        period_end: string;
+        total_spend: number;
+        total_tokens: number;
+        total_requests: number;
+        daily: _arbidocs_client.components["schemas"]["DailyUsage"][];
+        model_groups: {
+            [key: string]: _arbidocs_client.components["schemas"]["ModelGroupUsage"];
+        };
+        by_workspace: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_user: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_feature: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        invoice_pdf?: string | null;
+    }>>;
+} | {
+    metered: boolean | undefined;
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        project_ext_id: string;
+        period_start: string;
+        period_end: string;
+        total_spend: number;
+        total_tokens: number;
+        total_requests: number;
+        daily: _arbidocs_client.components["schemas"]["DailyUsage"][];
+        model_groups: {
+            [key: string]: _arbidocs_client.components["schemas"]["ModelGroupUsage"];
+        };
+        by_workspace: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_user: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_feature: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        invoice_pdf?: string | null;
+    }>, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<NoInfer<{
+        project_ext_id: string;
+        period_start: string;
+        period_end: string;
+        total_spend: number;
+        total_tokens: number;
+        total_requests: number;
+        daily: _arbidocs_client.components["schemas"]["DailyUsage"][];
+        model_groups: {
+            [key: string]: _arbidocs_client.components["schemas"]["ModelGroupUsage"];
+        };
+        by_workspace: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_user: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_feature: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        invoice_pdf?: string | null;
+    }>>;
+} | {
+    metered: boolean | undefined;
+    data: NoInfer<{
+        project_ext_id: string;
+        period_start: string;
+        period_end: string;
+        total_spend: number;
+        total_tokens: number;
+        total_requests: number;
+        daily: _arbidocs_client.components["schemas"]["DailyUsage"][];
+        model_groups: {
+            [key: string]: _arbidocs_client.components["schemas"]["ModelGroupUsage"];
+        };
+        by_workspace: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_user: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_feature: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        invoice_pdf?: string | null;
+    }>;
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        project_ext_id: string;
+        period_start: string;
+        period_end: string;
+        total_spend: number;
+        total_tokens: number;
+        total_requests: number;
+        daily: _arbidocs_client.components["schemas"]["DailyUsage"][];
+        model_groups: {
+            [key: string]: _arbidocs_client.components["schemas"]["ModelGroupUsage"];
+        };
+        by_workspace: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_user: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_feature: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        invoice_pdf?: string | null;
+    }>, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<NoInfer<{
+        project_ext_id: string;
+        period_start: string;
+        period_end: string;
+        total_spend: number;
+        total_tokens: number;
+        total_requests: number;
+        daily: _arbidocs_client.components["schemas"]["DailyUsage"][];
+        model_groups: {
+            [key: string]: _arbidocs_client.components["schemas"]["ModelGroupUsage"];
+        };
+        by_workspace: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_user: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        by_feature: {
+            [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
+        };
+        invoice_pdf?: string | null;
+    }>>;
+};
+/** One day of aggregated usage across projects (for a spend/token trend). */
+interface AggregatedDailyUsage {
+    date: string;
+    /** Credits used that day (not dollars). */
+    credits: number;
+    totalTokens: number;
+    apiRequests: number;
+}
+/** One model group's aggregated usage across projects (for a breakdown). */
+interface AggregatedModelGroupUsage {
+    model: string;
+    /** Credits used by this model group (not dollars). */
+    credits: number;
+    totalTokens: number;
+    promptTokens: number;
+    completionTokens: number;
+    successfulRequests: number;
+}
+/** Aggregated AI usage + spend across several projects. */
+interface ProjectsUsageAggregate {
+    /** Summed usage across the projects, in CREDITS (1 credit = $0.01 by default), not dollars. */
+    totalCredits: number;
+    /** Summed token count across the projects. */
+    totalTokens: number;
+    /** Summed API request count across the projects. */
+    totalRequests: number;
+    /** Per-day totals merged across every project, oldest first. */
+    daily: AggregatedDailyUsage[];
+    /** Per-model-group totals merged across every project, most credits first. */
+    modelGroups: AggregatedModelGroupUsage[];
+    /**
+     * False when none of the loaded projects records usage (billing is off on this deployment), so
+     * zeros mean "not metered". True while anything real was recorded, or before data arrived.
+     */
+    metered: boolean;
+    /** True while any per-project query is still loading. */
+    isLoading: boolean;
+    /** True if any per-project query errored. */
+    isError: boolean;
+}
+/**
+ * Firm-wide AI usage + spend: aggregates {@link useProjectUsage} across several
+ * projects (e.g. all of a firm's matters) in parallel and merges the real totals,
+ * the daily trend, and the per-model breakdown. Shares the per-project query
+ * cache, so it costs nothing extra where a project's usage is already loaded.
+ * Numbers are genuine — zero projects (or zero billed work) yields zero totals;
+ * callers render that honestly.
+ */
+declare function useProjectsUsage(projectExtIds: string[], monthsBack?: number, options?: {
+    enabled?: boolean;
+}): ProjectsUsageAggregate;
+/** List the Stripe invoices for a project's subscription. */
+declare function useProjectInvoices(projectExtId: string | undefined, options?: {
+    enabled?: boolean;
+}): _tanstack_react_query.UseQueryResult<NoInfer<{
+    project_ext_id: string;
+    invoices: _arbidocs_client.components["schemas"]["ProjectInvoice"][];
+}>, Error>;
+/** Today's deployment-wide credit use for the current user (`credits_used`, in credits). */
+declare function useUserUsageToday(options?: {
+    enabled?: boolean;
+}): _tanstack_react_query.UseQueryResult<NoInfer<{
+    credits_used: number;
+}>, Error>;
+
+/** An agent or deployment config: section name (`Agents`, `QueryLLM`, ...) to its parameters. */
+type AgentConfigSections = Record<string, Record<string, unknown>>;
+/** Create a task from a `CreateTaskRequest`. Resolves with the created task. */
+declare function useCreateTask(): _tanstack_react_query.UseMutationResult<{
+    external_id: string;
+    name: string;
+    trigger_type: string;
+    rrule: string | null;
+    run_at: string | null;
+    timezone: string;
+    event_kind: string | null;
+    action_type: string;
+    prompt: string;
+    skill_ref: string | null;
+    status: string;
+    next_run_at: string | null;
+    last_run_at: string | null;
+    last_error: string | null;
+    in_progress: boolean;
+    active_run_id: string | null;
+    agent_session: string | null;
+    active_response_id?: string | null;
+    active_conversation_ext_id?: string | null;
+    run_started_at: string | null;
+    notify_on_complete: boolean;
+    auth_mode: _arbidocs_client.components["schemas"]["AuthMode"];
+    pending_auth_request_id?: string | null;
+    pending_auth_session_pubkey?: string | null;
+    pending_auth_agent_email?: string | null;
+    created_by_kind: string;
+    workspace_ext_id?: string | null;
+    agent_ext_id?: string | null;
+    task_plan?: _arbidocs_client.components["schemas"]["TaskPlan"] | null;
+    is_goal_task: boolean;
+    goal_state?: {
+        [key: string]: unknown;
+    } | null;
+    created_at: string;
+    updated_at: string;
+}, Error, {
+    name: string;
+    trigger_type: _arbidocs_client.components["schemas"]["TriggerType"];
+    rrule?: string | null;
+    run_at?: string | null;
+    timezone: string;
+    event_kind?: string | null;
+    action_type: _arbidocs_client.components["schemas"]["ActionType"];
+    prompt: string;
+    skill_ref?: string | null;
+    notify_on_complete?: boolean | null;
+    auth_mode: _arbidocs_client.components["schemas"]["AuthMode"];
+    workspace_ext_id?: string | null;
+    agent_ext_id?: string | null;
+    task_plan?: _arbidocs_client.components["schemas"]["TaskPlan"] | null;
+}, unknown>;
+/** Patch a task; also pause / resume with `{ status }`. */
+declare function useUpdateTask(): _tanstack_react_query.UseMutationResult<{
+    external_id: string;
+    name: string;
+    trigger_type: string;
+    rrule: string | null;
+    run_at: string | null;
+    timezone: string;
+    event_kind: string | null;
+    action_type: string;
+    prompt: string;
+    skill_ref: string | null;
+    status: string;
+    next_run_at: string | null;
+    last_run_at: string | null;
+    last_error: string | null;
+    in_progress: boolean;
+    active_run_id: string | null;
+    agent_session: string | null;
+    active_response_id?: string | null;
+    active_conversation_ext_id?: string | null;
+    run_started_at: string | null;
+    notify_on_complete: boolean;
+    auth_mode: _arbidocs_client.components["schemas"]["AuthMode"];
+    pending_auth_request_id?: string | null;
+    pending_auth_session_pubkey?: string | null;
+    pending_auth_agent_email?: string | null;
+    created_by_kind: string;
+    workspace_ext_id?: string | null;
+    agent_ext_id?: string | null;
+    task_plan?: _arbidocs_client.components["schemas"]["TaskPlan"] | null;
+    is_goal_task: boolean;
+    goal_state?: {
+        [key: string]: unknown;
+    } | null;
+    created_at: string;
+    updated_at: string;
+}, Error, {
+    taskId: string;
+    patch: UpdateTaskRequest;
+}, unknown>;
+/**
+ * Run a task now, without moving its schedule. A run parked waiting for workspace access (a
+ * temporary authorization tier) is granted a temporary, session-scoped key and run again, so the
+ * owner clicking Run is the approval. Resolves with the updated task.
+ */
+declare function useRunTask(): _tanstack_react_query.UseMutationResult<{
+    external_id: string;
+    name: string;
+    trigger_type: string;
+    rrule: string | null;
+    run_at: string | null;
+    timezone: string;
+    event_kind: string | null;
+    action_type: string;
+    prompt: string;
+    skill_ref: string | null;
+    status: string;
+    next_run_at: string | null;
+    last_run_at: string | null;
+    last_error: string | null;
+    in_progress: boolean;
+    active_run_id: string | null;
+    agent_session: string | null;
+    active_response_id?: string | null;
+    active_conversation_ext_id?: string | null;
+    run_started_at: string | null;
+    notify_on_complete: boolean;
+    auth_mode: _arbidocs_client.components["schemas"]["AuthMode"];
+    pending_auth_request_id?: string | null;
+    pending_auth_session_pubkey?: string | null;
+    pending_auth_agent_email?: string | null;
+    created_by_kind: string;
+    workspace_ext_id?: string | null;
+    agent_ext_id?: string | null;
+    task_plan?: _arbidocs_client.components["schemas"]["TaskPlan"] | null;
+    is_goal_task: boolean;
+    goal_state?: {
+        [key: string]: unknown;
+    } | null;
+    created_at: string;
+    updated_at: string;
+}, Error, string, unknown>;
+declare function useDeleteTask(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+/** A task's run history, newest first; polls every 3 s while a run is in flight. */
+declare function useTaskRuns(taskId: string | undefined, options?: {
+    enabled?: boolean;
+}): _tanstack_react_query.UseQueryResult<NoInfer<{
+    run_id?: string | null;
+    conversation_ext_id?: string | null;
+    status: string;
+    error?: string | null;
+    started_at?: string | null;
+    finished_at?: string | null;
+}[]>, Error>;
+/** Create an agent by name. The one-time `signing_private_key` is in the result. */
+declare function useCreateAgent(): _tanstack_react_query.UseMutationResult<{
+    external_id: string;
+    parent_ext_id?: string | null;
+    email: string;
+    given_name: string;
+    family_name?: string | null;
+    picture?: string | null;
+    encryption_public_key: string;
+    is_sso: boolean;
+    signing_private_key: string;
+}, Error, string, unknown>;
+/**
+ * An agent's pinned config (persona, model, tool switches), or the library default config when
+ * `agentExtId` is omitted: edit forms seed from the first, create forms from the second.
+ */
+declare function useAgentConfig(agentExtId?: string, options?: {
+    enabled?: boolean;
+}): _tanstack_react_query.UseQueryResult<NoInfer<AgentConfigSections | null>, Error>;
+/** The model names an agent may be pinned to. */
+declare function useAgentModels(options?: {
+    enabled?: boolean;
+}): _tanstack_react_query.UseQueryResult<NoInfer<string[]>, Error>;
+interface SaveAgentConfigVars {
+    agentExtId: string;
+    /** Config title; defaults to `agent-<agentExtId>`. */
+    title?: string;
+    /**
+     * Parameters to set, per section, e.g. `{ Agents: { PERSONA: '...', WEB_SEARCH_ENABLED: true } }`.
+     * Merged key by key over the agent's current config (or the default one for a new agent).
+     */
+    sections: AgentConfigSections;
+}
+/** Pin a behaviour config to an agent: read its current config, merge `sections` over it, save. */
+declare function useSaveAgentConfig(): _tanstack_react_query.UseMutationResult<{
+    external_id: string;
+    title: string | null;
+    created_at: string;
+}, Error, SaveAgentConfigVars, unknown>;
+/** The workspaces an agent can currently open (`permanent` tells standing from temporary). */
+declare function useAgentWorkspaces(agentExtId: string | undefined, options?: {
+    enabled?: boolean;
+}): _tanstack_react_query.UseQueryResult<NoInfer<{
+    workspace_ext_id: string;
+    name: string;
+    role: _arbidocs_client.components["schemas"]["WorkspaceRole"];
+    joined_at: string;
+    permanent: boolean;
+    is_default: boolean;
+}[]>, Error>;
+/** How an agent is given a workspace. */
+type AgentAccessMode = 
+/** A standing member: the agent can open the workspace while the owner is away. */
+{
+    kind: 'standing';
+}
+/** A TTL'd, session-scoped key: gone when the run session ends. `ttlSeconds` omitted = default. */
+ | {
+    kind: 'temporary';
+    ttlSeconds?: number;
+};
+interface GrantAgentAccessVars {
+    agentExtId: string;
+    workspaceId: string;
+    /** Default `{ kind: 'standing' }`. */
+    mode?: AgentAccessMode;
+}
+/**
+ * Give an agent access to a workspace you own. Standing access adds the agent as a member without
+ * switching the open workspace; temporary access mints the agent's run session and deposits a
+ * session-scoped key on it (the `session_pubkey_b64` path).
+ */
+declare function useGrantAgentAccess(): _tanstack_react_query.UseMutationResult<{
+    session_pubkey_b64: string;
+    agent_email: string;
+    ttl: number;
+} | {
+    user: {
+        external_id: string;
+        parent_ext_id?: string | null | undefined;
+        email: string;
+        given_name: string;
+        family_name?: string | null | undefined;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+        is_sso: boolean;
+    };
+    role: _arbidocs_client.components["schemas"]["WorkspaceRole"];
+    joined_at: string;
+    conversation_count: number;
+    document_count: number;
+    files_mb: number;
+    agent_ext_id?: string | null | undefined;
+    is_temporary: boolean;
+}[], Error, GrantAgentAccessVars, unknown>;
+/** Take an agent out of a workspace (owner only). Restores the previously open workspace. */
+declare function useRevokeAgentAccess(): _tanstack_react_query.UseMutationResult<void, Error, {
+    agentExtId: string;
+    workspaceId: string;
+}, unknown>;
+/**
+ * The skills the user can run (own plus the shared marketplace), metadata only. Skills live in the
+ * deployment marketplace, so the list does not depend on the open workspace.
+ */
+declare function useSkills(options?: {
+    enabled?: boolean;
+    includeHidden?: boolean;
+}): _tanstack_react_query.UseQueryResult<NoInfer<{
+    name: string;
+    slug: string;
+    description: string;
+    user_invocable: boolean;
+    arg_hint: string;
+    skill_type: string;
+    workspace_ext_id: string;
+    doc_ext_id: string;
+    updated_at: string;
+    visibility: string;
+    is_owner: boolean;
+}[]>, Error>;
+
+/**
+ * Contacts: the user's colleagues and pending invitations.
+ *
+ * Shares `arbiQueryKeys.contacts()` with `useDirectMessages`, so a change made here refreshes the
+ * conversation rail on its own. The parts that turn an email list into a request and the backend
+ * outcome into a sentence live in `@arbidocs/blocks/collaboration` (`AddContactsForm`).
+ */
+/** The user's contacts, registered and pending. */
+declare function useContacts(options?: {
+    enabled?: boolean;
+}): _tanstack_react_query.UseQueryResult<NoInfer<{
+    external_id?: string | null | undefined;
+    email: string;
+    user?: {
+        external_id: string;
+        parent_ext_id?: string | null | undefined;
+        email: string;
+        given_name: string;
+        family_name?: string | null | undefined;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+        is_sso: boolean;
+    } | null | undefined;
+    status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+    created_at: string;
+    shared_workspace_ext_id?: string | null | undefined;
+    outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+    outcome_detail?: string | null | undefined;
+}[]>, Error>;
+/** Contacts still waiting to join (an invitation sent or expired); `Invite again` re-adds them. */
+declare function usePendingContacts(options?: {
+    enabled?: boolean;
+}): {
+    pending: {
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[];
+    data: NoInfer<{
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[]>;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[]>, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<NoInfer<{
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[]>>;
+} | {
+    pending: {
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[];
+    data: NoInfer<{
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[]>;
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[]>, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<NoInfer<{
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[]>>;
+} | {
+    pending: {
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[];
+    data: undefined;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: true;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[]>, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<NoInfer<{
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[]>>;
+} | {
+    pending: {
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[];
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoading: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[]>, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<NoInfer<{
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[]>>;
+} | {
+    pending: {
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[];
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[]>, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<NoInfer<{
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[]>>;
+} | {
+    pending: {
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[];
+    data: NoInfer<{
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[]>;
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    status: "success";
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: _tanstack_query_core.RefetchOptions) => Promise<_tanstack_query_core.QueryObserverResult<NoInfer<{
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[]>, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<NoInfer<{
+        external_id?: string | null | undefined;
+        email: string;
+        user?: {
+            external_id: string;
+            parent_ext_id?: string | null | undefined;
+            email: string;
+            given_name: string;
+            family_name?: string | null | undefined;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+            is_sso: boolean;
+        } | null | undefined;
+        status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
+        created_at: string;
+        shared_workspace_ext_id?: string | null | undefined;
+        outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+        outcome_detail?: string | null | undefined;
+    }[]>>;
+};
 /**
- * List the caller's durable activity feed, newest first.
- *
- * Activity entries are backend-originated, to-self log lines that are always
- * read — they are deliberately kept out of the normal notifications/DM feed and
- * never affect the unread badge, so this is a separate, opt-in query.
+ * Add contacts by email. An address not yet on ARBI is invited. Resolves with one row per
+ * address (`outcome`, `status`); map it with `toAddContactsRows` from `@arbidocs/blocks/collaboration`.
  */
-declare function useActivity(options?: {
-    enabled?: boolean;
-    limit?: number;
-    offset?: number;
-}): _tanstack_react_query.UseQueryResult<NoInfer<{
-    type: _arbidocs_client.components["schemas"]["NotificationType"];
-    external_id: string;
-    sender: {
-        external_id: string;
-        parent_ext_id?: string | null | undefined;
-        email: string;
-        given_name: string;
-        family_name?: string | null | undefined;
-        picture?: string | null | undefined;
-        encryption_public_key: string;
-        is_sso: boolean;
-    };
-    recipient: {
+declare function useAddContacts(): _tanstack_react_query.UseMutationResult<{
+    external_id?: string | null | undefined;
+    email: string;
+    user?: {
         external_id: string;
         parent_ext_id?: string | null | undefined;
         email: string;
@@ -714,134 +2259,50 @@ declare function useActivity(options?: {
         picture?: string | null | undefined;
         encryption_public_key: string;
         is_sso: boolean;
-    };
-    workspace_ext_id?: string | null | undefined;
-    content?: string | null | undefined;
-    conversation_ext_id?: string | null | undefined;
-    task_ext_id?: string | null | undefined;
-    read: boolean;
-    created_at: string;
-    updated_at: string;
-}[]>, Error>;
-/** List the logged-in user's projects (billing accounts). */
-declare function useProjects(options?: {
-    enabled?: boolean;
-}): _tanstack_react_query.UseQueryResult<NoInfer<{
-    external_id: string;
-    name: string;
-    created_by: string;
-    packs: number;
-    subscription: string;
+    } | null | undefined;
+    status: "invitation_pending" | "invitation_expired" | "registered" | "failed";
     created_at: string;
-    quotas: {
-        storage_gb: {
-            used: number;
-            limit: number;
-        };
-        ai_credits: {
-            used: number;
-            limit: number;
-        };
-        collaborators: {
-            used: number;
-            limit: number;
-        };
-        budget_reset_at?: number | null | undefined;
-    };
-    daily_cap_per_user?: number | null | undefined;
-    price_id?: string | null | undefined;
-    plan?: string | null | undefined;
-    amount?: number | null | undefined;
-    currency?: string | null | undefined;
-    current_period_end?: number | null | undefined;
-    cancel_at_period_end?: boolean | null | undefined;
-    portal_url?: string | null | undefined;
-}[]>, Error>;
+    shared_workspace_ext_id?: string | null | undefined;
+    outcome?: ("invited" | "reinvited" | "not_resent_still_pending" | "contact_added" | "already_contact" | "failed") | null | undefined;
+    outcome_detail?: string | null | undefined;
+}[], Error, string[], unknown>;
+/** Remove contacts, or withdraw invitations, by contact id. */
+declare function useRemoveContacts(): _tanstack_react_query.UseMutationResult<void, Error, string[], unknown>;
+
 /**
- * AI usage + spend breakdown for a project's billing period. `monthsBack`
- * selects the period (0 = current, 1 = previous month, …).
- */
-declare function useProjectUsage(projectExtId: string | undefined, monthsBack?: number, options?: {
-    enabled?: boolean;
-}): _tanstack_react_query.UseQueryResult<NoInfer<{
-    project_ext_id: string;
-    period_start: string;
-    period_end: string;
+ * Credits: the unit the ARBI backend reports AI usage in.
+ *
+ * The usage endpoints (`/v1/user/projects/{id}/usage`, `/me/usage/today`) convert the metered USD
+ * spend into whole credits at the API boundary: 1 credit = `CREDITS_TO_AI_USD`, which is $0.01 on
+ * a default deployment. The fields are still named `spend` / `total_spend` in the schema, but they
+ * hold CREDITS, never dollars. Label them as credits; use {@link creditsToUsd} only when a
+ * dollar figure is genuinely wanted, with the deployment's own rate.
+ */
+/** Dollars per credit on a default deployment (`CREDITS_TO_AI_USD`). */
+declare const DEFAULT_USD_PER_CREDIT = 0.01;
+interface FormatCreditsOptions {
+    /** Append the unit ("12 credits"). Default true; pass false inside a column headed "Credits". */
+    unit?: boolean;
+    /** BCP 47 locale for the digit grouping. Default `en-US`. */
+    locale?: string;
+}
+/** "1,234 credits" / "1 credit". The backend reports whole credits; this rounds away float dust. */
+declare function formatCredits(credits: number, options?: FormatCreditsOptions): string;
+/** The dollar value of an amount of credits. `usdPerCredit` defaults to {@link DEFAULT_USD_PER_CREDIT}. */
+declare function creditsToUsd(credits: number, usdPerCredit?: number): number;
+/** The slice of a usage response that tells whether anything was recorded. */
+interface UsageTotals {
     total_spend: number;
     total_tokens: number;
     total_requests: number;
-    daily: _arbidocs_client.components["schemas"]["DailyUsage"][];
-    model_groups: {
-        [key: string]: _arbidocs_client.components["schemas"]["ModelGroupUsage"];
-    };
-    by_workspace: {
-        [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
-    };
-    by_user: {
-        [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
-    };
-    by_feature: {
-        [key: string]: _arbidocs_client.components["schemas"]["TagBreakdown"];
-    };
-    invoice_pdf?: string | null;
-}>, Error>;
-/** One day of aggregated usage across projects (for a spend/token trend). */
-interface AggregatedDailyUsage {
-    date: string;
-    spend: number;
-    totalTokens: number;
-    apiRequests: number;
-}
-/** One model group's aggregated usage across projects (for a breakdown). */
-interface AggregatedModelGroupUsage {
-    model: string;
-    spend: number;
-    totalTokens: number;
-    promptTokens: number;
-    completionTokens: number;
-    successfulRequests: number;
-}
-/** Aggregated AI usage + spend across several projects. */
-interface ProjectsUsageAggregate {
-    /** Summed spend across the projects, in USD (the metered currency). */
-    totalSpend: number;
-    /** Summed token count across the projects. */
-    totalTokens: number;
-    /** Summed API request count across the projects. */
-    totalRequests: number;
-    /** Per-day totals merged across every project, oldest first. */
-    daily: AggregatedDailyUsage[];
-    /** Per-model-group totals merged across every project, biggest spend first. */
-    modelGroups: AggregatedModelGroupUsage[];
-    /** True while any per-project query is still loading. */
-    isLoading: boolean;
-    /** True if any per-project query errored. */
-    isError: boolean;
 }
 /**
- * Firm-wide AI usage + spend: aggregates {@link useProjectUsage} across several
- * projects (e.g. all of a firm's matters) in parallel and merges the real totals,
- * the daily trend, and the per-model breakdown. Shares the per-project query
- * cache, so it costs nothing extra where a project's usage is already loaded.
- * Numbers are genuine — zero projects (or zero billed work) yields zero totals;
- * callers render that honestly.
+ * Was this usage actually metered? A project on the `dev` plan belongs to a deployment with
+ * billing switched off: the backend only records AI usage per project when billing is enabled, so
+ * an all-zero response there means "not metered", not "nothing happened". Show a note instead of
+ * silent zeros.
  */
-declare function useProjectsUsage(projectExtIds: string[], monthsBack?: number, options?: {
-    enabled?: boolean;
-}): ProjectsUsageAggregate;
-/** List the Stripe invoices for a project's subscription. */
-declare function useProjectInvoices(projectExtId: string | undefined, options?: {
-    enabled?: boolean;
-}): _tanstack_react_query.UseQueryResult<NoInfer<{
-    project_ext_id: string;
-    invoices: _arbidocs_client.components["schemas"]["ProjectInvoice"][];
-}>, Error>;
-/** Today's deployment-wide credit spend for the current user. */
-declare function useUserUsageToday(options?: {
-    enabled?: boolean;
-}): _tanstack_react_query.UseQueryResult<NoInfer<{
-    credits_used: number;
-}>, Error>;
+declare function isUsageMetered(usage: UsageTotals, subscription: string | null | undefined): boolean;
 
 /**
  * The AI engine — domain-agnostic hooks for building an AI-native app on ARBI.
@@ -998,6 +2459,27 @@ declare function textToArtifact(title: string, content: string, opts?: {
     id?: string;
 }): ArtifactEvent;
 
+/**
+ * Citation markup normaliser.
+ *
+ * The backend marks a cited statement as a markdown link, `[statement](#cite-N)`, and the
+ * statement can include the markdown that surrounds it: a list marker, a heading marker or the
+ * opener of a bold/italic span whose closer sits after the link. Inside link text those tokens
+ * are not parsed as block or inline syntax, so they show literally and break lists and bold:
+ *
+ *   [- **Claimed quantum (by Claimant)](#cite-1):** **USD 47 million**
+ *
+ * `normalizeCitationMarkup` hoists the leading tokens out of the link text (and a trailing
+ * emphasis closer after it), so the link only wraps the words:
+ *
+ *   - **[Claimed quantum (by Claimant)](#cite-1):** **USD 47 million**
+ *
+ * It is conservative: emphasis that opens and closes inside the link text is valid markdown and
+ * is left alone, an opener is only hoisted when its closer follows on the same line, and fenced
+ * code blocks are never touched. The result is idempotent.
+ */
+declare function normalizeCitationMarkup(markdown: string): string;
+
 /**
  * Renders the live state of a single agentic task: streaming tokens, a "thinking"
  * indicator with the running step count, errors, and a grounded/cited footer with
@@ -1618,6 +3100,27 @@ interface DmConversation {
     sectionLabel?: string;
 }
 
+interface StartByEmailLabels {
+    email: string;
+    emailPlaceholder: string;
+    message: string;
+    messagePlaceholder: string;
+    send: string;
+    sending: string;
+    invalidEmail: string;
+}
+declare const DEFAULT_START_BY_EMAIL_LABELS: StartByEmailLabels;
+interface StartByEmailProps {
+    /** Send the first message to `email`. Reject to keep the form and show the error. */
+    onStart: (email: string, text: string) => Promise<unknown>;
+    /** Called after a successful send, with the value `onStart` resolved to. */
+    onStarted?: (result: unknown) => void;
+    classNames?: Pick<DmClassNames, 'sendButton'>;
+    labels?: Partial<StartByEmailLabels>;
+    className?: string;
+}
+declare function StartByEmail({ onStart, onStarted, classNames, labels, className, }: StartByEmailProps): React$1.JSX.Element;
+
 interface DirectMessagesProps {
     /** Extra classes for the outer card (e.g. a page-specific height). */
     className?: string;
@@ -1627,8 +3130,29 @@ interface DirectMessagesProps {
     emptyThread?: React.ReactNode;
     /** Rendered in the rail when there are no conversations. */
     emptyList?: React.ReactNode;
+    /**
+     * Replaces the rail's "Conversations / N colleagues" heading. `null` for no heading.
+     */
+    listHeader?: React.ReactNode;
+    /**
+     * Pinned at the top of the rail, e.g. `<DmInviteChip onClick={...} />` from
+     * `@arbidocs/blocks/collaboration`. Shown even when there are no conversations.
+     */
+    listLead?: React.ReactNode;
+    /**
+     * Offer a form at the top of the rail to message an address that is not in the list yet
+     * (email plus first message). The new conversation opens once it is sent.
+     */
+    startByEmail?: boolean | {
+        labels?: Partial<StartByEmailLabels>;
+    };
+    /**
+     * Hide the signed-in user's own row. A contact list that includes the owner would otherwise
+     * offer a conversation with yourself.
+     */
+    hideOwnContact?: boolean;
 }
-declare function DirectMessages({ className, classNames, emptyThread, emptyList, }: DirectMessagesProps): React$1.JSX.Element;
+declare function DirectMessages({ className, classNames, emptyThread, emptyList, listHeader, listLead, startByEmail, hideOwnContact, }: DirectMessagesProps): React$1.JSX.Element;
 
 interface ConversationListProps {
     conversations: DmConversation[];
@@ -1642,6 +3166,11 @@ interface ConversationListProps {
      * call to action. Pass `null` for no heading at all.
      */
     header?: React.ReactNode;
+    /**
+     * Pinned above the rows, below the heading: a call to action such as `DmInviteChip` from
+     * `@arbidocs/blocks/collaboration`, or a start-by-email form. Shown even when the list is empty.
+     */
+    lead?: React.ReactNode;
     /**
      * Overrides the rail's own sizing. The default is a fixed-width column beside
      * a thread; a consumer showing the list on its own needs it to fill instead,
@@ -1650,7 +3179,7 @@ interface ConversationListProps {
      */
     className?: string;
 }
-declare function ConversationList({ conversations, selectedPeerId, onSelect, classNames, emptyState, header, className, }: ConversationListProps): React$1.JSX.Element;
+declare function ConversationList({ conversations, selectedPeerId, onSelect, classNames, emptyState, header, lead, className, }: ConversationListProps): React$1.JSX.Element;
 
 interface MessageThreadProps {
     conversation: DmConversation | null;
@@ -2447,4 +3976,4 @@ interface ArbiUiState {
 }
 declare const useArbiUiStore: zustand.UseBoundStore<zustand.StoreApi<ArbiUiState>>;
 
-export { type ActivityContent, type ActivityDescription, ActivityFeed, type ActivityFeedProps, type AggregatedDailyUsage, type AggregatedModelGroupUsage, AiActionCard, AiAnswer, type AiRunOptions, type AiTaskStatus, AppleIcon, ArbiBotHeadIcon, ArbiBotIcon, ArbiChat, type ArbiChatLabels, ArbiChatPanel, type ArbiChatPanelProps, type ArbiChatProps, type ArbiChatTheme, ArbiIcon, ArbiProvider, type ArbiProviderProps, type ArbiUiState, ArbiWebSocketProvider, type ArbiWebSocketProviderProps, type ArbiWsState, type ArbiWsStatus, ArtifactCanvas, type AspectOption, AudIcon, type AudioRecorderState, ChatBubble, type ChatBubbleProps, type Chunk, type ChunkActivation, CitationRenderer, type CitationRendererProps, type CitationState, ClaudeIcon, CommandPalette, type CommandPaletteClassNames, type CommandPaletteProps, CommandPaletteProvider, type CommandPaletteProviderProps, type CommandPaletteValue, ConversationList, type ConversationListProps, type CropArea, type CropOutput, type CropResult, DEFAULT_ASPECT_OPTIONS, DateSeparator, type DateSeparatorProps, DirectMessages, type DirectMessagesProps, DmAvatar, type DmAvatarProps, type DmClassNames, DmComposer, type DmComposerProps, type DmConversation, type DmMessage, type DmNotification, type DmUser, DocIcon, DocQaPanel, DocSearch, DocumentCardMenu, type DocumentCardMenuProps, DocumentGallery, type DocumentGalleryProps, DocumentReview, type DocumentReviewProps, DocumentTable, type DocumentTableProps, DraftTitleControls, type DraftTitleControlsProps, EmlIcon, EntityIconComponent, FILE_TYPE_COLORS, FileIcon, FireworksIcon, GeminiIcon, GitHubIcon, GoogleIcon, HtmlIcon, ImageCropModal, type ImageCropModalProps, ImageCropper, type ImageCropperProps, ImgIcon, InlineMicButton, type InlineMicButtonProps, LinkedInIcon, type MessageArtifact, MessageArtifactCard, MessageBubble, type MessageBubbleProps, MessageThread, type MessageThreadProps, MicRecordingOverlay, type MicRecordingOverlayProps, MicWaveformIndicator, type MicWaveformIndicatorProps, type NotificationTypeMeta, OpenAIIcon, type PaletteNavItem, type ParsedChunk, type ParsedChunkMetadata, type ParsedDocument, type ParsedDocumentMetadata, PdfIcon, PhotoCapture, type PhotoCaptureProps, type ProjectsUsageAggregate, ProviderIcon, RUN_WINDOW_MS, type RenderMarkdown, type SearchChunk, SemanticSearch, type SemanticSearchProps, type ThreadAccessors, type ThreadItem, type ToolResponses, TxtIcon, TypingIndicator, type UseAudioRecorderResult, type UseCameraStreamResult, type UseDirectMessagesResult, type UseVideoRecorderResult, VidIcon, VideoCapture, type VideoCaptureProps, type VideoRecorderState, VoiceNoteRecorder, type VoiceNoteRecorderProps, XlsIcon, annotateThread, arbiQueryKeys, captureFrameAsBlob, cropImage, dayKey, describeActivity, formatElapsed, formatRelativeTime, getNotificationTypeMeta, getWorkspaceActionText, getWorkspaceSentPhrase, hasVideoTrack, isWorkspaceNotificationType, parseActivityContent, redlineStats, textToArtifact, toRedlineMarkdown, useActivity, useAgents, useAiTask, useArbi, useArbiConnected, useArbiDocumentSync, useArbiUiStore, useArbiWebSocket, useArbiWsContext, useArbiWsMessage, useArbiWsStatus, useArbiWsStore, useArbiWsTask, useArbiWsTasks, useAssistantQuery, useAudioRecorder, useCameraStream, useCommandPalette, useConfigs, useConversations, useDeleteAgents, useDirectMessages, useDocuments, useFacts, useHealth, useParsedDocument, useProjectInvoices, useProjectUsage, useProjects, useProjectsUsage, useSemanticSearch, useSessions, useTags, useTasks, useThumbnails, useUserUsageToday, useVideoRecorder, useWorkspaceDocs, useWorkspaces, userDisplayName, userInitials };
+export { type ActivityContent, type ActivityDescription, ActivityFeed, type ActivityFeedProps, type AgentAccessMode, type AgentConfigSections, type AggregatedDailyUsage, type AggregatedModelGroupUsage, AiActionCard, AiAnswer, type AiRunOptions, type AiTaskStatus, AppleIcon, ArbiBotHeadIcon, ArbiBotIcon, type ArbiChat, type ArbiChatDocument, type ArbiChatMessage, type ArbiChatMessageStatus, type ArbiChatRole, type ArbiChatThread, ArbiIcon, ArbiProvider, type ArbiProviderProps, type ArbiUiState, ArbiWebSocketProvider, type ArbiWebSocketProviderProps, type ArbiWsState, type ArbiWsStatus, ArtifactCanvas, type AspectOption, AudIcon, type AudioRecorderState, ChatBubble, type ChatBubbleProps, type Chunk, type ChunkActivation, CitationRenderer, type CitationRendererProps, type CitationState, ClaudeIcon, CommandPalette, type CommandPaletteClassNames, type CommandPaletteProps, CommandPaletteProvider, type CommandPaletteProviderProps, type CommandPaletteValue, ConversationList, type ConversationListProps, type CropArea, type CropOutput, type CropResult, DEFAULT_ASPECT_OPTIONS, DEFAULT_START_BY_EMAIL_LABELS, DEFAULT_USD_PER_CREDIT, DateSeparator, type DateSeparatorProps, DirectMessages, type DirectMessagesProps, DmAvatar, type DmAvatarProps, type DmClassNames, DmComposer, type DmComposerProps, type DmConversation, type DmMessage, type DmNotification, type DmUser, DocIcon, DocQaPanel, DocSearch, DocumentCardMenu, type DocumentCardMenuProps, DocumentGallery, type DocumentGalleryProps, DocumentReview, type DocumentReviewProps, DocumentTable, type DocumentTableProps, DraftTitleControls, type DraftTitleControlsProps, EmlIcon, EntityIconComponent, FILE_TYPE_COLORS, FileIcon, FireworksIcon, type FormatCreditsOptions, GeminiIcon, GitHubIcon, GoogleIcon, type GrantAgentAccessVars, HtmlIcon, ImageCropModal, type ImageCropModalProps, ImageCropper, type ImageCropperProps, ImgIcon, InlineMicButton, type InlineMicButtonProps, LinkedInIcon, type MessageArtifact, MessageArtifactCard, MessageBubble, type MessageBubbleProps, MessageThread, type MessageThreadProps, MicRecordingOverlay, type MicRecordingOverlayProps, MicWaveformIndicator, type MicWaveformIndicatorProps, type NotificationTypeMeta, OpenAIIcon, type PaletteNavItem, type ParsedChunk, type ParsedChunkMetadata, type ParsedDocument, type ParsedDocumentMetadata, PdfIcon, PhotoCapture, type PhotoCaptureProps, type ProjectsUsageAggregate, ProviderIcon, RUN_WINDOW_MS, type RenderMarkdown, type SaveAgentConfigVars, type SearchChunk, SemanticSearch, type SemanticSearchProps, type ShellRecentWorkspaceItem, type ShellWorkspaceItem, type ShellWorkspaceKind, type ShellWorkspaceMember, type ShellWorkspaceSeed, type ShellWorkspaceSource, StartByEmail, type StartByEmailLabels, type StartByEmailProps, type ThreadAccessors, type ThreadItem, type ToolResponses, TxtIcon, TypingIndicator, type UsageTotals, type UseArbiChatOptions, type UseArbiShellWorkspacesOptions, type UseAudioRecorderResult, type UseCameraStreamResult, type UseDirectMessagesResult, type UseShellWorkspacesOptions, type UseShellWorkspacesResult, type UseVideoRecorderResult, VidIcon, VideoCapture, type VideoCaptureProps, type VideoRecorderState, VoiceNoteRecorder, type VoiceNoteRecorderProps, XlsIcon, annotateThread, arbiQueryKeys, captureFrameAsBlob, creditsToUsd, cropImage, dayKey, describeActivity, formatCredits, formatElapsed, formatRelativeTime, getNotificationTypeMeta, getWorkspaceActionText, getWorkspaceKind, getWorkspaceSentPhrase, hasVideoTrack, isUsageMetered, isWorkspaceNotificationType, normalizeCitationMarkup, parseActivityContent, pickRecentWorkspaces, redlineStats, resolveActiveWorkspace, textToArtifact, titleFromQuestion, toRedlineMarkdown, toShellWorkspace, useActivity, useAddContacts, useAgentConfig, useAgentModels, useAgentWorkspaces, useAgents, useAiTask, useArbi, useArbiChat, useArbiConnected, useArbiDocumentSync, useArbiShellWorkspaces, useArbiUiStore, useArbiWebSocket, useArbiWsContext, useArbiWsMessage, useArbiWsStatus, useArbiWsStore, useArbiWsTask, useArbiWsTasks, useAssistantQuery, useAudioRecorder, useCameraStream, useCommandPalette, useConfigs, useContacts, useConversations, useCreateAgent, useCreateTask, useDeleteAgents, useDeleteTask, useDirectMessages, useDocuments, useFacts, useGrantAgentAccess, useHealth, useParsedDocument, usePendingContacts, useProjectInvoices, useProjectUsage, useProjects, useProjectsUsage, useRemoveContacts, useRevokeAgentAccess, useRunTask, useSaveAgentConfig, useSemanticSearch, useSessions, useShellWorkspaces, useSkills, useTags, useTaskRuns, useTasks, useThumbnails, useUpdateTask, useUserUsageToday, useVideoRecorder, useWorkspaceDocs, useWorkspaces, userDisplayName, userInitials };