@arbidocs/client 0.4.63 → 0.4.64

package/dist/index.d.cts

@@ -1021,7 +1021,7 @@ interface paths {
          * @description The decrypted structured data of a scope, plus the document files to fetch for a download.
          *
          *     One JSON array per entity type, a manifest, and ``files`` — each a document
-         *     version to fetch through ``/v1/document/{doc_ext_id}/download`` and store at
+         *     version to fetch through ``/v1/document/{doc_ext_id}/download?version={version}`` and store at
          *     ``path`` (current versions under ``documents/``, older ones under
          *     ``documents/_versions/``).
          */
@@ -1298,7 +1298,10 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Native Content */
+        /**
+         * Native Content
+         * @description The document as DOCX — its current version, or ``version`` (a read-only snapshot).
+         */
         get: operations['native_content_v1_editor__document_id__content_get'];
         put?: never;
         post?: never;
@@ -1319,10 +1322,11 @@ interface paths {
         put?: never;
         /**
          * Create Word Redline
-         * @description Compare two documents into a NEW redline document (base -> revised).
+         * @description Compare two document versions into a NEW redline document (base -> revised).
          *
-         *     Without ``base_ext_id`` the base is the revised document's previous version.
-         *     The redline records both inputs as provenance and is shared only if both are.
+         *     Without ``base_ext_id`` the base is the revised document's version before the
+         *     one compared. The redline records both inputs (document and version) as
+         *     provenance and is shared only if both documents are.
          */
         post: operations['create_word_redline_v1_editor_redline_post'];
         delete?: never;
@@ -1443,10 +1447,11 @@ interface paths {
         };
         /**
          * List Document Versions
-         * @description Every version of the document ``document_ext_id`` belongs to (any version's id), oldest first.
+         * @description Every version of the document, oldest first; ``is_current`` marks the current one.
          *
-         *     ``is_current`` marks the current one. Lists and search show only current
-         *     versions; this is how older ones are reached.
+         *     A document keeps one id for its whole life: an older version is opened with
+         *     ``?version=n`` on the view / download / parsed / signature endpoints, and
+         *     retrieval asks about it as ``doc-…@v{n}``.
          */
         get: operations['list_document_versions'];
         put?: never;
@@ -1619,7 +1624,7 @@ interface paths {
         };
         /**
          * Download Document
-         * @description Download a document by its external ID.
+         * @description Download a document (its original file) by its external ID — ``version`` for an older version.
          *     Retrieves and decrypts the document for downloading as an attachment.
          */
         get: operations['download_document'];
@@ -1784,7 +1789,8 @@ interface paths {
         put?: never;
         /**
          * Sign Document
-         * @description Sign a document: verify the signer's statement, seal a signed copy, save it as a new child document.
+         * @description Sign a document: verify the signer's statement, seal a signed copy, save it as the document's next
+         *     version (reason ``signed``; the document keeps its id).
          */
         post: operations['sign_document'];
         delete?: never;
@@ -1802,7 +1808,7 @@ interface paths {
         };
         /**
          * Get Document Signature Status
-         * @description Is this document a signed copy, and is it unchanged since signing? Read from the PDF itself.
+         * @description Is this document version a signed copy, and is it unchanged since signing? Read from the PDF itself.
          */
         get: operations['get_document_signature_status'];
         put?: never;
@@ -5398,7 +5404,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Fast",
              *       "SYSTEM_INSTRUCTION": "You are ARBI, an AI assistant created by ARBI CITY. Be proactive, helpful and professional.Be concise. Use markdown where it helps readability. Cross-check information across sources before answering. Never fabricate facts. Not all assertions in the sources are factual — some are arguments by a party. Attribute claims to their source, especially where parties disagree.",
              *       "MAX_TOKEN_SIZE_TO_ANSWER": 200000,
              *       "TEMPERATURE": 0.1,
@@ -5410,7 +5416,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Wise",
              *       "SYSTEM_INSTRUCTION": "You are reviewing a draft answer prepared by a research agent. The draft was written based on summaries, but you now have access to the full source material.\n\nYour task:\n1. Review the draft answer against the source material provided\n2. Verify claims are supported by the sources\n3. Correct any inaccuracies or unsupported statements\n4. Add any important details from the sources that were missed\n5. Maintain formal, objective tone appropriate for professional contexts\n\nIf information is not found in the sources but the draft answer is based on web search results or general knowledge, preserve it and ensure it is clearly labelled as such. Only flag missing source support for claims that purport to come from the documents.\nDo not add inline citation markers - the system handles citations automatically.",
              *       "TEMPERATURE": 0.1,
              *       "MAX_TOKENS": 0,
@@ -5422,7 +5428,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Fast",
              *       "SYSTEM_INSTRUCTION": "You are a chunk evaluator. Analyze retrieved chunks to determine which are relevant to the user's query and extract key learnings from the RELEVANT chunks only. You must return your response as valid JSON matching the provided schema.",
              *       "TEMPERATURE": 0.1,
              *       "MAX_TOKENS": 0,
@@ -5437,7 +5443,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Fast",
              *       "SYSTEM_INSTRUCTION": "You are a title generator that creates concise, descriptive titles.\n\nOutput the title as plain text only. Do not use Markdown or any other formatting. Specifically:\n- Do not bold, italicize, or otherwise emphasize any part of the title.\n- Do not include asterisks (*), underscores (_), backticks (`), or other Markdown markers.\n- Do not prefix the title with bullets, dashes (-), or numbered/lettered enumeration (e.g. \"1.\", \"a)\").\n- Do not wrap the title in quotes or brackets.",
              *       "MAX_TOKEN_SIZE_TO_ANSWER": 20,
              *       "TEMPERATURE": 0.3,
@@ -5449,7 +5455,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Wise",
              *       "SYSTEM_INSTRUCTION": "You are a conversation summariser. Condense the conversation history into a concise summary that preserves:\n- Key decisions and conclusions reached\n- Specific names, dates, numbers, and document references\n- Open questions and unresolved items\n- The user's goals and constraints\n\nWrite in past tense, third person. Be specific, not vague. Do not omit important details in favour of brevity.",
              *       "TEMPERATURE": 0.1,
              *       "MAX_TOKENS": 0,
@@ -5463,7 +5469,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Fast",
              *       "SYSTEM_INSTRUCTION": "You are a document analysis assistant. Answer questions based on the document content.\n\nYour answers are displayed directly as cell values in a table, so keep every answer as short as possible.\n\nGuidelines:\n- Answer with the value only — never a full sentence. Do not restate the question or add lead-ins such as \"This document is...\" or \"The document describes...\". Good: \"German\". Bad: \"This document is written in German.\"\n- When an answer has multiple values, put each value on its own line: separate values with a newline character. Do not separate them with commas, bullets, dashes, numbering, or by writing them as a sentence.\n- Answer from the document. Reasonable inferences are fine; if the document gives no basis for an answer, the value is null and sources is empty.\n- Follow the format instructions exactly for each answer.\n- Output answers as plain text only. Do not use Markdown or any other formatting: no bold, italics, asterisks (*), underscores (_), backticks (`), bullets, or numbered/lettered enumeration.\n- Passages may be preceded by markers like [p3.2]: not document content. Cite them in \"sources\", never in a value.",
              *       "MAX_TOKEN_CONTEXT_TO_ANSWER": 200000,
              *       "TEMPERATURE": 0.1,
@@ -5524,7 +5530,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Wise",
              *       "TEMPERATURE": 0.3,
              *       "MAX_TOKENS": 0,
              *       "MAX_TOKEN_CONTEXT": 200000,
@@ -5536,7 +5542,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": true,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Wise",
              *       "SYSTEM_INSTRUCTION": "You are a research planning assistant. Your job is to analyze a user query and produce a concise, numbered research plan.\n\nYou have access to a workspace of documents. The available tools for executing the plan are:\n- search_inside_documents: Search workspace documents for relevant passages (semantic, keyword, or hybrid). Use digest=true to extract learnings.\n- read_document: Read page ranges or entire documents. Use digest=true to extract learnings with citations.\n- get_table_of_contents: Get document headings with page references\n\nConsider:\n- What information is needed to answer the query\n- Which documents are likely relevant based on the document index\n- What search queries and document passages to examine\n- What order of operations will be most efficient\n- Whether parallel searches can be used for different aspects\n\nRespond with ONLY the plan (numbered steps). Do not execute any steps.",
              *       "TEMPERATURE": 0.3,
              *       "MAX_TOKENS": 0,
@@ -5549,7 +5555,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Fast",
              *       "SYSTEM_INSTRUCTION": "You are a context selector. Given a user's query, conversation history, and a table of available documents, determine the user's goal and select relevant context.\n\n## Instructions\n\n1. **goal**: 1-2 concise sentences describing the user's intent AND your filtering rationale. Explain what documents are needed and why. Examples:\n   - \"The user is greeting the assistant. No documents are needed.\"\n   - \"The user wants to find force majeure clauses. Only the three contracts are relevant, so I will keep only those.\"\n   - \"The user wants a full timeline of the case. Most documents are relevant, so I will drop only the unrelated procedural orders.\"\n\n2. **doc_filter_mode** and **doc_ids**: Select which documents the agent needs.\n   - `\"keep\"` mode: `doc_ids` lists the ONLY docs to keep. Everything else is dropped.\n   - `\"drop\"` mode: `doc_ids` lists the ONLY docs to drop. Everything else is kept.\n   - Pick whichever mode produces the **shorter `doc_ids` list**.\n   - Doc IDs are in the **Id** column of the Available Documents table (e.g. `\"doc-abc12345\"`). Copy them **exactly** from the table — do not invent, guess, or modify IDs.\n\n   | Scenario | doc_filter_mode | doc_ids |\n   |----------|----------------|---------|\n   | Need ALL docs | `\"drop\"` | `[]` |\n   | Need NO docs | `\"keep\"` | `[]` |\n   | Need 3 of 100 docs | `\"keep\"` | `[\"id1\",\"id2\",\"id3\"]` |\n   | Drop 3 of 100 docs | `\"drop\"` | `[\"id1\",\"id2\",\"id3\"]` |\n\n3. **chat_range_start** and **chat_range_end**: 0-based inclusive range of earlier history messages that provide relevant context. The last 3 messages are always included automatically. Set both to -1 if no earlier history is needed.\n\n## Rules\n\n- **Never repeat a doc ID.** Each ID must appear at most once.\n- Before writing `doc_ids`, count how many you would keep vs drop, then pick the shorter list.\n- Greetings or meta-questions about the assistant (e.g. \"hello\", \"who are you?\", \"what can you do?\"): the agent does NOT need any documents → `\"keep\"` with `[]`.\n- Ambiguous references like \"the document\" or \"this contract\" without specifying which: keep all → `\"drop\"` with `[]`.\n- For follow-up questions, include history messages that establish the topic.\n- Always return valid JSON matching the schema.",
              *       "TEMPERATURE": 0,
              *       "MAX_TOKENS": 0
@@ -5560,7 +5566,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Fast",
              *       "TEMPERATURE": 0.1,
              *       "MAX_TOKENS": 0,
              *       "MAX_PAGES_PER_CALL": 5,
@@ -5581,7 +5587,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": true,
-             *       "MODEL_NAME": "",
+             *       "MODEL_NAME": "Premium",
              *       "SYSTEM_INSTRUCTION": "You are a code execution agent. You write and run code to accomplish tasks.\n\nYou have access to an execute_code tool that runs code in a sandboxed Docker container.\n\nThe sandbox has:\n- Python 3.12 with numpy, pandas, matplotlib, requests, beautifulsoup4,\n  httpx, pillow, sympy, pyyaml (plus uv for installing more)\n- Node.js 22 with TypeScript (ts-node) and npm\n- Bash with git, curl, wget, jq, sqlite3, build-essential\n- Network access (can pip/npm install additional packages)\n\nInstructions:\n1. Write clean, correct code to accomplish the user's task\n2. Always call execute_code to run your code — never guess the output\n3. If execution errors, analyze the traceback, fix the code, and retry\n4. Once you have the correct output, respond with ONLY the final result\n\nKeep code simple and direct. Prefer Python unless the task specifically requires another language.",
              *       "TEMPERATURE": 0.2,
              *       "MAX_TOKENS": 0
@@ -5651,7 +5657,7 @@ interface components {
              *       },
              *       "MAX_CONCURRENT_REQUESTS": 256,
              *       "MODEL_NAME": "Qwen/Qwen3-Reranker-0.6B",
-             *       "API_TYPE": "local",
+             *       "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"
              *     }
              */
@@ -5672,7 +5678,7 @@ interface components {
             /**
              * @default {
              *       "MODEL_NAME": "Qwen/Qwen3-Embedding-0.6B",
-             *       "API_TYPE": "local",
+             *       "API_TYPE": "remote",
              *       "BATCH_SIZE": 128,
              *       "MAX_CONCURRENT_REQUESTS": 256,
              *       "DOCUMENT_PREFIX": "",
@@ -5941,13 +5947,13 @@ interface components {
             is_complete: boolean;
             /**
              * Version
-             * @description Version number for tracking changes/redlines
+             * @description The document version this artifact was saved as (1 for a new artifact)
              * @default 1
              */
             version: number;
             /**
              * Version Of
-             * @description Document this artifact updates; it is saved as the next version in that document's chain
+             * @description Set when this artifact updates an existing document: that document (equal to doc_ext_id — the update is saved as its next version, same id)
              */
             version_of?: string | null;
             /**
@@ -6283,6 +6289,8 @@ interface components {
             workspace_ext_id?: string | null;
             /** Doc Ext Id */
             doc_ext_id?: string | null;
+            /** Doc Version */
+            doc_version?: number | null;
             /** Doc Title */
             doc_title?: string | null;
             /** Chunk Id */
@@ -6398,6 +6406,8 @@ interface components {
         CitedDocument: {
             /** Doc Ext Id */
             doc_ext_id: string;
+            /** Version */
+            version?: number | null;
             /** Chunks */
             chunks?: components['schemas']['CitedChunk'][];
         };
@@ -6422,7 +6432,7 @@ interface components {
             /**
              * Model Name
              * @description Model for code generation. Should be a strong coding model.
-             * @default
+             * @default Premium
              */
             MODEL_NAME: string;
             /**
@@ -7595,12 +7605,16 @@ interface components {
         };
         /**
          * DerivedFrom
-         * @description One provenance link of a document: it was made from ``doc_ext_id`` as ``role``.
+         * @description One provenance link of a document: it was made from version ``version`` of
+         *     ``doc_ext_id`` as ``role``. ``version`` is None only for links whose version was
+         *     never recorded.
          */
         DerivedFrom: {
             /** Doc Ext Id */
             doc_ext_id: string;
             role: components['schemas']['DocRelationRole'];
+            /** Version */
+            version?: number | null;
         };
         /**
          * DmAttachmentUploadResponse
@@ -7631,9 +7645,11 @@ interface components {
         /**
          * DocRelationRole
          * @description How ``from_doc`` was derived from ``to_doc`` (provenance only, no behaviour).
+         *
+         *     Versions are not relations: they live inside their document (``docs.versions``).
          * @enum {string}
          */
-        DocRelationRole: 'edit' | 'sync' | 'crop' | 'redline_base' | 'redline_revised' | 'redaction' | 'annotated' | 'production';
+        DocRelationRole: 'crop' | 'redline_base' | 'redline_revised' | 'redaction' | 'annotated' | 'production';
         /** DocResponse */
         DocResponse: {
             /** External Id */
@@ -7672,18 +7688,16 @@ interface components {
             config_ext_id?: string | null;
             /** Parent Ext Id */
             parent_ext_id?: string | null;
-            /** Lineage Id */
-            lineage_id?: string | null;
             /**
-             * Version Number
+             * Current Version
              * @default 1
              */
-            version_number: number;
+            current_version: number;
             /**
-             * Is Current
-             * @default true
+             * Versions
+             * @default []
              */
-            is_current: boolean;
+            versions: components['schemas']['DocVersion'][];
             /** Thread Id */
             thread_id?: string | null;
             /**
@@ -7810,6 +7824,45 @@ interface components {
              */
             config_ext_id?: string | null;
         };
+        /**
+         * DocVersion
+         * @description One version of a document (``GET /v1/document/{id}/versions`` and ``DocResponse.versions``).
+         */
+        DocVersion: {
+            /** N */
+            n: number;
+            /** Created At */
+            created_at?: string | null;
+            /** Created By Ext Id */
+            created_by_ext_id?: string | null;
+            /**
+             * Reason
+             * @default upload
+             * @enum {string}
+             */
+            reason: 'upload' | 'edit' | 'signed' | 'sync';
+            /** File Name */
+            file_name?: string | null;
+            /** File Type */
+            file_type?: string | null;
+            /** File Size */
+            file_size?: number | null;
+            /** Content Hash */
+            content_hash?: string | null;
+            /** Status */
+            status?: string | null;
+            /** N Pages */
+            n_pages?: number | null;
+            /** N Chunks */
+            n_chunks?: number | null;
+            /** Made From */
+            made_from?: number | null;
+            /**
+             * Is Current
+             * @default false
+             */
+            is_current: boolean;
+        };
         /**
          * DoctagLLMConfig
          * @description Configuration for DoctagLLM - extracts information from documents based on tag instructions.
@@ -7831,7 +7884,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -8129,7 +8182,7 @@ interface components {
             /**
              * Api Type
              * @description The inference type (local or remote).
-             * @default local
+             * @default remote
              * @enum {string}
              */
             API_TYPE: 'local' | 'remote';
@@ -8274,7 +8327,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -8322,11 +8375,17 @@ interface components {
         };
         /**
          * ExportFile
-         * @description One file of a download: fetch ``/v1/document/{doc_ext_id}/download`` and store it at ``path``.
+         * @description One file of a download: fetch ``/v1/document/{doc_ext_id}/download?version={version}`` and store
+         *     it at ``path``.
          */
         ExportFile: {
             /** Doc Ext Id */
             doc_ext_id: string;
+            /**
+             * Version
+             * @default 1
+             */
+            version: number;
             /** Path */
             path: string;
             /**
@@ -8550,7 +8609,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -9440,7 +9499,7 @@ interface components {
             /**
              * Model Name
              * @description The model for note consolidation. Defaults to reasoning model.
-             * @default dummy
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -10173,6 +10232,8 @@ interface components {
         ParsedDocMetadata: {
             /** Doc Ext Id */
             doc_ext_id?: string | null;
+            /** Doc Version */
+            doc_version?: number | null;
             /** File Name */
             file_name?: string | null;
             /**
@@ -10332,7 +10393,7 @@ interface components {
             /**
              * Model Name
              * @description The model for plan generation. Defaults to reasoning model.
-             * @default dummy
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -10793,7 +10854,7 @@ interface components {
             /**
              * Model Name
              * @description The model for query answering.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -11124,7 +11185,7 @@ interface components {
             /**
              * Api Type
              * @description The inference type (local or remote).
-             * @default local
+             * @default remote
              * @enum {string}
              */
             API_TYPE: 'local' | 'remote';
@@ -11909,7 +11970,7 @@ interface components {
             /**
              * Model Name
              * @description The model for reviewing agent draft answers. Defaults to reasoning model.
-             * @default dummy
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -12367,8 +12428,16 @@ interface components {
         };
         /** SignDocumentResponse */
         SignDocumentResponse: {
-            /** Signed Doc Ext Id */
-            signed_doc_ext_id: string;
+            /**
+             * Doc Ext Id
+             * @description The signed document (it keeps its id)
+             */
+            doc_ext_id: string;
+            /**
+             * Version
+             * @description The new version holding the signed, sealed PDF
+             */
+            version: number;
             signature: components['schemas']['SignatureRecord'];
         };
         /**
@@ -12724,7 +12793,7 @@ interface components {
             /**
              * Model Name
              * @description The model for conversation summarisation. Defaults to reasoning model.
-             * @default dummy
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -12999,6 +13068,11 @@ interface components {
             type: 'task_update';
             /** Doc Ext Id */
             doc_ext_id: string;
+            /**
+             * Version
+             * @default 1
+             */
+            version: number;
             /** Workspace Ext Id */
             workspace_ext_id: string;
             /** File Name */
@@ -13068,7 +13142,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -13363,7 +13437,7 @@ interface components {
             kind: components['schemas']['TransferScopeKind'];
             /**
              * Items
-             * @description selection: external ids — documents (doc-), labels/fields (tag-), facts (fct-), conversations (con-) and automations (wfl-). A document brings all its versions and its attachments; an id of any version names the whole document.
+             * @description selection: external ids — documents (doc-), labels/fields (tag-), facts (fct-), conversations (con-) and automations (wfl-). A document brings all its versions and its attachments.
              */
             items?: string[];
             /** Label Ext Id */
@@ -13646,6 +13720,8 @@ interface components {
         UploadDocumentsResponse: {
             /** Doc Ext Ids */
             doc_ext_ids?: string[];
+            /** Version */
+            version?: number | null;
             /**
              * Batch Id
              * @description Batch ID for tracking completion via WebSocket batch_complete events
@@ -13673,7 +13749,7 @@ interface components {
             config_ext_id?: string | null;
             /**
              * Version Of
-             * @description Upload as the next version of this document (any of its versions)
+             * @description Upload as the next version of this document
              */
             version_of?: string | null;
             /** Wp Type */
@@ -14233,7 +14309,7 @@ interface components {
             /**
              * Model Name
              * @description The vision-capable model name (must support image inputs).
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -16627,7 +16703,10 @@ interface operations {
     };
     native_content_v1_editor__document_id__content_get: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
             header?: never;
             path: {
                 document_id: string;
@@ -16661,6 +16740,10 @@ interface operations {
             query: {
                 revised_ext_id: string;
                 base_ext_id?: string | null;
+                /** @description Version of the revised document (default current) */
+                revised_version?: number | null;
+                /** @description Version of the base document (default current) */
+                base_version?: number | null;
             };
             header?: never;
             path?: never;
@@ -16872,7 +16955,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['DocResponse'][];
+                    'application/json': components['schemas']['DocVersion'][];
                 };
             };
             /** @description Validation Error */
@@ -16990,7 +17073,7 @@ interface operations {
                 shared?: boolean;
                 /** @description Configuration to use for processing */
                 config_ext_id?: string | null;
-                /** @description Upload a single file as the next version of this document (any of its versions). It becomes the current version and takes the document's sharing, folder and labels. */
+                /** @description Upload a single file as the next version of this document. The document keeps its id, sharing, folder and labels; the new version becomes current (the response's `version`). */
                 version_of?: string | null;
                 /** @description A new, separate document made from this one (a crop, a redacted copy) or, repeated, from several (a production set); recorded as provenance only */
                 derived_from?: string[] | null;
@@ -17142,7 +17225,10 @@ interface operations {
     };
     download_document: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
             header?: never;
             path: {
                 document_ext_id: string;
@@ -17173,7 +17259,10 @@ interface operations {
     };
     view_document_inline: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
             header?: never;
             path: {
                 document_ext_id: string;
@@ -17204,7 +17293,10 @@ interface operations {
     };
     get_document_thumbnail: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
             header?: never;
             path: {
                 document_ext_id: string;
@@ -17268,7 +17360,10 @@ interface operations {
     };
     get_parsed_document: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
             header?: never;
             path: {
                 document_ext_id: string;
@@ -17406,7 +17501,10 @@ interface operations {
     };
     get_document_signature_status: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
             header?: never;
             path: {
                 document_ext_id: string;

package/dist/index.d.ts

@@ -1021,7 +1021,7 @@ interface paths {
          * @description The decrypted structured data of a scope, plus the document files to fetch for a download.
          *
          *     One JSON array per entity type, a manifest, and ``files`` — each a document
-         *     version to fetch through ``/v1/document/{doc_ext_id}/download`` and store at
+         *     version to fetch through ``/v1/document/{doc_ext_id}/download?version={version}`` and store at
          *     ``path`` (current versions under ``documents/``, older ones under
          *     ``documents/_versions/``).
          */
@@ -1298,7 +1298,10 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Native Content */
+        /**
+         * Native Content
+         * @description The document as DOCX — its current version, or ``version`` (a read-only snapshot).
+         */
         get: operations['native_content_v1_editor__document_id__content_get'];
         put?: never;
         post?: never;
@@ -1319,10 +1322,11 @@ interface paths {
         put?: never;
         /**
          * Create Word Redline
-         * @description Compare two documents into a NEW redline document (base -> revised).
+         * @description Compare two document versions into a NEW redline document (base -> revised).
          *
-         *     Without ``base_ext_id`` the base is the revised document's previous version.
-         *     The redline records both inputs as provenance and is shared only if both are.
+         *     Without ``base_ext_id`` the base is the revised document's version before the
+         *     one compared. The redline records both inputs (document and version) as
+         *     provenance and is shared only if both documents are.
          */
         post: operations['create_word_redline_v1_editor_redline_post'];
         delete?: never;
@@ -1443,10 +1447,11 @@ interface paths {
         };
         /**
          * List Document Versions
-         * @description Every version of the document ``document_ext_id`` belongs to (any version's id), oldest first.
+         * @description Every version of the document, oldest first; ``is_current`` marks the current one.
          *
-         *     ``is_current`` marks the current one. Lists and search show only current
-         *     versions; this is how older ones are reached.
+         *     A document keeps one id for its whole life: an older version is opened with
+         *     ``?version=n`` on the view / download / parsed / signature endpoints, and
+         *     retrieval asks about it as ``doc-…@v{n}``.
          */
         get: operations['list_document_versions'];
         put?: never;
@@ -1619,7 +1624,7 @@ interface paths {
         };
         /**
          * Download Document
-         * @description Download a document by its external ID.
+         * @description Download a document (its original file) by its external ID — ``version`` for an older version.
          *     Retrieves and decrypts the document for downloading as an attachment.
          */
         get: operations['download_document'];
@@ -1784,7 +1789,8 @@ interface paths {
         put?: never;
         /**
          * Sign Document
-         * @description Sign a document: verify the signer's statement, seal a signed copy, save it as a new child document.
+         * @description Sign a document: verify the signer's statement, seal a signed copy, save it as the document's next
+         *     version (reason ``signed``; the document keeps its id).
          */
         post: operations['sign_document'];
         delete?: never;
@@ -1802,7 +1808,7 @@ interface paths {
         };
         /**
          * Get Document Signature Status
-         * @description Is this document a signed copy, and is it unchanged since signing? Read from the PDF itself.
+         * @description Is this document version a signed copy, and is it unchanged since signing? Read from the PDF itself.
          */
         get: operations['get_document_signature_status'];
         put?: never;
@@ -5398,7 +5404,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Fast",
              *       "SYSTEM_INSTRUCTION": "You are ARBI, an AI assistant created by ARBI CITY. Be proactive, helpful and professional.Be concise. Use markdown where it helps readability. Cross-check information across sources before answering. Never fabricate facts. Not all assertions in the sources are factual — some are arguments by a party. Attribute claims to their source, especially where parties disagree.",
              *       "MAX_TOKEN_SIZE_TO_ANSWER": 200000,
              *       "TEMPERATURE": 0.1,
@@ -5410,7 +5416,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Wise",
              *       "SYSTEM_INSTRUCTION": "You are reviewing a draft answer prepared by a research agent. The draft was written based on summaries, but you now have access to the full source material.\n\nYour task:\n1. Review the draft answer against the source material provided\n2. Verify claims are supported by the sources\n3. Correct any inaccuracies or unsupported statements\n4. Add any important details from the sources that were missed\n5. Maintain formal, objective tone appropriate for professional contexts\n\nIf information is not found in the sources but the draft answer is based on web search results or general knowledge, preserve it and ensure it is clearly labelled as such. Only flag missing source support for claims that purport to come from the documents.\nDo not add inline citation markers - the system handles citations automatically.",
              *       "TEMPERATURE": 0.1,
              *       "MAX_TOKENS": 0,
@@ -5422,7 +5428,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Fast",
              *       "SYSTEM_INSTRUCTION": "You are a chunk evaluator. Analyze retrieved chunks to determine which are relevant to the user's query and extract key learnings from the RELEVANT chunks only. You must return your response as valid JSON matching the provided schema.",
              *       "TEMPERATURE": 0.1,
              *       "MAX_TOKENS": 0,
@@ -5437,7 +5443,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Fast",
              *       "SYSTEM_INSTRUCTION": "You are a title generator that creates concise, descriptive titles.\n\nOutput the title as plain text only. Do not use Markdown or any other formatting. Specifically:\n- Do not bold, italicize, or otherwise emphasize any part of the title.\n- Do not include asterisks (*), underscores (_), backticks (`), or other Markdown markers.\n- Do not prefix the title with bullets, dashes (-), or numbered/lettered enumeration (e.g. \"1.\", \"a)\").\n- Do not wrap the title in quotes or brackets.",
              *       "MAX_TOKEN_SIZE_TO_ANSWER": 20,
              *       "TEMPERATURE": 0.3,
@@ -5449,7 +5455,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Wise",
              *       "SYSTEM_INSTRUCTION": "You are a conversation summariser. Condense the conversation history into a concise summary that preserves:\n- Key decisions and conclusions reached\n- Specific names, dates, numbers, and document references\n- Open questions and unresolved items\n- The user's goals and constraints\n\nWrite in past tense, third person. Be specific, not vague. Do not omit important details in favour of brevity.",
              *       "TEMPERATURE": 0.1,
              *       "MAX_TOKENS": 0,
@@ -5463,7 +5469,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Fast",
              *       "SYSTEM_INSTRUCTION": "You are a document analysis assistant. Answer questions based on the document content.\n\nYour answers are displayed directly as cell values in a table, so keep every answer as short as possible.\n\nGuidelines:\n- Answer with the value only — never a full sentence. Do not restate the question or add lead-ins such as \"This document is...\" or \"The document describes...\". Good: \"German\". Bad: \"This document is written in German.\"\n- When an answer has multiple values, put each value on its own line: separate values with a newline character. Do not separate them with commas, bullets, dashes, numbering, or by writing them as a sentence.\n- Answer from the document. Reasonable inferences are fine; if the document gives no basis for an answer, the value is null and sources is empty.\n- Follow the format instructions exactly for each answer.\n- Output answers as plain text only. Do not use Markdown or any other formatting: no bold, italics, asterisks (*), underscores (_), backticks (`), bullets, or numbered/lettered enumeration.\n- Passages may be preceded by markers like [p3.2]: not document content. Cite them in \"sources\", never in a value.",
              *       "MAX_TOKEN_CONTEXT_TO_ANSWER": 200000,
              *       "TEMPERATURE": 0.1,
@@ -5524,7 +5530,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Wise",
              *       "TEMPERATURE": 0.3,
              *       "MAX_TOKENS": 0,
              *       "MAX_TOKEN_CONTEXT": 200000,
@@ -5536,7 +5542,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": true,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Wise",
              *       "SYSTEM_INSTRUCTION": "You are a research planning assistant. Your job is to analyze a user query and produce a concise, numbered research plan.\n\nYou have access to a workspace of documents. The available tools for executing the plan are:\n- search_inside_documents: Search workspace documents for relevant passages (semantic, keyword, or hybrid). Use digest=true to extract learnings.\n- read_document: Read page ranges or entire documents. Use digest=true to extract learnings with citations.\n- get_table_of_contents: Get document headings with page references\n\nConsider:\n- What information is needed to answer the query\n- Which documents are likely relevant based on the document index\n- What search queries and document passages to examine\n- What order of operations will be most efficient\n- Whether parallel searches can be used for different aspects\n\nRespond with ONLY the plan (numbered steps). Do not execute any steps.",
              *       "TEMPERATURE": 0.3,
              *       "MAX_TOKENS": 0,
@@ -5549,7 +5555,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Fast",
              *       "SYSTEM_INSTRUCTION": "You are a context selector. Given a user's query, conversation history, and a table of available documents, determine the user's goal and select relevant context.\n\n## Instructions\n\n1. **goal**: 1-2 concise sentences describing the user's intent AND your filtering rationale. Explain what documents are needed and why. Examples:\n   - \"The user is greeting the assistant. No documents are needed.\"\n   - \"The user wants to find force majeure clauses. Only the three contracts are relevant, so I will keep only those.\"\n   - \"The user wants a full timeline of the case. Most documents are relevant, so I will drop only the unrelated procedural orders.\"\n\n2. **doc_filter_mode** and **doc_ids**: Select which documents the agent needs.\n   - `\"keep\"` mode: `doc_ids` lists the ONLY docs to keep. Everything else is dropped.\n   - `\"drop\"` mode: `doc_ids` lists the ONLY docs to drop. Everything else is kept.\n   - Pick whichever mode produces the **shorter `doc_ids` list**.\n   - Doc IDs are in the **Id** column of the Available Documents table (e.g. `\"doc-abc12345\"`). Copy them **exactly** from the table — do not invent, guess, or modify IDs.\n\n   | Scenario | doc_filter_mode | doc_ids |\n   |----------|----------------|---------|\n   | Need ALL docs | `\"drop\"` | `[]` |\n   | Need NO docs | `\"keep\"` | `[]` |\n   | Need 3 of 100 docs | `\"keep\"` | `[\"id1\",\"id2\",\"id3\"]` |\n   | Drop 3 of 100 docs | `\"drop\"` | `[\"id1\",\"id2\",\"id3\"]` |\n\n3. **chat_range_start** and **chat_range_end**: 0-based inclusive range of earlier history messages that provide relevant context. The last 3 messages are always included automatically. Set both to -1 if no earlier history is needed.\n\n## Rules\n\n- **Never repeat a doc ID.** Each ID must appear at most once.\n- Before writing `doc_ids`, count how many you would keep vs drop, then pick the shorter list.\n- Greetings or meta-questions about the assistant (e.g. \"hello\", \"who are you?\", \"what can you do?\"): the agent does NOT need any documents → `\"keep\"` with `[]`.\n- Ambiguous references like \"the document\" or \"this contract\" without specifying which: keep all → `\"drop\"` with `[]`.\n- For follow-up questions, include history messages that establish the topic.\n- Always return valid JSON matching the schema.",
              *       "TEMPERATURE": 0,
              *       "MAX_TOKENS": 0
@@ -5560,7 +5566,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "dummy",
+             *       "MODEL_NAME": "Fast",
              *       "TEMPERATURE": 0.1,
              *       "MAX_TOKENS": 0,
              *       "MAX_PAGES_PER_CALL": 5,
@@ -5581,7 +5587,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": true,
-             *       "MODEL_NAME": "",
+             *       "MODEL_NAME": "Premium",
              *       "SYSTEM_INSTRUCTION": "You are a code execution agent. You write and run code to accomplish tasks.\n\nYou have access to an execute_code tool that runs code in a sandboxed Docker container.\n\nThe sandbox has:\n- Python 3.12 with numpy, pandas, matplotlib, requests, beautifulsoup4,\n  httpx, pillow, sympy, pyyaml (plus uv for installing more)\n- Node.js 22 with TypeScript (ts-node) and npm\n- Bash with git, curl, wget, jq, sqlite3, build-essential\n- Network access (can pip/npm install additional packages)\n\nInstructions:\n1. Write clean, correct code to accomplish the user's task\n2. Always call execute_code to run your code — never guess the output\n3. If execution errors, analyze the traceback, fix the code, and retry\n4. Once you have the correct output, respond with ONLY the final result\n\nKeep code simple and direct. Prefer Python unless the task specifically requires another language.",
              *       "TEMPERATURE": 0.2,
              *       "MAX_TOKENS": 0
@@ -5651,7 +5657,7 @@ interface components {
              *       },
              *       "MAX_CONCURRENT_REQUESTS": 256,
              *       "MODEL_NAME": "Qwen/Qwen3-Reranker-0.6B",
-             *       "API_TYPE": "local",
+             *       "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"
              *     }
              */
@@ -5672,7 +5678,7 @@ interface components {
             /**
              * @default {
              *       "MODEL_NAME": "Qwen/Qwen3-Embedding-0.6B",
-             *       "API_TYPE": "local",
+             *       "API_TYPE": "remote",
              *       "BATCH_SIZE": 128,
              *       "MAX_CONCURRENT_REQUESTS": 256,
              *       "DOCUMENT_PREFIX": "",
@@ -5941,13 +5947,13 @@ interface components {
             is_complete: boolean;
             /**
              * Version
-             * @description Version number for tracking changes/redlines
+             * @description The document version this artifact was saved as (1 for a new artifact)
              * @default 1
              */
             version: number;
             /**
              * Version Of
-             * @description Document this artifact updates; it is saved as the next version in that document's chain
+             * @description Set when this artifact updates an existing document: that document (equal to doc_ext_id — the update is saved as its next version, same id)
              */
             version_of?: string | null;
             /**
@@ -6283,6 +6289,8 @@ interface components {
             workspace_ext_id?: string | null;
             /** Doc Ext Id */
             doc_ext_id?: string | null;
+            /** Doc Version */
+            doc_version?: number | null;
             /** Doc Title */
             doc_title?: string | null;
             /** Chunk Id */
@@ -6398,6 +6406,8 @@ interface components {
         CitedDocument: {
             /** Doc Ext Id */
             doc_ext_id: string;
+            /** Version */
+            version?: number | null;
             /** Chunks */
             chunks?: components['schemas']['CitedChunk'][];
         };
@@ -6422,7 +6432,7 @@ interface components {
             /**
              * Model Name
              * @description Model for code generation. Should be a strong coding model.
-             * @default
+             * @default Premium
              */
             MODEL_NAME: string;
             /**
@@ -7595,12 +7605,16 @@ interface components {
         };
         /**
          * DerivedFrom
-         * @description One provenance link of a document: it was made from ``doc_ext_id`` as ``role``.
+         * @description One provenance link of a document: it was made from version ``version`` of
+         *     ``doc_ext_id`` as ``role``. ``version`` is None only for links whose version was
+         *     never recorded.
          */
         DerivedFrom: {
             /** Doc Ext Id */
             doc_ext_id: string;
             role: components['schemas']['DocRelationRole'];
+            /** Version */
+            version?: number | null;
         };
         /**
          * DmAttachmentUploadResponse
@@ -7631,9 +7645,11 @@ interface components {
         /**
          * DocRelationRole
          * @description How ``from_doc`` was derived from ``to_doc`` (provenance only, no behaviour).
+         *
+         *     Versions are not relations: they live inside their document (``docs.versions``).
          * @enum {string}
          */
-        DocRelationRole: 'edit' | 'sync' | 'crop' | 'redline_base' | 'redline_revised' | 'redaction' | 'annotated' | 'production';
+        DocRelationRole: 'crop' | 'redline_base' | 'redline_revised' | 'redaction' | 'annotated' | 'production';
         /** DocResponse */
         DocResponse: {
             /** External Id */
@@ -7672,18 +7688,16 @@ interface components {
             config_ext_id?: string | null;
             /** Parent Ext Id */
             parent_ext_id?: string | null;
-            /** Lineage Id */
-            lineage_id?: string | null;
             /**
-             * Version Number
+             * Current Version
              * @default 1
              */
-            version_number: number;
+            current_version: number;
             /**
-             * Is Current
-             * @default true
+             * Versions
+             * @default []
              */
-            is_current: boolean;
+            versions: components['schemas']['DocVersion'][];
             /** Thread Id */
             thread_id?: string | null;
             /**
@@ -7810,6 +7824,45 @@ interface components {
              */
             config_ext_id?: string | null;
         };
+        /**
+         * DocVersion
+         * @description One version of a document (``GET /v1/document/{id}/versions`` and ``DocResponse.versions``).
+         */
+        DocVersion: {
+            /** N */
+            n: number;
+            /** Created At */
+            created_at?: string | null;
+            /** Created By Ext Id */
+            created_by_ext_id?: string | null;
+            /**
+             * Reason
+             * @default upload
+             * @enum {string}
+             */
+            reason: 'upload' | 'edit' | 'signed' | 'sync';
+            /** File Name */
+            file_name?: string | null;
+            /** File Type */
+            file_type?: string | null;
+            /** File Size */
+            file_size?: number | null;
+            /** Content Hash */
+            content_hash?: string | null;
+            /** Status */
+            status?: string | null;
+            /** N Pages */
+            n_pages?: number | null;
+            /** N Chunks */
+            n_chunks?: number | null;
+            /** Made From */
+            made_from?: number | null;
+            /**
+             * Is Current
+             * @default false
+             */
+            is_current: boolean;
+        };
         /**
          * DoctagLLMConfig
          * @description Configuration for DoctagLLM - extracts information from documents based on tag instructions.
@@ -7831,7 +7884,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -8129,7 +8182,7 @@ interface components {
             /**
              * Api Type
              * @description The inference type (local or remote).
-             * @default local
+             * @default remote
              * @enum {string}
              */
             API_TYPE: 'local' | 'remote';
@@ -8274,7 +8327,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -8322,11 +8375,17 @@ interface components {
         };
         /**
          * ExportFile
-         * @description One file of a download: fetch ``/v1/document/{doc_ext_id}/download`` and store it at ``path``.
+         * @description One file of a download: fetch ``/v1/document/{doc_ext_id}/download?version={version}`` and store
+         *     it at ``path``.
          */
         ExportFile: {
             /** Doc Ext Id */
             doc_ext_id: string;
+            /**
+             * Version
+             * @default 1
+             */
+            version: number;
             /** Path */
             path: string;
             /**
@@ -8550,7 +8609,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -9440,7 +9499,7 @@ interface components {
             /**
              * Model Name
              * @description The model for note consolidation. Defaults to reasoning model.
-             * @default dummy
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -10173,6 +10232,8 @@ interface components {
         ParsedDocMetadata: {
             /** Doc Ext Id */
             doc_ext_id?: string | null;
+            /** Doc Version */
+            doc_version?: number | null;
             /** File Name */
             file_name?: string | null;
             /**
@@ -10332,7 +10393,7 @@ interface components {
             /**
              * Model Name
              * @description The model for plan generation. Defaults to reasoning model.
-             * @default dummy
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -10793,7 +10854,7 @@ interface components {
             /**
              * Model Name
              * @description The model for query answering.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -11124,7 +11185,7 @@ interface components {
             /**
              * Api Type
              * @description The inference type (local or remote).
-             * @default local
+             * @default remote
              * @enum {string}
              */
             API_TYPE: 'local' | 'remote';
@@ -11909,7 +11970,7 @@ interface components {
             /**
              * Model Name
              * @description The model for reviewing agent draft answers. Defaults to reasoning model.
-             * @default dummy
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -12367,8 +12428,16 @@ interface components {
         };
         /** SignDocumentResponse */
         SignDocumentResponse: {
-            /** Signed Doc Ext Id */
-            signed_doc_ext_id: string;
+            /**
+             * Doc Ext Id
+             * @description The signed document (it keeps its id)
+             */
+            doc_ext_id: string;
+            /**
+             * Version
+             * @description The new version holding the signed, sealed PDF
+             */
+            version: number;
             signature: components['schemas']['SignatureRecord'];
         };
         /**
@@ -12724,7 +12793,7 @@ interface components {
             /**
              * Model Name
              * @description The model for conversation summarisation. Defaults to reasoning model.
-             * @default dummy
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -12999,6 +13068,11 @@ interface components {
             type: 'task_update';
             /** Doc Ext Id */
             doc_ext_id: string;
+            /**
+             * Version
+             * @default 1
+             */
+            version: number;
             /** Workspace Ext Id */
             workspace_ext_id: string;
             /** File Name */
@@ -13068,7 +13142,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -13363,7 +13437,7 @@ interface components {
             kind: components['schemas']['TransferScopeKind'];
             /**
              * Items
-             * @description selection: external ids — documents (doc-), labels/fields (tag-), facts (fct-), conversations (con-) and automations (wfl-). A document brings all its versions and its attachments; an id of any version names the whole document.
+             * @description selection: external ids — documents (doc-), labels/fields (tag-), facts (fct-), conversations (con-) and automations (wfl-). A document brings all its versions and its attachments.
              */
             items?: string[];
             /** Label Ext Id */
@@ -13646,6 +13720,8 @@ interface components {
         UploadDocumentsResponse: {
             /** Doc Ext Ids */
             doc_ext_ids?: string[];
+            /** Version */
+            version?: number | null;
             /**
              * Batch Id
              * @description Batch ID for tracking completion via WebSocket batch_complete events
@@ -13673,7 +13749,7 @@ interface components {
             config_ext_id?: string | null;
             /**
              * Version Of
-             * @description Upload as the next version of this document (any of its versions)
+             * @description Upload as the next version of this document
              */
             version_of?: string | null;
             /** Wp Type */
@@ -14233,7 +14309,7 @@ interface components {
             /**
              * Model Name
              * @description The vision-capable model name (must support image inputs).
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -16627,7 +16703,10 @@ interface operations {
     };
     native_content_v1_editor__document_id__content_get: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
             header?: never;
             path: {
                 document_id: string;
@@ -16661,6 +16740,10 @@ interface operations {
             query: {
                 revised_ext_id: string;
                 base_ext_id?: string | null;
+                /** @description Version of the revised document (default current) */
+                revised_version?: number | null;
+                /** @description Version of the base document (default current) */
+                base_version?: number | null;
             };
             header?: never;
             path?: never;
@@ -16872,7 +16955,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['DocResponse'][];
+                    'application/json': components['schemas']['DocVersion'][];
                 };
             };
             /** @description Validation Error */
@@ -16990,7 +17073,7 @@ interface operations {
                 shared?: boolean;
                 /** @description Configuration to use for processing */
                 config_ext_id?: string | null;
-                /** @description Upload a single file as the next version of this document (any of its versions). It becomes the current version and takes the document's sharing, folder and labels. */
+                /** @description Upload a single file as the next version of this document. The document keeps its id, sharing, folder and labels; the new version becomes current (the response's `version`). */
                 version_of?: string | null;
                 /** @description A new, separate document made from this one (a crop, a redacted copy) or, repeated, from several (a production set); recorded as provenance only */
                 derived_from?: string[] | null;
@@ -17142,7 +17225,10 @@ interface operations {
     };
     download_document: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
             header?: never;
             path: {
                 document_ext_id: string;
@@ -17173,7 +17259,10 @@ interface operations {
     };
     view_document_inline: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
             header?: never;
             path: {
                 document_ext_id: string;
@@ -17204,7 +17293,10 @@ interface operations {
     };
     get_document_thumbnail: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
             header?: never;
             path: {
                 document_ext_id: string;
@@ -17268,7 +17360,10 @@ interface operations {
     };
     get_parsed_document: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
             header?: never;
             path: {
                 document_ext_id: string;
@@ -17406,7 +17501,10 @@ interface operations {
     };
     get_document_signature_status: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
             header?: never;
             path: {
                 document_ext_id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbidocs/client",
-  "version": "0.4.63",
+  "version": "0.4.64",
   "description": "TypeScript SDK for the ARBI API — zero-knowledge auth, E2E encryption, and type-safe REST client",
   "type": "module",
   "sideEffects": false,