@arbidocs/react 0.4.27 → 0.4.28

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 import * as React$1 from 'react';
 import React__default, { ReactNode, ComponentType } from 'react';
-import { ArbiOptions, Arbi, SSEStreamResult, SSEStreamStartData, UserMessageEvent, MessageMetadataPayload, ResponseOutputItemDoneEvent, ArtifactEvent, RequestApprovalRequest, ReviewWorkRequest, UpdateConversationRequest, UpdateWorkflowRequest, LoginProfile } from '@arbidocs/sdk/browser';
+import * as _arbidocs_sdk_browser from '@arbidocs/sdk/browser';
+import { ArbiOptions, QueryOptions, Arbi, SSEStreamResult, SSEStreamStartData, UserMessageEvent, MessageMetadataPayload, ResponseOutputItemDoneEvent, ArtifactEvent, RequestApprovalRequest, ReviewWorkRequest, UpdateConversationRequest, UpdateWorkflowRequest, LoginProfile } from '@arbidocs/sdk/browser';
 export { ActivityKind, ActivityResponse, AgentStepEvent, Arbi, ArbiError, ArbiOptions, ArtifactEvent, AuthMode, ConversationResponse, CreateFactRequest, CreateWorkRequest, CreateWorkflowRequest, FactResponse, FactSearchRequest, FactSearchResponse, LoginProfile, MessageMetadataPayload, OutputTokensDetails, PendingAuthResponse, PlanWorkRequest, ProjectInvoicesResponse, ProjectUsageResponse, QueryOptions, RequestApprovalRequest, ResponseCompletedEvent, ResponseContentPartAddedEvent, ResponseCreatedEvent, ResponseFailedEvent, ResponseOutputItemAddedEvent, ResponseOutputItemDoneEvent, ResponseOutputTextDeltaEvent, ResponseOutputTextDoneEvent, ResponseUsage, ReviewWorkRequest, SSEStreamCallbacks, SSEStreamResult, SSEStreamStartData, SkillSummary, TaskPlan, UpdateConversationRequest, UpdateWorkflowRequest, UserDailyUsageResponse, UserInputRequestEvent, UserMessageEvent, WorkStatus, WorkflowAuthMode, WorkflowResponse, WorkflowRunResponse } from '@arbidocs/sdk/browser';
 import * as _arbidocs_client from '@arbidocs/client';
 import { WebSocketServerMessage, WsTaskUpdateMessage, WsPresenceUpdateMessage, components } from '@arbidocs/client';
@@ -69,6 +70,8 @@ declare function toChatCitations(source: {
 type ArbiChatRole = 'user' | 'assistant';
 type ArbiChatMessageStatus = 'streaming' | 'complete' | 'error';
 interface ArbiChatMessage {
+    mentions?: QueryOptions['mentions'];
+    authorId?: string;
     id: string;
     role: ArbiChatRole;
     /** Markdown for an assistant message, plain text for a user message. */
@@ -96,6 +99,8 @@ interface ArbiChatDocument {
     isSelected: boolean;
 }
 interface UseArbiChatOptions {
+    /** Use an owned agent's independent session, history and sandbox files. */
+    agentId?: string;
     /** 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. */
@@ -113,6 +118,10 @@ interface UseArbiChatOptions {
     };
 }
 interface ArbiChat {
+    assistantMode: 'always' | 'mentioned';
+    isUpdatingAssistantMode: boolean;
+    isPostingComment: boolean;
+    setAssistantMode: (mode: 'always' | 'mentioned') => Promise<void>;
     threads: ArbiChatThread[];
     activeThreadId: string;
     messages: ArbiChatMessage[];
@@ -130,7 +139,9 @@ interface ArbiChat {
     isLoadingDocuments: boolean;
     isUploading: boolean;
     uploadError: string | null;
-    send: (text: string) => Promise<void>;
+    send: (text: string, options?: {
+        mentions?: QueryOptions['mentions'];
+    }) => Promise<void>;
     /** Re-ask the question whose answer failed. */
     retry: () => Promise<void>;
     /** Abort the running answer; what streamed so far stays, marked stopped. */
@@ -493,6 +504,7 @@ interface ParsedDocument {
 
 declare const arbiQueryKeys: {
     workspaces: () => readonly ["arbi", "workspaces"];
+    workspaceUsers: (workspaceId: string) => readonly ["arbi", "workspaceUsers", string];
     documents: (workspaceId: string) => readonly ["arbi", "documents", string];
     conversations: (workspaceId: string) => readonly ["arbi", "conversations", string];
     /** Every workspace's conversation list (and threads): the prefix a conversation write invalidates. */
@@ -523,6 +535,29 @@ declare const arbiQueryKeys: {
     /** The signed-in user's settings record (notification preferences, flags). */
     userSettings: () => readonly ["arbi", "userSettings"];
 };
+/** Workspace people for mentions, ownership and sign-off. */
+declare function useWorkspaceUsers(workspaceId: string | undefined, options?: {
+    enabled?: boolean;
+    beforeFetch?: () => Promise<unknown>;
+}): _tanstack_react_query.UseQueryResult<NoInfer<{
+    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>;
 /** List the logged-in user's workspaces. */
 declare function useWorkspaces(options?: {
     enabled?: boolean;
@@ -626,6 +661,7 @@ declare function useDocuments(workspaceId: string | undefined, options?: {
 /** List conversations in a workspace. */
 declare function useConversations(workspaceId: string | undefined, options?: {
     enabled?: boolean;
+    live?: boolean;
 }): _tanstack_react_query.UseQueryResult<NoInfer<{
     external_id: string;
     title: string | null;
@@ -648,6 +684,7 @@ declare function useConversations(workspaceId: string | undefined, options?: {
     workflow_ext_id?: string | null | undefined;
     agent_ext_id?: string | null | undefined;
     skill_ref?: string | null | undefined;
+    has_agent_action?: boolean | undefined;
     auth_mode?: (_arbidocs_client.components["schemas"]["src__models__work__AuthMode"] | null) | undefined;
     plan?: {
         goal: string;
@@ -675,6 +712,7 @@ declare function useConversations(workspaceId: string | undefined, options?: {
  */
 declare function useConversationThreads(workspaceId: string | undefined, conversationId: string | undefined, options?: {
     enabled?: boolean;
+    live?: boolean;
 }): _tanstack_react_query.UseQueryResult<NoInfer<{
     conversation_ext_id: string;
     threads: {
@@ -893,9 +931,14 @@ declare function useParsedDocument(docId: string | undefined, stage?: string, op
 /** Send a streaming query to the RAG assistant. Returns a mutation. */
 declare function useAssistantQuery(): _tanstack_react_query.UseMutationResult<SSEStreamResult, Error, {
     question: string;
+    agentId?: string;
+    workspaceId?: string;
     activeArtifactExtId?: string;
     docIds: string[];
     previousResponseId?: string | null;
+    conversationId?: string;
+    assistantMode?: QueryOptions["assistantMode"];
+    mentions?: QueryOptions["mentions"];
     model?: string;
     onToken?: (content: string) => void;
     /** Aborts the request and the stream; the mutation then rejects with an `AbortError`. */
@@ -1664,6 +1707,7 @@ declare function useUpdateConversation(): _tanstack_react_query.UseMutationResul
     workflow_ext_id?: string | null;
     agent_ext_id?: string | null;
     skill_ref?: string | null;
+    has_agent_action?: boolean;
     auth_mode?: _arbidocs_client.components["schemas"]["src__models__work__AuthMode"] | null;
     plan?: _arbidocs_client.components["schemas"]["TaskPlan"] | null;
     goal_state?: {
@@ -1706,6 +1750,7 @@ declare function useCreateWork(): _tanstack_react_query.UseMutationResult<{
     workflow_ext_id?: string | null;
     agent_ext_id?: string | null;
     skill_ref?: string | null;
+    has_agent_action?: boolean;
     auth_mode?: _arbidocs_client.components["schemas"]["src__models__work__AuthMode"] | null;
     plan?: _arbidocs_client.components["schemas"]["TaskPlan"] | null;
     goal_state?: {
@@ -1761,6 +1806,7 @@ declare function useRunConversation(): _tanstack_react_query.UseMutationResult<{
     workflow_ext_id?: string | null;
     agent_ext_id?: string | null;
     skill_ref?: string | null;
+    has_agent_action?: boolean;
     auth_mode?: _arbidocs_client.components["schemas"]["src__models__work__AuthMode"] | null;
     plan?: _arbidocs_client.components["schemas"]["TaskPlan"] | null;
     goal_state?: {
@@ -1800,6 +1846,7 @@ declare function useReviewConversation(): _tanstack_react_query.UseMutationResul
     workflow_ext_id?: string | null;
     agent_ext_id?: string | null;
     skill_ref?: string | null;
+    has_agent_action?: boolean;
     auth_mode?: _arbidocs_client.components["schemas"]["src__models__work__AuthMode"] | null;
     plan?: _arbidocs_client.components["schemas"]["TaskPlan"] | null;
     goal_state?: {
@@ -1842,6 +1889,7 @@ declare function useRequestConversationApproval(): _tanstack_react_query.UseMuta
     workflow_ext_id?: string | null;
     agent_ext_id?: string | null;
     skill_ref?: string | null;
+    has_agent_action?: boolean;
     auth_mode?: _arbidocs_client.components["schemas"]["src__models__work__AuthMode"] | null;
     plan?: _arbidocs_client.components["schemas"]["TaskPlan"] | null;
     goal_state?: {
@@ -1901,6 +1949,7 @@ declare function useConversationActivity(conversationId: string | undefined, opt
 /** The caller's workflows (their own, and the ones shared with the open workspace). */
 declare function useWorkflows(options?: {
     enabled?: boolean;
+    live?: boolean;
 }): _tanstack_react_query.UseQueryResult<NoInfer<{
     external_id: string;
     name: string;
@@ -2149,6 +2198,7 @@ declare function useRevokeAgentAccess(): _tanstack_react_query.UseMutationResult
 declare function useSkills(options?: {
     enabled?: boolean;
     includeHidden?: boolean;
+    live?: boolean;
 }): _tanstack_react_query.UseQueryResult<NoInfer<{
     name: string;
     slug: string;
@@ -2162,6 +2212,47 @@ declare function useSkills(options?: {
     visibility: string;
     is_owner: boolean;
 }[]>, Error>;
+/** Upload skill files through the same document path as the main application. */
+declare function useUploadSkillFiles(): _tanstack_react_query.UseMutationResult<{
+    doc_ext_ids?: string[];
+}[], Error, {
+    folder: string;
+    fileName: string;
+    content: Blob;
+}[], unknown>;
+/** Start the person's assistant as reviewable work, then resolve its persisted thread. */
+declare function useStartWorkQuery(): _tanstack_react_query.UseMutationResult<{
+    conversationId: string;
+    responseId: string;
+}, Error, Omit<_arbidocs_sdk_browser.SubmitBackgroundQueryOptions, "question" | "workspaceId" | keyof _arbidocs_sdk_browser.AuthHeaders> & {
+    question: string;
+}, unknown>;
+/** Independent agent login status, polled while its controls are visible. */
+declare function useAgentSession(agentId: string | undefined, options?: {
+    enabled?: boolean;
+}): _tanstack_react_query.UseQueryResult<NoInfer<{
+    backend: string;
+    active: boolean;
+    workspace_ext_id?: string | null | undefined;
+    workspace_name?: string | null | undefined;
+}>, Error>;
+declare function useAgentChats(agentId: string | undefined): _tanstack_react_query.UseQueryResult<NoInfer<{
+    conversation_ext_id: string;
+    workspace_ext_id: string;
+    workspace_name: string;
+    title: string;
+    updated_at: string;
+}[]>, Error>;
+declare function useStartAgentSession(): _tanstack_react_query.UseMutationResult<{
+    backend: string;
+    active: boolean;
+    workspace_ext_id?: string | null | undefined;
+    workspace_name?: string | null | undefined;
+}, Error, {
+    agentId: string;
+    workspaceId?: string;
+}, unknown>;
+declare function useCloseAgentSession(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
 
 /**
  * Contacts: the user's colleagues and pending invitations.
@@ -3858,6 +3949,646 @@ interface ActivityFeedProps {
  */
 declare function ActivityFeed({ limit, className, emptyLabel, enabled, 'data-testid': testId, }: ActivityFeedProps): React$1.JSX.Element;
 
+/** Persisted work notices, isolated by account and API, with live refresh and read receipts. */
+declare function useWorkNotifications(options: {
+    apiUrl: string;
+    userId?: string;
+    enabled: boolean;
+}): {
+    markRead: _tanstack_react_query.UseMutateAsyncFunction<void, Error, string[], unknown>;
+    data: 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;
+        dm_context_only: boolean;
+        content?: string | null | undefined;
+        conversation_ext_id?: string | null | undefined;
+        message_ext_id?: string | null | undefined;
+        read: boolean;
+        created_at: string;
+        updated_at: string;
+    }[]>;
+    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<{
+        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;
+        dm_context_only: boolean;
+        content?: string | null | undefined;
+        conversation_ext_id?: string | null | undefined;
+        message_ext_id?: string | null | undefined;
+        read: boolean;
+        created_at: string;
+        updated_at: string;
+    }[]>, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<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;
+        dm_context_only: boolean;
+        content?: string | null | undefined;
+        conversation_ext_id?: string | null | undefined;
+        message_ext_id?: string | null | undefined;
+        read: boolean;
+        created_at: string;
+        updated_at: string;
+    }[]>>;
+} | {
+    markRead: _tanstack_react_query.UseMutateAsyncFunction<void, Error, string[], unknown>;
+    data: 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;
+        dm_context_only: boolean;
+        content?: string | null | undefined;
+        conversation_ext_id?: string | null | undefined;
+        message_ext_id?: string | null | undefined;
+        read: boolean;
+        created_at: string;
+        updated_at: string;
+    }[]>;
+    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<{
+        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;
+        dm_context_only: boolean;
+        content?: string | null | undefined;
+        conversation_ext_id?: string | null | undefined;
+        message_ext_id?: string | null | undefined;
+        read: boolean;
+        created_at: string;
+        updated_at: string;
+    }[]>, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<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;
+        dm_context_only: boolean;
+        content?: string | null | undefined;
+        conversation_ext_id?: string | null | undefined;
+        message_ext_id?: string | null | undefined;
+        read: boolean;
+        created_at: string;
+        updated_at: string;
+    }[]>>;
+} | {
+    markRead: _tanstack_react_query.UseMutateAsyncFunction<void, Error, string[], unknown>;
+    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<{
+        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;
+        dm_context_only: boolean;
+        content?: string | null | undefined;
+        conversation_ext_id?: string | null | undefined;
+        message_ext_id?: string | null | undefined;
+        read: boolean;
+        created_at: string;
+        updated_at: string;
+    }[]>, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<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;
+        dm_context_only: boolean;
+        content?: string | null | undefined;
+        conversation_ext_id?: string | null | undefined;
+        message_ext_id?: string | null | undefined;
+        read: boolean;
+        created_at: string;
+        updated_at: string;
+    }[]>>;
+} | {
+    markRead: _tanstack_react_query.UseMutateAsyncFunction<void, Error, string[], unknown>;
+    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<{
+        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;
+        dm_context_only: boolean;
+        content?: string | null | undefined;
+        conversation_ext_id?: string | null | undefined;
+        message_ext_id?: string | null | undefined;
+        read: boolean;
+        created_at: string;
+        updated_at: string;
+    }[]>, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<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;
+        dm_context_only: boolean;
+        content?: string | null | undefined;
+        conversation_ext_id?: string | null | undefined;
+        message_ext_id?: string | null | undefined;
+        read: boolean;
+        created_at: string;
+        updated_at: string;
+    }[]>>;
+} | {
+    markRead: _tanstack_react_query.UseMutateAsyncFunction<void, Error, string[], unknown>;
+    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<{
+        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;
+        dm_context_only: boolean;
+        content?: string | null | undefined;
+        conversation_ext_id?: string | null | undefined;
+        message_ext_id?: string | null | undefined;
+        read: boolean;
+        created_at: string;
+        updated_at: string;
+    }[]>, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<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;
+        dm_context_only: boolean;
+        content?: string | null | undefined;
+        conversation_ext_id?: string | null | undefined;
+        message_ext_id?: string | null | undefined;
+        read: boolean;
+        created_at: string;
+        updated_at: string;
+    }[]>>;
+} | {
+    markRead: _tanstack_react_query.UseMutateAsyncFunction<void, Error, string[], unknown>;
+    data: 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;
+        dm_context_only: boolean;
+        content?: string | null | undefined;
+        conversation_ext_id?: string | null | undefined;
+        message_ext_id?: string | null | undefined;
+        read: boolean;
+        created_at: string;
+        updated_at: string;
+    }[]>;
+    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<{
+        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;
+        dm_context_only: boolean;
+        content?: string | null | undefined;
+        conversation_ext_id?: string | null | undefined;
+        message_ext_id?: string | null | undefined;
+        read: boolean;
+        created_at: string;
+        updated_at: string;
+    }[]>, Error>>;
+    fetchStatus: _tanstack_query_core.FetchStatus;
+    promise: Promise<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;
+        dm_context_only: boolean;
+        content?: string | null | undefined;
+        conversation_ext_id?: string | null | undefined;
+        message_ext_id?: string | null | undefined;
+        read: boolean;
+        created_at: string;
+        updated_at: string;
+    }[]>>;
+};
+
 /**
  * Direct-message view types.
  *
@@ -4815,4 +5546,4 @@ interface ArbiUiState {
 }
 declare const useArbiUiStore: zustand.UseBoundStore<zustand.StoreApi<ArbiUiState>>;
 
-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 ArbiChatCitation, type ArbiChatDocument, type ArbiChatMessage, type ArbiChatMessageStatus, type ArbiChatPassage, type ArbiChatRole, type ArbiChatThread, ArbiIcon, ArbiProvider, type ArbiProviderProps, type ArbiUiState, ArbiWebSocketProvider, type ArbiWebSocketProviderProps, type ArbiWsState, type ArbiWsStatus, ArtifactCanvas, type AspectOption, AudIcon, type AudioRecorderState, type AvatarCrop, type AvatarFileProblem, 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_PASSWORD_CHANGE_FORM_MESSAGES, DEFAULT_START_BY_EMAIL_LABELS, DEFAULT_USD_PER_CREDIT, DateSeparator, type DateSeparatorProps, type DeleteAccountBlocker, type DeleteAccountFlow, 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, type EmailChange, type EmailPreferences, 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, MAX_AVATAR_FILE_BYTES, type MessageArtifact, MessageArtifactCard, MessageBubble, type MessageBubbleProps, MessageThread, type MessageThreadProps, MicRecordingOverlay, type MicRecordingOverlayProps, MicWaveformIndicator, type MicWaveformIndicatorProps, type NameEditor, type NotificationPreferencesModel, type NotificationTypeMeta, OpenAIIcon, type PaletteNavItem, type ParsedChunk, type ParsedChunkMetadata, type ParsedDocument, type ParsedDocumentMetadata, type PasswordChangeForm, type PasswordChangeFormMessages, type PasswordChangeResult, type PasswordChangeVars, PdfIcon, PhotoCapture, type PhotoCaptureProps, type ProfileView, 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 UpdateProfileVars, type UsageTotals, type UseArbiChatOptions, type UseArbiShellWorkspacesOptions, type UseAudioRecorderResult, type UseAvatarCropOptions, type UseCameraStreamResult, type UseDeleteAccountFlowOptions, type UseDirectMessagesResult, type UseEmailChangeOptions, type UseNameEditorOptions, type UsePasswordChangeFormOptions, 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, parseActivityContent, parseDeleteAccountBlockers, pickRecentWorkspaces, redlineStats, resolveActiveWorkspace, textToArtifact, titleFromQuestion, toChatCitations, toNotificationPreferences, toProfileView, toRedlineMarkdown, toShellWorkspace, useActivity, useAddContacts, useAgentConfig, useAgentModels, useAgentWorkspaces, useAgents, useAiTask, useArbi, useArbiChat, useArbiConnected, useArbiDocumentSync, useArbiShellWorkspaces, useArbiUiStore, useArbiWebSocket, useArbiWsContext, useArbiWsMessage, useArbiWsStatus, useArbiWsStore, useArbiWsTask, useArbiWsTasks, useAssistantQuery, useAudioRecorder, useAvatarCrop, useCameraStream, useCommandPalette, useConfigs, useConfirmEmailChange, useContacts, useConversationActivity, useConversationPendingAuth, useConversationThreads, useConversations, useCreateAgent, useCreateWork, useCreateWorkflow, useCurrentSessionId, useDeleteAccount, useDeleteAccountFlow, useDeleteAgents, useDeleteWorkflow, useDirectMessages, useDocuments, useEmailChange, useFacts, useGrantAgentAccess, useHealth, useLogoutAllSessions, useNameEditor, useNotificationPreferences, useParsedDocument, usePasswordChange, usePasswordChangeForm, usePendingContacts, usePlanWork, useProfile, useProjectInvoices, useProjectUsage, useProjects, useProjectsUsage, useRemoveContacts, useRequestConversationApproval, useRequestEmailChange, useReviewConversation, useRevokeAgentAccess, useRunConversation, useRunWorkflow, useSaveAgentConfig, useSemanticSearch, useSessions, useShellWorkspaces, useSkills, useTags, useTerminateSession, useThumbnails, useUpdateConversation, useUpdateProfile, useUpdateWorkflow, useUserSettings, useUserUsageToday, useVideoRecorder, useWorkflows, 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 ArbiChatCitation, type ArbiChatDocument, type ArbiChatMessage, type ArbiChatMessageStatus, type ArbiChatPassage, type ArbiChatRole, type ArbiChatThread, ArbiIcon, ArbiProvider, type ArbiProviderProps, type ArbiUiState, ArbiWebSocketProvider, type ArbiWebSocketProviderProps, type ArbiWsState, type ArbiWsStatus, ArtifactCanvas, type AspectOption, AudIcon, type AudioRecorderState, type AvatarCrop, type AvatarFileProblem, 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_PASSWORD_CHANGE_FORM_MESSAGES, DEFAULT_START_BY_EMAIL_LABELS, DEFAULT_USD_PER_CREDIT, DateSeparator, type DateSeparatorProps, type DeleteAccountBlocker, type DeleteAccountFlow, 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, type EmailChange, type EmailPreferences, 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, MAX_AVATAR_FILE_BYTES, type MessageArtifact, MessageArtifactCard, MessageBubble, type MessageBubbleProps, MessageThread, type MessageThreadProps, MicRecordingOverlay, type MicRecordingOverlayProps, MicWaveformIndicator, type MicWaveformIndicatorProps, type NameEditor, type NotificationPreferencesModel, type NotificationTypeMeta, OpenAIIcon, type PaletteNavItem, type ParsedChunk, type ParsedChunkMetadata, type ParsedDocument, type ParsedDocumentMetadata, type PasswordChangeForm, type PasswordChangeFormMessages, type PasswordChangeResult, type PasswordChangeVars, PdfIcon, PhotoCapture, type PhotoCaptureProps, type ProfileView, 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 UpdateProfileVars, type UsageTotals, type UseArbiChatOptions, type UseArbiShellWorkspacesOptions, type UseAudioRecorderResult, type UseAvatarCropOptions, type UseCameraStreamResult, type UseDeleteAccountFlowOptions, type UseDirectMessagesResult, type UseEmailChangeOptions, type UseNameEditorOptions, type UsePasswordChangeFormOptions, 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, parseActivityContent, parseDeleteAccountBlockers, pickRecentWorkspaces, redlineStats, resolveActiveWorkspace, textToArtifact, titleFromQuestion, toChatCitations, toNotificationPreferences, toProfileView, toRedlineMarkdown, toShellWorkspace, useActivity, useAddContacts, useAgentChats, useAgentConfig, useAgentModels, useAgentSession, useAgentWorkspaces, useAgents, useAiTask, useArbi, useArbiChat, useArbiConnected, useArbiDocumentSync, useArbiShellWorkspaces, useArbiUiStore, useArbiWebSocket, useArbiWsContext, useArbiWsMessage, useArbiWsStatus, useArbiWsStore, useArbiWsTask, useArbiWsTasks, useAssistantQuery, useAudioRecorder, useAvatarCrop, useCameraStream, useCloseAgentSession, useCommandPalette, useConfigs, useConfirmEmailChange, useContacts, useConversationActivity, useConversationPendingAuth, useConversationThreads, useConversations, useCreateAgent, useCreateWork, useCreateWorkflow, useCurrentSessionId, useDeleteAccount, useDeleteAccountFlow, useDeleteAgents, useDeleteWorkflow, useDirectMessages, useDocuments, useEmailChange, useFacts, useGrantAgentAccess, useHealth, useLogoutAllSessions, useNameEditor, useNotificationPreferences, useParsedDocument, usePasswordChange, usePasswordChangeForm, usePendingContacts, usePlanWork, useProfile, useProjectInvoices, useProjectUsage, useProjects, useProjectsUsage, useRemoveContacts, useRequestConversationApproval, useRequestEmailChange, useReviewConversation, useRevokeAgentAccess, useRunConversation, useRunWorkflow, useSaveAgentConfig, useSemanticSearch, useSessions, useShellWorkspaces, useSkills, useStartAgentSession, useStartWorkQuery, useTags, useTerminateSession, useThumbnails, useUpdateConversation, useUpdateProfile, useUpdateWorkflow, useUploadSkillFiles, useUserSettings, useUserUsageToday, useVideoRecorder, useWorkNotifications, useWorkflows, useWorkspaceDocs, useWorkspaceUsers, useWorkspaces, userDisplayName, userInitials };