@arbidocs/sdk 0.3.11 → 0.3.14

package/dist/browser-DtwXhEkG.d.cts

@@ -0,0 +1,3230 @@
+import * as _arbidocs_client from '@arbidocs/client';
+import { ArbiClient, LoginResult, components, WebSocketServerMessage, WsTaskUpdateMessage } from '@arbidocs/client';
+
+/**
+ * Core error types and throwing error utilities.
+ *
+ * Unlike CLI helpers which call process.exit(1), these throw typed errors
+ * that consumers (CLI, TUI) can catch and handle in their own way.
+ */
+declare class ArbiError extends Error {
+    constructor(message: string);
+}
+declare class ArbiApiError extends ArbiError {
+    readonly apiError?: unknown;
+    constructor(message: string, apiError?: unknown);
+}
+/**
+ * Check API response and throw on error. Returns narrowed non-null data.
+ */
+declare function requireData<T>(result: {
+    data?: T;
+    error?: unknown;
+}, message: string): T;
+/**
+ * Check API response for delete/void operations (no data expected).
+ */
+declare function requireOk(result: {
+    error?: unknown;
+}, message: string): void;
+/**
+ * Extract a human-readable message from an unknown error value.
+ * Centralises the `err instanceof Error ? err.message : String(err)` pattern.
+ *
+ * Unwraps `.cause` chains to surface the root error — critical for Node.js
+ * fetch errors where TypeError("fetch failed") wraps the real cause
+ * (ECONNREFUSED, UNABLE_TO_VERIFY_LEAF_SIGNATURE, etc.).
+ */
+declare function getErrorMessage(err: unknown): string;
+/**
+ * Extract the Node.js error code (e.g. 'ECONNREFUSED', 'ENOTFOUND') from an
+ * error or its cause chain. Returns undefined if no code is found.
+ */
+declare function getErrorCode(err: unknown): string | undefined;
+
+/**
+ * Authenticated fetch utility — eliminates repeated raw-fetch boilerplate
+ * in operations that can't use the typed SDK client (streaming, multipart, etc.).
+ */
+interface AuthHeaders {
+    baseUrl: string;
+    accessToken: string;
+    workspaceKeyHeader: string;
+}
+interface AuthFetchOptions extends AuthHeaders {
+    /** URL path relative to baseUrl (e.g. '/v1/document/upload'). */
+    path: string;
+    method?: string;
+    body?: string | FormData | ArrayBuffer | ReadableStream | Blob | null;
+    /** Extra headers to merge in. */
+    headers?: Record<string, string>;
+}
+/**
+ * Make an authenticated fetch request with standard error handling.
+ * Automatically sets Authorization + workspace-key headers.
+ * Throws on non-ok responses with a human-readable message including server error details.
+ */
+declare function authenticatedFetch(options: AuthFetchOptions): Promise<Response>;
+
+/**
+ * Configuration types — shared between browser and Node.js environments.
+ *
+ * This file has NO Node.js dependencies and is safe for browser bundling.
+ */
+interface CliConfig {
+    baseUrl: string;
+    deploymentDomain: string;
+    selectedWorkspaceId?: string;
+    autoUpdate?: boolean;
+    notifications?: boolean;
+    verbose?: boolean;
+    watch?: boolean;
+}
+interface CliCredentials {
+    email: string;
+    signingPrivateKeyBase64: string;
+    serverSessionKeyBase64: string;
+    /** Cached workspace-scoped JWT from last successful resolveWorkspace() */
+    accessToken?: string;
+    /** Cached workspace key header from last successful resolveWorkspace() */
+    workspaceKeyHeader?: string;
+    /** Workspace ID the cached token was issued for */
+    workspaceId?: string;
+    /** ISO timestamp when the token was cached */
+    tokenTimestamp?: string;
+}
+interface ChatSession {
+    /** Last assistant message ID — used as previous_response_id for follow-ups */
+    lastMessageExtId: string | null;
+    /** Conversation external ID — used to restore chat history on restart */
+    conversationExtId: string | null;
+    /** Workspace ID where the conversation started — used to detect workspace changes */
+    workspaceId: string | null;
+}
+interface ConfigStore {
+    getConfig(): CliConfig | null;
+    saveConfig(config: CliConfig): void;
+    updateConfig(updates: Partial<CliConfig>): void;
+    requireConfig(): CliConfig;
+    getCredentials(): CliCredentials | null;
+    saveCredentials(creds: CliCredentials): void;
+    deleteCredentials(): void;
+    requireCredentials(): CliCredentials;
+    getChatSession(): ChatSession;
+    saveChatSession(session: ChatSession): void;
+    updateChatSession(updates: Partial<ChatSession>): void;
+    clearChatSession(): void;
+}
+
+/**
+ * Parameterized authentication functions.
+ *
+ * Unlike CLI's client.ts, these take explicit params instead of reading from disk.
+ * This allows both CLI and TUI to use them with their own config sources.
+ */
+
+interface AuthenticatedClient {
+    arbi: ArbiClient;
+    loginResult: LoginResult;
+}
+interface AuthContext {
+    arbi: ArbiClient;
+    loginResult: LoginResult;
+    config: CliConfig;
+}
+interface WorkspaceContext extends AuthContext {
+    workspaceId: string;
+    accessToken: string;
+    workspaceKeyHeader: string;
+}
+/** Minimal workspace shape required by formatWorkspaceChoices. */
+interface WorkspaceForChoice {
+    name: string;
+    external_id: string;
+    shared_document_count: number;
+    private_document_count: number;
+}
+/**
+ * Format a list of workspaces into prompt-friendly choices.
+ * Returns `{ name, value, description }` objects suitable for @inquirer/prompts
+ * or any similar select component.
+ */
+declare function formatWorkspaceChoices(wsList: WorkspaceForChoice[]): Array<{
+    name: string;
+    value: string;
+    description: string;
+}>;
+/**
+ * Create an SDK client, init sodium, and log in with stored signing key.
+ * Returns the client + login result (which includes serverSessionKey).
+ */
+declare function createAuthenticatedClient(config: CliConfig, creds: CliCredentials, store: ConfigStore): Promise<AuthenticatedClient>;
+/**
+ * Interactive (password-based) login flow.
+ *
+ * Creates an SDK client, initializes sodium, authenticates with email/password,
+ * and persists the derived credentials to the config store.
+ *
+ * Use this for CLI/TUI login commands. For session recovery from stored keys,
+ * use createAuthenticatedClient() instead.
+ */
+declare function performPasswordLogin(config: CliConfig, email: string, password: string, store: ConfigStore): Promise<AuthContext>;
+/**
+ * Decrypt wrapped workspace key and set it as the active workspace header.
+ */
+declare function selectWorkspace(arbi: ArbiClient, workspaceId: string, wrappedKey: string, serverSessionKey: Uint8Array, signingPrivateKeyBase64: string): Promise<void>;
+/**
+ * Generate an encrypted workspace key for the given workspace.
+ * Used for operations that need a key for a workspace other than the current one
+ * (e.g., copy documents to a target workspace).
+ */
+declare function generateEncryptedWorkspaceKey(arbi: ArbiClient, wrappedKey: string, serverSessionKey: Uint8Array, signingPrivateKeyBase64: string): Promise<string>;
+/**
+ * Find a workspace by ID in the user's workspace list, select it, and return workspace info.
+ */
+declare function selectWorkspaceById(arbi: ArbiClient, workspaceId: string, serverSessionKey: Uint8Array, signingPrivateKeyBase64: string): Promise<{
+    external_id: string;
+    name: string;
+    wrapped_key: string;
+}>;
+/**
+ * Authenticate and return the SDK client + config.
+ * Throws ArbiError instead of calling process.exit.
+ */
+declare function resolveAuth(store: ConfigStore): Promise<AuthContext>;
+/**
+ * Authenticate, resolve workspace, and set up headers.
+ * Uses cached JWT when available for the same workspace and not expired.
+ * Throws ArbiError instead of calling process.exit.
+ */
+declare function resolveWorkspace(store: ConfigStore, workspaceOpt?: string): Promise<WorkspaceContext>;
+
+/**
+ * SSE event types — re-exported from the auto-generated OpenAPI schema.
+ *
+ * Consumers should import these from '@arbidocs/sdk' (or '/browser')
+ * rather than reaching into '@arbidocs/client' directly.
+ */
+
+type ResponseCreatedEvent = components['schemas']['ResponseCreatedEvent'];
+type ResponseCompletedEvent = components['schemas']['ResponseCompletedEvent'];
+type ResponseFailedEvent = components['schemas']['ResponseFailedEvent'];
+type ResponseOutputTextDeltaEvent = components['schemas']['ResponseOutputTextDeltaEvent'];
+type ResponseOutputTextDoneEvent = components['schemas']['ResponseOutputTextDoneEvent'];
+type ResponseOutputItemAddedEvent = components['schemas']['ResponseOutputItemAddedEvent'];
+type ResponseOutputItemDoneEvent = components['schemas']['ResponseOutputItemDoneEvent'];
+type ResponseContentPartAddedEvent = components['schemas']['ResponseContentPartAddedEvent'];
+type AgentStepEvent = components['schemas']['AgentStepEvent'];
+type UserInputRequestEvent = components['schemas']['UserInputRequestEvent'];
+type ArtifactEvent = components['schemas']['ArtifactEvent'];
+type UserMessageEvent = components['schemas']['UserMessageEvent'];
+type MessageMetadataPayload = components['schemas']['MessageMetadataPayload'];
+type ResponseUsage = components['schemas']['ResponseUsage'];
+type OutputTokensDetails = components['schemas']['OutputTokensDetails'];
+type TokenBudgetContext = components['schemas']['TokenBudgetContext'];
+/** Convenience type — what onStreamStart callbacks receive. */
+type SSEStreamStartData = {
+    assistant_message_ext_id: string;
+};
+
+/**
+ * Server-Sent Events (SSE) parsing utilities.
+ *
+ * Extracted from CLI ask.ts for shared use by CLI and TUI.
+ */
+
+interface SSEEvent {
+    event: string;
+    data: string;
+}
+declare const TOOL_LABELS: Record<string, string>;
+declare const LIFECYCLE_LABELS: Record<string, string>;
+/**
+ * Format an AgentStepEvent into a human-readable label.
+ *
+ * Priority:
+ * 1. `focus` — the agent's descriptive sentence about what it's doing
+ * 2. For `tool_progress` — tool-specific label + optional message
+ * 3. Lifecycle label (planning, evaluation, etc.)
+ * 4. Tool name from detail
+ * 5. Fallback to step name or empty string
+ */
+declare function formatAgentStepLabel(step: AgentStepEvent): string;
+/**
+ * Parse SSE events from a chunk of text, combining with a buffer
+ * of incomplete data from previous chunks.
+ *
+ * Returns parsed events and any remaining incomplete data.
+ */
+declare function parseSSEEvents(chunk: string, buffer: string): {
+    events: SSEEvent[];
+    remaining: string;
+};
+/**
+ * Callbacks for streaming SSE events. All callbacks are optional —
+ * omitted callbacks simply ignore that event type.
+ */
+interface SSEStreamCallbacks {
+    onStreamStart?: (data: SSEStreamStartData) => void;
+    onToken?: (content: string) => void;
+    onTextDone?: (text: string) => void;
+    onOutputItemAdded?: (data: ResponseOutputItemAddedEvent) => void;
+    onOutputItemDone?: (data: ResponseOutputItemDoneEvent) => void;
+    onContentPartAdded?: (data: ResponseContentPartAddedEvent) => void;
+    onAgentStep?: (data: AgentStepEvent) => void;
+    onError?: (message: string) => void;
+    onUserMessage?: (data: UserMessageEvent) => void;
+    onMetadata?: (data: MessageMetadataPayload) => void;
+    onUserInputRequest?: (data: UserInputRequestEvent) => void;
+    onArtifact?: (data: ArtifactEvent) => void;
+    onElapsedTime?: (t: number) => void;
+    onUsage?: (usage: ResponseUsage) => void;
+    onComplete?: () => void;
+}
+/**
+ * Result returned after the SSE stream is fully consumed.
+ */
+interface SSEStreamResult {
+    text: string;
+    assistantMessageExtId: string | null;
+    agentSteps: string[];
+    /** Total number of tool calls across all agent steps. */
+    toolCallCount: number;
+    errors: string[];
+    userMessage: UserMessageEvent | null;
+    metadata: MessageMetadataPayload | null;
+    artifacts: ArtifactEvent[];
+    usage: ResponseUsage | null;
+    /** Token budget context snapshot from response.completed. */
+    context: TokenBudgetContext | null;
+}
+/**
+ * Stream SSE events from a Response, invoking callbacks as events arrive.
+ *
+ * This is the primary streaming function — use it when you need real-time
+ * event handling (CLI streaming to stdout, TUI rendering, etc.).
+ *
+ * Also accumulates the full response and returns it, so callers can use
+ * both the streaming callbacks and the final result.
+ */
+declare function streamSSE(response: Response, callbacks?: SSEStreamCallbacks): Promise<SSEStreamResult>;
+/**
+ * Consume an entire SSE stream without streaming callbacks.
+ * Convenience alias for `streamSSE(response)`.
+ */
+declare const consumeSSEStream: typeof streamSSE;
+
+/**
+ * WebSocket connection manager.
+ *
+ * Uses Node.js native WebSocket (available in Node 22+).
+ * Authenticates via SDK helpers, routes typed messages to the consumer.
+ */
+
+interface WsConnection {
+    close: () => void;
+}
+interface ConnectOptions {
+    baseUrl: string;
+    accessToken: string;
+    onMessage: (msg: WebSocketServerMessage) => void;
+    onClose?: (code: number, reason: string) => void;
+}
+interface ReconnectOptions extends ConnectOptions {
+    maxRetries?: number;
+    initialDelayMs?: number;
+    onReconnecting?: (attempt: number, maxRetries: number) => void;
+    onReconnected?: () => void;
+    onReconnectFailed?: () => void;
+}
+interface ReconnectableWsConnection {
+    close: () => void;
+}
+/**
+ * Open a WebSocket, authenticate, and start routing messages.
+ *
+ * Resolves after a successful `auth_result`, rejects on auth failure or timeout.
+ * Subsequent messages are dispatched to `onMessage`.
+ */
+declare function connectWebSocket(options: ConnectOptions): Promise<WsConnection>;
+/**
+ * Connect WebSocket with automatic reconnection on disconnect.
+ *
+ * Initial connection throws on failure (same as connectWebSocket).
+ * After successful auth, disconnects trigger exponential backoff reconnection.
+ * Call close() on the returned handle to stop reconnection attempts.
+ */
+declare function connectWithReconnect(options: ReconnectOptions): Promise<ReconnectableWsConnection>;
+interface DocumentWaiterOptions {
+    /** Base URL of the ARBI server (e.g. "https://app.arbi.city"). */
+    baseUrl: string;
+    /** JWT access token for WebSocket authentication. */
+    accessToken: string;
+    /** Optional callback invoked for every task_update on tracked documents. */
+    onStatus?: (msg: WsTaskUpdateMessage) => void;
+}
+interface DocumentWaiter {
+    /** Register document IDs to track. Can be called multiple times. */
+    addDocIds(ids: string[]): void;
+    /** Block until all tracked documents reach terminal status. */
+    waitUntilDone(timeoutMs?: number): Promise<Map<string, string>>;
+    /** Close the WebSocket without waiting. */
+    close(): void;
+}
+/**
+ * Open a WebSocket and start collecting document status events.
+ *
+ * Call this BEFORE uploading so no events are missed. Then call `addDocIds()`
+ * once you know the IDs, and `waitUntilDone()` to block until all reach a
+ * terminal status (completed, failed, or skipped).
+ *
+ * Mirrors the backend SDK's `ArbiWebSocket.wait_for_docs()` pattern.
+ *
+ * @example
+ * ```ts
+ * const waiter = createDocumentWaiter({ baseUrl, accessToken })
+ * const result = await uploadDocuments(...)
+ * waiter.addDocIds(result.doc_ext_ids)
+ * const statuses = await waiter.waitUntilDone(120_000)
+ * ```
+ */
+declare function createDocumentWaiter(options: DocumentWaiterOptions): DocumentWaiter;
+type MessageLevel = 'info' | 'success' | 'error' | 'warning';
+interface FormattedWsMessage {
+    text: string;
+    level: MessageLevel;
+}
+/**
+ * Format a WebSocket message into display text + severity level.
+ * Shared by TUI (toasts) and CLI (stderr lines) — single source of truth.
+ */
+declare function formatWsMessage(msg: WebSocketServerMessage): FormattedWsMessage;
+
+/**
+ * Shared formatting utilities.
+ */
+/**
+ * Converts file size in bytes to human-readable format.
+ *
+ * @param bytes File size in bytes
+ * @param fallback String to return for null/undefined values (default: 'N/A')
+ * @returns Formatted string (e.g., "1.5 MB", "250 KB")
+ */
+declare function formatFileSize(bytes: number | null | undefined, fallback?: string): string;
+/** Minimal user shape used for display formatting. */
+type UserInfo = {
+    external_id?: string;
+    email?: string;
+    given_name?: string;
+    family_name?: string;
+};
+/**
+ * Format a user's display name from given_name + family_name.
+ * Returns empty string if no name parts are available.
+ */
+declare function formatUserName(user: UserInfo | null | undefined): string;
+
+/**
+ * Document operations — browser-safe functions.
+ *
+ * For Node.js file system operations (uploadLocalFile, uploadDirectory, uploadZip),
+ * import from './documents-node.js' instead.
+ */
+
+type DocUpdateRequest$1 = components['schemas']['DocUpdateRequest'];
+/** File extensions supported for document upload. */
+declare const SUPPORTED_EXTENSIONS: Set<string>;
+/**
+ * Sanitize a folder path to only contain characters allowed by the backend
+ * pattern `^[a-zA-Z0-9_\-\/]*$`. Replaces disallowed characters with `_` and
+ * collapses consecutive underscores.
+ */
+declare function sanitizeFolderPath(folderPath: string): string;
+interface UploadOptions {
+    folder?: string;
+}
+interface UploadResult {
+    doc_ext_ids: string[];
+    duplicates?: string[];
+}
+interface UploadBatchResult {
+    doc_ext_ids: string[];
+    duplicates: string[];
+    folders: Map<string, {
+        fileCount: number;
+        doc_ext_ids: string[];
+        duplicates: string[];
+    }>;
+}
+declare function listDocuments(arbi: ArbiClient): Promise<{
+    external_id: string;
+    workspace_ext_id: string;
+    file_name?: string | null | undefined;
+    status?: string | null | undefined;
+    n_pages?: number | null | undefined;
+    n_chunks?: number | null | undefined;
+    tokens?: number | null | undefined;
+    file_type?: string | null | undefined;
+    file_size?: number | null | undefined;
+    storage_type?: string | null | undefined;
+    storage_uri?: string | null | undefined;
+    content_hash?: string | null | undefined;
+    shared?: boolean | null | undefined;
+    re_ocred?: boolean | null | undefined;
+    config_ext_id?: string | null | undefined;
+    parent_ext_id?: string | null | undefined;
+    created_by_ext_id: string;
+    updated_by_ext_id?: string | null | undefined;
+    created_at: string;
+    updated_at: string;
+    wp_type?: string | null | undefined;
+    folder?: string | null | undefined;
+    doctags: {
+        doc_ext_id: string;
+        tag_ext_id: string;
+        note?: string | null | undefined;
+        citations?: {
+            [x: string]: {
+                chunk_ids: string[];
+                scores: number[];
+                statement: string;
+                offset_start: number;
+                offset_end: number;
+            };
+        } | null | undefined;
+        created_by_ext_id: string;
+        updated_by_ext_id?: string | null | undefined;
+        created_at: string;
+        updated_at: string;
+    }[];
+    doc_metadata?: {
+        doc_nature?: string | null | undefined;
+        doc_author?: string | null | undefined;
+        doc_subject?: string | null | undefined;
+        doc_date?: string | null | undefined;
+        title?: string | null | undefined;
+    } | null | undefined;
+}[]>;
+declare function getDocuments(arbi: ArbiClient, externalIds: string[]): Promise<{
+    external_id: string;
+    workspace_ext_id: string;
+    file_name?: string | null | undefined;
+    status?: string | null | undefined;
+    n_pages?: number | null | undefined;
+    n_chunks?: number | null | undefined;
+    tokens?: number | null | undefined;
+    file_type?: string | null | undefined;
+    file_size?: number | null | undefined;
+    storage_type?: string | null | undefined;
+    storage_uri?: string | null | undefined;
+    content_hash?: string | null | undefined;
+    shared?: boolean | null | undefined;
+    re_ocred?: boolean | null | undefined;
+    config_ext_id?: string | null | undefined;
+    parent_ext_id?: string | null | undefined;
+    created_by_ext_id: string;
+    updated_by_ext_id?: string | null | undefined;
+    created_at: string;
+    updated_at: string;
+    wp_type?: string | null | undefined;
+    folder?: string | null | undefined;
+    doctags: {
+        doc_ext_id: string;
+        tag_ext_id: string;
+        note?: string | null | undefined;
+        citations?: {
+            [x: string]: {
+                chunk_ids: string[];
+                scores: number[];
+                statement: string;
+                offset_start: number;
+                offset_end: number;
+            };
+        } | null | undefined;
+        created_by_ext_id: string;
+        updated_by_ext_id?: string | null | undefined;
+        created_at: string;
+        updated_at: string;
+    }[];
+    doc_metadata?: {
+        doc_nature?: string | null | undefined;
+        doc_author?: string | null | undefined;
+        doc_subject?: string | null | undefined;
+        doc_date?: string | null | undefined;
+        title?: string | null | undefined;
+    } | null | undefined;
+}[]>;
+declare function deleteDocuments(arbi: ArbiClient, externalIds: string[]): Promise<void>;
+declare function updateDocuments(arbi: ArbiClient, documents: DocUpdateRequest$1[]): Promise<{
+    external_id: string;
+    workspace_ext_id: string;
+    file_name?: string | null | undefined;
+    status?: string | null | undefined;
+    n_pages?: number | null | undefined;
+    n_chunks?: number | null | undefined;
+    tokens?: number | null | undefined;
+    file_type?: string | null | undefined;
+    file_size?: number | null | undefined;
+    storage_type?: string | null | undefined;
+    storage_uri?: string | null | undefined;
+    content_hash?: string | null | undefined;
+    shared?: boolean | null | undefined;
+    re_ocred?: boolean | null | undefined;
+    config_ext_id?: string | null | undefined;
+    parent_ext_id?: string | null | undefined;
+    created_by_ext_id: string;
+    updated_by_ext_id?: string | null | undefined;
+    created_at: string;
+    updated_at: string;
+    wp_type?: string | null | undefined;
+    folder?: string | null | undefined;
+    doctags: {
+        doc_ext_id: string;
+        tag_ext_id: string;
+        note?: string | null | undefined;
+        citations?: {
+            [x: string]: {
+                chunk_ids: string[];
+                scores: number[];
+                statement: string;
+                offset_start: number;
+                offset_end: number;
+            };
+        } | null | undefined;
+        created_by_ext_id: string;
+        updated_by_ext_id?: string | null | undefined;
+        created_at: string;
+        updated_at: string;
+    }[];
+    doc_metadata?: {
+        doc_nature?: string | null | undefined;
+        doc_author?: string | null | undefined;
+        doc_subject?: string | null | undefined;
+        doc_date?: string | null | undefined;
+        title?: string | null | undefined;
+    } | null | undefined;
+}[]>;
+declare function uploadUrl(arbi: ArbiClient, urls: string[], workspaceId: string, shared?: boolean): Promise<{
+    doc_ext_ids: string[];
+    duplicates?: string[] | undefined;
+}>;
+/**
+ * Get parsed document content.
+ */
+declare function getParsedContent(auth: AuthHeaders, docId: string, stage: string): Promise<Record<string, unknown>>;
+/**
+ * Upload a file to a workspace. Uses raw fetch for multipart upload.
+ */
+declare function uploadFile$1(auth: AuthHeaders, workspaceId: string, fileData: Blob, fileName: string, options?: UploadOptions): Promise<UploadResult>;
+/**
+ * Upload multiple files in a single FormData request with an optional folder parameter.
+ */
+declare function uploadFiles(auth: AuthHeaders, workspaceId: string, files: Array<{
+    data: Blob;
+    name: string;
+}>, options?: UploadOptions): Promise<UploadResult>;
+/**
+ * Download a document. Returns the response for the caller to handle.
+ */
+declare function downloadDocument(auth: AuthHeaders, docId: string): Promise<Response>;
+
+declare const documents_SUPPORTED_EXTENSIONS: typeof SUPPORTED_EXTENSIONS;
+type documents_UploadBatchResult = UploadBatchResult;
+type documents_UploadOptions = UploadOptions;
+type documents_UploadResult = UploadResult;
+declare const documents_deleteDocuments: typeof deleteDocuments;
+declare const documents_downloadDocument: typeof downloadDocument;
+declare const documents_getDocuments: typeof getDocuments;
+declare const documents_getParsedContent: typeof getParsedContent;
+declare const documents_listDocuments: typeof listDocuments;
+declare const documents_sanitizeFolderPath: typeof sanitizeFolderPath;
+declare const documents_updateDocuments: typeof updateDocuments;
+declare const documents_uploadFiles: typeof uploadFiles;
+declare const documents_uploadUrl: typeof uploadUrl;
+declare namespace documents {
+  export { documents_SUPPORTED_EXTENSIONS as SUPPORTED_EXTENSIONS, type documents_UploadBatchResult as UploadBatchResult, type documents_UploadOptions as UploadOptions, type documents_UploadResult as UploadResult, documents_deleteDocuments as deleteDocuments, documents_downloadDocument as downloadDocument, documents_getDocuments as getDocuments, documents_getParsedContent as getParsedContent, documents_listDocuments as listDocuments, documents_sanitizeFolderPath as sanitizeFolderPath, documents_updateDocuments as updateDocuments, uploadFile$1 as uploadFile, documents_uploadFiles as uploadFiles, documents_uploadUrl as uploadUrl };
+}
+
+/**
+ * Assistant operations — retrieve (search-only) and query (with LLM).
+ *
+ * retrieve: Uses the typed SDK route POST /v1/assistant/retrieve.
+ *           Returns matching chunks without LLM generation.
+ *
+ * queryAssistant: Returns the raw Response for SSE streaming.
+ *                 Uses raw fetch because the SDK client doesn't support streaming responses.
+ */
+
+declare function buildRetrievalChunkTool(docIds: string[], searchMode?: 'semantic' | 'keyword' | 'hybrid'): components['schemas']['RetrievalChunkTool'];
+declare function buildRetrievalFullContextTool(docIds: string[]): components['schemas']['RetrievalFullContextTool'];
+declare function buildRetrievalTocTool(docIds: string[]): components['schemas']['RetrievalTOCTool'];
+interface RetrieveOptions {
+    arbi: ArbiClient;
+    workspaceId: string;
+    query: string;
+    docIds: string[];
+    searchMode?: 'semantic' | 'keyword' | 'hybrid';
+    fullContextDocIds?: string[];
+    tocDocIds?: string[];
+    model?: string;
+}
+interface ChunkMetadata {
+    doc_ext_id?: string | null;
+    doc_title?: string | null;
+    chunk_ext_id: string;
+    chunk_pg_idx: number;
+    chunk_doc_idx: number;
+    page_number: number;
+    score?: number | null;
+    rerank_score?: number | null;
+    tokens?: number | null;
+    created_at: string;
+    heading: boolean;
+}
+interface Chunk {
+    metadata: ChunkMetadata;
+    content: string;
+}
+interface RetrieveResult {
+    retrieval_chunk?: {
+        tool_responses: Record<string, Chunk[]>;
+    };
+    retrieval_full_context?: {
+        tool_responses: Record<string, Chunk[]>;
+    };
+    retrieval_toc?: {
+        tool_responses: Record<string, Record<string, unknown>[]>;
+    };
+}
+/**
+ * Search documents and return matching chunks without LLM generation.
+ * Uses the typed SDK route POST /v1/assistant/retrieve.
+ */
+declare function retrieve(options: RetrieveOptions): Promise<RetrieveResult>;
+interface AssistantQueryOptions extends AuthHeaders {
+    workspaceId: string;
+    question: string;
+    docIds: string[];
+    previousResponseId?: string | null;
+    model?: string;
+}
+/**
+ * Send a query to the RAG assistant. Returns the raw Response
+ * so the caller can stream or buffer as needed.
+ *
+ * Uses raw fetch (not the SDK client) because we need the streaming
+ * Response body — the SDK client consumes the body to parse JSON.
+ */
+declare function queryAssistant(options: AssistantQueryOptions): Promise<Response>;
+/**
+ * Respond to an agent's question during a human-in-the-loop workflow.
+ * The assistant_message_ext_id identifies which agent message to answer.
+ */
+declare function respondToAgent(arbi: ArbiClient, assistantMessageExtId: string, answer: string): Promise<unknown>;
+
+type assistant_AssistantQueryOptions = AssistantQueryOptions;
+type assistant_Chunk = Chunk;
+type assistant_ChunkMetadata = ChunkMetadata;
+type assistant_RetrieveOptions = RetrieveOptions;
+type assistant_RetrieveResult = RetrieveResult;
+declare const assistant_buildRetrievalChunkTool: typeof buildRetrievalChunkTool;
+declare const assistant_buildRetrievalFullContextTool: typeof buildRetrievalFullContextTool;
+declare const assistant_buildRetrievalTocTool: typeof buildRetrievalTocTool;
+declare const assistant_queryAssistant: typeof queryAssistant;
+declare const assistant_respondToAgent: typeof respondToAgent;
+declare const assistant_retrieve: typeof retrieve;
+declare namespace assistant {
+  export { type assistant_AssistantQueryOptions as AssistantQueryOptions, type assistant_Chunk as Chunk, type assistant_ChunkMetadata as ChunkMetadata, type assistant_RetrieveOptions as RetrieveOptions, type assistant_RetrieveResult as RetrieveResult, assistant_buildRetrievalChunkTool as buildRetrievalChunkTool, assistant_buildRetrievalFullContextTool as buildRetrievalFullContextTool, assistant_buildRetrievalTocTool as buildRetrievalTocTool, assistant_queryAssistant as queryAssistant, assistant_respondToAgent as respondToAgent, assistant_retrieve as retrieve };
+}
+
+/**
+ * Contact operations — list, add, remove.
+ */
+
+declare function listContacts(arbi: ArbiClient): Promise<{
+    external_id: string;
+    email: string;
+    user?: {
+        external_id: string;
+        email: string;
+        given_name: string;
+        family_name: string;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+    } | null | undefined;
+    status: "invitation_pending" | "invitation_expired" | "registered";
+    created_at: string;
+}[]>;
+declare function addContacts(arbi: ArbiClient, emails: string[]): Promise<{
+    external_id: string;
+    email: string;
+    user?: {
+        external_id: string;
+        email: string;
+        given_name: string;
+        family_name: string;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+    } | null | undefined;
+    status: "invitation_pending" | "invitation_expired" | "registered";
+    created_at: string;
+}[]>;
+declare function removeContacts(arbi: ArbiClient, contactIds: string[]): Promise<void>;
+/**
+ * Group contacts by registration status.
+ * Returns registered contacts and pending (not yet registered) contacts.
+ */
+declare function groupContactsByStatus<T extends {
+    status: string;
+}>(contactList: T[]): {
+    registered: T[];
+    pending: T[];
+};
+
+declare const contacts_addContacts: typeof addContacts;
+declare const contacts_groupContactsByStatus: typeof groupContactsByStatus;
+declare const contacts_listContacts: typeof listContacts;
+declare const contacts_removeContacts: typeof removeContacts;
+declare namespace contacts {
+  export { contacts_addContacts as addContacts, contacts_groupContactsByStatus as groupContactsByStatus, contacts_listContacts as listContacts, contacts_removeContacts as removeContacts };
+}
+
+/**
+ * File operations — OpenAI-compatible Files API (list, get, delete, upload, content).
+ */
+
+type FileObject = components['schemas']['FileObject'];
+type FileDeleteResponse = components['schemas']['FileDeleteResponse'];
+type FileListResponse = components['schemas']['FileListResponse'];
+
+interface ListFilesOptions {
+    purpose?: string | null;
+    limit?: number;
+    order?: string;
+    after?: string | null;
+}
+declare function listFiles(arbi: ArbiClient, options?: ListFilesOptions): Promise<{
+    object: string;
+    data: {
+        id: string;
+        object: string;
+        bytes: number;
+        created_at: number;
+        filename: string;
+        purpose: string;
+        status: string;
+        expires_at?: number | null | undefined;
+        status_details?: string | null | undefined;
+    }[];
+    has_more: boolean;
+    first_id?: string | null | undefined;
+    last_id?: string | null | undefined;
+}>;
+declare function getFile(arbi: ArbiClient, fileId: string): Promise<{
+    id: string;
+    object: string;
+    bytes: number;
+    created_at: number;
+    filename: string;
+    purpose: string;
+    status: string;
+    expires_at?: number | null | undefined;
+    status_details?: string | null | undefined;
+}>;
+declare function deleteFile(arbi: ArbiClient, fileId: string): Promise<{
+    id: string;
+    object: string;
+    deleted: boolean;
+}>;
+/**
+ * Upload a file via the OpenAI-compatible Files API.
+ * Uses raw fetch for multipart upload.
+ */
+declare function uploadFile(auth: AuthHeaders, fileData: Blob, fileName: string, purpose?: string): Promise<FileObject>;
+/**
+ * Get file content (binary). Returns the raw Response for the caller to handle.
+ */
+declare function getFileContent(auth: AuthHeaders, fileId: string): Promise<Response>;
+
+type files_FileDeleteResponse = FileDeleteResponse;
+type files_FileListResponse = FileListResponse;
+type files_FileObject = FileObject;
+type files_ListFilesOptions = ListFilesOptions;
+declare const files_deleteFile: typeof deleteFile;
+declare const files_getFile: typeof getFile;
+declare const files_getFileContent: typeof getFileContent;
+declare const files_listFiles: typeof listFiles;
+declare const files_uploadFile: typeof uploadFile;
+declare namespace files {
+  export { type files_FileDeleteResponse as FileDeleteResponse, type files_FileListResponse as FileListResponse, type files_FileObject as FileObject, type files_ListFilesOptions as ListFilesOptions, files_deleteFile as deleteFile, files_getFile as getFile, files_getFileContent as getFileContent, files_listFiles as listFiles, files_uploadFile as uploadFile };
+}
+
+/**
+ * High-level convenience class that wraps the full ARBI stack into a simple API.
+ *
+ * Handles SDK client creation, sodium initialization, authentication,
+ * workspace key decryption, and delegates to all operations modules.
+ *
+ * Usage:
+ *   const arbi = new Arbi({ url: 'https://arbi.mycompany.com' })
+ *   await arbi.login('user@example.com', 'password')
+ *   const workspaces = await arbi.workspaces.list()
+ *   await arbi.selectWorkspace(workspaces[0].external_id)
+ *   const docs = await arbi.documents.list()
+ */
+
+type DocUpdateRequest = components['schemas']['DocUpdateRequest'];
+type WorkspaceUpdateRequest$1 = components['schemas']['WorkspaceUpdateRequest'];
+type UpdateTagRequest$1 = components['schemas']['UpdateTagRequest'];
+type TagFormat = components['schemas']['TagFormat'];
+type CitationData$1 = components['schemas']['CitationData'];
+type UserSettingsUpdate$1 = components['schemas']['UserSettingsUpdate'];
+type ConfigUpdateData$1 = components['schemas']['ConfigUpdateData'];
+
+interface ArbiOptions {
+    /** Backend API URL (e.g. 'https://arbi.mycompany.com') */
+    url: string;
+    /** Deployment domain for key derivation. Defaults to hostname of url. */
+    deploymentDomain?: string;
+    /** Include credentials (cookies) in requests. Default: 'omit' for SDK consumers. */
+    credentials?: 'include' | 'omit' | 'same-origin';
+}
+interface QueryOptions {
+    /** Document IDs to search against */
+    docIds: string[];
+    /** Previous response ID for follow-up questions */
+    previousResponseId?: string | null;
+    /** Model to use for generation */
+    model?: string;
+    /** Called for each streaming token */
+    onToken?: (content: string) => void;
+    /** Called when stream starts */
+    onStreamStart?: (data: SSEStreamStartData) => void;
+    /** Called for each agent step */
+    onAgentStep?: (data: AgentStepEvent) => void;
+    /** Called on stream error */
+    onError?: (message: string) => void;
+    /** Called when a user message event is received */
+    onUserMessage?: (data: UserMessageEvent) => void;
+    /** Called when message metadata is received */
+    onMetadata?: (data: MessageMetadataPayload) => void;
+    /** Called when the agent requests user input */
+    onUserInputRequest?: (data: UserInputRequestEvent) => void;
+    /** Called when an artifact event is received */
+    onArtifact?: (data: ArtifactEvent) => void;
+    /** Called when backend elapsed time is received */
+    onElapsedTime?: (t: number) => void;
+    /** Called when stream completes */
+    onComplete?: () => void;
+}
+declare class Arbi {
+    private client;
+    private loginResult;
+    private currentWorkspaceId;
+    private readonly options;
+    constructor(options: ArbiOptions);
+    /** Initialize the SDK client and sodium crypto. Called automatically by login(). */
+    init(): Promise<ArbiClient>;
+    /**
+     * Request a verification email for registration.
+     * The user will receive an email with a 3-word verification code.
+     */
+    requestVerification(email: string): Promise<void>;
+    /**
+     * Register a new account using the verification code received by email.
+     */
+    register(params: {
+        email: string;
+        password: string;
+        verificationCode: string;
+        firstName?: string;
+        lastName?: string;
+    }): Promise<void>;
+    /**
+     * Log in with email and password.
+     * Initializes the SDK client if not already done.
+     */
+    login(email: string, password: string): Promise<void>;
+    /**
+     * Recover a session using a stored signing private key (base64).
+     * Useful for session recovery without re-entering the password.
+     */
+    loginWithKey(email: string, signingPrivateKeyBase64: string): Promise<void>;
+    /**
+     * Select a workspace by ID. Fetches the workspace list, finds the matching
+     * workspace, decrypts the wrapped key, and sets up auth headers.
+     */
+    selectWorkspace(workspaceId: string): Promise<void>;
+    /** Log out and clear internal state. */
+    logout(): Promise<void>;
+    /** Get the underlying ArbiClient (throws if not initialized). */
+    getClient(): ArbiClient;
+    /** Get the current workspace ID (throws if none selected). */
+    getWorkspaceId(): string;
+    /** Check if the user is logged in. */
+    get isLoggedIn(): boolean;
+    /** Check if a workspace is selected. */
+    get hasWorkspace(): boolean;
+    private getAuthHeaders;
+    readonly workspaces: {
+        list: () => Promise<{
+            external_id: string;
+            name: string;
+            description: string | null;
+            is_public: boolean;
+            created_by_ext_id: string;
+            updated_by_ext_id?: string | null | undefined;
+            created_at: string;
+            updated_at: string;
+            wrapped_key?: string | null | undefined;
+            shared_conversation_count: number;
+            private_conversation_count: number;
+            shared_document_count: number;
+            private_document_count: number;
+            user_files_mb: number;
+            users: {
+                user: {
+                    external_id: string;
+                    email: string;
+                    given_name: string;
+                    family_name: string;
+                    picture?: string | null | undefined;
+                    encryption_public_key: string;
+                };
+                role: components["schemas"]["WorkspaceRole"];
+                joined_at: string;
+                conversation_count: number;
+                document_count: number;
+            }[];
+        }[]>;
+        create: (name: string, description?: string | null, isPublic?: boolean) => Promise<{
+            external_id: string;
+            name: string;
+            description: string | null;
+            is_public: boolean;
+            created_by_ext_id: string;
+            updated_by_ext_id?: string | null | undefined;
+            created_at: string;
+            updated_at: string;
+            wrapped_key?: string | null | undefined;
+            shared_conversation_count: number;
+            private_conversation_count: number;
+            shared_document_count: number;
+            private_document_count: number;
+            user_files_mb: number;
+            users: {
+                user: {
+                    external_id: string;
+                    email: string;
+                    given_name: string;
+                    family_name: string;
+                    picture?: string | null | undefined;
+                    encryption_public_key: string;
+                };
+                role: components["schemas"]["WorkspaceRole"];
+                joined_at: string;
+                conversation_count: number;
+                document_count: number;
+            }[];
+        }>;
+        delete: (workspaceIds: string[]) => Promise<void>;
+        update: (body: WorkspaceUpdateRequest$1) => Promise<{
+            external_id: string;
+            name: string;
+            description: string | null;
+            is_public: boolean;
+            created_by_ext_id: string;
+            updated_by_ext_id?: string | null | undefined;
+            created_at: string;
+            updated_at: string;
+            wrapped_key?: string | null | undefined;
+            shared_conversation_count: number;
+            private_conversation_count: number;
+            shared_document_count: number;
+            private_document_count: number;
+            user_files_mb: number;
+            users: {
+                user: {
+                    external_id: string;
+                    email: string;
+                    given_name: string;
+                    family_name: string;
+                    picture?: string | null | undefined;
+                    encryption_public_key: string;
+                };
+                role: components["schemas"]["WorkspaceRole"];
+                joined_at: string;
+                conversation_count: number;
+                document_count: number;
+            }[];
+        }>;
+        listUsers: () => Promise<{
+            user: {
+                external_id: string;
+                email: string;
+                given_name: string;
+                family_name: string;
+                picture?: string | null | undefined;
+                encryption_public_key: string;
+            };
+            role: components["schemas"]["WorkspaceRole"];
+            joined_at: string;
+            conversation_count: number;
+            document_count: number;
+        }[]>;
+        addUsers: (emails: string[], role?: "owner" | "collaborator" | "guest") => Promise<{
+            user: {
+                external_id: string;
+                email: string;
+                given_name: string;
+                family_name: string;
+                picture?: string | null | undefined;
+                encryption_public_key: string;
+            };
+            role: components["schemas"]["WorkspaceRole"];
+            joined_at: string;
+            conversation_count: number;
+            document_count: number;
+        }[]>;
+        removeUsers: (userIds: string[]) => Promise<void>;
+        setUserRole: (userIds: string[], role: "owner" | "collaborator" | "guest") => Promise<{
+            user: {
+                external_id: string;
+                email: string;
+                given_name: string;
+                family_name: string;
+                picture?: string | null | undefined;
+                encryption_public_key: string;
+            };
+            role: components["schemas"]["WorkspaceRole"];
+            joined_at: string;
+            conversation_count: number;
+            document_count: number;
+        }[]>;
+        copyDocuments: (targetWorkspaceId: string, docIds: string[], targetWorkspaceKey: string) => Promise<{
+            detail: string;
+            documents_copied: number;
+            results: {
+                source_doc_ext_id: string;
+                success: boolean;
+                new_doc_ext_id?: string | null | undefined;
+                error?: string | null | undefined;
+            }[];
+        }>;
+    };
+    readonly documents: {
+        list: () => Promise<{
+            external_id: string;
+            workspace_ext_id: string;
+            file_name?: string | null | undefined;
+            status?: string | null | undefined;
+            n_pages?: number | null | undefined;
+            n_chunks?: number | null | undefined;
+            tokens?: number | null | undefined;
+            file_type?: string | null | undefined;
+            file_size?: number | null | undefined;
+            storage_type?: string | null | undefined;
+            storage_uri?: string | null | undefined;
+            content_hash?: string | null | undefined;
+            shared?: boolean | null | undefined;
+            re_ocred?: boolean | null | undefined;
+            config_ext_id?: string | null | undefined;
+            parent_ext_id?: string | null | undefined;
+            created_by_ext_id: string;
+            updated_by_ext_id?: string | null | undefined;
+            created_at: string;
+            updated_at: string;
+            wp_type?: string | null | undefined;
+            folder?: string | null | undefined;
+            doctags: {
+                doc_ext_id: string;
+                tag_ext_id: string;
+                note?: string | null | undefined;
+                citations?: {
+                    [x: string]: {
+                        chunk_ids: string[];
+                        scores: number[];
+                        statement: string;
+                        offset_start: number;
+                        offset_end: number;
+                    };
+                } | null | undefined;
+                created_by_ext_id: string;
+                updated_by_ext_id?: string | null | undefined;
+                created_at: string;
+                updated_at: string;
+            }[];
+            doc_metadata?: {
+                doc_nature?: string | null | undefined;
+                doc_author?: string | null | undefined;
+                doc_subject?: string | null | undefined;
+                doc_date?: string | null | undefined;
+                title?: string | null | undefined;
+            } | null | undefined;
+        }[]>;
+        get: (externalIds: string[]) => Promise<{
+            external_id: string;
+            workspace_ext_id: string;
+            file_name?: string | null | undefined;
+            status?: string | null | undefined;
+            n_pages?: number | null | undefined;
+            n_chunks?: number | null | undefined;
+            tokens?: number | null | undefined;
+            file_type?: string | null | undefined;
+            file_size?: number | null | undefined;
+            storage_type?: string | null | undefined;
+            storage_uri?: string | null | undefined;
+            content_hash?: string | null | undefined;
+            shared?: boolean | null | undefined;
+            re_ocred?: boolean | null | undefined;
+            config_ext_id?: string | null | undefined;
+            parent_ext_id?: string | null | undefined;
+            created_by_ext_id: string;
+            updated_by_ext_id?: string | null | undefined;
+            created_at: string;
+            updated_at: string;
+            wp_type?: string | null | undefined;
+            folder?: string | null | undefined;
+            doctags: {
+                doc_ext_id: string;
+                tag_ext_id: string;
+                note?: string | null | undefined;
+                citations?: {
+                    [x: string]: {
+                        chunk_ids: string[];
+                        scores: number[];
+                        statement: string;
+                        offset_start: number;
+                        offset_end: number;
+                    };
+                } | null | undefined;
+                created_by_ext_id: string;
+                updated_by_ext_id?: string | null | undefined;
+                created_at: string;
+                updated_at: string;
+            }[];
+            doc_metadata?: {
+                doc_nature?: string | null | undefined;
+                doc_author?: string | null | undefined;
+                doc_subject?: string | null | undefined;
+                doc_date?: string | null | undefined;
+                title?: string | null | undefined;
+            } | null | undefined;
+        }[]>;
+        delete: (externalIds: string[]) => Promise<void>;
+        update: (documents: DocUpdateRequest[]) => Promise<{
+            external_id: string;
+            workspace_ext_id: string;
+            file_name?: string | null | undefined;
+            status?: string | null | undefined;
+            n_pages?: number | null | undefined;
+            n_chunks?: number | null | undefined;
+            tokens?: number | null | undefined;
+            file_type?: string | null | undefined;
+            file_size?: number | null | undefined;
+            storage_type?: string | null | undefined;
+            storage_uri?: string | null | undefined;
+            content_hash?: string | null | undefined;
+            shared?: boolean | null | undefined;
+            re_ocred?: boolean | null | undefined;
+            config_ext_id?: string | null | undefined;
+            parent_ext_id?: string | null | undefined;
+            created_by_ext_id: string;
+            updated_by_ext_id?: string | null | undefined;
+            created_at: string;
+            updated_at: string;
+            wp_type?: string | null | undefined;
+            folder?: string | null | undefined;
+            doctags: {
+                doc_ext_id: string;
+                tag_ext_id: string;
+                note?: string | null | undefined;
+                citations?: {
+                    [x: string]: {
+                        chunk_ids: string[];
+                        scores: number[];
+                        statement: string;
+                        offset_start: number;
+                        offset_end: number;
+                    };
+                } | null | undefined;
+                created_by_ext_id: string;
+                updated_by_ext_id?: string | null | undefined;
+                created_at: string;
+                updated_at: string;
+            }[];
+            doc_metadata?: {
+                doc_nature?: string | null | undefined;
+                doc_author?: string | null | undefined;
+                doc_subject?: string | null | undefined;
+                doc_date?: string | null | undefined;
+                title?: string | null | undefined;
+            } | null | undefined;
+        }[]>;
+        uploadUrl: (urls: string[], shared?: boolean, workspaceId?: string) => Promise<{
+            doc_ext_ids: string[];
+            duplicates?: string[] | undefined;
+        }>;
+        uploadFile: (fileData: Blob, fileName: string, options?: {
+            workspaceId?: string;
+            folder?: string;
+        }) => Promise<UploadResult>;
+        download: (docId: string) => Promise<Response>;
+        getParsedContent: (docId: string, stage: string) => Promise<Record<string, unknown>>;
+    };
+    readonly conversations: {
+        list: () => Promise<{
+            external_id: string;
+            title: string | null;
+            created_by_ext_id: string;
+            updated_by_ext_id?: string | null | undefined;
+            created_at: string;
+            updated_at: string;
+            is_shared: boolean;
+            message_count: number;
+        }[]>;
+        getThreads: (conversationId: string) => Promise<{
+            conversation_ext_id: string;
+            threads: {
+                leaf_message_ext_id: string;
+                history: {
+                    role: "user" | "assistant" | "system";
+                    content: string;
+                    tools?: {
+                        [x: string]: {
+                            name: "model_citation";
+                            description: string;
+                            tool_responses: {
+                                [x: string]: {
+                                    chunk_ids: string[];
+                                    scores: number[];
+                                    statement: string;
+                                    offset_start: number;
+                                    offset_end: number;
+                                };
+                            };
+                        } | {
+                            name: "retrieval_chunk";
+                            description: string;
+                            tool_args: {
+                                doc_ext_ids: string[];
+                                search_mode?: ("semantic" | "keyword" | "hybrid") | null | undefined;
+                            };
+                            tool_responses: {
+                                [x: string]: {
+                                    metadata: {
+                                        workspace_ext_id?: string | null | undefined;
+                                        doc_ext_id?: string | null | undefined;
+                                        doc_title?: string | null | undefined;
+                                        chunk_id?: string | null | undefined;
+                                        chunk_ext_id: string;
+                                        chunk_pg_idx: number;
+                                        chunk_doc_idx: number;
+                                        page_number: number;
+                                        score?: number | null | undefined;
+                                        rerank_score?: number | null | undefined;
+                                        tokens?: number | null | undefined;
+                                        created_at: string;
+                                        heading: boolean;
+                                        bbox?: number[] | null | undefined;
+                                        element_type?: string | null | undefined;
+                                        heading_level?: number | null | undefined;
+                                    };
+                                    content: string;
+                                }[];
+                            };
+                        } | {
+                            name: "retrieval_full_context";
+                            description: string;
+                            tool_args: {
+                                doc_ext_ids: string[];
+                                from_ref?: string | null | undefined;
+                                to_ref?: string | null | undefined;
+                            };
+                            tool_responses: {
+                                [x: string]: {
+                                    metadata: {
+                                        workspace_ext_id?: string | null | undefined;
+                                        doc_ext_id?: string | null | undefined;
+                                        doc_title?: string | null | undefined;
+                                        chunk_id?: string | null | undefined;
+                                        chunk_ext_id: string;
+                                        chunk_pg_idx: number;
+                                        chunk_doc_idx: number;
+                                        page_number: number;
+                                        score?: number | null | undefined;
+                                        rerank_score?: number | null | undefined;
+                                        tokens?: number | null | undefined;
+                                        created_at: string;
+                                        heading: boolean;
+                                        bbox?: number[] | null | undefined;
+                                        element_type?: string | null | undefined;
+                                        heading_level?: number | null | undefined;
+                                    };
+                                    content: string;
+                                }[];
+                            };
+                        } | {
+                            name: "retrieval_toc";
+                            description: string;
+                            tool_args: {
+                                doc_ext_ids: string[];
+                            };
+                            tool_responses: {
+                                [x: string]: {
+                                    [x: string]: unknown;
+                                }[];
+                            };
+                        } | {
+                            name: "trace";
+                            description: string;
+                            trace_id?: string | null | undefined;
+                            start_time?: number | null | undefined;
+                            duration_seconds?: number | null | undefined;
+                            steps: {
+                                [x: string]: unknown;
+                            }[];
+                        } | {
+                            name: "compaction";
+                            description: string;
+                            tool_args: {
+                                source_conversation_ext_id: string;
+                                source_leaf_message_ext_id: string;
+                            };
+                            tool_responses: {
+                                [x: string]: string;
+                            };
+                        } | {
+                            name: "personal_agent";
+                            description: string;
+                            tool_args: {
+                                task: string;
+                            };
+                            tool_responses: {
+                                [x: string]: unknown;
+                            };
+                        } | {
+                            name: "stream_events";
+                            events: {
+                                [x: string]: unknown;
+                            }[];
+                        };
+                    } | undefined;
+                    config_ext_id?: string | null | undefined;
+                    shared: boolean;
+                    tokens: number;
+                    external_id: string;
+                    created_at: string;
+                    created_by_ext_id: string;
+                    conversation_ext_id: string;
+                    parent_message_ext_id?: string | null | undefined;
+                }[];
+            }[];
+        }>;
+        delete: (conversationId: string) => Promise<{
+            detail: string;
+        }>;
+        share: (conversationId: string) => Promise<{
+            detail: string;
+        }>;
+        updateTitle: (conversationId: string, title: string) => Promise<{
+            detail: string;
+            title: string;
+        }>;
+        getMessage: (messageId: string) => Promise<{
+            role: "user" | "assistant" | "system";
+            content: string;
+            tools?: {
+                [x: string]: {
+                    name: "model_citation";
+                    description: string;
+                    tool_responses: {
+                        [x: string]: {
+                            chunk_ids: string[];
+                            scores: number[];
+                            statement: string;
+                            offset_start: number;
+                            offset_end: number;
+                        };
+                    };
+                } | {
+                    name: "retrieval_chunk";
+                    description: string;
+                    tool_args: {
+                        doc_ext_ids: string[];
+                        search_mode?: ("semantic" | "keyword" | "hybrid") | null | undefined;
+                    };
+                    tool_responses: {
+                        [x: string]: {
+                            metadata: {
+                                workspace_ext_id?: string | null | undefined;
+                                doc_ext_id?: string | null | undefined;
+                                doc_title?: string | null | undefined;
+                                chunk_id?: string | null | undefined;
+                                chunk_ext_id: string;
+                                chunk_pg_idx: number;
+                                chunk_doc_idx: number;
+                                page_number: number;
+                                score?: number | null | undefined;
+                                rerank_score?: number | null | undefined;
+                                tokens?: number | null | undefined;
+                                created_at: string;
+                                heading: boolean;
+                                bbox?: number[] | null | undefined;
+                                element_type?: string | null | undefined;
+                                heading_level?: number | null | undefined;
+                            };
+                            content: string;
+                        }[];
+                    };
+                } | {
+                    name: "retrieval_full_context";
+                    description: string;
+                    tool_args: {
+                        doc_ext_ids: string[];
+                        from_ref?: string | null | undefined;
+                        to_ref?: string | null | undefined;
+                    };
+                    tool_responses: {
+                        [x: string]: {
+                            metadata: {
+                                workspace_ext_id?: string | null | undefined;
+                                doc_ext_id?: string | null | undefined;
+                                doc_title?: string | null | undefined;
+                                chunk_id?: string | null | undefined;
+                                chunk_ext_id: string;
+                                chunk_pg_idx: number;
+                                chunk_doc_idx: number;
+                                page_number: number;
+                                score?: number | null | undefined;
+                                rerank_score?: number | null | undefined;
+                                tokens?: number | null | undefined;
+                                created_at: string;
+                                heading: boolean;
+                                bbox?: number[] | null | undefined;
+                                element_type?: string | null | undefined;
+                                heading_level?: number | null | undefined;
+                            };
+                            content: string;
+                        }[];
+                    };
+                } | {
+                    name: "retrieval_toc";
+                    description: string;
+                    tool_args: {
+                        doc_ext_ids: string[];
+                    };
+                    tool_responses: {
+                        [x: string]: {
+                            [x: string]: unknown;
+                        }[];
+                    };
+                } | {
+                    name: "trace";
+                    description: string;
+                    trace_id?: string | null | undefined;
+                    start_time?: number | null | undefined;
+                    duration_seconds?: number | null | undefined;
+                    steps: {
+                        [x: string]: unknown;
+                    }[];
+                } | {
+                    name: "compaction";
+                    description: string;
+                    tool_args: {
+                        source_conversation_ext_id: string;
+                        source_leaf_message_ext_id: string;
+                    };
+                    tool_responses: {
+                        [x: string]: string;
+                    };
+                } | {
+                    name: "personal_agent";
+                    description: string;
+                    tool_args: {
+                        task: string;
+                    };
+                    tool_responses: {
+                        [x: string]: unknown;
+                    };
+                } | {
+                    name: "stream_events";
+                    events: {
+                        [x: string]: unknown;
+                    }[];
+                };
+            } | undefined;
+            config_ext_id?: string | null | undefined;
+            shared: boolean;
+            tokens: number;
+            external_id: string;
+            created_at: string;
+            created_by_ext_id: string;
+            conversation_ext_id: string;
+            parent_message_ext_id?: string | null | undefined;
+        }>;
+        deleteMessage: (messageId: string) => Promise<{
+            detail: string;
+        }>;
+    };
+    readonly assistant: {
+        /**
+         * Send a question to the RAG assistant with streaming support.
+         * Returns the accumulated result after the stream completes.
+         */
+        query: (question: string, options: QueryOptions) => Promise<SSEStreamResult>;
+        /**
+         * Respond to an agent's question during a human-in-the-loop workflow.
+         */
+        respond: (assistantMessageExtId: string, answer: string) => Promise<unknown>;
+        /**
+         * Search documents without LLM generation (retrieval only).
+         */
+        retrieve: (query: string, docIds: string[], options?: {
+            searchMode?: "semantic" | "keyword" | "hybrid";
+            fullContextDocIds?: string[];
+            tocDocIds?: string[];
+            model?: string;
+        }) => Promise<RetrieveResult>;
+    };
+    readonly tags: {
+        list: () => Promise<{
+            external_id: string;
+            workspace_ext_id: string;
+            name: string;
+            instruction?: string | null | undefined;
+            tag_type: {
+                type: "checkbox" | "text" | "number" | "select" | "search" | "date";
+                options: string[];
+            };
+            shared: boolean;
+            parent_ext_id?: string | null | undefined;
+            doctag_count: number;
+            created_by_ext_id: string;
+            updated_by_ext_id?: string | null | undefined;
+            created_at: string;
+            updated_at: string;
+        }[]>;
+        create: (options: {
+            name: string;
+            workspaceId?: string;
+            tagType?: TagFormat;
+            instruction?: string | null;
+            shared?: boolean;
+        }) => Promise<{
+            external_id: string;
+            workspace_ext_id: string;
+            name: string;
+            instruction?: string | null | undefined;
+            tag_type: {
+                type: "checkbox" | "text" | "number" | "select" | "search" | "date";
+                options: string[];
+            };
+            shared: boolean;
+            parent_ext_id?: string | null | undefined;
+            doctag_count: number;
+            created_by_ext_id: string;
+            updated_by_ext_id?: string | null | undefined;
+            created_at: string;
+            updated_at: string;
+        }>;
+        delete: (tagId: string) => Promise<{
+            detail: string;
+        }>;
+        update: (tagId: string, body: UpdateTagRequest$1) => Promise<{
+            external_id: string;
+            workspace_ext_id: string;
+            name: string;
+            instruction?: string | null | undefined;
+            tag_type: {
+                type: "checkbox" | "text" | "number" | "select" | "search" | "date";
+                options: string[];
+            };
+            shared: boolean;
+            parent_ext_id?: string | null | undefined;
+            doctag_count: number;
+            created_by_ext_id: string;
+            updated_by_ext_id?: string | null | undefined;
+            created_at: string;
+            updated_at: string;
+        }>;
+    };
+    readonly doctags: {
+        assign: (tagId: string, docIds: string[], note?: string | null) => Promise<{
+            doc_ext_id: string;
+            tag_ext_id: string;
+            note?: string | null | undefined;
+            citations?: {
+                [x: string]: {
+                    chunk_ids: string[];
+                    scores: number[];
+                    statement: string;
+                    offset_start: number;
+                    offset_end: number;
+                };
+            } | null | undefined;
+            created_by_ext_id: string;
+            updated_by_ext_id?: string | null | undefined;
+            created_at: string;
+            updated_at: string;
+        }[]>;
+        remove: (tagId: string, docIds: string[]) => Promise<void>;
+        update: (tagId: string, docId: string, updates: {
+            note?: string | null;
+            citations?: Record<string, CitationData$1> | null;
+        }) => Promise<{
+            doc_ext_id: string;
+            tag_ext_id: string;
+            note?: string | null | undefined;
+            citations?: {
+                [x: string]: {
+                    chunk_ids: string[];
+                    scores: number[];
+                    statement: string;
+                    offset_start: number;
+                    offset_end: number;
+                };
+            } | null | undefined;
+            created_by_ext_id: string;
+            updated_by_ext_id?: string | null | undefined;
+            created_at: string;
+            updated_at: string;
+        }>;
+        generate: (tagIds: string[], docIds: string[]) => Promise<{
+            doc_ext_ids: string[];
+            tag_ext_ids: string[];
+        }>;
+    };
+    readonly contacts: {
+        list: () => Promise<{
+            external_id: string;
+            email: string;
+            user?: {
+                external_id: string;
+                email: string;
+                given_name: string;
+                family_name: string;
+                picture?: string | null | undefined;
+                encryption_public_key: string;
+            } | null | undefined;
+            status: "invitation_pending" | "invitation_expired" | "registered";
+            created_at: string;
+        }[]>;
+        add: (emails: string[]) => Promise<{
+            external_id: string;
+            email: string;
+            user?: {
+                external_id: string;
+                email: string;
+                given_name: string;
+                family_name: string;
+                picture?: string | null | undefined;
+                encryption_public_key: string;
+            } | null | undefined;
+            status: "invitation_pending" | "invitation_expired" | "registered";
+            created_at: string;
+        }[]>;
+        remove: (contactIds: string[]) => Promise<void>;
+        groupByStatus: typeof groupContactsByStatus;
+    };
+    readonly dm: {
+        list: () => Promise<{
+            type: components["schemas"]["NotificationType"];
+            external_id: string;
+            sender: {
+                external_id: string;
+                email: string;
+                given_name: string;
+                family_name: string;
+                picture?: string | null | undefined;
+                encryption_public_key: string;
+            };
+            recipient: {
+                external_id: string;
+                email: string;
+                given_name: string;
+                family_name: string;
+                picture?: string | null | undefined;
+                encryption_public_key: string;
+            };
+            workspace_ext_id?: string | null | undefined;
+            content?: string | null | undefined;
+            read: boolean;
+            created_at: string;
+            updated_at: string;
+        }[]>;
+        send: (messages: Array<{
+            recipient_ext_id: string;
+            content: string;
+        }>) => Promise<{
+            type: components["schemas"]["NotificationType"];
+            external_id: string;
+            sender: {
+                external_id: string;
+                email: string;
+                given_name: string;
+                family_name: string;
+                picture?: string | null | undefined;
+                encryption_public_key: string;
+            };
+            recipient: {
+                external_id: string;
+                email: string;
+                given_name: string;
+                family_name: string;
+                picture?: string | null | undefined;
+                encryption_public_key: string;
+            };
+            workspace_ext_id?: string | null | undefined;
+            content?: string | null | undefined;
+            read: boolean;
+            created_at: string;
+            updated_at: string;
+        }[]>;
+        markRead: (messageIds: string[]) => Promise<{
+            type: components["schemas"]["NotificationType"];
+            external_id: string;
+            sender: {
+                external_id: string;
+                email: string;
+                given_name: string;
+                family_name: string;
+                picture?: string | null | undefined;
+                encryption_public_key: string;
+            };
+            recipient: {
+                external_id: string;
+                email: string;
+                given_name: string;
+                family_name: string;
+                picture?: string | null | undefined;
+                encryption_public_key: string;
+            };
+            workspace_ext_id?: string | null | undefined;
+            content?: string | null | undefined;
+            read: boolean;
+            created_at: string;
+            updated_at: string;
+        }[]>;
+        delete: (messageIds: string[]) => Promise<void>;
+    };
+    readonly settings: {
+        get: () => Promise<{
+            [x: string]: unknown;
+            subscription?: {
+                status: string;
+                trial_expires?: number | null | undefined;
+            } | null | undefined;
+            last_workspace?: string | null | undefined;
+            pinned_workspaces: string[];
+            pinned_templates: string[];
+            tableviews: {
+                workspace: string;
+                name: string;
+                columns: string[];
+            }[];
+            developer: boolean;
+            show_document_navigator: boolean;
+            show_thread_visualization: boolean;
+            show_smart_search: boolean;
+            show_security_settings: boolean;
+            show_invite_tab: boolean;
+            show_help_page: boolean;
+            show_templates: boolean;
+            show_pa_mode: boolean;
+            hide_online_status: boolean;
+            muted_users: string[];
+        }>;
+        update: (body: UserSettingsUpdate$1) => Promise<void>;
+    };
+    readonly agentConfig: {
+        list: () => Promise<{
+            versions: {
+                external_id: string;
+                title: string | null;
+                created_at: string;
+            }[];
+        }>;
+        get: (configId: string) => Promise<{
+            Agents: {
+                ENABLED: boolean;
+                HUMAN_IN_THE_LOOP: boolean;
+                WEB_SEARCH?: {
+                    ENABLED: boolean;
+                    SAVE_SOURCES: boolean;
+                } | undefined;
+                RUN_CODE?: {
+                    ENABLED: boolean;
+                    IMAGE: string;
+                    TIMEOUT_SECONDS: number;
+                    MEMORY_LIMIT: string;
+                    NETWORK: string;
+                } | undefined;
+                MCP_TOOLS: string[];
+                PLANNING_ENABLED: boolean;
+                SUGGESTED_QUERIES: boolean;
+                ARTIFACTS_ENABLED: boolean;
+                VISION_ENABLED: boolean;
+                DOC_INDEX_COMPACT_THRESHOLD: number;
+                DOC_INDEX_SKIP_THRESHOLD: number;
+                PERSONAL_AGENT: boolean;
+                MEMORY_ENABLED: boolean;
+                SKILLS_ENABLED: boolean;
+                SKILL_CREATION: boolean;
+                REVIEW_ENABLED: boolean;
+                PERSONA: string;
+                AGENT_MODEL_NAME: string;
+                AGENT_API_TYPE: "local" | "remote";
+                LLM_AGENT_TEMPERATURE: number;
+                AGENT_MAX_TOKENS: number;
+                AGENT_MAX_ITERATIONS: number;
+                MAX_PASSAGE_PAGES: number;
+                AGENT_HISTORY_CHAR_THRESHOLD: number;
+                AGENT_SYSTEM_PROMPT: string;
+            };
+            QueryLLM: {
+                API_TYPE: "local" | "remote";
+                MODEL_NAME: string;
+                SYSTEM_INSTRUCTION: string;
+                MAX_CHAR_SIZE_TO_ANSWER: number;
+                TEMPERATURE: number;
+                MAX_TOKENS: number;
+            };
+            ReviewLLM: {
+                API_TYPE: "local" | "remote";
+                MODEL_NAME: string;
+                SYSTEM_INSTRUCTION: string;
+                TEMPERATURE: number;
+                MAX_TOKENS: number;
+                MAX_CHAR_SIZE_TO_ANSWER: number;
+            };
+            EvaluatorLLM: {
+                API_TYPE: "local" | "remote";
+                MODEL_NAME: string;
+                SYSTEM_INSTRUCTION: string;
+                TEMPERATURE: number;
+                MAX_TOKENS: number;
+                MAX_CHAR_SIZE_TO_ANSWER: number;
+            };
+            TitleLLM: {
+                API_TYPE: "local" | "remote";
+                MODEL_NAME: string;
+                SYSTEM_INSTRUCTION: string;
+                MAX_CHAR_SIZE_TO_ANSWER: number;
+                TEMPERATURE: number;
+                MAX_TOKENS: number;
+            };
+            SummariseLLM: {
+                API_TYPE: "local" | "remote";
+                MODEL_NAME: string;
+                SYSTEM_INSTRUCTION: string;
+                TEMPERATURE: number;
+                MAX_TOKENS: number;
+                MAX_CHAR_SIZE_TO_ANSWER: number;
+                COMPACTION_THRESHOLD_TOKENS: number;
+                COMPACTION_KEEP_RECENT: number;
+            };
+            DoctagLLM: {
+                API_TYPE: "local" | "remote";
+                MODEL_NAME: string;
+                SYSTEM_INSTRUCTION: string;
+                MAX_CHAR_CONTEXT_TO_ANSWER: number;
+                TEMPERATURE: number;
+                MAX_TOKENS: number;
+                MAX_CONCURRENT_DOCS: number;
+                DEFAULT_METADATA_TAGS: {
+                    name: string;
+                    instruction?: string | null | undefined;
+                    tag_type?: {
+                        type: "checkbox" | "text" | "number" | "select" | "search" | "date";
+                        options: string[];
+                    } | undefined;
+                }[];
+            };
+            MemoryLLM: {
+                API_TYPE: "local" | "remote";
+                MODEL_NAME: string;
+                SYSTEM_INSTRUCTION: string;
+                TEMPERATURE: number;
+                MAX_TOKENS: number;
+                MAX_CHAR_CONTEXT: number;
+                MAX_CONCURRENT: number;
+            };
+            PlanningLLM: {
+                API_TYPE: "local" | "remote";
+                MODEL_NAME: string;
+                SYSTEM_INSTRUCTION: string;
+                TEMPERATURE: number;
+                MAX_TOKENS: number;
+                MAX_CHAR_SIZE_TO_ANSWER: number;
+                APPROVAL_TIMEOUT: number;
+            };
+            VisionLLM: {
+                API_TYPE: "local" | "remote";
+                MODEL_NAME: string;
+                TEMPERATURE: number;
+                MAX_TOKENS: number;
+                MAX_PAGES_PER_CALL: number;
+                IMAGE_MAX_DIMENSION: number;
+            };
+            CodeAgent: {
+                API_TYPE: "local" | "remote";
+                MODEL_NAME: string;
+                SYSTEM_INSTRUCTION: string;
+                TEMPERATURE: number;
+                MAX_TOKENS: number;
+                MAX_ITERATIONS: number;
+            };
+            ModelCitation: {
+                SIM_THREASHOLD: number;
+                MIN_CHAR_SIZE_TO_ANSWER: number;
+                MAX_NUMB_CITATIONS: number;
+            };
+            Retriever: {
+                MIN_RETRIEVAL_SIM_SCORE: number;
+                MAX_DISTINCT_DOCUMENTS: number;
+                MAX_TOTAL_CHUNKS_TO_RETRIEVE: number;
+                GROUP_SIZE: number;
+                SEARCH_MODE: components["schemas"]["SearchMode"];
+                HYBRID_DENSE_WEIGHT: number;
+                HYBRID_SPARSE_WEIGHT: number;
+                HYBRID_RERANKER_WEIGHT: number;
+            };
+            Reranker: {
+                MIN_SCORE: number;
+                MAX_NUMB_OF_CHUNKS: number;
+                MAX_CONCURRENT_REQUESTS: number;
+                MODEL_NAME: string;
+                API_TYPE: "local" | "remote";
+            };
+            Parser: {
+                SKIP_DUPLICATES: boolean;
+            };
+            Chunker: {
+                MAX_CHUNK_TOKENS: number;
+                TOKENIZER_TYPE: "tiktoken" | "huggingface";
+                TOKENIZER_NAME: string;
+            };
+            Embedder: {
+                MODEL_NAME: string;
+                API_TYPE: "local" | "remote";
+                BATCH_SIZE: number;
+                MAX_CONCURRENT_REQUESTS: number;
+                DOCUMENT_PREFIX: string;
+                QUERY_PREFIX: string;
+            };
+            KeywordEmbedder: {
+                DIMENSION_SPACE: number;
+                FILTER_STOPWORDS: boolean;
+                BM25_K1: number;
+                BM25_B: number;
+                BM25_AVGDL: number;
+            };
+        } | {
+            Agents: {
+                [x: string]: string | boolean;
+            };
+        }>;
+        save: (body: ConfigUpdateData$1) => Promise<{
+            external_id: string;
+            title: string | null;
+            created_at: string;
+        }>;
+        delete: (configId: string) => Promise<{
+            detail: string;
+        }>;
+        getSchema: () => Promise<unknown>;
+        getModels: () => Promise<{
+            models: {
+                model_name: string;
+                api_type: string;
+                tags?: string[] | null | undefined;
+                max_input_tokens?: number | null | undefined;
+                max_output_tokens?: number | null | undefined;
+                input_cost_per_token?: number | null | undefined;
+                output_cost_per_token?: number | null | undefined;
+                provider?: string | null | undefined;
+                mode?: string | null | undefined;
+                supports_vision?: boolean | null | undefined;
+                supports_reasoning?: boolean | null | undefined;
+                supports_function_calling?: boolean | null | undefined;
+                supports_response_schema?: boolean | null | undefined;
+            }[];
+        }>;
+    };
+    readonly health: {
+        check: () => Promise<{
+            status: string;
+            backend_git_hash?: string | null | undefined;
+            frontend_docker_version?: string | null | undefined;
+            services: {
+                name: string;
+                status: string;
+                detail?: string | null | undefined;
+                service_info?: {
+                    [x: string]: unknown;
+                } | null | undefined;
+            }[];
+            models_health?: {
+                application: string;
+                models: {
+                    model: string;
+                    status: string;
+                    detail?: string | null | undefined;
+                }[];
+            } | null | undefined;
+            available_models: string[];
+        }>;
+        models: () => Promise<{
+            models: {
+                model_name: string;
+                api_type: string;
+                tags?: string[] | null | undefined;
+                max_input_tokens?: number | null | undefined;
+                max_output_tokens?: number | null | undefined;
+                input_cost_per_token?: number | null | undefined;
+                output_cost_per_token?: number | null | undefined;
+                provider?: string | null | undefined;
+                mode?: string | null | undefined;
+                supports_vision?: boolean | null | undefined;
+                supports_reasoning?: boolean | null | undefined;
+                supports_function_calling?: boolean | null | undefined;
+                supports_response_schema?: boolean | null | undefined;
+            }[];
+        }>;
+        remoteModels: () => Promise<{
+            application: string;
+            models: {
+                model: string;
+                status: string;
+                detail?: string | null | undefined;
+            }[];
+        }>;
+        mcpTools: () => Promise<{
+            tools: {
+                name: string;
+                description: string;
+                server_name: string;
+            }[];
+        }>;
+    };
+    readonly files: {
+        list: (options?: ListFilesOptions) => Promise<{
+            object: string;
+            data: {
+                id: string;
+                object: string;
+                bytes: number;
+                created_at: number;
+                filename: string;
+                purpose: string;
+                status: string;
+                expires_at?: number | null | undefined;
+                status_details?: string | null | undefined;
+            }[];
+            has_more: boolean;
+            first_id?: string | null | undefined;
+            last_id?: string | null | undefined;
+        }>;
+        get: (fileId: string) => Promise<{
+            id: string;
+            object: string;
+            bytes: number;
+            created_at: number;
+            filename: string;
+            purpose: string;
+            status: string;
+            expires_at?: number | null | undefined;
+            status_details?: string | null | undefined;
+        }>;
+        delete: (fileId: string) => Promise<{
+            id: string;
+            object: string;
+            deleted: boolean;
+        }>;
+        upload: (fileData: Blob, fileName: string, purpose?: string) => Promise<{
+            id: string;
+            object: string;
+            bytes: number;
+            created_at: number;
+            filename: string;
+            purpose: string;
+            status: string;
+            expires_at?: number | null;
+            status_details?: string | null;
+        }>;
+        getContent: (fileId: string) => Promise<Response>;
+    };
+    private requireClient;
+    private requireLogin;
+    private requireWorkspace;
+}
+
+/**
+ * Workspace operations — list, create, delete, update, users, copy.
+ */
+
+type WorkspaceUpdateRequest = components['schemas']['WorkspaceUpdateRequest'];
+declare function listWorkspaces(arbi: ArbiClient): Promise<{
+    external_id: string;
+    name: string;
+    description: string | null;
+    is_public: boolean;
+    created_by_ext_id: string;
+    updated_by_ext_id?: string | null | undefined;
+    created_at: string;
+    updated_at: string;
+    wrapped_key?: string | null | undefined;
+    shared_conversation_count: number;
+    private_conversation_count: number;
+    shared_document_count: number;
+    private_document_count: number;
+    user_files_mb: number;
+    users: {
+        user: {
+            external_id: string;
+            email: string;
+            given_name: string;
+            family_name: string;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+        };
+        role: components["schemas"]["WorkspaceRole"];
+        joined_at: string;
+        conversation_count: number;
+        document_count: number;
+    }[];
+}[]>;
+declare function createWorkspace(arbi: ArbiClient, name: string, description?: string | null, isPublic?: boolean): Promise<{
+    external_id: string;
+    name: string;
+    description: string | null;
+    is_public: boolean;
+    created_by_ext_id: string;
+    updated_by_ext_id?: string | null | undefined;
+    created_at: string;
+    updated_at: string;
+    wrapped_key?: string | null | undefined;
+    shared_conversation_count: number;
+    private_conversation_count: number;
+    shared_document_count: number;
+    private_document_count: number;
+    user_files_mb: number;
+    users: {
+        user: {
+            external_id: string;
+            email: string;
+            given_name: string;
+            family_name: string;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+        };
+        role: components["schemas"]["WorkspaceRole"];
+        joined_at: string;
+        conversation_count: number;
+        document_count: number;
+    }[];
+}>;
+declare function deleteWorkspaces(arbi: ArbiClient, workspaceIds: string[]): Promise<void>;
+declare function updateWorkspace(arbi: ArbiClient, body: WorkspaceUpdateRequest): Promise<{
+    external_id: string;
+    name: string;
+    description: string | null;
+    is_public: boolean;
+    created_by_ext_id: string;
+    updated_by_ext_id?: string | null | undefined;
+    created_at: string;
+    updated_at: string;
+    wrapped_key?: string | null | undefined;
+    shared_conversation_count: number;
+    private_conversation_count: number;
+    shared_document_count: number;
+    private_document_count: number;
+    user_files_mb: number;
+    users: {
+        user: {
+            external_id: string;
+            email: string;
+            given_name: string;
+            family_name: string;
+            picture?: string | null | undefined;
+            encryption_public_key: string;
+        };
+        role: components["schemas"]["WorkspaceRole"];
+        joined_at: string;
+        conversation_count: number;
+        document_count: number;
+    }[];
+}>;
+declare function listWorkspaceUsers(arbi: ArbiClient): Promise<{
+    user: {
+        external_id: string;
+        email: string;
+        given_name: string;
+        family_name: string;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+    };
+    role: components["schemas"]["WorkspaceRole"];
+    joined_at: string;
+    conversation_count: number;
+    document_count: number;
+}[]>;
+declare function addWorkspaceUsers(arbi: ArbiClient, emails: string[], role?: 'owner' | 'collaborator' | 'guest'): Promise<{
+    user: {
+        external_id: string;
+        email: string;
+        given_name: string;
+        family_name: string;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+    };
+    role: components["schemas"]["WorkspaceRole"];
+    joined_at: string;
+    conversation_count: number;
+    document_count: number;
+}[]>;
+declare function removeWorkspaceUsers(arbi: ArbiClient, userIds: string[]): Promise<void>;
+declare function setUserRole(arbi: ArbiClient, userIds: string[], role: 'owner' | 'collaborator' | 'guest'): Promise<{
+    user: {
+        external_id: string;
+        email: string;
+        given_name: string;
+        family_name: string;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+    };
+    role: components["schemas"]["WorkspaceRole"];
+    joined_at: string;
+    conversation_count: number;
+    document_count: number;
+}[]>;
+declare function copyDocuments(arbi: ArbiClient, targetWorkspaceId: string, docIds: string[], targetWorkspaceKey: string): Promise<{
+    detail: string;
+    documents_copied: number;
+    results: {
+        source_doc_ext_id: string;
+        success: boolean;
+        new_doc_ext_id?: string | null | undefined;
+        error?: string | null | undefined;
+    }[];
+}>;
+
+declare const workspaces_addWorkspaceUsers: typeof addWorkspaceUsers;
+declare const workspaces_copyDocuments: typeof copyDocuments;
+declare const workspaces_createWorkspace: typeof createWorkspace;
+declare const workspaces_deleteWorkspaces: typeof deleteWorkspaces;
+declare const workspaces_listWorkspaceUsers: typeof listWorkspaceUsers;
+declare const workspaces_listWorkspaces: typeof listWorkspaces;
+declare const workspaces_removeWorkspaceUsers: typeof removeWorkspaceUsers;
+declare const workspaces_setUserRole: typeof setUserRole;
+declare const workspaces_updateWorkspace: typeof updateWorkspace;
+declare namespace workspaces {
+  export { workspaces_addWorkspaceUsers as addWorkspaceUsers, workspaces_copyDocuments as copyDocuments, workspaces_createWorkspace as createWorkspace, workspaces_deleteWorkspaces as deleteWorkspaces, workspaces_listWorkspaceUsers as listWorkspaceUsers, workspaces_listWorkspaces as listWorkspaces, workspaces_removeWorkspaceUsers as removeWorkspaceUsers, workspaces_setUserRole as setUserRole, workspaces_updateWorkspace as updateWorkspace };
+}
+
+/**
+ * Tag operations — list, create, delete, update.
+ */
+
+type UpdateTagRequest = components['schemas']['UpdateTagRequest'];
+declare function listTags(arbi: ArbiClient): Promise<{
+    external_id: string;
+    workspace_ext_id: string;
+    name: string;
+    instruction?: string | null | undefined;
+    tag_type: {
+        type: "checkbox" | "text" | "number" | "select" | "search" | "date";
+        options: string[];
+    };
+    shared: boolean;
+    parent_ext_id?: string | null | undefined;
+    doctag_count: number;
+    created_by_ext_id: string;
+    updated_by_ext_id?: string | null | undefined;
+    created_at: string;
+    updated_at: string;
+}[]>;
+declare function createTag(arbi: ArbiClient, options: {
+    name: string;
+    workspaceId?: string;
+    tagType?: components['schemas']['TagFormat'];
+    instruction?: string | null;
+    shared?: boolean;
+}): Promise<{
+    external_id: string;
+    workspace_ext_id: string;
+    name: string;
+    instruction?: string | null | undefined;
+    tag_type: {
+        type: "checkbox" | "text" | "number" | "select" | "search" | "date";
+        options: string[];
+    };
+    shared: boolean;
+    parent_ext_id?: string | null | undefined;
+    doctag_count: number;
+    created_by_ext_id: string;
+    updated_by_ext_id?: string | null | undefined;
+    created_at: string;
+    updated_at: string;
+}>;
+declare function deleteTag(arbi: ArbiClient, tagId: string): Promise<{
+    detail: string;
+}>;
+declare function updateTag(arbi: ArbiClient, tagId: string, body: UpdateTagRequest): Promise<{
+    external_id: string;
+    workspace_ext_id: string;
+    name: string;
+    instruction?: string | null | undefined;
+    tag_type: {
+        type: "checkbox" | "text" | "number" | "select" | "search" | "date";
+        options: string[];
+    };
+    shared: boolean;
+    parent_ext_id?: string | null | undefined;
+    doctag_count: number;
+    created_by_ext_id: string;
+    updated_by_ext_id?: string | null | undefined;
+    created_at: string;
+    updated_at: string;
+}>;
+
+declare const tags_createTag: typeof createTag;
+declare const tags_deleteTag: typeof deleteTag;
+declare const tags_listTags: typeof listTags;
+declare const tags_updateTag: typeof updateTag;
+declare namespace tags {
+  export { tags_createTag as createTag, tags_deleteTag as deleteTag, tags_listTags as listTags, tags_updateTag as updateTag };
+}
+
+/**
+ * Conversation operations — list, threads, delete, share, title, messages.
+ */
+
+declare function listConversations(arbi: ArbiClient): Promise<{
+    external_id: string;
+    title: string | null;
+    created_by_ext_id: string;
+    updated_by_ext_id?: string | null | undefined;
+    created_at: string;
+    updated_at: string;
+    is_shared: boolean;
+    message_count: number;
+}[]>;
+declare function getConversationThreads(arbi: ArbiClient, conversationId: string): Promise<{
+    conversation_ext_id: string;
+    threads: {
+        leaf_message_ext_id: string;
+        history: {
+            role: "user" | "assistant" | "system";
+            content: string;
+            tools?: {
+                [x: string]: {
+                    name: "model_citation";
+                    description: string;
+                    tool_responses: {
+                        [x: string]: {
+                            chunk_ids: string[];
+                            scores: number[];
+                            statement: string;
+                            offset_start: number;
+                            offset_end: number;
+                        };
+                    };
+                } | {
+                    name: "retrieval_chunk";
+                    description: string;
+                    tool_args: {
+                        doc_ext_ids: string[];
+                        search_mode?: ("semantic" | "keyword" | "hybrid") | null | undefined;
+                    };
+                    tool_responses: {
+                        [x: string]: {
+                            metadata: {
+                                workspace_ext_id?: string | null | undefined;
+                                doc_ext_id?: string | null | undefined;
+                                doc_title?: string | null | undefined;
+                                chunk_id?: string | null | undefined;
+                                chunk_ext_id: string;
+                                chunk_pg_idx: number;
+                                chunk_doc_idx: number;
+                                page_number: number;
+                                score?: number | null | undefined;
+                                rerank_score?: number | null | undefined;
+                                tokens?: number | null | undefined;
+                                created_at: string;
+                                heading: boolean;
+                                bbox?: number[] | null | undefined;
+                                element_type?: string | null | undefined;
+                                heading_level?: number | null | undefined;
+                            };
+                            content: string;
+                        }[];
+                    };
+                } | {
+                    name: "retrieval_full_context";
+                    description: string;
+                    tool_args: {
+                        doc_ext_ids: string[];
+                        from_ref?: string | null | undefined;
+                        to_ref?: string | null | undefined;
+                    };
+                    tool_responses: {
+                        [x: string]: {
+                            metadata: {
+                                workspace_ext_id?: string | null | undefined;
+                                doc_ext_id?: string | null | undefined;
+                                doc_title?: string | null | undefined;
+                                chunk_id?: string | null | undefined;
+                                chunk_ext_id: string;
+                                chunk_pg_idx: number;
+                                chunk_doc_idx: number;
+                                page_number: number;
+                                score?: number | null | undefined;
+                                rerank_score?: number | null | undefined;
+                                tokens?: number | null | undefined;
+                                created_at: string;
+                                heading: boolean;
+                                bbox?: number[] | null | undefined;
+                                element_type?: string | null | undefined;
+                                heading_level?: number | null | undefined;
+                            };
+                            content: string;
+                        }[];
+                    };
+                } | {
+                    name: "retrieval_toc";
+                    description: string;
+                    tool_args: {
+                        doc_ext_ids: string[];
+                    };
+                    tool_responses: {
+                        [x: string]: {
+                            [x: string]: unknown;
+                        }[];
+                    };
+                } | {
+                    name: "trace";
+                    description: string;
+                    trace_id?: string | null | undefined;
+                    start_time?: number | null | undefined;
+                    duration_seconds?: number | null | undefined;
+                    steps: {
+                        [x: string]: unknown;
+                    }[];
+                } | {
+                    name: "compaction";
+                    description: string;
+                    tool_args: {
+                        source_conversation_ext_id: string;
+                        source_leaf_message_ext_id: string;
+                    };
+                    tool_responses: {
+                        [x: string]: string;
+                    };
+                } | {
+                    name: "personal_agent";
+                    description: string;
+                    tool_args: {
+                        task: string;
+                    };
+                    tool_responses: {
+                        [x: string]: unknown;
+                    };
+                } | {
+                    name: "stream_events";
+                    events: {
+                        [x: string]: unknown;
+                    }[];
+                };
+            } | undefined;
+            config_ext_id?: string | null | undefined;
+            shared: boolean;
+            tokens: number;
+            external_id: string;
+            created_at: string;
+            created_by_ext_id: string;
+            conversation_ext_id: string;
+            parent_message_ext_id?: string | null | undefined;
+        }[];
+    }[];
+}>;
+declare function deleteConversation(arbi: ArbiClient, conversationId: string): Promise<{
+    detail: string;
+}>;
+declare function shareConversation(arbi: ArbiClient, conversationId: string): Promise<{
+    detail: string;
+}>;
+declare function updateConversationTitle(arbi: ArbiClient, conversationId: string, title: string): Promise<{
+    detail: string;
+    title: string;
+}>;
+declare function getMessage(arbi: ArbiClient, messageId: string): Promise<{
+    role: "user" | "assistant" | "system";
+    content: string;
+    tools?: {
+        [x: string]: {
+            name: "model_citation";
+            description: string;
+            tool_responses: {
+                [x: string]: {
+                    chunk_ids: string[];
+                    scores: number[];
+                    statement: string;
+                    offset_start: number;
+                    offset_end: number;
+                };
+            };
+        } | {
+            name: "retrieval_chunk";
+            description: string;
+            tool_args: {
+                doc_ext_ids: string[];
+                search_mode?: ("semantic" | "keyword" | "hybrid") | null | undefined;
+            };
+            tool_responses: {
+                [x: string]: {
+                    metadata: {
+                        workspace_ext_id?: string | null | undefined;
+                        doc_ext_id?: string | null | undefined;
+                        doc_title?: string | null | undefined;
+                        chunk_id?: string | null | undefined;
+                        chunk_ext_id: string;
+                        chunk_pg_idx: number;
+                        chunk_doc_idx: number;
+                        page_number: number;
+                        score?: number | null | undefined;
+                        rerank_score?: number | null | undefined;
+                        tokens?: number | null | undefined;
+                        created_at: string;
+                        heading: boolean;
+                        bbox?: number[] | null | undefined;
+                        element_type?: string | null | undefined;
+                        heading_level?: number | null | undefined;
+                    };
+                    content: string;
+                }[];
+            };
+        } | {
+            name: "retrieval_full_context";
+            description: string;
+            tool_args: {
+                doc_ext_ids: string[];
+                from_ref?: string | null | undefined;
+                to_ref?: string | null | undefined;
+            };
+            tool_responses: {
+                [x: string]: {
+                    metadata: {
+                        workspace_ext_id?: string | null | undefined;
+                        doc_ext_id?: string | null | undefined;
+                        doc_title?: string | null | undefined;
+                        chunk_id?: string | null | undefined;
+                        chunk_ext_id: string;
+                        chunk_pg_idx: number;
+                        chunk_doc_idx: number;
+                        page_number: number;
+                        score?: number | null | undefined;
+                        rerank_score?: number | null | undefined;
+                        tokens?: number | null | undefined;
+                        created_at: string;
+                        heading: boolean;
+                        bbox?: number[] | null | undefined;
+                        element_type?: string | null | undefined;
+                        heading_level?: number | null | undefined;
+                    };
+                    content: string;
+                }[];
+            };
+        } | {
+            name: "retrieval_toc";
+            description: string;
+            tool_args: {
+                doc_ext_ids: string[];
+            };
+            tool_responses: {
+                [x: string]: {
+                    [x: string]: unknown;
+                }[];
+            };
+        } | {
+            name: "trace";
+            description: string;
+            trace_id?: string | null | undefined;
+            start_time?: number | null | undefined;
+            duration_seconds?: number | null | undefined;
+            steps: {
+                [x: string]: unknown;
+            }[];
+        } | {
+            name: "compaction";
+            description: string;
+            tool_args: {
+                source_conversation_ext_id: string;
+                source_leaf_message_ext_id: string;
+            };
+            tool_responses: {
+                [x: string]: string;
+            };
+        } | {
+            name: "personal_agent";
+            description: string;
+            tool_args: {
+                task: string;
+            };
+            tool_responses: {
+                [x: string]: unknown;
+            };
+        } | {
+            name: "stream_events";
+            events: {
+                [x: string]: unknown;
+            }[];
+        };
+    } | undefined;
+    config_ext_id?: string | null | undefined;
+    shared: boolean;
+    tokens: number;
+    external_id: string;
+    created_at: string;
+    created_by_ext_id: string;
+    conversation_ext_id: string;
+    parent_message_ext_id?: string | null | undefined;
+}>;
+declare function deleteMessage(arbi: ArbiClient, messageId: string): Promise<{
+    detail: string;
+}>;
+
+declare const conversations_deleteConversation: typeof deleteConversation;
+declare const conversations_deleteMessage: typeof deleteMessage;
+declare const conversations_getConversationThreads: typeof getConversationThreads;
+declare const conversations_getMessage: typeof getMessage;
+declare const conversations_listConversations: typeof listConversations;
+declare const conversations_shareConversation: typeof shareConversation;
+declare const conversations_updateConversationTitle: typeof updateConversationTitle;
+declare namespace conversations {
+  export { conversations_deleteConversation as deleteConversation, conversations_deleteMessage as deleteMessage, conversations_getConversationThreads as getConversationThreads, conversations_getMessage as getMessage, conversations_listConversations as listConversations, conversations_shareConversation as shareConversation, conversations_updateConversationTitle as updateConversationTitle };
+}
+
+/**
+ * Document-tag (doctag) operations — assign, remove, generate.
+ */
+
+type CitationData = components['schemas']['CitationData'];
+declare function assignDocTags(arbi: ArbiClient, tagId: string, docIds: string[], note?: string | null): Promise<{
+    doc_ext_id: string;
+    tag_ext_id: string;
+    note?: string | null | undefined;
+    citations?: {
+        [x: string]: {
+            chunk_ids: string[];
+            scores: number[];
+            statement: string;
+            offset_start: number;
+            offset_end: number;
+        };
+    } | null | undefined;
+    created_by_ext_id: string;
+    updated_by_ext_id?: string | null | undefined;
+    created_at: string;
+    updated_at: string;
+}[]>;
+declare function removeDocTags(arbi: ArbiClient, tagId: string, docIds: string[]): Promise<void>;
+declare function updateDocTag(arbi: ArbiClient, tagId: string, docId: string, updates: {
+    note?: string | null;
+    citations?: Record<string, CitationData> | null;
+}): Promise<{
+    doc_ext_id: string;
+    tag_ext_id: string;
+    note?: string | null | undefined;
+    citations?: {
+        [x: string]: {
+            chunk_ids: string[];
+            scores: number[];
+            statement: string;
+            offset_start: number;
+            offset_end: number;
+        };
+    } | null | undefined;
+    created_by_ext_id: string;
+    updated_by_ext_id?: string | null | undefined;
+    created_at: string;
+    updated_at: string;
+}>;
+declare function generateDocTags(arbi: ArbiClient, tagIds: string[], docIds: string[]): Promise<{
+    doc_ext_ids: string[];
+    tag_ext_ids: string[];
+}>;
+
+declare const doctags_assignDocTags: typeof assignDocTags;
+declare const doctags_generateDocTags: typeof generateDocTags;
+declare const doctags_removeDocTags: typeof removeDocTags;
+declare const doctags_updateDocTag: typeof updateDocTag;
+declare namespace doctags {
+  export { doctags_assignDocTags as assignDocTags, doctags_generateDocTags as generateDocTags, doctags_removeDocTags as removeDocTags, doctags_updateDocTag as updateDocTag };
+}
+
+declare function listDMs(arbi: ArbiClient): Promise<{
+    type: _arbidocs_client.components["schemas"]["NotificationType"];
+    external_id: string;
+    sender: {
+        external_id: string;
+        email: string;
+        given_name: string;
+        family_name: string;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+    };
+    recipient: {
+        external_id: string;
+        email: string;
+        given_name: string;
+        family_name: string;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+    };
+    workspace_ext_id?: string | null | undefined;
+    content?: string | null | undefined;
+    read: boolean;
+    created_at: string;
+    updated_at: string;
+}[]>;
+declare function sendDM(arbi: ArbiClient, messages: Array<{
+    recipient_ext_id: string;
+    content: string;
+}>): Promise<{
+    type: _arbidocs_client.components["schemas"]["NotificationType"];
+    external_id: string;
+    sender: {
+        external_id: string;
+        email: string;
+        given_name: string;
+        family_name: string;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+    };
+    recipient: {
+        external_id: string;
+        email: string;
+        given_name: string;
+        family_name: string;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+    };
+    workspace_ext_id?: string | null | undefined;
+    content?: string | null | undefined;
+    read: boolean;
+    created_at: string;
+    updated_at: string;
+}[]>;
+declare function markRead(arbi: ArbiClient, messageIds: string[]): Promise<{
+    type: _arbidocs_client.components["schemas"]["NotificationType"];
+    external_id: string;
+    sender: {
+        external_id: string;
+        email: string;
+        given_name: string;
+        family_name: string;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+    };
+    recipient: {
+        external_id: string;
+        email: string;
+        given_name: string;
+        family_name: string;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+    };
+    workspace_ext_id?: string | null | undefined;
+    content?: string | null | undefined;
+    read: boolean;
+    created_at: string;
+    updated_at: string;
+}[]>;
+declare function deleteDMs(arbi: ArbiClient, messageIds: string[]): Promise<void>;
+
+declare const dm_deleteDMs: typeof deleteDMs;
+declare const dm_listDMs: typeof listDMs;
+declare const dm_markRead: typeof markRead;
+declare const dm_sendDM: typeof sendDM;
+declare namespace dm {
+  export { dm_deleteDMs as deleteDMs, dm_listDMs as listDMs, dm_markRead as markRead, dm_sendDM as sendDM };
+}
+
+/**
+ * User settings operations — get, update.
+ */
+
+type UserSettingsUpdate = components['schemas']['UserSettingsUpdate'];
+declare function getSettings(arbi: ArbiClient): Promise<{
+    [x: string]: unknown;
+    subscription?: {
+        status: string;
+        trial_expires?: number | null | undefined;
+    } | null | undefined;
+    last_workspace?: string | null | undefined;
+    pinned_workspaces: string[];
+    pinned_templates: string[];
+    tableviews: {
+        workspace: string;
+        name: string;
+        columns: string[];
+    }[];
+    developer: boolean;
+    show_document_navigator: boolean;
+    show_thread_visualization: boolean;
+    show_smart_search: boolean;
+    show_security_settings: boolean;
+    show_invite_tab: boolean;
+    show_help_page: boolean;
+    show_templates: boolean;
+    show_pa_mode: boolean;
+    hide_online_status: boolean;
+    muted_users: string[];
+}>;
+declare function updateSettings(arbi: ArbiClient, body: UserSettingsUpdate): Promise<void>;
+
+declare const settings_getSettings: typeof getSettings;
+declare const settings_updateSettings: typeof updateSettings;
+declare namespace settings {
+  export { settings_getSettings as getSettings, settings_updateSettings as updateSettings };
+}
+
+/**
+ * Agent configuration operations — list, get, save, delete, schema, models.
+ */
+
+type ConfigUpdateData = components['schemas']['ConfigUpdateData'];
+declare function listConfigs(arbi: ArbiClient): Promise<{
+    versions: {
+        external_id: string;
+        title: string | null;
+        created_at: string;
+    }[];
+}>;
+declare function getConfig(arbi: ArbiClient, configId: string): Promise<{
+    Agents: {
+        ENABLED: boolean;
+        HUMAN_IN_THE_LOOP: boolean;
+        WEB_SEARCH?: {
+            ENABLED: boolean;
+            SAVE_SOURCES: boolean;
+        } | undefined;
+        RUN_CODE?: {
+            ENABLED: boolean;
+            IMAGE: string;
+            TIMEOUT_SECONDS: number;
+            MEMORY_LIMIT: string;
+            NETWORK: string;
+        } | undefined;
+        MCP_TOOLS: string[];
+        PLANNING_ENABLED: boolean;
+        SUGGESTED_QUERIES: boolean;
+        ARTIFACTS_ENABLED: boolean;
+        VISION_ENABLED: boolean;
+        DOC_INDEX_COMPACT_THRESHOLD: number;
+        DOC_INDEX_SKIP_THRESHOLD: number;
+        PERSONAL_AGENT: boolean;
+        MEMORY_ENABLED: boolean;
+        SKILLS_ENABLED: boolean;
+        SKILL_CREATION: boolean;
+        REVIEW_ENABLED: boolean;
+        PERSONA: string;
+        AGENT_MODEL_NAME: string;
+        AGENT_API_TYPE: "local" | "remote";
+        LLM_AGENT_TEMPERATURE: number;
+        AGENT_MAX_TOKENS: number;
+        AGENT_MAX_ITERATIONS: number;
+        MAX_PASSAGE_PAGES: number;
+        AGENT_HISTORY_CHAR_THRESHOLD: number;
+        AGENT_SYSTEM_PROMPT: string;
+    };
+    QueryLLM: {
+        API_TYPE: "local" | "remote";
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        MAX_CHAR_SIZE_TO_ANSWER: number;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+    };
+    ReviewLLM: {
+        API_TYPE: "local" | "remote";
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_CHAR_SIZE_TO_ANSWER: number;
+    };
+    EvaluatorLLM: {
+        API_TYPE: "local" | "remote";
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_CHAR_SIZE_TO_ANSWER: number;
+    };
+    TitleLLM: {
+        API_TYPE: "local" | "remote";
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        MAX_CHAR_SIZE_TO_ANSWER: number;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+    };
+    SummariseLLM: {
+        API_TYPE: "local" | "remote";
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_CHAR_SIZE_TO_ANSWER: number;
+        COMPACTION_THRESHOLD_TOKENS: number;
+        COMPACTION_KEEP_RECENT: number;
+    };
+    DoctagLLM: {
+        API_TYPE: "local" | "remote";
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        MAX_CHAR_CONTEXT_TO_ANSWER: number;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_CONCURRENT_DOCS: number;
+        DEFAULT_METADATA_TAGS: {
+            name: string;
+            instruction?: string | null | undefined;
+            tag_type?: {
+                type: "checkbox" | "text" | "number" | "select" | "search" | "date";
+                options: string[];
+            } | undefined;
+        }[];
+    };
+    MemoryLLM: {
+        API_TYPE: "local" | "remote";
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_CHAR_CONTEXT: number;
+        MAX_CONCURRENT: number;
+    };
+    PlanningLLM: {
+        API_TYPE: "local" | "remote";
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_CHAR_SIZE_TO_ANSWER: number;
+        APPROVAL_TIMEOUT: number;
+    };
+    VisionLLM: {
+        API_TYPE: "local" | "remote";
+        MODEL_NAME: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_PAGES_PER_CALL: number;
+        IMAGE_MAX_DIMENSION: number;
+    };
+    CodeAgent: {
+        API_TYPE: "local" | "remote";
+        MODEL_NAME: string;
+        SYSTEM_INSTRUCTION: string;
+        TEMPERATURE: number;
+        MAX_TOKENS: number;
+        MAX_ITERATIONS: number;
+    };
+    ModelCitation: {
+        SIM_THREASHOLD: number;
+        MIN_CHAR_SIZE_TO_ANSWER: number;
+        MAX_NUMB_CITATIONS: number;
+    };
+    Retriever: {
+        MIN_RETRIEVAL_SIM_SCORE: number;
+        MAX_DISTINCT_DOCUMENTS: number;
+        MAX_TOTAL_CHUNKS_TO_RETRIEVE: number;
+        GROUP_SIZE: number;
+        SEARCH_MODE: components["schemas"]["SearchMode"];
+        HYBRID_DENSE_WEIGHT: number;
+        HYBRID_SPARSE_WEIGHT: number;
+        HYBRID_RERANKER_WEIGHT: number;
+    };
+    Reranker: {
+        MIN_SCORE: number;
+        MAX_NUMB_OF_CHUNKS: number;
+        MAX_CONCURRENT_REQUESTS: number;
+        MODEL_NAME: string;
+        API_TYPE: "local" | "remote";
+    };
+    Parser: {
+        SKIP_DUPLICATES: boolean;
+    };
+    Chunker: {
+        MAX_CHUNK_TOKENS: number;
+        TOKENIZER_TYPE: "tiktoken" | "huggingface";
+        TOKENIZER_NAME: string;
+    };
+    Embedder: {
+        MODEL_NAME: string;
+        API_TYPE: "local" | "remote";
+        BATCH_SIZE: number;
+        MAX_CONCURRENT_REQUESTS: number;
+        DOCUMENT_PREFIX: string;
+        QUERY_PREFIX: string;
+    };
+    KeywordEmbedder: {
+        DIMENSION_SPACE: number;
+        FILTER_STOPWORDS: boolean;
+        BM25_K1: number;
+        BM25_B: number;
+        BM25_AVGDL: number;
+    };
+} | {
+    Agents: {
+        [x: string]: string | boolean;
+    };
+}>;
+declare function saveConfig(arbi: ArbiClient, body: ConfigUpdateData): Promise<{
+    external_id: string;
+    title: string | null;
+    created_at: string;
+}>;
+declare function deleteConfig(arbi: ArbiClient, configId: string): Promise<{
+    detail: string;
+}>;
+declare function getSchema(arbi: ArbiClient): Promise<unknown>;
+declare function getModels(arbi: ArbiClient): Promise<{
+    models: {
+        model_name: string;
+        api_type: string;
+        tags?: string[] | null | undefined;
+        max_input_tokens?: number | null | undefined;
+        max_output_tokens?: number | null | undefined;
+        input_cost_per_token?: number | null | undefined;
+        output_cost_per_token?: number | null | undefined;
+        provider?: string | null | undefined;
+        mode?: string | null | undefined;
+        supports_vision?: boolean | null | undefined;
+        supports_reasoning?: boolean | null | undefined;
+        supports_function_calling?: boolean | null | undefined;
+        supports_response_schema?: boolean | null | undefined;
+    }[];
+}>;
+
+declare const agentconfig_deleteConfig: typeof deleteConfig;
+declare const agentconfig_getConfig: typeof getConfig;
+declare const agentconfig_getModels: typeof getModels;
+declare const agentconfig_getSchema: typeof getSchema;
+declare const agentconfig_listConfigs: typeof listConfigs;
+declare const agentconfig_saveConfig: typeof saveConfig;
+declare namespace agentconfig {
+  export { agentconfig_deleteConfig as deleteConfig, agentconfig_getConfig as getConfig, agentconfig_getModels as getModels, agentconfig_getSchema as getSchema, agentconfig_listConfigs as listConfigs, agentconfig_saveConfig as saveConfig };
+}
+
+/**
+ * Health and model operations.
+ */
+
+declare function getHealth(arbi: ArbiClient): Promise<{
+    status: string;
+    backend_git_hash?: string | null | undefined;
+    frontend_docker_version?: string | null | undefined;
+    services: {
+        name: string;
+        status: string;
+        detail?: string | null | undefined;
+        service_info?: {
+            [x: string]: unknown;
+        } | null | undefined;
+    }[];
+    models_health?: {
+        application: string;
+        models: {
+            model: string;
+            status: string;
+            detail?: string | null | undefined;
+        }[];
+    } | null | undefined;
+    available_models: string[];
+}>;
+declare function getHealthModels(arbi: ArbiClient): Promise<{
+    models: {
+        model_name: string;
+        api_type: string;
+        tags?: string[] | null | undefined;
+        max_input_tokens?: number | null | undefined;
+        max_output_tokens?: number | null | undefined;
+        input_cost_per_token?: number | null | undefined;
+        output_cost_per_token?: number | null | undefined;
+        provider?: string | null | undefined;
+        mode?: string | null | undefined;
+        supports_vision?: boolean | null | undefined;
+        supports_reasoning?: boolean | null | undefined;
+        supports_function_calling?: boolean | null | undefined;
+        supports_response_schema?: boolean | null | undefined;
+    }[];
+}>;
+declare function getRemoteModels(arbi: ArbiClient): Promise<{
+    application: string;
+    models: {
+        model: string;
+        status: string;
+        detail?: string | null | undefined;
+    }[];
+}>;
+declare function getMcpTools(arbi: ArbiClient): Promise<{
+    tools: {
+        name: string;
+        description: string;
+        server_name: string;
+    }[];
+}>;
+
+declare const health_getHealth: typeof getHealth;
+declare const health_getHealthModels: typeof getHealthModels;
+declare const health_getMcpTools: typeof getMcpTools;
+declare const health_getRemoteModels: typeof getRemoteModels;
+declare namespace health {
+  export { health_getHealth as getHealth, health_getHealthModels as getHealthModels, health_getMcpTools as getMcpTools, health_getRemoteModels as getRemoteModels };
+}
+
+/**
+ * Responses operations — background query submission and retrieval.
+ *
+ * submitBackgroundQuery: POST /v1/responses with background=true → 202 with task ID.
+ * getResponse: GET /v1/responses/{responseId} → current status + output.
+ * extractResponseText: Walk response output and join text content.
+ */
+
+type ResponsesAPIResponse = components['schemas']['ResponsesAPIResponse'];
+interface SubmitBackgroundQueryOptions extends AuthHeaders {
+    workspaceId: string;
+    question: string;
+    docIds: string[];
+    previousResponseId?: string | null;
+    model?: string;
+}
+/**
+ * Submit a query for background processing.
+ * Returns immediately with a response ID and "queued" status.
+ */
+declare function submitBackgroundQuery(options: SubmitBackgroundQueryOptions): Promise<ResponsesAPIResponse>;
+/**
+ * Fetch the current state of a response by ID.
+ * Returns progressive status, output, usage, and metadata.
+ */
+declare function getResponse(auth: AuthHeaders, responseId: string): Promise<ResponsesAPIResponse>;
+/**
+ * Walk response output messages and join all output_text content.
+ * Pure function, no I/O.
+ */
+declare function extractResponseText(response: ResponsesAPIResponse): string;
+
+type responses_SubmitBackgroundQueryOptions = SubmitBackgroundQueryOptions;
+declare const responses_extractResponseText: typeof extractResponseText;
+declare const responses_getResponse: typeof getResponse;
+declare const responses_submitBackgroundQuery: typeof submitBackgroundQuery;
+declare namespace responses {
+  export { type responses_SubmitBackgroundQueryOptions as SubmitBackgroundQueryOptions, responses_extractResponseText as extractResponseText, responses_getResponse as getResponse, responses_submitBackgroundQuery as submitBackgroundQuery };
+}
+
+export { connectWithReconnect as $, type AuthHeaders as A, type SSEStreamCallbacks as B, type ConfigStore as C, type DocumentWaiter as D, type SSEStreamResult as E, type FormattedWsMessage as F, type SSEStreamStartData as G, type UserInfo as H, type UserInputRequestEvent as I, type UserMessageEvent as J, type WsConnection as K, LIFECYCLE_LABELS as L, type MessageLevel as M, agentconfig as N, type OutputTokensDetails as O, assistant as P, type QueryOptions as Q, type ReconnectOptions as R, type SSEEvent as S, TOOL_LABELS as T, type UploadBatchResult as U, authenticatedFetch as V, type WorkspaceContext as W, buildRetrievalChunkTool as X, buildRetrievalFullContextTool as Y, buildRetrievalTocTool as Z, connectWebSocket as _, type CliConfig as a, consumeSSEStream as a0, contacts as a1, conversations as a2, createAuthenticatedClient as a3, createDocumentWaiter as a4, dm as a5, doctags as a6, documents as a7, files as a8, formatAgentStepLabel as a9, formatFileSize as aa, formatUserName as ab, formatWorkspaceChoices as ac, formatWsMessage as ad, generateEncryptedWorkspaceKey as ae, getErrorCode as af, getErrorMessage as ag, health as ah, parseSSEEvents as ai, performPasswordLogin as aj, requireData as ak, requireOk as al, resolveAuth as am, resolveWorkspace as an, responses as ao, selectWorkspace as ap, selectWorkspaceById as aq, settings as ar, streamSSE as as, tags as at, workspaces as au, type CliCredentials as b, type ChatSession as c, type UploadOptions as d, type UploadResult as e, type AgentStepEvent as f, Arbi as g, ArbiApiError as h, ArbiError as i, type ArbiOptions as j, type ArtifactEvent as k, type AuthContext as l, type AuthenticatedClient as m, type ConnectOptions as n, type DocumentWaiterOptions as o, type MessageMetadataPayload as p, type ReconnectableWsConnection as q, type ResponseCompletedEvent as r, type ResponseContentPartAddedEvent as s, type ResponseCreatedEvent as t, type ResponseFailedEvent as u, type ResponseOutputItemAddedEvent as v, type ResponseOutputItemDoneEvent as w, type ResponseOutputTextDeltaEvent as x, type ResponseOutputTextDoneEvent as y, type ResponseUsage as z };