@arbidocs/client 0.3.28 → 0.3.30

package/dist/index.d.cts

@@ -5,6 +5,177 @@ import createFetchClient, { Middleware } from 'openapi-fetch';
  * Do not make direct changes to the file.
  */
 interface paths {
+    '/v1/user/projects/': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Projects
+         * @description List all projects owned by the current user.
+         */
+        get: operations['list_projects'];
+        put?: never;
+        /**
+         * Create Project
+         * @description Create a new project.
+         */
+        post: operations['create_project'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/user/projects/{project_ext_id}': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Delete Project
+         * @description Delete a project. Only allowed when empty (no workspaces, no subscription).
+         */
+        delete: operations['delete_project'];
+        options?: never;
+        head?: never;
+        /**
+         * Update Project
+         * @description Update project name.
+         */
+        patch: operations['update_project'];
+        trace?: never;
+    };
+    '/v1/user/projects/{project_ext_id}/checkout': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create Project Checkout
+         * @description Create a Stripe checkout session for this project.
+         */
+        post: operations['create_project_checkout'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/user/projects/{project_ext_id}/change-plan': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Change Project Plan
+         * @description Change pack quantity for a project.
+         *
+         *     - Increase: proration_behavior="create_prorations" (charges difference immediately)
+         *     - Decrease: proration_behavior="none" (keeps current packs until period end)
+         */
+        post: operations['change_project_plan'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/user/projects/{project_ext_id}/refresh': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Refresh Project
+         * @description Refresh project status from Stripe (call after checkout completes).
+         */
+        post: operations['refresh_project'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/user/projects/{project_ext_id}/usage': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Project Usage Endpoint
+         * @description Get AI usage breakdown for a project's billing period.
+         */
+        get: operations['get_project_usage'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/user/projects/{project_ext_id}/invoices': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Project Invoices
+         * @description List Stripe invoices for a project's subscription.
+         */
+        get: operations['get_project_invoices'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/user/projects/{project_ext_id}/cancel': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Cancel Project Subscription
+         * @description Cancel a project's subscription at the end of the current billing period.
+         */
+        post: operations['cancel_project_subscription'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/user/verify-email': {
         parameters: {
             query?: never;
@@ -387,33 +558,6 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    '/v1/user/subscription': {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get Stripe Subscription
-         * @description Get detailed Stripe subscription information including portal URL for management.
-         *
-         *     First updates local subscription status based on Stripe subscription tier (to refresh after purchase),
-         *     then fetches detailed subscription information from Stripe Subscriptions API.
-         */
-        get: operations['get_subscription'];
-        put?: never;
-        /**
-         * Create Subscription
-         * @description Create a new Stripe checkout session for subscription purchase.
-         */
-        post: operations['create_subscription'];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     '/v1/workspace/create_protected': {
         parameters: {
             query?: never;
@@ -582,7 +726,11 @@ interface paths {
         };
         /**
          * List Documents
-         * @description List all documents in the current workspace.
+         * @description List documents in the current workspace.
+         *
+         *     By default returns all documents (no pagination) since the frontend needs
+         *     the full set for client-side sort/search/filter. Pass ``limit``/``offset``
+         *     to opt into pagination — useful for the CLI when streaming a workspace.
          */
         get: operations['list_documents'];
         put?: never;
@@ -650,8 +798,17 @@ interface paths {
          * @description Update one or more documents.
          *
          *     Special status handling:
-         *     - status="processing": Smart reprocess - reindexes if final.pklenc exists, else full re-parse.
-         *       Skips if doc was updated < 10 min ago (prevents duplicate submissions).
+         *     - status="processing": Smart reprocess — reindexes if final.pklenc exists in MinIO
+         *       (regardless of current doc.status), else full re-parse from the original file.
+         *       Skips if a fresh Redis task already exists for the doc (< 10 min old).
+         *
+         *     Batch behavior: the request handler validates + commits ORM field updates
+         *     synchronously, then hands the reprocess work off to a FastAPI background task
+         *     (dispatch_batch_reprocess). The response returns as soon as the background task
+         *     is scheduled, so a single user asking to reprocess 1000+ docs does not block
+         *     the event loop or tie up an HTTP worker. The background dispatcher fans out
+         *     requeue_document_processing calls bounded by the existing deployment-wide
+         *     _indexing_semaphore to keep other users responsive.
          */
         patch: operations['update_documents'];
         trace?: never;
@@ -708,7 +865,7 @@ interface paths {
          *     - tag_ext_id: Links document to a tag
          *     - folder: Logical folder path for grouping (URL safe, e.g., 'skills/weather')
          *
-         *     Requires active subscription (paid/trial/dev) if Stripe is configured.
+         *     Requires active subscription if Stripe is configured.
          */
         post: operations['upload_documents'];
         delete?: never;
@@ -731,7 +888,7 @@ interface paths {
          * @description Download and upload documents from URLs to a workspace with encryption.
          *     Documents are queued for processing, parsed, and indexed for vector search.
          *
-         *     Requires active subscription (paid/trial/dev) if Stripe is configured.
+         *     Requires active subscription if Stripe is configured.
          */
         post: operations['upload_from_url'];
         delete?: never;
@@ -883,7 +1040,26 @@ interface paths {
         };
         /**
          * Get Threads With Histories
-         * @description Retrieve all conversation threads (leaf messages and their histories) for a given conversation external ID.
+         * @description Retrieve all conversation threads (leaf messages and their histories).
+         *
+         *     Performance notes
+         *     -----------------
+         *     This endpoint used to issue 3+ DB round-trips per message in every
+         *     history (user_ext_id, config_ext_id, parent_ext_id) and serially decrypt
+         *     each message's tools blob on the event loop. For a conversation with N
+         *     forks of M messages each that's O(N*M) round-trips. The rewrite is
+         *     O(forks) DB calls plus three constant-count batch queries:
+         *
+         *       1. ``get_threads`` to find leaf message ids
+         *       2. one ``get_conversation_history`` recursive CTE per leaf
+         *       3. one batched user-ext-id query (across every message in every fork)
+         *       4. one batched configuration-ext-id query
+         *       5. one ``asyncio.gather`` over ``decrypt_tools_async`` so blobs decrypt
+         *          in parallel on worker threads instead of one-at-a-time on the loop
+         *
+         *     Parent message ext_ids are read off the already-fetched message set —
+         *     parents are by definition ancestors of leaves, so they're always in the
+         *     history we just loaded. No extra query.
          */
         get: operations['get_conversation_threads'];
         put?: never;
@@ -996,7 +1172,7 @@ interface paths {
          * @description Process a user query against documents in a workspace.
          *     Performs retrieval augmented generation with streaming response.
          *
-         *     Requires active subscription (paid/trial/dev) if Stripe is configured.
+         *     Requires active project if Stripe is configured.
          */
         post: operations['generate'];
         delete?: never;
@@ -1128,6 +1304,35 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/health/metrics': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Metrics
+         * @description Live operational metrics for this instance (developer-only).
+         *
+         *     Returns a structured snapshot of DB pool utilisation, in-process
+         *     semaphores (embedder, reranker, indexing, qdrant, doctag_llm, etc.),
+         *     Redis queue backpressure for this deployment, and the current
+         *     asyncio task count. Same data the periodic concurrency_monitor
+         *     logger emits, but as JSON for dashboards / probes / tests.
+         *
+         *     Gated to developer accounts because the payload exposes internal
+         *     pool sizes and saturation — useful for recon if leaked to end users.
+         */
+        get: operations['get_metrics'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/tag/list': {
         parameters: {
             query?: never;
@@ -1229,10 +1434,10 @@ interface paths {
         };
         /**
          * Get Notifications
-         * @description Retrieve all notifications for the current user.
+         * @description Retrieve notifications for the current user, newest first.
          *
-         *     Returns notifications ordered by most recent first.
-         *     Bilateral model: user sees notifications they sent OR received.
+         *     Bilateral model: user sees notifications they sent OR received. Capped at
+         *     ``limit`` (default 100) so the response stays small for chatty users.
          *     Use POST /notifications/read to mark specific notifications as read.
          */
         get: operations['get_notifications'];
@@ -1832,6 +2037,33 @@ interface components {
              */
             AGENT_SYSTEM_PROMPT: string;
         };
+        /** AgentsUserConfig */
+        AgentsUserConfig: {
+            /**
+             * Enabled
+             * @description Whether to use agents mode for queries.
+             * @default true
+             */
+            ENABLED: boolean;
+            /**
+             * Memory Enabled
+             * @description Run memory synthesis (skills, memories) after agent queries.
+             * @default false
+             */
+            MEMORY_ENABLED: boolean;
+            /**
+             * Persona
+             * @description Agent persona prepended to the system prompt. Customise to change the agent's identity and tone.
+             * @default You are ARBI, an AI assistant created by ARBI CITY. Be proactive, helpful and professional.
+             */
+            PERSONA: string;
+            /**
+             * Agent Model Name
+             * @description The name of the model to be used for the agent decision-making.
+             * @default auto
+             */
+            AGENT_MODEL_NAME: string;
+        };
         /** AllConfigs */
         AllConfigs: {
             /**
@@ -1944,6 +2176,8 @@ interface components {
              *       "TEMPERATURE": 0.1,
              *       "MAX_TOKENS": 2000,
              *       "MAX_CONCURRENT_DOCS": 10,
+             *       "AUTO_RENAME": false,
+             *       "AUTO_RENAME_INSTRUCTION": "Create a short substantive title for the document of no more than 10 words. E.g. \"Email from X to Y re ABC\", \"Service Agreement between A and B\".",
              *       "DEFAULT_METADATA_TAGS": [
              *         {
              *           "instruction": "What is the primary date of this document (creation date, signing date, or effective date)? Identify the most significant date such as the document's creation, signing, or effective date.",
@@ -2080,7 +2314,7 @@ interface components {
              * @default {
              *       "MIN_SCORE": 0.01,
              *       "MAX_NUMB_OF_CHUNKS": 30,
-             *       "MAX_CONCURRENT_REQUESTS": 64,
+             *       "MAX_CONCURRENT_REQUESTS": 256,
              *       "MODEL_NAME": "Qwen/Qwen3-Reranker-0.6B",
              *       "API_TYPE": "remote",
              *       "RETRIEVAL_INSTRUCTION": "Judge whether the passage contains the specific facts, figures, names, or references mentioned in the query. Only answer yes if the passage directly contains these details"
@@ -2106,7 +2340,7 @@ interface components {
              *       "MODEL_NAME": "Qwen/Qwen3-Embedding-0.6B",
              *       "API_TYPE": "remote",
              *       "BATCH_SIZE": 128,
-             *       "MAX_CONCURRENT_REQUESTS": 64,
+             *       "MAX_CONCURRENT_REQUESTS": 256,
              *       "DOCUMENT_PREFIX": "",
              *       "QUERY_PREFIX": "Instruct: Represent the user search query for retrieving relevant documents.\nQuery:"
              *     }
@@ -2895,22 +3129,6 @@ interface components {
              */
             query: string;
         };
-        /**
-         * CreateSubscriptionRequest
-         * @description Request to create a new subscription checkout session.
-         */
-        CreateSubscriptionRequest: {
-            /** Price Id */
-            price_id: string;
-        };
-        /**
-         * CreateSubscriptionResponse
-         * @description Response containing Stripe checkout session client secret.
-         */
-        CreateSubscriptionResponse: {
-            /** Client Secret */
-            client_secret: string;
-        };
         /**
          * CreateTagRequest
          * @description Request to create a new tag in a workspace.
@@ -2926,6 +3144,36 @@ interface components {
             /** Parent Ext Id */
             parent_ext_id?: string | null;
         };
+        /**
+         * DailyUsage
+         * @description Usage for a single day.
+         */
+        DailyUsage: {
+            /** Date */
+            date: string;
+            /**
+             * Spend
+             * @default 0
+             */
+            spend: number;
+            /**
+             * Total Tokens
+             * @default 0
+             */
+            total_tokens: number;
+            /**
+             * Api Requests
+             * @default 0
+             */
+            api_requests: number;
+            /**
+             * Model Groups
+             * @default {}
+             */
+            model_groups: {
+                [key: string]: components['schemas']['ModelGroupUsage'];
+            };
+        };
         /**
          * DeleteAgentsRequest
          * @description Request to delete agents by external ID.
@@ -3007,6 +3255,8 @@ interface components {
             file_name?: string | null;
             /** Status */
             status?: string | null;
+            /** Error Message */
+            error_message?: string | null;
             /** N Pages */
             n_pages?: number | null;
             /** N Chunks */
@@ -3122,9 +3372,14 @@ interface components {
             content?: string | null;
             /**
              * Folder
-             * @description Logical folder path (URL safe)
+             * @description Logical folder path — preserved as-is for e-discovery (Unicode, spaces allowed)
              */
             folder?: string | null;
+            /**
+             * Config Ext Id
+             * @description Configuration to use for reprocessing. If provided, overrides the document's stored config.
+             */
+            config_ext_id?: string | null;
         };
         /**
          * DoctagLLMConfig
@@ -3186,57 +3441,43 @@ interface components {
              * @default 10
              */
             MAX_CONCURRENT_DOCS: number;
+            /**
+             * Auto Rename
+             * @description Generate a descriptive document title via LLM instead of using the filename. The generated title replaces the filename-derived title in doc_metadata.
+             * @default false
+             */
+            AUTO_RENAME: boolean;
+            /**
+             * Auto Rename Instruction
+             * @description Instruction for generating document titles when AUTO_RENAME is enabled.
+             * @default Create a short substantive title for the document of no more than 10 words. E.g. "Email from X to Y re ABC", "Service Agreement between A and B".
+             */
+            AUTO_RENAME_INSTRUCTION: string;
             /**
              * Default Metadata Tags
-             * @description Metadata templates used for automatic document metadata extraction during indexing.
-             * @default [
-             *       {
-             *         "name": "doc_date",
-             *         "instruction": "What is the primary date of this document (creation date, signing date, or effective date)? Identify the most significant date such as the document's creation, signing, or effective date.",
-             *         "tag_type": {
-             *           "options": [],
-             *           "type": "date"
-             *         }
-             *       },
-             *       {
-             *         "name": "doc_nature",
-             *         "instruction": "What is the Document type (select one):",
-             *         "tag_type": {
-             *           "options": [
-             *             "Agreement",
-             *             "Email",
-             *             "Letter",
-             *             "Report",
-             *             "Decision",
-             *             "Memo",
-             *             "Financial",
-             *             "Form",
-             *             "Index",
-             *             "Submission",
-             *             "Other"
-             *           ],
-             *           "type": "select"
-             *         }
-             *       },
-             *       {
-             *         "name": "doc_author",
-             *         "instruction": "Who is the author or creator of this document? If there are multiple authors, list up to 3 followed by 'et al.' if more exist.",
-             *         "tag_type": {
-             *           "options": [],
-             *           "type": "text"
-             *         }
-             *       },
-             *       {
-             *         "name": "doc_subject",
-             *         "instruction": "What is the main subject or purpose of this document? Provide a brief 1-2 sentence description.",
-             *         "tag_type": {
-             *           "options": [],
-             *           "type": "text"
-             *         }
-             *       }
-             *     ]
+             * @description Metadata templates used for automatic document metadata extraction during indexing. Built-in tags cannot be removed; additional tags may be appended.
              */
-            DEFAULT_METADATA_TAGS: components['schemas']['TagTemplate'][];
+            DEFAULT_METADATA_TAGS?: components['schemas']['TagTemplate'][];
+        };
+        /** DoctagLLMUserConfig */
+        DoctagLLMUserConfig: {
+            /**
+             * Auto Rename
+             * @description Generate a descriptive document title via LLM instead of using the filename. The generated title replaces the filename-derived title in doc_metadata.
+             * @default false
+             */
+            AUTO_RENAME: boolean;
+            /**
+             * Auto Rename Instruction
+             * @description Instruction for generating document titles when AUTO_RENAME is enabled.
+             * @default Create a short substantive title for the document of no more than 10 words. E.g. "Email from X to Y re ABC", "Service Agreement between A and B".
+             */
+            AUTO_RENAME_INSTRUCTION: string;
+            /**
+             * Default Metadata Tags
+             * @description Metadata templates used for automatic document metadata extraction during indexing. Built-in tags cannot be removed; additional tags may be appended.
+             */
+            DEFAULT_METADATA_TAGS?: components['schemas']['TagTemplate'][];
         };
         /** EmbedderConfig */
         EmbedderConfig: {
@@ -3261,8 +3502,8 @@ interface components {
             BATCH_SIZE: number;
             /**
              * Max Concurrent Requests
-             * @description Adjust concurrency level as needed.
-             * @default 64
+             * @description Deployment-wide in-flight embedder requests — sized for ~5 replicas * ~50 concurrent each.
+             * @default 256
              */
             MAX_CONCURRENT_REQUESTS: number;
             /**
@@ -4004,13 +4245,56 @@ interface components {
                 [key: string]: components['schemas']['CitationData'];
             };
         };
-        /** ModelInfo */
-        ModelInfo: {
-            /** Model Name */
-            model_name: string;
-            /** Api Type */
-            api_type: string;
-            /** Tags */
+        /**
+         * ModelGroupUsage
+         * @description Usage metrics for a model group (e.g. Fast, Wise, Premium) with per-model detail.
+         */
+        ModelGroupUsage: {
+            /**
+             * Spend
+             * @default 0
+             */
+            spend: number;
+            /**
+             * Prompt Tokens
+             * @default 0
+             */
+            prompt_tokens: number;
+            /**
+             * Completion Tokens
+             * @default 0
+             */
+            completion_tokens: number;
+            /**
+             * Total Tokens
+             * @default 0
+             */
+            total_tokens: number;
+            /**
+             * Successful Requests
+             * @default 0
+             */
+            successful_requests: number;
+            /**
+             * Failed Requests
+             * @default 0
+             */
+            failed_requests: number;
+            /**
+             * Models
+             * @default {}
+             */
+            models: {
+                [key: string]: components['schemas']['ModelUsage'];
+            };
+        };
+        /** ModelInfo */
+        ModelInfo: {
+            /** Model Name */
+            model_name: string;
+            /** Api Type */
+            api_type: string;
+            /** Tags */
             tags?: string[] | null;
             /** Max Input Tokens */
             max_input_tokens?: number | null;
@@ -4042,6 +4326,42 @@ interface components {
             /** Detail */
             detail?: string | null;
         };
+        /**
+         * ModelUsage
+         * @description Usage metrics for a single model.
+         */
+        ModelUsage: {
+            /**
+             * Spend
+             * @default 0
+             */
+            spend: number;
+            /**
+             * Prompt Tokens
+             * @default 0
+             */
+            prompt_tokens: number;
+            /**
+             * Completion Tokens
+             * @default 0
+             */
+            completion_tokens: number;
+            /**
+             * Total Tokens
+             * @default 0
+             */
+            total_tokens: number;
+            /**
+             * Successful Requests
+             * @default 0
+             */
+            successful_requests: number;
+            /**
+             * Failed Requests
+             * @default 0
+             */
+            failed_requests: number;
+        };
         /** ModelsHealthStatus */
         ModelsHealthStatus: {
             /** Application */
@@ -4054,15 +4374,11 @@ interface components {
             /** Models */
             models: components['schemas']['ModelInfo'][];
         };
-        /**
-         * NonDeveloperConfig
-         * @description Limited configuration response for non-developer users
-         */
+        /** NonDeveloperConfig */
         NonDeveloperConfig: {
-            /** Agents */
-            Agents: {
-                [key: string]: string | boolean;
-            };
+            Agents: components['schemas']['AgentsUserConfig'];
+            DoctagLLM: components['schemas']['DoctagLLMUserConfig'];
+            Parser: components['schemas']['ParserUserConfig'];
         };
         /**
          * NotificationResponse
@@ -4238,6 +4554,15 @@ interface components {
              */
             SKIP_DUPLICATES: boolean;
         };
+        /** ParserUserConfig */
+        ParserUserConfig: {
+            /**
+             * Skip Duplicates
+             * @description Skip files with identical content already in the workspace.
+             * @default false
+             */
+            SKIP_DUPLICATES: boolean;
+        };
         /**
          * PersonalAgentDetail
          * @description Detail for a personal_agent tool call.
@@ -4377,6 +4702,16 @@ interface components {
             /** Timestamp */
             timestamp: string;
         };
+        /**
+         * PriceTier
+         * @description Stripe volume pricing tier.
+         */
+        PriceTier: {
+            /** Up To */
+            up_to?: number | null;
+            /** Unit Amount */
+            unit_amount: number;
+        };
         /**
          * ProductPrice
          * @description Stripe product price information.
@@ -4385,7 +4720,7 @@ interface components {
             /** Price Id */
             price_id: string;
             /** Amount */
-            amount: number;
+            amount?: number | null;
             /** Currency */
             currency: string;
             /** Interval */
@@ -4394,6 +4729,13 @@ interface components {
             interval_count: number;
             /** Default Price */
             default_price: boolean;
+            /**
+             * Billing Scheme
+             * @default per_unit
+             */
+            billing_scheme: string;
+            /** Tiers */
+            tiers?: components['schemas']['PriceTier'][] | null;
         };
         /**
          * ProductResponse
@@ -4409,6 +4751,202 @@ interface components {
             /** Prices */
             prices: components['schemas']['ProductPrice'][];
         };
+        /**
+         * ProjectCheckoutRequest
+         * @description Create a Stripe checkout session for this project.
+         */
+        ProjectCheckoutRequest: {
+            /** Price Id */
+            price_id: string;
+            /**
+             * Quantity
+             * @description Number of Pro Packs
+             * @default 1
+             */
+            quantity: number;
+            /**
+             * Promo Code
+             * @description Promo code to auto-apply
+             */
+            promo_code?: string | null;
+        };
+        /**
+         * ProjectCheckoutResponse
+         * @description Stripe checkout session client secret.
+         */
+        ProjectCheckoutResponse: {
+            /** Client Secret */
+            client_secret: string;
+        };
+        /**
+         * ProjectCreateRequest
+         * @description Create a new project.
+         */
+        ProjectCreateRequest: {
+            /** Name */
+            name: string;
+        };
+        /**
+         * ProjectInvoice
+         * @description Single Stripe invoice/receipt for a project.
+         */
+        ProjectInvoice: {
+            /** Date */
+            date: string;
+            /** Amount */
+            amount: number;
+            /** Currency */
+            currency: string;
+            /** Status */
+            status: string;
+            /** Url */
+            url?: string | null;
+            /** Pdf Url */
+            pdf_url?: string | null;
+        };
+        /**
+         * ProjectInvoicesResponse
+         * @description Invoices for a project subscription.
+         */
+        ProjectInvoicesResponse: {
+            /** Project Ext Id */
+            project_ext_id: string;
+            /**
+             * Invoices
+             * @default []
+             */
+            invoices: components['schemas']['ProjectInvoice'][];
+        };
+        /**
+         * ProjectQuotas
+         * @description All quota metrics for a project, derived from packs.
+         */
+        ProjectQuotas: {
+            storage_gb: components['schemas']['QuotaUsage'];
+            ai_credits: components['schemas']['QuotaUsage'];
+            collaborators: components['schemas']['QuotaUsage'];
+            /** Budget Reset At */
+            budget_reset_at?: number | null;
+        };
+        /**
+         * ProjectResponse
+         * @description Project summary returned in list and detail views.
+         */
+        ProjectResponse: {
+            /** External Id */
+            external_id: string;
+            /** Name */
+            name: string;
+            /** Packs */
+            packs: number;
+            /** Subscription */
+            subscription: string;
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+            quotas: components['schemas']['ProjectQuotas'];
+            /** Price Id */
+            price_id?: string | null;
+            /** Plan */
+            plan?: string | null;
+            /** Amount */
+            amount?: number | null;
+            /** Currency */
+            currency?: string | null;
+            /** Current Period End */
+            current_period_end?: number | null;
+            /** Cancel At Period End */
+            cancel_at_period_end?: boolean | null;
+            /** Portal Url */
+            portal_url?: string | null;
+        };
+        /**
+         * ProjectUpdateRequest
+         * @description Update project name.
+         */
+        ProjectUpdateRequest: {
+            /** Name */
+            name?: string | null;
+        };
+        /**
+         * ProjectUpgradeRequest
+         * @description Change pack quantity on an existing project.
+         */
+        ProjectUpgradeRequest: {
+            /** Price Id */
+            price_id: string;
+            /** Quantity */
+            quantity: number;
+            /**
+             * Proration Behavior
+             * @default create_prorations
+             */
+            proration_behavior: string;
+        };
+        /**
+         * ProjectUsageResponse
+         * @description Usage breakdown for a project's billing period.
+         */
+        ProjectUsageResponse: {
+            /** Project Ext Id */
+            project_ext_id: string;
+            /** Period Start */
+            period_start: string;
+            /** Period End */
+            period_end: string;
+            /**
+             * Total Spend
+             * @default 0
+             */
+            total_spend: number;
+            /**
+             * Total Tokens
+             * @default 0
+             */
+            total_tokens: number;
+            /**
+             * Total Requests
+             * @default 0
+             */
+            total_requests: number;
+            /**
+             * Daily
+             * @default []
+             */
+            daily: components['schemas']['DailyUsage'][];
+            /**
+             * Model Groups
+             * @default {}
+             */
+            model_groups: {
+                [key: string]: components['schemas']['ModelGroupUsage'];
+            };
+            /**
+             * By Workspace
+             * @default {}
+             */
+            by_workspace: {
+                [key: string]: components['schemas']['TagBreakdown'];
+            };
+            /**
+             * By User
+             * @default {}
+             */
+            by_user: {
+                [key: string]: components['schemas']['TagBreakdown'];
+            };
+            /**
+             * By Feature
+             * @default {}
+             */
+            by_feature: {
+                [key: string]: components['schemas']['TagBreakdown'];
+            };
+            /** Invoice Pdf */
+            invoice_pdf?: string | null;
+        };
         /** QueryLLMConfig */
         QueryLLMConfig: {
             /**
@@ -4455,6 +4993,16 @@ interface components {
              */
             MAX_TOKENS: number;
         };
+        /**
+         * QuotaUsage
+         * @description Single quota metric: current usage vs limit.
+         */
+        QuotaUsage: {
+            /** Used */
+            used: number;
+            /** Limit */
+            limit: number;
+        };
         /**
          * ReadDocumentDetail
          * @description Detail for a read_document tool call.
@@ -4583,8 +5131,8 @@ interface components {
             MAX_NUMB_OF_CHUNKS: number;
             /**
              * Max Concurrent Requests
-             * @description Maximum number of concurrent reranking requests.
-             * @default 64
+             * @description Deployment-wide in-flight reranker requests — sized for ~5 replicas * ~50 concurrent each.
+             * @default 256
              */
             MAX_CONCURRENT_REQUESTS: number;
             /**
@@ -5631,6 +6179,16 @@ interface components {
              */
             detail: string;
         };
+        /**
+         * SkippedFile
+         * @description A file that was skipped during upload with the reason.
+         */
+        SkippedFile: {
+            /** File Name */
+            file_name: string;
+            /** Reason */
+            reason: string;
+        };
         /**
          * StepUsage
          * @description Per-step token usage from a single LLM call.
@@ -5684,54 +6242,9 @@ interface components {
         SubscriptionInfo: {
             /**
              * Status
-             * @default restricted
+             * @default active
              */
             status: string;
-            /** Trial Expires */
-            trial_expires?: number | null;
-        };
-        /**
-         * SubscriptionStatusResponse
-         * @description Subscription status response - unified model for all subscription states.
-         *
-         *     Status is one of the tier names configured in STRIPE_TIERS, plus system tiers:
-         *     - Paid tiers (e.g., "pro", "pro_plus"): Active Stripe subscription
-         *     - "trial": User is on trial (has trial_expires, days_remaining)
-         *     - "dev": Developer access
-         *     - "restricted": No access (trial expired or no subscription)
-         *     - "inactive": Expired/canceled/unpaid Stripe subscription
-         */
-        SubscriptionStatusResponse: {
-            /** Status */
-            status: string;
-            /** Trial Expires */
-            trial_expires?: number | null;
-            /** Days Remaining */
-            days_remaining?: number | null;
-            /** Price Id */
-            price_id?: string | null;
-            /** Plan */
-            plan?: string | null;
-            /** Amount */
-            amount?: number | null;
-            /** Currency */
-            currency?: string | null;
-            /** Current Period End */
-            current_period_end?: number | null;
-            /** Cancel At Period End */
-            cancel_at_period_end?: boolean | null;
-            /** Portal Url */
-            portal_url?: string | null;
-            /** Spend */
-            spend?: number | null;
-            /** Max Budget */
-            max_budget?: number | null;
-            /** Budget Reset At */
-            budget_reset_at?: number | null;
-            /** Total Files Mb */
-            total_files_mb?: number | null;
-            /** Storage Quota Mb */
-            storage_quota_mb?: number | null;
         };
         /**
          * SummariseLLMConfig
@@ -5816,6 +6329,27 @@ interface components {
             /** Columns */
             columns: string[];
         };
+        /**
+         * TagBreakdown
+         * @description Spend/token breakdown keyed by tag value (e.g. wrk-xxx, usr-xxx).
+         */
+        TagBreakdown: {
+            /**
+             * Spend
+             * @default 0
+             */
+            spend: number;
+            /**
+             * Total Tokens
+             * @default 0
+             */
+            total_tokens: number;
+            /**
+             * Requests
+             * @default 0
+             */
+            requests: number;
+        };
         /**
          * TagFormat
          * @description Tag format configuration stored as JSONB.
@@ -5902,7 +6436,7 @@ interface components {
              * Status
              * @enum {string}
              */
-            status: 'queued' | 'parsing' | 'encrypting' | 'indexing' | 'analysing' | 'completed' | 'failed' | 'skipped';
+            status: 'queued' | 'parsing' | 'encrypting' | 'indexing' | 'analysing' | 'completed' | 'failed' | 'skipped' | 'empty';
             /** Progress */
             progress: number;
         };
@@ -6123,14 +6657,6 @@ interface components {
                 [key: string]: unknown;
             }[];
         };
-        /**
-         * TrialUpdate
-         * @description Trial update - only trial_expires can be set, and only if currently null.
-         */
-        TrialUpdate: {
-            /** Trial Expires */
-            trial_expires?: number | null;
-        };
         /**
          * UpdateDocTagRequest
          * @description Update a doctag's note or citations. Identified by (tag_ext_id, doc_ext_id) pair.
@@ -6191,17 +6717,22 @@ interface components {
          * UploadDocumentsResponse
          * @description Response for document upload operations.
          *
-         *     Returns array of document IDs in the same order as uploaded files.
-         *     Includes duplicate warnings for files with identical content already in workspace.
+         *     Returns array of document IDs for successfully uploaded files.
+         *     Files that fail validation are skipped and listed with reasons.
          */
         UploadDocumentsResponse: {
             /** Doc Ext Ids */
-            doc_ext_ids: string[];
+            doc_ext_ids?: string[];
+            /**
+             * Batch Id
+             * @description Batch ID for tracking completion via WebSocket batch_complete events
+             */
+            batch_id?: string | null;
             /**
-             * Duplicates
-             * @description Doc IDs that have identical content to existing documents in the workspace
+             * Skipped
+             * @description Files that were skipped during upload with reasons
              */
-            duplicates?: string[];
+            skipped?: components['schemas']['SkippedFile'][];
         };
         /**
          * UserInputBody
@@ -6340,6 +6871,8 @@ interface components {
             subscription?: components['schemas']['SubscriptionInfo'] | null;
             /** Last Workspace */
             last_workspace?: string | null;
+            /** Last Config */
+            last_config?: string | null;
             /**
              * Pinned Workspaces
              * @default []
@@ -6370,11 +6903,6 @@ interface components {
              * @default false
              */
             show_thread_visualization: boolean;
-            /**
-             * Show Smart Search
-             * @default false
-             */
-            show_smart_search: boolean;
             /**
              * Show Security Settings
              * @default false
@@ -6425,12 +6953,8 @@ interface components {
         /**
          * UserSettingsUpdate
          * @description User settings update request - allows partial updates.
-         *
-         *     Note: stripe_customer_id and status are not patchable.
-         *     trial_expires can only be set once (to start trial).
          */
         UserSettingsUpdate: {
-            subscription?: components['schemas']['TrialUpdate'] | null;
             /** Pinned Workspaces */
             pinned_workspaces?: string[] | null;
             /** Pinned Templates */
@@ -6441,8 +6965,6 @@ interface components {
             show_document_navigator?: boolean | null;
             /** Show Thread Visualization */
             show_thread_visualization?: boolean | null;
-            /** Show Smart Search */
-            show_smart_search?: boolean | null;
             /** Show Security Settings */
             show_security_settings?: boolean | null;
             /** Show Invite Tab */
@@ -6638,6 +7160,8 @@ interface components {
             is_public: boolean;
             /** Workspace Key */
             workspace_key: string;
+            /** Project Ext Id */
+            project_ext_id: string;
         };
         /**
          * WorkspaceOpenRequest
@@ -6719,6 +7243,14 @@ interface components {
              * @default []
              */
             users: components['schemas']['WorkspaceUserResponse'][];
+            /** Project Ext Id */
+            project_ext_id?: string | null;
+            /** Project Name */
+            project_name?: string | null;
+            /** Project Subscription */
+            project_subscription?: string | null;
+            /** Project Owner Ext Id */
+            project_owner_ext_id?: string | null;
         };
         /**
          * WorkspaceRole
@@ -6734,6 +7266,8 @@ interface components {
             description?: string | null;
             /** Is Public */
             is_public?: boolean | null;
+            /** Project Ext Id */
+            project_ext_id?: string | null;
         };
         /**
          * WorkspaceUserResponse
@@ -6777,18 +7311,14 @@ interface components {
 }
 type $defs = Record<string, never>;
 interface operations {
-    verify_email: {
+    list_projects: {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                'application/json': components['schemas']['VerifyEmailRequest'];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description Successful Response */
             200: {
@@ -6796,16 +7326,338 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['VerifyEmailResponse'];
-                };
-            };
-            /** @description Validation Error */
-            422: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['HTTPValidationError'];
+                    'application/json': components['schemas']['ProjectResponse'][];
+                };
+            };
+        };
+    };
+    create_project: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['ProjectCreateRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ProjectResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    delete_project: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                project_ext_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    update_project: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                project_ext_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['ProjectUpdateRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ProjectResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    create_project_checkout: {
+        parameters: {
+            query?: never;
+            header?: {
+                origin?: string;
+                referer?: string;
+                'x-frontend-origin'?: string;
+            };
+            path: {
+                project_ext_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['ProjectCheckoutRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ProjectCheckoutResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    change_project_plan: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                project_ext_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['ProjectUpgradeRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ProjectResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    refresh_project: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                project_ext_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ProjectResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    get_project_usage: {
+        parameters: {
+            query?: {
+                /** @description 0 = current billing period, 1 = previous month, etc. */
+                months_back?: number;
+            };
+            header?: never;
+            path: {
+                project_ext_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ProjectUsageResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    get_project_invoices: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                project_ext_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ProjectInvoicesResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    cancel_project_subscription: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                project_ext_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ProjectResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    verify_email: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['VerifyEmailRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['VerifyEmailResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
                 };
             };
         };
@@ -7310,61 +8162,6 @@ interface operations {
             };
         };
     };
-    get_subscription: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Successful Response */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['SubscriptionStatusResponse'];
-                };
-            };
-        };
-    };
-    create_subscription: {
-        parameters: {
-            query?: never;
-            header?: {
-                origin?: string;
-            };
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                'application/json': components['schemas']['CreateSubscriptionRequest'];
-            };
-        };
-        responses: {
-            /** @description Successful Response */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['CreateSubscriptionResponse'];
-                };
-            };
-            /** @description Validation Error */
-            422: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['HTTPValidationError'];
-                };
-            };
-        };
-    };
     create_workspace: {
         parameters: {
             query?: never;
@@ -7649,7 +8446,12 @@ interface operations {
     };
     list_documents: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Optional page size. Omit to return every document in the workspace (the default — the web UI's sort/search/filter is client-side and needs the full list). Set when paging through huge workspaces from a CLI. */
+                limit?: number | null;
+                /** @description Optional offset for pagination. Requires a stable id-ordered scan. */
+                offset?: number | null;
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -7665,12 +8467,21 @@ interface operations {
                     'application/json': components['schemas']['DocResponse'][];
                 };
             };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
         };
     };
     get_similar_documents: {
         parameters: {
             query?: {
-                /** @description Minimum similarity score (0.0 = all stored pairs) */
+                /** @description Minimum similarity score (default 0.92 for near-duplicates) */
                 threshold?: number;
                 /** @description Filter pairs involving a specific document */
                 doc_ext_id?: string | null;
@@ -7906,7 +8717,7 @@ interface operations {
                 wp_type?: string | null;
                 /** @description Tag to link the document to */
                 tag_ext_id?: string | null;
-                /** @description Optional logical folder path (URL safe) */
+                /** @description Optional logical folder path (preserved as-is for e-discovery) */
                 folder?: string | null;
             };
             header?: never;
@@ -8517,6 +9328,28 @@ interface operations {
             };
         };
     };
+    get_metrics: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': {
+                        [key: string]: unknown;
+                    };
+                };
+            };
+        };
+    };
     list_tags: {
         parameters: {
             query?: never;
@@ -8658,7 +9491,12 @@ interface operations {
     };
     get_notifications: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Maximum number of notifications to return, newest first. Defaults to 100 — almost everyone only cares about the latest. Increase or page via offset to walk further back in history. */
+                limit?: number;
+                /** @description Number of notifications to skip from the newest, for paging. */
+                offset?: number;
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -8674,6 +9512,15 @@ interface operations {
                     'application/json': components['schemas']['NotificationResponse'][];
                 };
             };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
         };
     };
     send_messages: {