@arbidocs/sdk 0.3.11 → 0.3.14

package/dist/index.d.cts

@@ -1,101 +1,13 @@
-import * as _arbidocs_client from '@arbidocs/client';
-import { ArbiClient, LoginResult, components, WebSocketServerMessage, WsTaskUpdateMessage } from '@arbidocs/client';
+import { C as ConfigStore, a as CliConfig, b as CliCredentials, c as ChatSession, A as AuthHeaders, U as UploadBatchResult, d as UploadOptions, e as UploadResult } from './browser-DtwXhEkG.cjs';
+export { f as AgentStepEvent, g as Arbi, h as ArbiApiError, i as ArbiError, j as ArbiOptions, k as ArtifactEvent, l as AuthContext, m as AuthenticatedClient, n as ConnectOptions, D as DocumentWaiter, o as DocumentWaiterOptions, F as FormattedWsMessage, L as LIFECYCLE_LABELS, M as MessageLevel, p as MessageMetadataPayload, O as OutputTokensDetails, Q as QueryOptions, R as ReconnectOptions, q as ReconnectableWsConnection, r as ResponseCompletedEvent, s as ResponseContentPartAddedEvent, t as ResponseCreatedEvent, u as ResponseFailedEvent, v as ResponseOutputItemAddedEvent, w as ResponseOutputItemDoneEvent, x as ResponseOutputTextDeltaEvent, y as ResponseOutputTextDoneEvent, z as ResponseUsage, S as SSEEvent, B as SSEStreamCallbacks, E as SSEStreamResult, G as SSEStreamStartData, T as TOOL_LABELS, H as UserInfo, I as UserInputRequestEvent, J as UserMessageEvent, W as WorkspaceContext, K as WsConnection, N as agentconfig, P as assistant, V as authenticatedFetch, X as buildRetrievalChunkTool, Y as buildRetrievalFullContextTool, Z as buildRetrievalTocTool, _ as connectWebSocket, $ as connectWithReconnect, a0 as consumeSSEStream, a1 as contacts, a2 as conversations, a3 as createAuthenticatedClient, a4 as createDocumentWaiter, a5 as dm, a6 as doctags, a7 as documents, a8 as files, a9 as formatAgentStepLabel, aa as formatFileSize, ab as formatUserName, ac as formatWorkspaceChoices, ad as formatWsMessage, ae as generateEncryptedWorkspaceKey, af as getErrorCode, ag as getErrorMessage, ah as health, ai as parseSSEEvents, aj as performPasswordLogin, ak as requireData, al as requireOk, am as resolveAuth, an as resolveWorkspace, ao as responses, ap as selectWorkspace, aq as selectWorkspaceById, ar as settings, as as streamSSE, at as tags, au as workspaces } from './browser-DtwXhEkG.cjs';
+import '@arbidocs/client';
 
 /**
- * Core error types and throwing error utilities.
+ * Configuration persistence — file-based implementation for Node.js environments.
  *
- * Unlike CLI helpers which call process.exit(1), these throw typed errors
- * that consumers (CLI, MCP) can catch and handle in their own way.
+ * Browser consumers should import from './config-types.ts' directly.
  */
-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.
- */
-declare function getErrorMessage(err: unknown): string;
 
-/**
- * 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 persistence — types, interface, and file-based implementation.
- *
- * Both CLI and MCP share the same ~/.arbi/ config directory.
- */
-interface CliConfig {
-    baseUrl: string;
-    deploymentDomain: string;
-    selectedWorkspaceId?: string;
-    autoUpdate?: boolean;
-    notifications?: boolean;
-}
-interface CliCredentials {
-    email: string;
-    signingPrivateKeyBase64: string;
-    serverSessionKeyBase64: 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;
-}
 declare class FileConfigStore implements ConfigStore {
     private readonly configDir;
     private readonly configFile;
@@ -117,2907 +29,62 @@ declare class FileConfigStore implements ConfigStore {
     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 MCP 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.
- * 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'];
-/** 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 MCP.
- */
-
-interface SSEEvent {
-    event: string;
-    data: 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[];
-    errors: string[];
-    userMessage: UserMessageEvent | null;
-    metadata: MessageMetadataPayload | null;
-    artifacts: ArtifactEvent[];
-    usage: ResponseUsage | 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;
-
-/**
- * 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$1(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 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, uploadFile$1 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$1 = 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.
+     * Try to resolve config from multiple sources, in priority order:
+     *
+     * 1. Existing `~/.arbi/config.json` (highest priority)
+     * 2. `ARBI_SERVER_URL` environment variable
+     * 3. `.env` file in `searchDir` → read `VITE_DEPLOYMENT_DOMAIN`
+     * 4. `public/config.json` in `searchDir` → read `deployment.domain`
+     * 5. Default to `https://localhost`
+     *
+     * Returns `{ config, source }` where source describes where the config came from.
+     * Saves auto-detected config to disk so subsequent calls use the fast path.
      */
-    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>;
+    resolveConfigWithFallbacks(searchDir?: string): {
+        config: CliConfig;
+        source: string;
+    };
     /**
-     * Recover a session using a stored signing private key (base64).
-     * Useful for session recovery without re-entering the password.
+     * Read VITE_DEPLOYMENT_DOMAIN from a .env file.
      */
-    loginWithKey(email: string, signingPrivateKeyBase64: string): Promise<void>;
+    private readDotEnvDomain;
     /**
-     * Select a workspace by ID. Fetches the workspace list, finds the matching
-     * workspace, decrypts the wrapped key, and sets up auth headers.
+     * Read deployment.domain from a public/config.json file.
      */
-    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;
-            doctags: {
-                doc_ext_id: string;
-                tag_ext_id: string;
-                note?: string | null | undefined;
-                citations?: {
-                    [x: string]: {
-                        chunk_ids: string[];
-                        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;
-            doctags: {
-                doc_ext_id: string;
-                tag_ext_id: string;
-                note?: string | null | undefined;
-                citations?: {
-                    [x: string]: {
-                        chunk_ids: string[];
-                        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$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;
-            doctags: {
-                doc_ext_id: string;
-                tag_ext_id: string;
-                note?: string | null | undefined;
-                citations?: {
-                    [x: string]: {
-                        chunk_ids: string[];
-                        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, workspaceId?: string) => Promise<{
-            doc_ext_ids: string[];
-            duplicates?: string[];
-        }>;
-        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[];
-                                    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;
-                            };
-                        };
-                    } | 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[];
-                            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;
-                    };
-                };
-            } | 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" | "folder" | "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" | "folder" | "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" | "folder" | "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[];
-                    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[];
-                    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[];
-            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;
-            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;
-                MCP_TOOLS: string[];
-                PLANNING_ENABLED: boolean;
-                SUGGESTED_QUERIES: boolean;
-                ARTIFACTS_ENABLED: boolean;
-                VISION_ENABLED: boolean;
-                PERSONAL_AGENT: 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" | "folder" | "search" | "date";
-                        options: string[];
-                    } | undefined;
-                }[];
-            };
-            MemoryLLM: {
-                API_TYPE: "local" | "remote";
-                MODEL_NAME: string;
-                ENABLED: boolean;
-                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;
-            };
-            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: {
-                MAX_NUMB_OF_CHUNKS: number;
-                MAX_CONCURRENT_REQUESTS: number;
-                MODEL_NAME: string;
-                API_TYPE: "local" | "remote";
-                QUERY_INSTRUCTION: string;
-            };
-            Parser: {};
-            Chunker: {
-                MAX_CHUNK_TOKENS: number;
-            };
-            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;
-            };
-            MemoryLLM: {
-                [x: 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;
-                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;
-                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;
+    private readPublicConfigDomain;
 }
 
 /**
- * Document operations — list, get, delete, update, upload-url, parsed content, upload, download.
+ * Document operations — Node.js file system operations.
+ *
+ * These functions require Node.js built-ins (fs, path) and are not browser-safe.
+ * Browser consumers should use the Blob-based uploadFile/uploadFiles from './documents.js'.
  */
 
-type DocUpdateRequest = components['schemas']['DocUpdateRequest'];
-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;
-    doctags: {
-        doc_ext_id: string;
-        tag_ext_id: string;
-        note?: string | null | undefined;
-        citations?: {
-            [x: string]: {
-                chunk_ids: string[];
-                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;
-    doctags: {
-        doc_ext_id: string;
-        tag_ext_id: string;
-        note?: string | null | undefined;
-        citations?: {
-            [x: string]: {
-                chunk_ids: string[];
-                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[]): 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;
-    doctags: {
-        doc_ext_id: string;
-        tag_ext_id: string;
-        note?: string | null | undefined;
-        citations?: {
-            [x: string]: {
-                chunk_ids: string[];
-                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(auth: AuthHeaders, workspaceId: string, fileData: Blob, fileName: string): Promise<{
-    doc_ext_ids: string[];
-    duplicates?: string[];
-}>;
 /**
  * Upload a local file by path. Handles readFileSync + basename + Blob + uploadFile.
  * Convenience wrapper for CLI/TUI consumers that work with file system paths.
  */
-declare function uploadLocalFile(auth: AuthHeaders, workspaceId: string, filePath: string): Promise<{
-    doc_ext_ids: string[];
-    duplicates?: string[];
+declare function uploadLocalFile(auth: AuthHeaders, workspaceId: string, filePath: string, options?: UploadOptions): Promise<UploadResult & {
     fileName: string;
 }>;
 /**
- * Download a document. Returns the response for the caller to handle.
+ * Upload all supported files from a directory, preserving folder structure.
+ * Files are grouped by their relative folder path and uploaded per group.
  */
-declare function downloadDocument(auth: AuthHeaders, docId: string): Promise<Response>;
-
-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_updateDocuments: typeof updateDocuments;
-declare const documents_uploadFile: typeof uploadFile;
-declare const documents_uploadLocalFile: typeof uploadLocalFile;
-declare const documents_uploadUrl: typeof uploadUrl;
-declare namespace documents {
-  export { documents_deleteDocuments as deleteDocuments, documents_downloadDocument as downloadDocument, documents_getDocuments as getDocuments, documents_getParsedContent as getParsedContent, documents_listDocuments as listDocuments, documents_updateDocuments as updateDocuments, documents_uploadFile as uploadFile, documents_uploadLocalFile as uploadLocalFile, documents_uploadUrl as uploadUrl };
-}
-
+declare function uploadDirectory(auth: AuthHeaders, workspaceId: string, dirPath: string): Promise<UploadBatchResult>;
 /**
- * Workspace operations — list, create, delete, update, users, copy.
+ * Upload files from a zip archive, preserving internal folder structure.
+ * Uses jszip via dynamic import so the dependency is optional at load time.
  */
+declare function uploadZip(auth: AuthHeaders, workspaceId: string, zipPath: string): Promise<UploadBatchResult>;
 
-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" | "folder" | "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" | "folder" | "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" | "folder" | "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[];
-                            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;
-                    };
-                };
-            } | 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[];
-                    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;
-            };
-        };
-    } | 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[];
-            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[];
-            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[];
-    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;
-    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;
-        MCP_TOOLS: string[];
-        PLANNING_ENABLED: boolean;
-        SUGGESTED_QUERIES: boolean;
-        ARTIFACTS_ENABLED: boolean;
-        VISION_ENABLED: boolean;
-        PERSONAL_AGENT: 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" | "folder" | "search" | "date";
-                options: string[];
-            } | undefined;
-        }[];
-    };
-    MemoryLLM: {
-        API_TYPE: "local" | "remote";
-        MODEL_NAME: string;
-        ENABLED: boolean;
-        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;
-    };
-    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: {
-        MAX_NUMB_OF_CHUNKS: number;
-        MAX_CONCURRENT_REQUESTS: number;
-        MODEL_NAME: string;
-        API_TYPE: "local" | "remote";
-        QUERY_INSTRUCTION: string;
-    };
-    Parser: {};
-    Chunker: {
-        MAX_CHUNK_TOKENS: number;
-    };
-    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;
-    };
-    MemoryLLM: {
-        [x: 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;
-        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;
-        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 };
+declare const documentsNode_uploadDirectory: typeof uploadDirectory;
+declare const documentsNode_uploadLocalFile: typeof uploadLocalFile;
+declare const documentsNode_uploadZip: typeof uploadZip;
+declare namespace documentsNode {
+  export { documentsNode_uploadDirectory as uploadDirectory, documentsNode_uploadLocalFile as uploadLocalFile, documentsNode_uploadZip as uploadZip };
 }
 
-export { type AgentStepEvent, Arbi, ArbiApiError, ArbiError, type ArbiOptions, type ArtifactEvent, type AuthContext, type AuthHeaders, type AuthenticatedClient, type ChatSession, type CliConfig, type CliCredentials, type ConfigStore, type ConnectOptions, type DocumentWaiter, type DocumentWaiterOptions, FileConfigStore, type FormattedWsMessage, type MessageLevel, type MessageMetadataPayload, type OutputTokensDetails, type QueryOptions, type ReconnectOptions, type ReconnectableWsConnection, type ResponseCompletedEvent, type ResponseContentPartAddedEvent, type ResponseCreatedEvent, type ResponseFailedEvent, type ResponseOutputItemAddedEvent, type ResponseOutputItemDoneEvent, type ResponseOutputTextDeltaEvent, type ResponseOutputTextDoneEvent, type ResponseUsage, type SSEEvent, type SSEStreamCallbacks, type SSEStreamResult, type SSEStreamStartData, type UserInfo, type UserInputRequestEvent, type UserMessageEvent, type WorkspaceContext, type WsConnection, agentconfig, assistant, authenticatedFetch, buildRetrievalChunkTool, buildRetrievalFullContextTool, buildRetrievalTocTool, connectWebSocket, connectWithReconnect, consumeSSEStream, contacts, conversations, createAuthenticatedClient, createDocumentWaiter, dm, doctags, documents, files, formatFileSize, formatUserName, formatWorkspaceChoices, formatWsMessage, generateEncryptedWorkspaceKey, getErrorMessage, health, parseSSEEvents, performPasswordLogin, requireData, requireOk, resolveAuth, resolveWorkspace, selectWorkspace, selectWorkspaceById, settings, streamSSE, tags, workspaces };
+export { AuthHeaders, ChatSession, CliConfig, CliCredentials, ConfigStore, FileConfigStore, documentsNode };