@arbidocs/client 0.4.64 → 0.4.65

package/dist/index.d.cts

@@ -1819,6 +1819,56 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/document/{document_ext_id}/markup': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Document Markup
+         * @description The version's marks and their revision (0 = no markup yet). Anyone who can see the document
+         *     can read them; ``can_edit`` says whether the caller may save.
+         */
+        get: operations['get_document_markup'];
+        /**
+         * Save Document Markup
+         * @description Save the version's whole layer, overwriting its markup in place.
+         *
+         *     Optimistic concurrency: the save must name the revision it started from (``If-Match`` or
+         *     ``base_revision``). When someone saved in between, nothing is written and the 409 carries the
+         *     latest revision: the client re-reads it, merges by annotation id and saves again.
+         */
+        put: operations['save_document_markup'];
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/document/{document_ext_id}/markup/pdf': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Download Document Markup
+         * @description "Download with markup": the version's PDF with its annotations as native PDF annotations
+         *     (Acrobat, Preview and other viewers show them). The plain download serves the original.
+         */
+        get: operations['download_document_markup'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/conversation/list': {
         parameters: {
             query?: never;
@@ -5404,7 +5454,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "Fast",
+             *       "MODEL_NAME": "dummy",
              *       "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,
@@ -5416,7 +5466,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "Wise",
+             *       "MODEL_NAME": "dummy",
              *       "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,
@@ -5428,7 +5478,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "Fast",
+             *       "MODEL_NAME": "dummy",
              *       "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,
@@ -5443,7 +5493,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "Fast",
+             *       "MODEL_NAME": "dummy",
              *       "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,
@@ -5455,7 +5505,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "Wise",
+             *       "MODEL_NAME": "dummy",
              *       "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,
@@ -5469,7 +5519,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "Fast",
+             *       "MODEL_NAME": "dummy",
              *       "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,
@@ -5530,7 +5580,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "Wise",
+             *       "MODEL_NAME": "dummy",
              *       "TEMPERATURE": 0.3,
              *       "MAX_TOKENS": 0,
              *       "MAX_TOKEN_CONTEXT": 200000,
@@ -5542,7 +5592,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": true,
-             *       "MODEL_NAME": "Wise",
+             *       "MODEL_NAME": "dummy",
              *       "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,
@@ -5555,7 +5605,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "Fast",
+             *       "MODEL_NAME": "dummy",
              *       "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
@@ -5566,7 +5616,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
-             *       "MODEL_NAME": "Fast",
+             *       "MODEL_NAME": "dummy",
              *       "TEMPERATURE": 0.1,
              *       "MAX_TOKENS": 0,
              *       "MAX_PAGES_PER_CALL": 5,
@@ -5587,7 +5637,7 @@ interface components {
              * @default {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": true,
-             *       "MODEL_NAME": "Premium",
+             *       "MODEL_NAME": "",
              *       "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
@@ -5657,7 +5707,7 @@ interface components {
              *       },
              *       "MAX_CONCURRENT_REQUESTS": 256,
              *       "MODEL_NAME": "Qwen/Qwen3-Reranker-0.6B",
-             *       "API_TYPE": "remote",
+             *       "API_TYPE": "local",
              *       "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"
              *     }
              */
@@ -5678,7 +5728,7 @@ interface components {
             /**
              * @default {
              *       "MODEL_NAME": "Qwen/Qwen3-Embedding-0.6B",
-             *       "API_TYPE": "remote",
+             *       "API_TYPE": "local",
              *       "BATCH_SIZE": 128,
              *       "MAX_CONCURRENT_REQUESTS": 256,
              *       "DOCUMENT_PREFIX": "",
@@ -6111,6 +6161,29 @@ interface components {
             /** Audio */
             audio: string;
         };
+        /** BoxMark */
+        BoxMark: {
+            /** Id */
+            id: string;
+            /** Page */
+            page: number;
+            /** Author */
+            author: string;
+            /** Createdat */
+            createdAt: string;
+            /** Updatedat */
+            updatedAt: string;
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            kind: 'box';
+            rect: components['schemas']['MarkupRect'];
+            /** Color */
+            color: string;
+            /** Strokewidth */
+            strokeWidth: number;
+        };
         /**
          * CalendarRead
          * @description A selectable calendar in the picker.
@@ -6432,7 +6505,7 @@ interface components {
             /**
              * Model Name
              * @description Model for code generation. Should be a strong coding model.
-             * @default Premium
+             * @default
              */
             MODEL_NAME: string;
             /**
@@ -6519,6 +6592,34 @@ interface components {
             /** Commands */
             commands: components['schemas']['CommandDescriptorResponse'][];
         };
+        /** CommentMark */
+        CommentMark: {
+            /** Id */
+            id: string;
+            /** Page */
+            page: number;
+            /** Author */
+            author: string;
+            /** Createdat */
+            createdAt: string;
+            /** Updatedat */
+            updatedAt: string;
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            kind: 'comment';
+            rect: components['schemas']['MarkupRect'];
+            /** Body */
+            body: string;
+            /** Replies */
+            replies?: components['schemas']['MarkupReply'][];
+            /**
+             * Resolved
+             * @default false
+             */
+            resolved: boolean;
+        };
         /**
          * CompactionEvent
          * @description Emitted when the thread was compacted this turn.
@@ -7862,6 +7963,16 @@ interface components {
              * @default false
              */
             is_current: boolean;
+            /**
+             * Markup Revision
+             * @default 0
+             */
+            markup_revision: number;
+            /**
+             * Markup Count
+             * @default 0
+             */
+            markup_count: number;
         };
         /**
          * DoctagLLMConfig
@@ -7884,7 +7995,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default Fast
+             * @default dummy
              */
             MODEL_NAME: string;
             /**
@@ -8182,7 +8293,7 @@ interface components {
             /**
              * Api Type
              * @description The inference type (local or remote).
-             * @default remote
+             * @default local
              * @enum {string}
              */
             API_TYPE: 'local' | 'remote';
@@ -8327,7 +8438,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default Fast
+             * @default dummy
              */
             MODEL_NAME: string;
             /**
@@ -8376,7 +8487,8 @@ interface components {
         /**
          * ExportFile
          * @description One file of a download: fetch ``/v1/document/{doc_ext_id}/download?version={version}`` and store
-         *     it at ``path``.
+         *     it at ``path`` — or, for ``markup``, the version's markup PDF from
+         *     ``/v1/document/{doc_ext_id}/markup/pdf?version={version}``.
          */
         ExportFile: {
             /** Doc Ext Id */
@@ -8393,6 +8505,11 @@ interface components {
              * @default true
              */
             is_current: boolean;
+            /**
+             * Markup
+             * @default false
+             */
+            markup: boolean;
         };
         /** FactDeleteResponse */
         FactDeleteResponse: {
@@ -8609,7 +8726,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default Fast
+             * @default dummy
              */
             MODEL_NAME: string;
             /**
@@ -8912,6 +9029,30 @@ interface components {
             /** Detail */
             detail?: components['schemas']['ValidationError'][];
         };
+        /** HighlightMark */
+        HighlightMark: {
+            /** Id */
+            id: string;
+            /** Page */
+            page: number;
+            /** Author */
+            author: string;
+            /** Createdat */
+            createdAt: string;
+            /** Updatedat */
+            updatedAt: string;
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            kind: 'highlight';
+            /** Rects */
+            rects: components['schemas']['MarkupRect'][];
+            /** Color */
+            color: string;
+            /** Text */
+            text?: string | null;
+        };
         /**
          * ImageGenConfig
          * @description Configuration for ImageGen — conversational text→image / image editing.
@@ -9454,6 +9595,67 @@ interface components {
             /** Last Sync At */
             last_sync_at?: string | null;
         };
+        /**
+         * MarkupConflict
+         * @description The 409 body: someone saved first. Re-read, merge by annotation id, save again.
+         */
+        MarkupConflict: {
+            /** Detail */
+            detail: string;
+            /** Revision */
+            revision: number;
+        };
+        /**
+         * MarkupLayerResponse
+         * @description ``GET /v1/document/{id}/markup``: the version's marks and the revision they are at.
+         */
+        MarkupLayerResponse: {
+            /** Doc Ext Id */
+            doc_ext_id: string;
+            /** Version */
+            version: number;
+            /**
+             * Revision
+             * @default 0
+             */
+            revision: number;
+            /** Annotations */
+            annotations?: (components['schemas']['HighlightMark'] | components['schemas']['BoxMark'] | components['schemas']['CommentMark'] | components['schemas']['StampMark'] | components['schemas']['RedactionMark'])[];
+            /** Updated At */
+            updated_at?: string | null;
+            /** Updated By Ext Id */
+            updated_by_ext_id?: string | null;
+            /**
+             * Can Edit
+             * @default false
+             */
+            can_edit: boolean;
+        };
+        /**
+         * MarkupRect
+         * @description A rectangle in fractions of the displayed page, origin top-left.
+         */
+        MarkupRect: {
+            /** X */
+            x: number;
+            /** Y */
+            y: number;
+            /** W */
+            w: number;
+            /** H */
+            h: number;
+        };
+        /** MarkupReply */
+        MarkupReply: {
+            /** Id */
+            id: string;
+            /** Author */
+            author: string;
+            /** Createdat */
+            createdAt: string;
+            /** Body */
+            body: string;
+        };
         /** McpToolInfo */
         McpToolInfo: {
             /** Name */
@@ -9499,7 +9701,7 @@ interface components {
             /**
              * Model Name
              * @description The model for note consolidation. Defaults to reasoning model.
-             * @default Wise
+             * @default dummy
              */
             MODEL_NAME: string;
             /**
@@ -10393,7 +10595,7 @@ interface components {
             /**
              * Model Name
              * @description The model for plan generation. Defaults to reasoning model.
-             * @default Wise
+             * @default dummy
              */
             MODEL_NAME: string;
             /**
@@ -10854,7 +11056,7 @@ interface components {
             /**
              * Model Name
              * @description The model for query answering.
-             * @default Fast
+             * @default dummy
              */
             MODEL_NAME: string;
             /**
@@ -10987,6 +11189,40 @@ interface components {
             /** @description ARBI agent-trace extension (non-standard). */
             arbi?: components['schemas']['ArbiItemMeta'] | null;
         };
+        /** RedactionMark */
+        RedactionMark: {
+            /** Id */
+            id: string;
+            /** Page */
+            page: number;
+            /** Author */
+            author: string;
+            /** Createdat */
+            createdAt: string;
+            /** Updatedat */
+            updatedAt: string;
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            kind: 'redaction';
+            /** Rects */
+            rects: components['schemas']['MarkupRect'][];
+            /** Reason */
+            reason: string;
+            /** Text */
+            text?: string | null;
+            /**
+             * Status
+             * @default pending
+             * @enum {string}
+             */
+            status: 'pending' | 'approved' | 'rejected';
+            /** Reviewedby */
+            reviewedBy?: string | null;
+            /** Reviewedat */
+            reviewedAt?: string | null;
+        };
         /**
          * ReferencedDocuments
          * @description What to do with a document a note / conversation / automation cites but the scope does not include.
@@ -11185,7 +11421,7 @@ interface components {
             /**
              * Api Type
              * @description The inference type (local or remote).
-             * @default remote
+             * @default local
              * @enum {string}
              */
             API_TYPE: 'local' | 'remote';
@@ -11970,7 +12206,7 @@ interface components {
             /**
              * Model Name
              * @description The model for reviewing agent draft answers. Defaults to reasoning model.
-             * @default Wise
+             * @default dummy
              */
             MODEL_NAME: string;
             /**
@@ -12183,6 +12419,29 @@ interface components {
             /** State */
             state?: string | null;
         };
+        /**
+         * SaveMarkupRequest
+         * @description ``PUT /v1/document/{id}/markup``: the whole layer, and the revision the client started from.
+         *
+         *     The ``If-Match`` header, when present, takes precedence over ``base_revision``.
+         */
+        SaveMarkupRequest: {
+            /** Base Revision */
+            base_revision?: number | null;
+            /** Annotations */
+            annotations?: (components['schemas']['HighlightMark'] | components['schemas']['BoxMark'] | components['schemas']['CommentMark'] | components['schemas']['StampMark'] | components['schemas']['RedactionMark'])[];
+        };
+        /** SaveMarkupResponse */
+        SaveMarkupResponse: {
+            /** Doc Ext Id */
+            doc_ext_id: string;
+            /** Version */
+            version: number;
+            /** Revision */
+            revision: number;
+            /** Count */
+            count: number;
+        };
         /**
          * SaveSkillDetail
          * @description Detail for a save_skill tool call.
@@ -12679,6 +12938,29 @@ interface components {
              */
             task_length: number;
         };
+        /** StampMark */
+        StampMark: {
+            /** Id */
+            id: string;
+            /** Page */
+            page: number;
+            /** Author */
+            author: string;
+            /** Createdat */
+            createdAt: string;
+            /** Updatedat */
+            updatedAt: string;
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            kind: 'stamp';
+            rect: components['schemas']['MarkupRect'];
+            /** Label */
+            label: string;
+            /** Color */
+            color: string;
+        };
         /**
          * StepUsage
          * @description Per-step token usage from a single LLM call.
@@ -12793,7 +13075,7 @@ interface components {
             /**
              * Model Name
              * @description The model for conversation summarisation. Defaults to reasoning model.
-             * @default Wise
+             * @default dummy
              */
             MODEL_NAME: string;
             /**
@@ -13142,7 +13424,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default Fast
+             * @default dummy
              */
             MODEL_NAME: string;
             /**
@@ -14309,7 +14591,7 @@ interface components {
             /**
              * Model Name
              * @description The vision-capable model name (must support image inputs).
-             * @default Fast
+             * @default dummy
              */
             MODEL_NAME: string;
             /**
@@ -17533,6 +17815,139 @@ interface operations {
             };
         };
     };
+    get_document_markup: {
+        parameters: {
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
+            header?: {
+                'if-none-match'?: string | null;
+            };
+            path: {
+                document_ext_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['MarkupLayerResponse'];
+                };
+            };
+            /** @description Unchanged since the revision in If-None-Match */
+            304: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    save_document_markup: {
+        parameters: {
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
+            header?: {
+                'if-match'?: string | null;
+            };
+            path: {
+                document_ext_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['SaveMarkupRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['SaveMarkupResponse'];
+                };
+            };
+            /** @description Saved by someone else first; re-read and merge */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['MarkupConflict'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    download_document_markup: {
+        parameters: {
+            query?: {
+                /** @description Document version (default: the current one) */
+                version?: number | null;
+            };
+            header?: never;
+            path: {
+                document_ext_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/pdf': unknown;
+                };
+            };
+            /** @description This version has no markup */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     list_conversations: {
         parameters: {
             query?: never;