@arbidocs/sdk 0.3.115 → 0.3.117

package/dist/{browser-B5b3SDW6.d.ts → browser-CxTSIAhf.d.ts}

@@ -1417,226 +1417,562 @@ declare namespace contacts {
 }
 
 /**
- * File operations — OpenAI-compatible Files API (list, get, delete, upload, content).
+ * Direct message / notification operations — list, send, mark read, delete.
+ *
+ * All message content is E2E encrypted using ECDH (X25519 + XSalsa20-Poly1305).
+ * Encryption keys are derived from the user's Ed25519 signing keypair.
  */
 
-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;
+type NotificationResponse = components['schemas']['NotificationResponse'];
+/** A resolved DM recipient: their external_id + curve25519 public key. */
+interface ResolvedRecipient {
+    extId: string;
+    pubKey: string;
 }
-declare function listFiles(arbi: ArbiClient, options?: ListFilesOptions): Promise<{
-    object: string;
-    data: {
-        id: string;
-        object: string;
-        bytes: number;
-        created_at: number;
-        filename: string;
-        purpose: string;
-        status: string;
-        expires_at?: number | null | undefined;
-        status_details?: string | null | undefined;
-    }[];
-    has_more: boolean;
-    first_id?: string | null | undefined;
-    last_id?: string | null | undefined;
-}>;
-declare function getFile(arbi: ArbiClient, fileId: string): Promise<{
-    id: string;
-    object: string;
-    bytes: number;
-    created_at: number;
-    filename: string;
-    purpose: string;
-    status: string;
-    expires_at?: number | null | undefined;
-    status_details?: string | null | undefined;
-}>;
-declare function deleteFile(arbi: ArbiClient, fileId: string): Promise<{
-    id: string;
-    object: string;
-    deleted: boolean;
-}>;
 /**
- * Upload a file via the OpenAI-compatible Files API.
- * Uses raw fetch for multipart upload.
- */
-declare function uploadFile(auth: AuthHeaders, fileData: Blob, fileName: string, purpose?: string): Promise<FileObject>;
-/**
- * Get file content (binary). Returns the raw Response for the caller to handle.
+ * Everything needed to encrypt/decrypt DMs.
+ * Derive once per session, pass to all DM operations.
  */
-declare function getFileContent(auth: AuthHeaders, fileId: string): Promise<Response>;
-
-type files_FileDeleteResponse = FileDeleteResponse;
-type files_FileListResponse = FileListResponse;
-type files_FileObject = FileObject;
-type files_ListFilesOptions = ListFilesOptions;
-declare const files_deleteFile: typeof deleteFile;
-declare const files_getFile: typeof getFile;
-declare const files_getFileContent: typeof getFileContent;
-declare const files_listFiles: typeof listFiles;
-declare const files_uploadFile: typeof uploadFile;
-declare namespace files {
-  export { type files_FileDeleteResponse as FileDeleteResponse, type files_FileListResponse as FileListResponse, type files_FileObject as FileObject, type files_ListFilesOptions as ListFilesOptions, files_deleteFile as deleteFile, files_getFile as getFile, files_getFileContent as getFileContent, files_listFiles as listFiles, files_uploadFile as uploadFile };
+interface DmCryptoContext {
+    /** User's X25519 encryption keypair (derived from Ed25519 signing key) */
+    encryptionKeypair: KeyPair;
+    /** User's own external_id (to determine send vs receive direction) */
+    userExtId: string;
 }
-
 /**
- * Scheduled agent tasks — one-time, recurring (RFC-5545 rrule) or event-triggered
- * jobs whose action is a reminder, an agent prompt, or a skill run.
- * Backend: `/v1/tasks` (src/api/v1/routers/tasks.py).
+ * Create a DM crypto context from a signing private key.
+ *
+ * @param arbi - ArbiClient instance (provides crypto utilities)
+ * @param signingPrivateKeyBytes - Ed25519 signing private key (64 bytes)
+ * @param userExtId - Current user's external_id
  */
-
-type TaskResponse = components['schemas']['TaskResponse'];
-type CreateTaskRequest = components['schemas']['CreateTaskRequest'];
-type UpdateTaskRequest = components['schemas']['UpdateTaskRequest'];
-/** List the caller's scheduled tasks (newest first). */
-declare function listTasks(arbi: ArbiClient): Promise<TaskResponse[]>;
-/** Create a scheduled task. `name` is required; supply trigger + action fields. */
-declare function createTask(arbi: ArbiClient, body: CreateTaskRequest): Promise<TaskResponse>;
-declare function getTask(arbi: ArbiClient, taskId: string): Promise<TaskResponse>;
-/** Update a task — including `status` to pause/resume (`active` | `paused`). */
-declare function updateTask(arbi: ArbiClient, taskId: string, body: UpdateTaskRequest): Promise<TaskResponse>;
-declare function deleteTask(arbi: ArbiClient, taskId: string): Promise<void>;
-/** Fire a task immediately without advancing its schedule. */
-declare function runTask(arbi: ArbiClient, taskId: string): Promise<TaskResponse>;
-
-type tasks_CreateTaskRequest = CreateTaskRequest;
-type tasks_TaskResponse = TaskResponse;
-type tasks_UpdateTaskRequest = UpdateTaskRequest;
-declare const tasks_createTask: typeof createTask;
-declare const tasks_deleteTask: typeof deleteTask;
-declare const tasks_getTask: typeof getTask;
-declare const tasks_listTasks: typeof listTasks;
-declare const tasks_runTask: typeof runTask;
-declare const tasks_updateTask: typeof updateTask;
-declare namespace tasks {
-  export { type tasks_CreateTaskRequest as CreateTaskRequest, type tasks_TaskResponse as TaskResponse, type tasks_UpdateTaskRequest as UpdateTaskRequest, tasks_createTask as createTask, tasks_deleteTask as deleteTask, tasks_getTask as getTask, tasks_listTasks as listTasks, tasks_runTask as runTask, tasks_updateTask as updateTask };
-}
-
+declare function createDmCryptoContext(arbi: ArbiClient, signingPrivateKeyBytes: Uint8Array, userExtId: string): DmCryptoContext;
 /**
- * Workspace memory — per-workspace encrypted knowledge notes with citations.
- * The firm's practice profile / house style / precedent knowhow lives here and is
- * read by grounded agents. All endpoints require an OPEN workspace.
- * Backend: `/v1/memory` (src/api/v1/routers/memory.py).
+ * Encrypt a plaintext message for a recipient.
+ *
+ * @param arbi - ArbiClient instance
+ * @param plaintext - Message content to encrypt
+ * @param recipientEncryptionPubKeyBase64 - Recipient's X25519 public key (base64)
+ * @param senderEncryptionSecretKey - Sender's X25519 secret key (Uint8Array)
+ * @returns Base64-encoded ciphertext (nonce prepended)
  */
-
-type MemoryResponse = components['schemas']['MemoryResponse'];
-type CreateMemoryRequest = components['schemas']['CreateMemoryRequest'];
-type UpdateMemoryRequest = components['schemas']['UpdateMemoryRequest'];
-type MemorySearchRequest = components['schemas']['MemorySearchRequest'];
-type MemorySearchResponse = components['schemas']['MemorySearchResponse'];
-/** Create a memory. `content` is required; `shared` makes it workspace-wide. */
-declare function createMemory(arbi: ArbiClient, body: CreateMemoryRequest): Promise<MemoryResponse>;
-/** List the open workspace's memories (newest first). */
-declare function listMemories(arbi: ArbiClient, options?: {
-    pinnedOnly?: boolean;
-}): Promise<MemoryResponse[]>;
-/** Semantic/keyword/hybrid search across the workspace's memories. */
-declare function searchMemories(arbi: ArbiClient, body: MemorySearchRequest): Promise<MemorySearchResponse>;
-declare function updateMemory(arbi: ArbiClient, memoryId: string, body: UpdateMemoryRequest): Promise<MemoryResponse>;
-declare function deleteMemory(arbi: ArbiClient, memoryId: string): Promise<void>;
-
-type memory_CreateMemoryRequest = CreateMemoryRequest;
-type memory_MemoryResponse = MemoryResponse;
-type memory_MemorySearchRequest = MemorySearchRequest;
-type memory_MemorySearchResponse = MemorySearchResponse;
-type memory_UpdateMemoryRequest = UpdateMemoryRequest;
-declare const memory_createMemory: typeof createMemory;
-declare const memory_deleteMemory: typeof deleteMemory;
-declare const memory_listMemories: typeof listMemories;
-declare const memory_searchMemories: typeof searchMemories;
-declare const memory_updateMemory: typeof updateMemory;
-declare namespace memory {
-  export { type memory_CreateMemoryRequest as CreateMemoryRequest, type memory_MemoryResponse as MemoryResponse, type memory_MemorySearchRequest as MemorySearchRequest, type memory_MemorySearchResponse as MemorySearchResponse, type memory_UpdateMemoryRequest as UpdateMemoryRequest, memory_createMemory as createMemory, memory_deleteMemory as deleteMemory, memory_listMemories as listMemories, memory_searchMemories as searchMemories, memory_updateMemory as updateMemory };
-}
-
+declare function encryptDmContent(arbi: ArbiClient, plaintext: string, recipientEncryptionPubKeyBase64: string, senderEncryptionSecretKey: Uint8Array): Promise<string>;
 /**
- * High-level convenience class that wraps the full ARBI stack into a simple API.
+ * Decrypt an encrypted notification message.
  *
- * Handles SDK client creation, sodium initialization, authentication,
- * workspace key decryption, and delegates to all operations modules.
+ * Uses the sender/recipient public keys embedded in NotificationResponse
+ * to determine the "other party" for ECDH decryption.
  *
- * 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()
+ * @param arbi - ArbiClient instance
+ * @param notification - The notification with encrypted content
+ * @param crypto - DM crypto context for the current user
+ * @returns Decrypted plaintext, or null if content is empty
+ * @throws Error if decryption fails (wrong keys or tampered message)
  */
-
-type DocUpdateRequest = components['schemas']['DocUpdateRequest'];
-type WorkspaceUpdateRequest$1 = components['schemas']['WorkspaceUpdateRequest'];
-type UpdateTagRequest$1 = components['schemas']['UpdateTagRequest'];
-type TagFormat = components['schemas']['TagFormat'];
-type CitationData$1 = components['schemas']['CitationData'];
-type UserSettingsUpdate$1 = components['schemas']['UserSettingsUpdate'];
-type ConfigUpdateData$1 = components['schemas']['ConfigUpdateData'];
-
-interface ArbiOptions {
-    /** Backend API URL (e.g. 'https://arbi.mycompany.com') */
-    url: string;
-    /** Deployment domain for key derivation. Defaults to hostname of url. */
-    deploymentDomain?: string;
-    /** Include credentials (cookies) in requests. Default: 'omit' for SDK consumers. */
-    credentials?: 'include' | 'omit' | 'same-origin';
-}
-interface QueryOptions {
-    /** Document IDs to search against */
-    docIds: string[];
-    /** Previous response ID for follow-up questions */
-    previousResponseId?: string | null;
-    /** Model to use for generation */
-    model?: string;
-    /** Called for each streaming token */
-    onToken?: (content: string) => void;
-    /** Called when stream starts */
-    onStreamStart?: (data: SSEStreamStartData) => void;
-    /** Called for each agent step */
-    onAgentStep?: (data: AgentStepEvent) => void;
-    /** Called on stream error */
-    onError?: (message: string) => void;
-    /** Called when a user message event is received */
-    onUserMessage?: (data: UserMessageEvent) => void;
-    /** Called when message metadata is received */
-    onMetadata?: (data: MessageMetadataPayload$1) => void;
-    /** Called when the agent requests user input */
-    onUserInputRequest?: (data: UserInputRequestEvent) => void;
-    /** Called when an artifact event is received */
-    onArtifact?: (data: ArtifactEvent) => void;
-    /** Called when backend elapsed time is received */
-    onElapsedTime?: (t: number) => void;
-    /** Called when stream completes */
-    onComplete?: () => void;
-}
-declare class Arbi {
-    private client;
-    private loginResult;
-    private currentWorkspaceId;
-    private readonly options;
-    constructor(options: ArbiOptions);
-    /** Initialize the SDK client and sodium crypto. Called automatically by login(). */
-    init(): Promise<ArbiClient>;
-    /**
-     * Request a verification email for registration.
-     * The user will receive an email with a 3-word verification code.
-     */
-    requestVerification(email: string): Promise<void>;
-    /**
-     * Register a new account using the verification code received by email.
-     */
-    register(params: {
+declare function decryptDmContent(arbi: ArbiClient, notification: NotificationResponse, crypto: DmCryptoContext): Promise<string | null>;
+/**
+ * Decrypt a batch of notifications, replacing content in-place.
+ * Failed decryptions get content set to '[Decryption failed]'.
+ *
+ * @returns New array with decrypted content
+ */
+declare function decryptDmBatch(arbi: ArbiClient, notifications: NotificationResponse[], crypto: DmCryptoContext): Promise<NotificationResponse[]>;
+/**
+ * List DMs (raw — content is encrypted ciphertext).
+ */
+declare function listDMs(arbi: ArbiClient): Promise<{
+    type: components["schemas"]["NotificationType"];
+    external_id: string;
+    sender: {
+        external_id: string;
+        parent_ext_id?: string | null | undefined;
         email: string;
-        password: string;
-        verificationCode: string;
-        firstName?: string;
-        lastName?: string;
-    }): Promise<void>;
+        given_name: string;
+        family_name?: string | null | undefined;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+        is_sso: boolean;
+    };
+    recipient: {
+        external_id: string;
+        parent_ext_id?: string | null | undefined;
+        email: string;
+        given_name: string;
+        family_name?: string | null | undefined;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+        is_sso: boolean;
+    };
+    workspace_ext_id?: string | null | undefined;
+    content?: string | null | undefined;
+    read: boolean;
+    created_at: string;
+    updated_at: string;
+}[]>;
+/**
+ * List and decrypt DMs in one call.
+ */
+declare function listDecryptedDMs(arbi: ArbiClient, crypto: DmCryptoContext): Promise<{
+    type: components["schemas"]["NotificationType"];
+    external_id: string;
+    sender: components["schemas"]["UserResponse"];
+    recipient: components["schemas"]["UserResponse"];
+    workspace_ext_id?: string | null;
+    content?: string | null;
+    read: boolean;
+    created_at: string;
+    updated_at: string;
+}[]>;
+/**
+ * List the current user's durable activity feed, newest first.
+ *
+ * Activity notifications are backend-originated, to-self log lines (recipient ==
+ * sender == the acting user) that are always read — they never appear in the
+ * normal DM/notification feed or the unread badge. Reading them requires the
+ * explicit `type=activity` filter, which this helper always sets.
+ */
+declare function listActivity(arbi: ArbiClient, options?: {
+    limit?: number;
+    offset?: number;
+}): Promise<{
+    type: components["schemas"]["NotificationType"];
+    external_id: string;
+    sender: {
+        external_id: string;
+        parent_ext_id?: string | null | undefined;
+        email: string;
+        given_name: string;
+        family_name?: string | null | undefined;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+        is_sso: boolean;
+    };
+    recipient: {
+        external_id: string;
+        parent_ext_id?: string | null | undefined;
+        email: string;
+        given_name: string;
+        family_name?: string | null | undefined;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+        is_sso: boolean;
+    };
+    workspace_ext_id?: string | null | undefined;
+    content?: string | null | undefined;
+    read: boolean;
+    created_at: string;
+    updated_at: string;
+}[]>;
+/**
+ * Resolve a recipient reference (email OR `usr-`/`agt-` external_id) into the
+ * `{ extId, pubKey }` an encrypted send needs. Walks three directories in order
+ * — contacts, parent-owned agents, current-workspace members — and stops at the
+ * first hit with a usable curve25519 public key. Returns `null` when nothing
+ * matches so callers can surface a recovery hint.
+ *
+ * This is the single resolution path shared by the app, the CLI and seeding —
+ * no consumer should re-implement directory lookups.
+ */
+declare function resolveRecipient(arbi: ArbiClient, ref: string): Promise<ResolvedRecipient | null>;
+/**
+ * Send an E2E encrypted DM.
+ *
+ * Encrypts plaintext content for each recipient using their public key.
+ * Requires recipient public keys — fetch via contacts or user lookup first.
+ *
+ * @param arbi - ArbiClient instance
+ * @param messages - Array of { recipient_ext_id, content (plaintext), recipient_encryption_public_key }
+ * @param crypto - DM crypto context for the sender
+ */
+declare function sendEncryptedDM(arbi: ArbiClient, messages: Array<{
+    recipient_ext_id: string;
+    content: string;
+    recipient_encryption_public_key: string;
+}>, crypto: DmCryptoContext): Promise<{
+    type: components["schemas"]["NotificationType"];
+    external_id: string;
+    sender: {
+        external_id: string;
+        parent_ext_id?: string | null | undefined;
+        email: string;
+        given_name: string;
+        family_name?: string | null | undefined;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+        is_sso: boolean;
+    };
+    recipient: {
+        external_id: string;
+        parent_ext_id?: string | null | undefined;
+        email: string;
+        given_name: string;
+        family_name?: string | null | undefined;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+        is_sso: boolean;
+    };
+    workspace_ext_id?: string | null | undefined;
+    content?: string | null | undefined;
+    read: boolean;
+    created_at: string;
+    updated_at: string;
+}[]>;
+/**
+ * Ask another user to grant you workspace access.
+ *
+ * Creates a `workspace_access_request` notification. The `content` is an
+ * opaque base64 blob, E2E-encrypted with the requester↔recipient shared key
+ * (same scheme as a DM), carrying the requester's live session public key
+ * (`sessionPubkeyB64`) so the recipient can mint a temporary, session-scoped
+ * grant, plus an optional note.
+ *
+ * `workspaceExtId` is optional and only meaningful for API/SDK/CLI callers who
+ * already know a workspace id (obtained out-of-band); omit it and the recipient
+ * picks the workspace.
+ */
+declare function requestWorkspaceAccess(arbi: ArbiClient, params: {
+    recipientExtId: string;
+    recipientEncryptionPublicKey: string;
+    sessionPubkeyB64: string;
+    note?: string;
+    workspaceExtId?: string;
+}, crypto: DmCryptoContext): Promise<{
+    type: components["schemas"]["NotificationType"];
+    external_id: string;
+    sender: {
+        external_id: string;
+        parent_ext_id?: string | null | undefined;
+        email: string;
+        given_name: string;
+        family_name?: string | null | undefined;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+        is_sso: boolean;
+    };
+    recipient: {
+        external_id: string;
+        parent_ext_id?: string | null | undefined;
+        email: string;
+        given_name: string;
+        family_name?: string | null | undefined;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+        is_sso: boolean;
+    };
+    workspace_ext_id?: string | null | undefined;
+    content?: string | null | undefined;
+    read: boolean;
+    created_at: string;
+    updated_at: string;
+}>;
+/**
+ * Send a plaintext DM (no encryption).
+ * @deprecated Use sendEncryptedDM instead.
+ */
+declare function sendDM(arbi: ArbiClient, messages: Array<{
+    recipient_ext_id: string;
+    content: string;
+}>): Promise<{
+    type: components["schemas"]["NotificationType"];
+    external_id: string;
+    sender: {
+        external_id: string;
+        parent_ext_id?: string | null | undefined;
+        email: string;
+        given_name: string;
+        family_name?: string | null | undefined;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+        is_sso: boolean;
+    };
+    recipient: {
+        external_id: string;
+        parent_ext_id?: string | null | undefined;
+        email: string;
+        given_name: string;
+        family_name?: string | null | undefined;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+        is_sso: boolean;
+    };
+    workspace_ext_id?: string | null | undefined;
+    content?: string | null | undefined;
+    read: boolean;
+    created_at: string;
+    updated_at: string;
+}[]>;
+declare function markRead(arbi: ArbiClient, messageIds: string[]): Promise<{
+    type: components["schemas"]["NotificationType"];
+    external_id: string;
+    sender: {
+        external_id: string;
+        parent_ext_id?: string | null | undefined;
+        email: string;
+        given_name: string;
+        family_name?: string | null | undefined;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+        is_sso: boolean;
+    };
+    recipient: {
+        external_id: string;
+        parent_ext_id?: string | null | undefined;
+        email: string;
+        given_name: string;
+        family_name?: string | null | undefined;
+        picture?: string | null | undefined;
+        encryption_public_key: string;
+        is_sso: boolean;
+    };
+    workspace_ext_id?: string | null | undefined;
+    content?: string | null | undefined;
+    read: boolean;
+    created_at: string;
+    updated_at: string;
+}[]>;
+declare function deleteDMs(arbi: ArbiClient, messageIds: string[]): Promise<void>;
+
+type dm_DmCryptoContext = DmCryptoContext;
+type dm_ResolvedRecipient = ResolvedRecipient;
+declare const dm_createDmCryptoContext: typeof createDmCryptoContext;
+declare const dm_decryptDmBatch: typeof decryptDmBatch;
+declare const dm_decryptDmContent: typeof decryptDmContent;
+declare const dm_deleteDMs: typeof deleteDMs;
+declare const dm_encryptDmContent: typeof encryptDmContent;
+declare const dm_listActivity: typeof listActivity;
+declare const dm_listDMs: typeof listDMs;
+declare const dm_listDecryptedDMs: typeof listDecryptedDMs;
+declare const dm_markRead: typeof markRead;
+declare const dm_requestWorkspaceAccess: typeof requestWorkspaceAccess;
+declare const dm_resolveRecipient: typeof resolveRecipient;
+declare const dm_sendDM: typeof sendDM;
+declare const dm_sendEncryptedDM: typeof sendEncryptedDM;
+declare namespace dm {
+  export { type dm_DmCryptoContext as DmCryptoContext, type dm_ResolvedRecipient as ResolvedRecipient, dm_createDmCryptoContext as createDmCryptoContext, dm_decryptDmBatch as decryptDmBatch, dm_decryptDmContent as decryptDmContent, dm_deleteDMs as deleteDMs, dm_encryptDmContent as encryptDmContent, dm_listActivity as listActivity, dm_listDMs as listDMs, dm_listDecryptedDMs as listDecryptedDMs, dm_markRead as markRead, dm_requestWorkspaceAccess as requestWorkspaceAccess, dm_resolveRecipient as resolveRecipient, dm_sendDM as sendDM, dm_sendEncryptedDM as sendEncryptedDM };
+}
+
+/**
+ * File operations — OpenAI-compatible Files API (list, get, delete, upload, content).
+ */
+
+type FileObject = components['schemas']['FileObject'];
+type FileDeleteResponse = components['schemas']['FileDeleteResponse'];
+type FileListResponse = components['schemas']['FileListResponse'];
+
+interface ListFilesOptions {
+    purpose?: string | null;
+    limit?: number;
+    order?: string;
+    after?: string | null;
+}
+declare function listFiles(arbi: ArbiClient, options?: ListFilesOptions): Promise<{
+    object: string;
+    data: {
+        id: string;
+        object: string;
+        bytes: number;
+        created_at: number;
+        filename: string;
+        purpose: string;
+        status: string;
+        expires_at?: number | null | undefined;
+        status_details?: string | null | undefined;
+    }[];
+    has_more: boolean;
+    first_id?: string | null | undefined;
+    last_id?: string | null | undefined;
+}>;
+declare function getFile(arbi: ArbiClient, fileId: string): Promise<{
+    id: string;
+    object: string;
+    bytes: number;
+    created_at: number;
+    filename: string;
+    purpose: string;
+    status: string;
+    expires_at?: number | null | undefined;
+    status_details?: string | null | undefined;
+}>;
+declare function deleteFile(arbi: ArbiClient, fileId: string): Promise<{
+    id: string;
+    object: string;
+    deleted: boolean;
+}>;
+/**
+ * Upload a file via the OpenAI-compatible Files API.
+ * Uses raw fetch for multipart upload.
+ */
+declare function uploadFile(auth: AuthHeaders, fileData: Blob, fileName: string, purpose?: string): Promise<FileObject>;
+/**
+ * Get file content (binary). Returns the raw Response for the caller to handle.
+ */
+declare function getFileContent(auth: AuthHeaders, fileId: string): Promise<Response>;
+
+type files_FileDeleteResponse = FileDeleteResponse;
+type files_FileListResponse = FileListResponse;
+type files_FileObject = FileObject;
+type files_ListFilesOptions = ListFilesOptions;
+declare const files_deleteFile: typeof deleteFile;
+declare const files_getFile: typeof getFile;
+declare const files_getFileContent: typeof getFileContent;
+declare const files_listFiles: typeof listFiles;
+declare const files_uploadFile: typeof uploadFile;
+declare namespace files {
+  export { type files_FileDeleteResponse as FileDeleteResponse, type files_FileListResponse as FileListResponse, type files_FileObject as FileObject, type files_ListFilesOptions as ListFilesOptions, files_deleteFile as deleteFile, files_getFile as getFile, files_getFileContent as getFileContent, files_listFiles as listFiles, files_uploadFile as uploadFile };
+}
+
+/**
+ * Scheduled agent tasks — one-time, recurring (RFC-5545 rrule) or event-triggered
+ * jobs whose action is a reminder, an agent prompt, or a skill run.
+ * Backend: `/v1/tasks` (src/api/v1/routers/tasks.py).
+ */
+
+type TaskResponse = components['schemas']['TaskResponse'];
+type CreateTaskRequest = components['schemas']['CreateTaskRequest'];
+type UpdateTaskRequest = components['schemas']['UpdateTaskRequest'];
+/** List the caller's scheduled tasks (newest first). */
+declare function listTasks(arbi: ArbiClient): Promise<TaskResponse[]>;
+/** Create a scheduled task. `name` is required; supply trigger + action fields. */
+declare function createTask(arbi: ArbiClient, body: CreateTaskRequest): Promise<TaskResponse>;
+declare function getTask(arbi: ArbiClient, taskId: string): Promise<TaskResponse>;
+/** Update a task — including `status` to pause/resume (`active` | `paused`). */
+declare function updateTask(arbi: ArbiClient, taskId: string, body: UpdateTaskRequest): Promise<TaskResponse>;
+declare function deleteTask(arbi: ArbiClient, taskId: string): Promise<void>;
+/** Fire a task immediately without advancing its schedule. */
+declare function runTask(arbi: ArbiClient, taskId: string): Promise<TaskResponse>;
+
+type tasks_CreateTaskRequest = CreateTaskRequest;
+type tasks_TaskResponse = TaskResponse;
+type tasks_UpdateTaskRequest = UpdateTaskRequest;
+declare const tasks_createTask: typeof createTask;
+declare const tasks_deleteTask: typeof deleteTask;
+declare const tasks_getTask: typeof getTask;
+declare const tasks_listTasks: typeof listTasks;
+declare const tasks_runTask: typeof runTask;
+declare const tasks_updateTask: typeof updateTask;
+declare namespace tasks {
+  export { type tasks_CreateTaskRequest as CreateTaskRequest, type tasks_TaskResponse as TaskResponse, type tasks_UpdateTaskRequest as UpdateTaskRequest, tasks_createTask as createTask, tasks_deleteTask as deleteTask, tasks_getTask as getTask, tasks_listTasks as listTasks, tasks_runTask as runTask, tasks_updateTask as updateTask };
+}
+
+/**
+ * Workspace memory — per-workspace encrypted knowledge notes with citations.
+ * The firm's practice profile / house style / precedent knowhow lives here and is
+ * read by grounded agents. All endpoints require an OPEN workspace.
+ * Backend: `/v1/memory` (src/api/v1/routers/memory.py).
+ */
+
+type MemoryResponse = components['schemas']['MemoryResponse'];
+type CreateMemoryRequest = components['schemas']['CreateMemoryRequest'];
+type UpdateMemoryRequest = components['schemas']['UpdateMemoryRequest'];
+type MemorySearchRequest = components['schemas']['MemorySearchRequest'];
+type MemorySearchResponse = components['schemas']['MemorySearchResponse'];
+/** Create a memory. `content` is required; `shared` makes it workspace-wide. */
+declare function createMemory(arbi: ArbiClient, body: CreateMemoryRequest): Promise<MemoryResponse>;
+/** List the open workspace's memories (newest first). */
+declare function listMemories(arbi: ArbiClient, options?: {
+    pinnedOnly?: boolean;
+}): Promise<MemoryResponse[]>;
+/** Semantic/keyword/hybrid search across the workspace's memories. */
+declare function searchMemories(arbi: ArbiClient, body: MemorySearchRequest): Promise<MemorySearchResponse>;
+declare function updateMemory(arbi: ArbiClient, memoryId: string, body: UpdateMemoryRequest): Promise<MemoryResponse>;
+declare function deleteMemory(arbi: ArbiClient, memoryId: string): Promise<void>;
+
+type memory_CreateMemoryRequest = CreateMemoryRequest;
+type memory_MemoryResponse = MemoryResponse;
+type memory_MemorySearchRequest = MemorySearchRequest;
+type memory_MemorySearchResponse = MemorySearchResponse;
+type memory_UpdateMemoryRequest = UpdateMemoryRequest;
+declare const memory_createMemory: typeof createMemory;
+declare const memory_deleteMemory: typeof deleteMemory;
+declare const memory_listMemories: typeof listMemories;
+declare const memory_searchMemories: typeof searchMemories;
+declare const memory_updateMemory: typeof updateMemory;
+declare namespace memory {
+  export { type memory_CreateMemoryRequest as CreateMemoryRequest, type memory_MemoryResponse as MemoryResponse, type memory_MemorySearchRequest as MemorySearchRequest, type memory_MemorySearchResponse as MemorySearchResponse, type memory_UpdateMemoryRequest as UpdateMemoryRequest, memory_createMemory as createMemory, memory_deleteMemory as deleteMemory, memory_listMemories as listMemories, memory_searchMemories as searchMemories, memory_updateMemory as updateMemory };
+}
+
+/**
+ * High-level convenience class that wraps the full ARBI stack into a simple API.
+ *
+ * Handles SDK client creation, sodium initialization, authentication,
+ * workspace key decryption, and delegates to all operations modules.
+ *
+ * Usage:
+ *   const arbi = new Arbi({ url: 'https://arbi.mycompany.com' })
+ *   await arbi.login('user@example.com', 'password')
+ *   const workspaces = await arbi.workspaces.list()
+ *   await arbi.selectWorkspace(workspaces[0].external_id)
+ *   const docs = await arbi.documents.list()
+ */
+
+type DocUpdateRequest = components['schemas']['DocUpdateRequest'];
+type WorkspaceUpdateRequest$1 = components['schemas']['WorkspaceUpdateRequest'];
+type UpdateTagRequest$1 = components['schemas']['UpdateTagRequest'];
+type TagFormat = components['schemas']['TagFormat'];
+type CitationData$1 = components['schemas']['CitationData'];
+type UserSettingsUpdate$1 = components['schemas']['UserSettingsUpdate'];
+type ConfigUpdateData$1 = components['schemas']['ConfigUpdateData'];
+
+interface ArbiOptions {
+    /** Backend API URL (e.g. 'https://arbi.mycompany.com') */
+    url: string;
+    /** Deployment domain for key derivation. Defaults to hostname of url. */
+    deploymentDomain?: string;
+    /** Include credentials (cookies) in requests. Default: 'omit' for SDK consumers. */
+    credentials?: 'include' | 'omit' | 'same-origin';
+}
+interface QueryOptions {
+    /** Document IDs to search against */
+    docIds: string[];
+    /** Previous response ID for follow-up questions */
+    previousResponseId?: string | null;
+    /** Model to use for generation */
+    model?: string;
+    /** Called for each streaming token */
+    onToken?: (content: string) => void;
+    /** Called when stream starts */
+    onStreamStart?: (data: SSEStreamStartData) => void;
+    /** Called for each agent step */
+    onAgentStep?: (data: AgentStepEvent) => void;
+    /** Called on stream error */
+    onError?: (message: string) => void;
+    /** Called when a user message event is received */
+    onUserMessage?: (data: UserMessageEvent) => void;
+    /** Called when message metadata is received */
+    onMetadata?: (data: MessageMetadataPayload$1) => 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 dmCryptoContext;
+    private readonly options;
+    constructor(options: ArbiOptions);
+    /** Initialize the SDK client and sodium crypto. Called automatically by login(). */
+    init(): Promise<ArbiClient>;
+    /**
+     * Request a verification email for registration.
+     * The user will receive an email with a 3-word verification code.
+     */
+    requestVerification(email: string): Promise<void>;
+    /**
+     * Register a new account using the verification code received by email.
+     */
+    register(params: {
+        email: string;
+        password: string;
+        verificationCode: string;
+        firstName?: string;
+        lastName?: string;
+    }): Promise<void>;
     /**
      * Log in with email and password.
      * Initializes the SDK client if not already done.
@@ -1769,6 +2105,50 @@ declare class Arbi {
             cancel_at_period_end?: boolean | null | undefined;
             portal_url?: string | null | undefined;
         }>;
+        /** AI usage + spend breakdown for a project's billing period. */
+        usage: (projectExtId: string, monthsBack?: number) => Promise<{
+            project_ext_id: string;
+            period_start: string;
+            period_end: string;
+            total_spend: number;
+            total_tokens: number;
+            total_requests: number;
+            daily: components["schemas"]["DailyUsage"][];
+            model_groups: {
+                [key: string]: components["schemas"]["ModelGroupUsage"];
+            };
+            by_workspace: {
+                [key: string]: components["schemas"]["TagBreakdown"];
+            };
+            by_user: {
+                [key: string]: components["schemas"]["TagBreakdown"];
+            };
+            by_feature: {
+                [key: string]: components["schemas"]["TagBreakdown"];
+            };
+            invoice_pdf?: string | null;
+        }>;
+        /** Stripe invoices for a project's subscription. */
+        invoices: (projectExtId: string) => Promise<{
+            project_ext_id: string;
+            invoices: components["schemas"]["ProjectInvoice"][];
+        }>;
+    };
+    readonly user: {
+        /**
+         * The authenticated user's identity from the current session
+         * (`external_id` + `email`), established at login. Returns `null` when not
+         * logged in. This is the canonical "who am I" accessor — DM direction and
+         * ownership checks read it instead of re-deriving identity per call.
+         */
+        identity: () => {
+            externalId: string;
+            email: string;
+        } | null;
+        /** Today's deployment-wide credit spend for the current user. */
+        usageToday: () => Promise<{
+            credits_used: number;
+        }>;
     };
     readonly workspaces: {
         list: () => Promise<{
@@ -2003,6 +2383,17 @@ declare class Arbi {
                 error?: string | null | undefined;
             }[];
         }>;
+        /**
+         * The last-generated document-derived chronology (key case events / dates).
+         * Defaults to the currently open workspace when no id is passed.
+         */
+        chronology: (workspaceId?: string) => Promise<{
+            events?: {
+                [key: string]: unknown;
+            }[] | null;
+            generated_at?: string | null;
+            doc_count?: number | null;
+        }>;
     };
     readonly documents: {
         list: () => Promise<{
@@ -2699,8 +3090,73 @@ declare class Arbi {
     readonly contacts: {
         list: () => Promise<{
             external_id: string;
-            email: string;
-            user?: {
+            email: string;
+            user?: {
+                external_id: string;
+                parent_ext_id?: string | null | undefined;
+                email: string;
+                given_name: string;
+                family_name?: string | null | undefined;
+                picture?: string | null | undefined;
+                encryption_public_key: string;
+                is_sso: boolean;
+            } | null | undefined;
+            status: "invitation_pending" | "invitation_expired" | "registered";
+            created_at: string;
+        }[]>;
+        add: (emails: string[]) => Promise<{
+            external_id: string;
+            email: string;
+            user?: {
+                external_id: string;
+                parent_ext_id?: string | null | undefined;
+                email: string;
+                given_name: string;
+                family_name?: string | null | undefined;
+                picture?: string | null | undefined;
+                encryption_public_key: string;
+                is_sso: boolean;
+            } | null | undefined;
+            status: "invitation_pending" | "invitation_expired" | "registered";
+            created_at: string;
+        }[]>;
+        remove: (contactIds: string[]) => Promise<void>;
+        groupByStatus: typeof groupContactsByStatus;
+    };
+    /**
+     * Build (and cache) the DM crypto context for the current session.
+     *
+     * Derives the user's curve25519 keypair from the stored signing key and pairs
+     * it with their external_id — everything `list()`/`send()` need to encrypt and
+     * decrypt. Cached for the session and cleared on logout. Consumers never touch
+     * this: it's an internal of the `dm` surface.
+     */
+    private requireDmCrypto;
+    readonly dm: {
+        /**
+         * List direct messages, newest first, with content already **decrypted**.
+         * (A message that can't be decrypted comes back as `[Decryption failed]`.)
+         */
+        list: () => Promise<{
+            type: components["schemas"]["NotificationType"];
+            external_id: string;
+            sender: components["schemas"]["UserResponse"];
+            recipient: components["schemas"]["UserResponse"];
+            workspace_ext_id?: string | null;
+            content?: string | null;
+            read: boolean;
+            created_at: string;
+            updated_at: string;
+        }[]>;
+        /**
+         * Send an E2E-encrypted DM to a recipient (email or `usr-`/`agt-` id).
+         * Resolves the recipient's public key and encrypts internally — the caller
+         * passes plaintext and never handles keys or ciphertext.
+         */
+        send: (recipient: string, text: string) => Promise<{
+            type: components["schemas"]["NotificationType"];
+            external_id: string;
+            sender: {
                 external_id: string;
                 parent_ext_id?: string | null | undefined;
                 email: string;
@@ -2709,14 +3165,8 @@ declare class Arbi {
                 picture?: string | null | undefined;
                 encryption_public_key: string;
                 is_sso: boolean;
-            } | null | undefined;
-            status: "invitation_pending" | "invitation_expired" | "registered";
-            created_at: string;
-        }[]>;
-        add: (emails: string[]) => Promise<{
-            external_id: string;
-            email: string;
-            user?: {
+            };
+            recipient: {
                 external_id: string;
                 parent_ext_id?: string | null | undefined;
                 email: string;
@@ -2725,15 +3175,18 @@ declare class Arbi {
                 picture?: string | null | undefined;
                 encryption_public_key: string;
                 is_sso: boolean;
-            } | null | undefined;
-            status: "invitation_pending" | "invitation_expired" | "registered";
+            };
+            workspace_ext_id?: string | null | undefined;
+            content?: string | null | undefined;
+            read: boolean;
             created_at: string;
+            updated_at: string;
         }[]>;
-        remove: (contactIds: string[]) => Promise<void>;
-        groupByStatus: typeof groupContactsByStatus;
-    };
-    readonly dm: {
-        list: () => Promise<{
+        /**
+         * Send to a recipient whose external_id + public key are already known
+         * (e.g. from a message's `sender`), skipping directory resolution.
+         */
+        sendTo: (recipientExtId: string, recipientPublicKey: string, text: string) => Promise<{
             type: components["schemas"]["NotificationType"];
             external_id: string;
             sender: {
@@ -2762,10 +3215,9 @@ declare class Arbi {
             created_at: string;
             updated_at: string;
         }[]>;
-        send: (messages: Array<{
-            recipient_ext_id: string;
-            content: string;
-        }>) => Promise<{
+        /** Resolve a recipient reference to `{ extId, pubKey }` (contacts → agents → workspace). */
+        resolveRecipient: (recipient: string) => Promise<ResolvedRecipient | null>;
+        markRead: (messageIds: string[]) => Promise<{
             type: components["schemas"]["NotificationType"];
             external_id: string;
             sender: {
@@ -2794,7 +3246,12 @@ declare class Arbi {
             created_at: string;
             updated_at: string;
         }[]>;
-        markRead: (messageIds: string[]) => Promise<{
+        delete: (messageIds: string[]) => Promise<void>;
+        /** List the current user's durable activity feed (never unread; excluded from DMs). */
+        listActivity: (options?: {
+            limit?: number;
+            offset?: number;
+        }) => Promise<{
             type: components["schemas"]["NotificationType"];
             external_id: string;
             sender: {
@@ -2823,7 +3280,6 @@ declare class Arbi {
             created_at: string;
             updated_at: string;
         }[]>;
-        delete: (messageIds: string[]) => Promise<void>;
     };
     readonly settings: {
         get: () => Promise<{
@@ -3811,6 +4267,7 @@ declare class Arbi {
  */
 
 type WorkspaceUpdateRequest = components['schemas']['WorkspaceUpdateRequest'];
+type WorkspaceChronologyOut = components['schemas']['WorkspaceChronologyOut'];
 declare function listWorkspaces(arbi: ArbiClient): Promise<{
     external_id: string;
     name: string;
@@ -4000,6 +4457,11 @@ declare function setUserRole(arbi: ArbiClient, userIds: string[], role: 'owner'
     agent_ext_id?: string | null | undefined;
     is_temporary: boolean;
 }[]>;
+/**
+ * Return the last-generated document-derived chronology (key case events /
+ * dates) for a workspace. Fields are all-null when none has been generated yet.
+ */
+declare function getWorkspaceChronology(arbi: ArbiClient, workspaceId: string): Promise<WorkspaceChronologyOut>;
 declare function copyDocuments(arbi: ArbiClient, targetWorkspaceId: string, docIds: string[], targetWorkspaceKey: string): Promise<{
     detail: string;
     documents_copied: number;
@@ -4011,17 +4473,19 @@ declare function copyDocuments(arbi: ArbiClient, targetWorkspaceId: string, docI
     }[];
 }>;
 
+type workspaces_WorkspaceChronologyOut = WorkspaceChronologyOut;
 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_getWorkspaceChronology: typeof getWorkspaceChronology;
 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 };
+  export { type workspaces_WorkspaceChronologyOut as WorkspaceChronologyOut, workspaces_addWorkspaceUsers as addWorkspaceUsers, workspaces_copyDocuments as copyDocuments, workspaces_createWorkspace as createWorkspace, workspaces_deleteWorkspaces as deleteWorkspaces, workspaces_getWorkspaceChronology as getWorkspaceChronology, workspaces_listWorkspaceUsers as listWorkspaceUsers, workspaces_listWorkspaces as listWorkspaces, workspaces_removeWorkspaceUsers as removeWorkspaceUsers, workspaces_setUserRole as setUserRole, workspaces_updateWorkspace as updateWorkspace };
 }
 
 /**
@@ -4281,503 +4745,227 @@ declare function deleteConversation(arbi: ArbiClient, conversationId: string): P
 declare function shareConversation(arbi: ArbiClient, conversationId: string): Promise<{
     detail: string;
 }>;
-declare function updateConversationTitle(arbi: ArbiClient, conversationId: string, title: string): Promise<{
-    detail: string;
-    title: string;
-}>;
-declare function getMessage(arbi: ArbiClient, messageId: string): Promise<{
-    role: "user" | "assistant" | "system";
-    content: string;
-    tools?: {
-        [x: string]: {
-            name: "model_citation";
-            description: string;
-            tool_responses: {
-                [x: string]: {
-                    chunk_ids: string[];
-                    scores: number[];
-                    statement: string;
-                    offset_start: number;
-                    offset_end: number;
-                };
-            };
-        } | {
-            name: "retrieval_chunk";
-            description: string;
-            tool_args: {
-                doc_ext_ids: string[];
-                search_mode?: ("semantic" | "keyword" | "hybrid") | null | undefined;
-            };
-            tool_responses: {
-                [x: string]: {
-                    metadata: {
-                        workspace_ext_id?: string | null | undefined;
-                        doc_ext_id?: string | null | undefined;
-                        doc_title?: string | null | undefined;
-                        chunk_id?: string | null | undefined;
-                        chunk_ext_id: string;
-                        chunk_pg_idx: number;
-                        chunk_doc_idx: number;
-                        page_number: number;
-                        score?: number | null | undefined;
-                        rerank_score?: number | null | undefined;
-                        tokens?: number | null | undefined;
-                        created_at: string;
-                        heading: boolean;
-                        bbox?: number[] | null | undefined;
-                        element_type?: string | null | undefined;
-                        heading_level?: number | null | undefined;
-                    };
-                    content: string;
-                }[];
-            };
-        } | {
-            name: "retrieval_full_context";
-            description: string;
-            tool_args: {
-                doc_ext_ids: string[];
-                from_ref?: string | null | undefined;
-                to_ref?: string | null | undefined;
-            };
-            tool_responses: {
-                [x: string]: {
-                    metadata: {
-                        workspace_ext_id?: string | null | undefined;
-                        doc_ext_id?: string | null | undefined;
-                        doc_title?: string | null | undefined;
-                        chunk_id?: string | null | undefined;
-                        chunk_ext_id: string;
-                        chunk_pg_idx: number;
-                        chunk_doc_idx: number;
-                        page_number: number;
-                        score?: number | null | undefined;
-                        rerank_score?: number | null | undefined;
-                        tokens?: number | null | undefined;
-                        created_at: string;
-                        heading: boolean;
-                        bbox?: number[] | null | undefined;
-                        element_type?: string | null | undefined;
-                        heading_level?: number | null | undefined;
-                    };
-                    content: string;
-                }[];
-            };
-        } | {
-            name: "retrieval_toc";
-            description: string;
-            tool_args: {
-                doc_ext_ids: string[];
-            };
-            tool_responses: {
-                [x: string]: {
-                    [x: string]: unknown;
-                }[];
-            };
-        } | {
-            name: "trace";
-            description: string;
-            trace_id?: string | null | undefined;
-            start_time?: number | null | undefined;
-            duration_seconds?: number | null | undefined;
-            steps: {
-                [x: string]: unknown;
-            }[];
-        } | {
-            name: "compaction";
-            description: string;
-            tool_args: {
-                source_conversation_ext_id?: string | null | undefined;
-                source_leaf_message_ext_id?: string | null | undefined;
-                messages_summarized?: number | null | undefined;
-                tokens_above?: number | null | undefined;
-                tokens_summary?: number | null | undefined;
-                model_used?: string | null | undefined;
-            };
-            tool_responses: {
-                [x: string]: string;
-            };
-        } | {
-            name: "personal_agent";
-            description: string;
-            tool_args: {
-                task: string;
-            };
-            tool_responses: {
-                [x: string]: unknown;
-            };
-        } | {
-            name: "stream_events";
-            events: {
-                [x: string]: unknown;
-            }[];
-        } | {
-            name: "memory";
-            description: string;
-            tool_responses: {
-                written: string[];
-                superseded: string[];
-            };
-        };
-    } | undefined;
-    config_ext_id?: string | null | undefined;
-    shared: boolean;
-    tokens: number;
-    status: string;
-    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;
-}>;
-
-type conversations_ConversationImportResponse = ConversationImportResponse;
-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_importConversations: typeof importConversations;
-declare const conversations_listConversations: typeof listConversations;
-declare const conversations_shareConversation: typeof shareConversation;
-declare const conversations_updateConversationTitle: typeof updateConversationTitle;
-declare namespace conversations {
-  export { type conversations_ConversationImportResponse as ConversationImportResponse, conversations_deleteConversation as deleteConversation, conversations_deleteMessage as deleteMessage, conversations_getConversationThreads as getConversationThreads, conversations_getMessage as getMessage, conversations_importConversations as importConversations, conversations_listConversations as listConversations, conversations_shareConversation as shareConversation, conversations_updateConversationTitle as updateConversationTitle };
-}
-
-/**
- * Document-tag (doctag) operations — assign, remove, generate.
- */
-
-type CitationData = components['schemas']['CitationData'];
-declare function assignDocTags(arbi: ArbiClient, tagId: string, docIds: string[], note?: string | null): Promise<{
-    doc_ext_id: string;
-    tag_ext_id: string;
-    note?: string | null | undefined;
-    citations?: {
-        [x: string]: {
-            chunk_ids: string[];
-            scores: number[];
-            statement: string;
-            offset_start: number;
-            offset_end: number;
-        };
-    } | null | undefined;
-    created_by_ext_id: string;
-    updated_by_ext_id?: string | null | undefined;
-    created_at: string;
-    updated_at: string;
-}[]>;
-declare function removeDocTags(arbi: ArbiClient, tagId: string, docIds: string[]): Promise<void>;
-declare function updateDocTag(arbi: ArbiClient, tagId: string, docId: string, updates: {
-    note?: string | null;
-    citations?: Record<string, CitationData> | null;
-}): Promise<{
-    doc_ext_id: string;
-    tag_ext_id: string;
-    note?: string | null | undefined;
-    citations?: {
-        [x: string]: {
-            chunk_ids: string[];
-            scores: number[];
-            statement: string;
-            offset_start: number;
-            offset_end: number;
-        };
-    } | null | undefined;
-    created_by_ext_id: string;
-    updated_by_ext_id?: string | null | undefined;
-    created_at: string;
-    updated_at: string;
-}>;
-declare function generateDocTags(arbi: ArbiClient, tagIds: string[], docIds: string[]): Promise<{
-    doc_ext_ids: string[];
-    tag_ext_ids: string[];
+declare function updateConversationTitle(arbi: ArbiClient, conversationId: string, title: string): Promise<{
+    detail: string;
+    title: 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 };
-}
-
-/**
- * Direct message / notification operations — list, send, mark read, delete.
- *
- * All message content is E2E encrypted using ECDH (X25519 + XSalsa20-Poly1305).
- * Encryption keys are derived from the user's Ed25519 signing keypair.
- */
-
-type NotificationResponse = components['schemas']['NotificationResponse'];
-/**
- * Everything needed to encrypt/decrypt DMs.
- * Derive once per session, pass to all DM operations.
- */
-interface DmCryptoContext {
-    /** User's X25519 encryption keypair (derived from Ed25519 signing key) */
-    encryptionKeypair: KeyPair;
-    /** User's own external_id (to determine send vs receive direction) */
-    userExtId: string;
-}
-/**
- * Create a DM crypto context from a signing private key.
- *
- * @param arbi - ArbiClient instance (provides crypto utilities)
- * @param signingPrivateKeyBytes - Ed25519 signing private key (64 bytes)
- * @param userExtId - Current user's external_id
- */
-declare function createDmCryptoContext(arbi: ArbiClient, signingPrivateKeyBytes: Uint8Array, userExtId: string): DmCryptoContext;
-/**
- * Encrypt a plaintext message for a recipient.
- *
- * @param arbi - ArbiClient instance
- * @param plaintext - Message content to encrypt
- * @param recipientEncryptionPubKeyBase64 - Recipient's X25519 public key (base64)
- * @param senderEncryptionSecretKey - Sender's X25519 secret key (Uint8Array)
- * @returns Base64-encoded ciphertext (nonce prepended)
- */
-declare function encryptDmContent(arbi: ArbiClient, plaintext: string, recipientEncryptionPubKeyBase64: string, senderEncryptionSecretKey: Uint8Array): Promise<string>;
-/**
- * Decrypt an encrypted notification message.
- *
- * Uses the sender/recipient public keys embedded in NotificationResponse
- * to determine the "other party" for ECDH decryption.
- *
- * @param arbi - ArbiClient instance
- * @param notification - The notification with encrypted content
- * @param crypto - DM crypto context for the current user
- * @returns Decrypted plaintext, or null if content is empty
- * @throws Error if decryption fails (wrong keys or tampered message)
- */
-declare function decryptDmContent(arbi: ArbiClient, notification: NotificationResponse, crypto: DmCryptoContext): Promise<string | null>;
-/**
- * Decrypt a batch of notifications, replacing content in-place.
- * Failed decryptions get content set to '[Decryption failed]'.
- *
- * @returns New array with decrypted content
- */
-declare function decryptDmBatch(arbi: ArbiClient, notifications: NotificationResponse[], crypto: DmCryptoContext): Promise<NotificationResponse[]>;
-/**
- * List DMs (raw — content is encrypted ciphertext).
- */
-declare function listDMs(arbi: ArbiClient): Promise<{
-    type: components["schemas"]["NotificationType"];
-    external_id: string;
-    sender: {
-        external_id: string;
-        parent_ext_id?: string | null | undefined;
-        email: string;
-        given_name: string;
-        family_name?: string | null | undefined;
-        picture?: string | null | undefined;
-        encryption_public_key: string;
-        is_sso: boolean;
-    };
-    recipient: {
-        external_id: string;
-        parent_ext_id?: string | null | undefined;
-        email: string;
-        given_name: string;
-        family_name?: string | null | undefined;
-        picture?: string | null | undefined;
-        encryption_public_key: string;
-        is_sso: boolean;
-    };
-    workspace_ext_id?: string | null | undefined;
-    content?: string | null | undefined;
-    read: boolean;
-    created_at: string;
-    updated_at: string;
-}[]>;
-/**
- * List and decrypt DMs in one call.
- */
-declare function listDecryptedDMs(arbi: ArbiClient, crypto: DmCryptoContext): Promise<{
-    type: components["schemas"]["NotificationType"];
-    external_id: string;
-    sender: components["schemas"]["UserResponse"];
-    recipient: components["schemas"]["UserResponse"];
-    workspace_ext_id?: string | null;
-    content?: string | null;
-    read: boolean;
-    created_at: string;
-    updated_at: string;
-}[]>;
-/**
- * Send an E2E encrypted DM.
- *
- * Encrypts plaintext content for each recipient using their public key.
- * Requires recipient public keys — fetch via contacts or user lookup first.
- *
- * @param arbi - ArbiClient instance
- * @param messages - Array of { recipient_ext_id, content (plaintext), recipient_encryption_public_key }
- * @param crypto - DM crypto context for the sender
- */
-declare function sendEncryptedDM(arbi: ArbiClient, messages: Array<{
-    recipient_ext_id: string;
+declare function getMessage(arbi: ArbiClient, messageId: string): Promise<{
+    role: "user" | "assistant" | "system";
     content: string;
-    recipient_encryption_public_key: string;
-}>, crypto: DmCryptoContext): Promise<{
-    type: components["schemas"]["NotificationType"];
-    external_id: string;
-    sender: {
-        external_id: string;
-        parent_ext_id?: string | null | undefined;
-        email: string;
-        given_name: string;
-        family_name?: string | null | undefined;
-        picture?: string | null | undefined;
-        encryption_public_key: string;
-        is_sso: boolean;
-    };
-    recipient: {
-        external_id: string;
-        parent_ext_id?: string | null | undefined;
-        email: string;
-        given_name: string;
-        family_name?: string | null | undefined;
-        picture?: string | null | undefined;
-        encryption_public_key: string;
-        is_sso: boolean;
-    };
-    workspace_ext_id?: string | null | undefined;
-    content?: string | null | undefined;
-    read: boolean;
-    created_at: string;
-    updated_at: string;
-}[]>;
-/**
- * Ask another user to grant you workspace access.
- *
- * Creates a `workspace_access_request` notification. The `content` is an
- * opaque base64 blob, E2E-encrypted with the requester↔recipient shared key
- * (same scheme as a DM), carrying the requester's live session public key
- * (`sessionPubkeyB64`) so the recipient can mint a temporary, session-scoped
- * grant, plus an optional note.
- *
- * `workspaceExtId` is optional and only meaningful for API/SDK/CLI callers who
- * already know a workspace id (obtained out-of-band); omit it and the recipient
- * picks the workspace.
- */
-declare function requestWorkspaceAccess(arbi: ArbiClient, params: {
-    recipientExtId: string;
-    recipientEncryptionPublicKey: string;
-    sessionPubkeyB64: string;
-    note?: string;
-    workspaceExtId?: string;
-}, crypto: DmCryptoContext): Promise<{
-    type: components["schemas"]["NotificationType"];
+    tools?: {
+        [x: string]: {
+            name: "model_citation";
+            description: string;
+            tool_responses: {
+                [x: string]: {
+                    chunk_ids: string[];
+                    scores: number[];
+                    statement: string;
+                    offset_start: number;
+                    offset_end: number;
+                };
+            };
+        } | {
+            name: "retrieval_chunk";
+            description: string;
+            tool_args: {
+                doc_ext_ids: string[];
+                search_mode?: ("semantic" | "keyword" | "hybrid") | null | undefined;
+            };
+            tool_responses: {
+                [x: string]: {
+                    metadata: {
+                        workspace_ext_id?: string | null | undefined;
+                        doc_ext_id?: string | null | undefined;
+                        doc_title?: string | null | undefined;
+                        chunk_id?: string | null | undefined;
+                        chunk_ext_id: string;
+                        chunk_pg_idx: number;
+                        chunk_doc_idx: number;
+                        page_number: number;
+                        score?: number | null | undefined;
+                        rerank_score?: number | null | undefined;
+                        tokens?: number | null | undefined;
+                        created_at: string;
+                        heading: boolean;
+                        bbox?: number[] | null | undefined;
+                        element_type?: string | null | undefined;
+                        heading_level?: number | null | undefined;
+                    };
+                    content: string;
+                }[];
+            };
+        } | {
+            name: "retrieval_full_context";
+            description: string;
+            tool_args: {
+                doc_ext_ids: string[];
+                from_ref?: string | null | undefined;
+                to_ref?: string | null | undefined;
+            };
+            tool_responses: {
+                [x: string]: {
+                    metadata: {
+                        workspace_ext_id?: string | null | undefined;
+                        doc_ext_id?: string | null | undefined;
+                        doc_title?: string | null | undefined;
+                        chunk_id?: string | null | undefined;
+                        chunk_ext_id: string;
+                        chunk_pg_idx: number;
+                        chunk_doc_idx: number;
+                        page_number: number;
+                        score?: number | null | undefined;
+                        rerank_score?: number | null | undefined;
+                        tokens?: number | null | undefined;
+                        created_at: string;
+                        heading: boolean;
+                        bbox?: number[] | null | undefined;
+                        element_type?: string | null | undefined;
+                        heading_level?: number | null | undefined;
+                    };
+                    content: string;
+                }[];
+            };
+        } | {
+            name: "retrieval_toc";
+            description: string;
+            tool_args: {
+                doc_ext_ids: string[];
+            };
+            tool_responses: {
+                [x: string]: {
+                    [x: string]: unknown;
+                }[];
+            };
+        } | {
+            name: "trace";
+            description: string;
+            trace_id?: string | null | undefined;
+            start_time?: number | null | undefined;
+            duration_seconds?: number | null | undefined;
+            steps: {
+                [x: string]: unknown;
+            }[];
+        } | {
+            name: "compaction";
+            description: string;
+            tool_args: {
+                source_conversation_ext_id?: string | null | undefined;
+                source_leaf_message_ext_id?: string | null | undefined;
+                messages_summarized?: number | null | undefined;
+                tokens_above?: number | null | undefined;
+                tokens_summary?: number | null | undefined;
+                model_used?: string | null | undefined;
+            };
+            tool_responses: {
+                [x: string]: string;
+            };
+        } | {
+            name: "personal_agent";
+            description: string;
+            tool_args: {
+                task: string;
+            };
+            tool_responses: {
+                [x: string]: unknown;
+            };
+        } | {
+            name: "stream_events";
+            events: {
+                [x: string]: unknown;
+            }[];
+        } | {
+            name: "memory";
+            description: string;
+            tool_responses: {
+                written: string[];
+                superseded: string[];
+            };
+        };
+    } | undefined;
+    config_ext_id?: string | null | undefined;
+    shared: boolean;
+    tokens: number;
+    status: string;
     external_id: string;
-    sender: {
-        external_id: string;
-        parent_ext_id?: string | null | undefined;
-        email: string;
-        given_name: string;
-        family_name?: string | null | undefined;
-        picture?: string | null | undefined;
-        encryption_public_key: string;
-        is_sso: boolean;
-    };
-    recipient: {
-        external_id: string;
-        parent_ext_id?: string | null | undefined;
-        email: string;
-        given_name: string;
-        family_name?: string | null | undefined;
-        picture?: string | null | undefined;
-        encryption_public_key: string;
-        is_sso: boolean;
-    };
-    workspace_ext_id?: string | null | undefined;
-    content?: string | null | undefined;
-    read: boolean;
     created_at: string;
-    updated_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;
 }>;
+
+type conversations_ConversationImportResponse = ConversationImportResponse;
+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_importConversations: typeof importConversations;
+declare const conversations_listConversations: typeof listConversations;
+declare const conversations_shareConversation: typeof shareConversation;
+declare const conversations_updateConversationTitle: typeof updateConversationTitle;
+declare namespace conversations {
+  export { type conversations_ConversationImportResponse as ConversationImportResponse, conversations_deleteConversation as deleteConversation, conversations_deleteMessage as deleteMessage, conversations_getConversationThreads as getConversationThreads, conversations_getMessage as getMessage, conversations_importConversations as importConversations, conversations_listConversations as listConversations, conversations_shareConversation as shareConversation, conversations_updateConversationTitle as updateConversationTitle };
+}
+
 /**
- * Send a plaintext DM (no encryption).
- * @deprecated Use sendEncryptedDM instead.
+ * Document-tag (doctag) operations — assign, remove, generate.
  */
-declare function sendDM(arbi: ArbiClient, messages: Array<{
-    recipient_ext_id: string;
-    content: string;
-}>): Promise<{
-    type: components["schemas"]["NotificationType"];
-    external_id: string;
-    sender: {
-        external_id: string;
-        parent_ext_id?: string | null | undefined;
-        email: string;
-        given_name: string;
-        family_name?: string | null | undefined;
-        picture?: string | null | undefined;
-        encryption_public_key: string;
-        is_sso: boolean;
-    };
-    recipient: {
-        external_id: string;
-        parent_ext_id?: string | null | undefined;
-        email: string;
-        given_name: string;
-        family_name?: string | null | undefined;
-        picture?: string | null | undefined;
-        encryption_public_key: string;
-        is_sso: boolean;
-    };
-    workspace_ext_id?: string | null | undefined;
-    content?: string | null | undefined;
-    read: boolean;
+
+type CitationData = components['schemas']['CitationData'];
+declare function assignDocTags(arbi: ArbiClient, tagId: string, docIds: string[], note?: string | null): Promise<{
+    doc_ext_id: string;
+    tag_ext_id: string;
+    note?: string | null | undefined;
+    citations?: {
+        [x: string]: {
+            chunk_ids: string[];
+            scores: number[];
+            statement: string;
+            offset_start: number;
+            offset_end: number;
+        };
+    } | null | undefined;
+    created_by_ext_id: string;
+    updated_by_ext_id?: string | null | undefined;
     created_at: string;
     updated_at: string;
 }[]>;
-declare function markRead(arbi: ArbiClient, messageIds: string[]): Promise<{
-    type: components["schemas"]["NotificationType"];
-    external_id: string;
-    sender: {
-        external_id: string;
-        parent_ext_id?: string | null | undefined;
-        email: string;
-        given_name: string;
-        family_name?: string | null | undefined;
-        picture?: string | null | undefined;
-        encryption_public_key: string;
-        is_sso: boolean;
-    };
-    recipient: {
-        external_id: string;
-        parent_ext_id?: string | null | undefined;
-        email: string;
-        given_name: string;
-        family_name?: string | null | undefined;
-        picture?: string | null | undefined;
-        encryption_public_key: string;
-        is_sso: boolean;
-    };
-    workspace_ext_id?: string | null | undefined;
-    content?: string | null | undefined;
-    read: boolean;
+declare function removeDocTags(arbi: ArbiClient, tagId: string, docIds: string[]): Promise<void>;
+declare function updateDocTag(arbi: ArbiClient, tagId: string, docId: string, updates: {
+    note?: string | null;
+    citations?: Record<string, CitationData> | null;
+}): Promise<{
+    doc_ext_id: string;
+    tag_ext_id: string;
+    note?: string | null | undefined;
+    citations?: {
+        [x: string]: {
+            chunk_ids: string[];
+            scores: number[];
+            statement: string;
+            offset_start: number;
+            offset_end: number;
+        };
+    } | null | undefined;
+    created_by_ext_id: string;
+    updated_by_ext_id?: string | null | undefined;
     created_at: string;
     updated_at: string;
-}[]>;
-declare function deleteDMs(arbi: ArbiClient, messageIds: string[]): Promise<void>;
+}>;
+declare function generateDocTags(arbi: ArbiClient, tagIds: string[], docIds: string[]): Promise<{
+    doc_ext_ids: string[];
+    tag_ext_ids: string[];
+}>;
 
-type dm_DmCryptoContext = DmCryptoContext;
-declare const dm_createDmCryptoContext: typeof createDmCryptoContext;
-declare const dm_decryptDmBatch: typeof decryptDmBatch;
-declare const dm_decryptDmContent: typeof decryptDmContent;
-declare const dm_deleteDMs: typeof deleteDMs;
-declare const dm_encryptDmContent: typeof encryptDmContent;
-declare const dm_listDMs: typeof listDMs;
-declare const dm_listDecryptedDMs: typeof listDecryptedDMs;
-declare const dm_markRead: typeof markRead;
-declare const dm_requestWorkspaceAccess: typeof requestWorkspaceAccess;
-declare const dm_sendDM: typeof sendDM;
-declare const dm_sendEncryptedDM: typeof sendEncryptedDM;
-declare namespace dm {
-  export { type dm_DmCryptoContext as DmCryptoContext, dm_createDmCryptoContext as createDmCryptoContext, dm_decryptDmBatch as decryptDmBatch, dm_decryptDmContent as decryptDmContent, dm_deleteDMs as deleteDMs, dm_encryptDmContent as encryptDmContent, dm_listDMs as listDMs, dm_listDecryptedDMs as listDecryptedDMs, dm_markRead as markRead, dm_requestWorkspaceAccess as requestWorkspaceAccess, dm_sendDM as sendDM, dm_sendEncryptedDM as sendEncryptedDM };
+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 };
 }
 
 /**
@@ -5280,4 +5468,131 @@ declare namespace responses {
   export { type responses_SubmitBackgroundQueryOptions as SubmitBackgroundQueryOptions, responses_extractResponseText as extractResponseText, responses_getResponse as getResponse, responses_submitBackgroundQuery as submitBackgroundQuery };
 }
 
-export { type SSEStreamResult as $, type AgentStepDeltaEvent as A, type MemorySearchResponse as B, type ChatSession as C, DOC_TERMINAL_STATUSES as D, type MessageLevel as E, type FormattedWsMessage as F, type MessageMetadataPayload$1 as G, type MessageQueuedEvent as H, type ReconnectableWsConnection as I, type ResolvedCitation as J, type ResponseCompletedEvent as K, type ListAllOptions as L, type MemoryResponse as M, type ResponseContentPartAddedEvent as N, type OutputTokensDetails as O, type ParsedSlashCommand as P, type QueryOptions as Q, type ReconnectOptions as R, type ResponseCreatedEvent as S, type ResponseFailedEvent as T, type ResponseOutputItemAddedEvent as U, type ResponseOutputItemDoneEvent as V, type ResponseOutputTextDeltaEvent as W, type ResponseOutputTextDoneEvent as X, type ResponseUsage as Y, type SSEEvent as Z, type SSEStreamCallbacks as _, type AgentStepEvent as a, selectWorkspaceById as a$, type SSEStreamStartData as a0, SUPPORTED_EXTENSIONS as a1, type SkillSummary as a2, type SkippedFile as a3, type TaskResponse as a4, type UpdateMemoryRequest as a5, type UpdateTaskRequest as a6, type UploadBatchResult as a7, type UploadDirectOptions as a8, type UploadDirectResult as a9, filterSkills as aA, formatAgentStepLabel as aB, formatFileSize as aC, formatStreamSummary as aD, formatUserName as aE, formatWorkspaceChoices as aF, formatWsMessage as aG, generateEncryptedWorkspaceKey as aH, generateNewWorkspaceKey as aI, getErrorCode as aJ, getErrorMessage as aK, getRawWorkspaceKey as aL, health as aM, memory as aN, parseSSEEvents as aO, parseSlashCommand as aP, parseSlashTokenInProgress as aQ, performPasswordLogin as aR, performSigningKeyLogin as aS, performSsoDeviceFlowLogin as aT, requireData as aU, requireOk as aV, resolveAuth as aW, resolveCitations as aX, resolveWorkspace as aY, responses as aZ, selectWorkspace as a_, type UploadOptions as aa, type UploadResult as ab, type UserInfo as ac, type UserInputRequestEvent as ad, type UserMessageEvent as ae, WebSocketAuthError as af, type WorkspaceContext as ag, type WsConnection as ah, agentconfig as ai, assistant as aj, authenticatedFetch as ak, buildRetrievalChunkTool as al, buildRetrievalFullContextTool as am, buildRetrievalTocTool as an, connectWebSocket as ao, connectWithReconnect as ap, consumeSSEStream as aq, contacts as ar, conversations as as, countCitations as at, createAuthenticatedClient as au, createDocumentWaiter as av, dm as aw, doctags as ax, documents as ay, files as az, Arbi as b, settings as b0, streamSSE as b1, stripCitationMarkdown as b2, summarizeCitations as b3, tags as b4, tasks as b5, workspaces as b6, ArbiApiError as c, ArbiError as d, type ArbiErrorEvent as e, type ArbiOptions as f, type ArtifactEvent as g, type AuthContext as h, type AuthHeaders as i, type AuthenticatedClient as j, type CitationSummary as k, type CliConfig as l, type CliCredentials as m, type CommandDescriptor as n, type ConfigStore as o, type ConnectOptions as p, type CreateMemoryRequest as q, type CreateTaskRequest as r, type DmCryptoContext as s, type DocNameMap as t, type DocumentListFields as u, type DocumentListOrder as v, type DocumentWaiter as w, type DocumentWaiterOptions as x, type ListPaginatedOptions as y, type MemorySearchRequest as z };
+/**
+ * Project operations — list, create, update, delete, checkout, refresh, usage.
+ */
+
+type ProjectUsageResponse = components['schemas']['ProjectUsageResponse'];
+type ProjectInvoicesResponse = components['schemas']['ProjectInvoicesResponse'];
+type UserDailyUsageResponse = components['schemas']['UserDailyUsageResponse'];
+declare function listProjects(arbi: ArbiClient): Promise<{
+    external_id: string;
+    name: string;
+    created_by: string;
+    packs: number;
+    subscription: string;
+    created_at: string;
+    quotas: {
+        storage_gb: {
+            used: number;
+            limit: number;
+        };
+        ai_credits: {
+            used: number;
+            limit: number;
+        };
+        collaborators: {
+            used: number;
+            limit: number;
+        };
+        budget_reset_at?: number | null | undefined;
+    };
+    daily_cap_per_user?: number | null | undefined;
+    price_id?: string | null | undefined;
+    plan?: string | null | undefined;
+    amount?: number | null | undefined;
+    currency?: string | null | undefined;
+    current_period_end?: number | null | undefined;
+    cancel_at_period_end?: boolean | null | undefined;
+    portal_url?: string | null | undefined;
+}[]>;
+declare function createProject(arbi: ArbiClient, name: string): Promise<{
+    external_id: string;
+    name: string;
+    created_by: string;
+    packs: number;
+    subscription: string;
+    created_at: string;
+    quotas: {
+        storage_gb: {
+            used: number;
+            limit: number;
+        };
+        ai_credits: {
+            used: number;
+            limit: number;
+        };
+        collaborators: {
+            used: number;
+            limit: number;
+        };
+        budget_reset_at?: number | null | undefined;
+    };
+    daily_cap_per_user?: number | null | undefined;
+    price_id?: string | null | undefined;
+    plan?: string | null | undefined;
+    amount?: number | null | undefined;
+    currency?: string | null | undefined;
+    current_period_end?: number | null | undefined;
+    cancel_at_period_end?: boolean | null | undefined;
+    portal_url?: string | null | undefined;
+}>;
+declare function refreshProject(arbi: ArbiClient, projectExtId: string): Promise<{
+    external_id: string;
+    name: string;
+    created_by: string;
+    packs: number;
+    subscription: string;
+    created_at: string;
+    quotas: {
+        storage_gb: {
+            used: number;
+            limit: number;
+        };
+        ai_credits: {
+            used: number;
+            limit: number;
+        };
+        collaborators: {
+            used: number;
+            limit: number;
+        };
+        budget_reset_at?: number | null | undefined;
+    };
+    daily_cap_per_user?: number | null | undefined;
+    price_id?: string | null | undefined;
+    plan?: string | null | undefined;
+    amount?: number | null | undefined;
+    currency?: string | null | undefined;
+    current_period_end?: number | null | undefined;
+    cancel_at_period_end?: boolean | null | undefined;
+    portal_url?: string | null | undefined;
+}>;
+/**
+ * AI usage + spend breakdown for a project's billing period. `monthsBack`
+ * selects the period: 0 (default) = current, 1 = previous month, etc.
+ */
+declare function getProjectUsage(arbi: ArbiClient, projectExtId: string, monthsBack?: number): Promise<ProjectUsageResponse>;
+/** List the Stripe invoices for a project's subscription. */
+declare function getProjectInvoices(arbi: ArbiClient, projectExtId: string): Promise<ProjectInvoicesResponse>;
+/**
+ * Today's deployment-wide credit spend for the current user — the number the
+ * per-user daily cap is enforced against. Pair with a project's
+ * `daily_cap_per_user` to render a "credits today" indicator.
+ */
+declare function getUserUsageToday(arbi: ArbiClient): Promise<UserDailyUsageResponse>;
+
+type projects_ProjectInvoicesResponse = ProjectInvoicesResponse;
+type projects_ProjectUsageResponse = ProjectUsageResponse;
+type projects_UserDailyUsageResponse = UserDailyUsageResponse;
+declare const projects_createProject: typeof createProject;
+declare const projects_getProjectInvoices: typeof getProjectInvoices;
+declare const projects_getProjectUsage: typeof getProjectUsage;
+declare const projects_getUserUsageToday: typeof getUserUsageToday;
+declare const projects_listProjects: typeof listProjects;
+declare const projects_refreshProject: typeof refreshProject;
+declare namespace projects {
+  export { type projects_ProjectInvoicesResponse as ProjectInvoicesResponse, type projects_ProjectUsageResponse as ProjectUsageResponse, type projects_UserDailyUsageResponse as UserDailyUsageResponse, projects_createProject as createProject, projects_getProjectInvoices as getProjectInvoices, projects_getProjectUsage as getProjectUsage, projects_getUserUsageToday as getUserUsageToday, projects_listProjects as listProjects, projects_refreshProject as refreshProject };
+}
+
+export { type ResponseUsage as $, type AgentStepDeltaEvent as A, type MemorySearchResponse as B, type ChatSession as C, DOC_TERMINAL_STATUSES as D, type MessageLevel as E, type FormattedWsMessage as F, type MessageMetadataPayload$1 as G, type MessageQueuedEvent as H, type ProjectInvoicesResponse as I, type ProjectUsageResponse as J, type ReconnectableWsConnection as K, type ListAllOptions as L, type MemoryResponse as M, type ResolvedCitation as N, type OutputTokensDetails as O, type ParsedSlashCommand as P, type QueryOptions as Q, type ReconnectOptions as R, type ResolvedRecipient as S, type ResponseCompletedEvent as T, type ResponseContentPartAddedEvent as U, type ResponseCreatedEvent as V, type ResponseFailedEvent as W, type ResponseOutputItemAddedEvent as X, type ResponseOutputItemDoneEvent as Y, type ResponseOutputTextDeltaEvent as Z, type ResponseOutputTextDoneEvent as _, type AgentStepEvent as a, requireOk as a$, type SSEEvent as a0, type SSEStreamCallbacks as a1, type SSEStreamResult as a2, type SSEStreamStartData as a3, SUPPORTED_EXTENSIONS as a4, type SkillSummary as a5, type SkippedFile as a6, type TaskResponse as a7, type UpdateMemoryRequest as a8, type UpdateTaskRequest as a9, createDocumentWaiter as aA, dm as aB, doctags as aC, documents as aD, files as aE, filterSkills as aF, formatAgentStepLabel as aG, formatFileSize as aH, formatStreamSummary as aI, formatUserName as aJ, formatWorkspaceChoices as aK, formatWsMessage as aL, generateEncryptedWorkspaceKey as aM, generateNewWorkspaceKey as aN, getErrorCode as aO, getErrorMessage as aP, getRawWorkspaceKey as aQ, health as aR, memory as aS, parseSSEEvents as aT, parseSlashCommand as aU, parseSlashTokenInProgress as aV, performPasswordLogin as aW, performSigningKeyLogin as aX, performSsoDeviceFlowLogin as aY, projects as aZ, requireData as a_, type UploadBatchResult as aa, type UploadDirectOptions as ab, type UploadDirectResult as ac, type UploadOptions as ad, type UploadResult as ae, type UserDailyUsageResponse as af, type UserInfo as ag, type UserInputRequestEvent as ah, type UserMessageEvent as ai, WebSocketAuthError as aj, type WorkspaceChronologyOut as ak, type WorkspaceContext as al, type WsConnection as am, agentconfig as an, assistant as ao, authenticatedFetch as ap, buildRetrievalChunkTool as aq, buildRetrievalFullContextTool as ar, buildRetrievalTocTool as as, connectWebSocket as at, connectWithReconnect as au, consumeSSEStream as av, contacts as aw, conversations as ax, countCitations as ay, createAuthenticatedClient as az, Arbi as b, resolveAuth as b0, resolveCitations as b1, resolveWorkspace as b2, responses as b3, selectWorkspace as b4, selectWorkspaceById as b5, settings as b6, streamSSE as b7, stripCitationMarkdown as b8, summarizeCitations as b9, tags as ba, tasks as bb, workspaces as bc, ArbiApiError as c, ArbiError as d, type ArbiErrorEvent as e, type ArbiOptions as f, type ArtifactEvent as g, type AuthContext as h, type AuthHeaders as i, type AuthenticatedClient as j, type CitationSummary as k, type CliConfig as l, type CliCredentials as m, type CommandDescriptor as n, type ConfigStore as o, type ConnectOptions as p, type CreateMemoryRequest as q, type CreateTaskRequest as r, type DmCryptoContext as s, type DocNameMap as t, type DocumentListFields as u, type DocumentListOrder as v, type DocumentWaiter as w, type DocumentWaiterOptions as x, type ListPaginatedOptions as y, type MemorySearchRequest as z };