@arbidocs/client 0.3.181 → 0.3.183

package/dist/index.d.cts

@@ -1988,6 +1988,30 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/facts/batch': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create Facts Batch Endpoint
+         * @description Create several facts in one transaction — all of them, or none.
+         *
+         *     Prefer this to a loop of single creates for an import: tags are resolved once and the facts are
+         *     embedded in batches after the commit, rather than one request, one tag lookup and one background
+         *     embedding task per fact. Responses come back in request order.
+         */
+        post: operations['create_facts_batch'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/facts/list': {
         parameters: {
             query?: never;
@@ -2003,6 +2027,9 @@ interface paths {
          *     into the timeline: only dated facts, ordered by when they happened. Each
          *     bound is read at its own precision and widened outward, so ``date_to=2019``
          *     runs through 31 December rather than stopping on 1 January.
+         *
+         *     Narrow with ``tag_ext_id`` (repeatable; a fact must carry all of them) and ``doc_ext_id``, and page
+         *     with ``limit``/``offset`` — a large workspace need not be fetched whole.
          */
         get: operations['list_facts'];
         put?: never;
@@ -3401,6 +3428,20 @@ interface components {
          *     follow-up call with this set to true for those specific emails actually sends the
          *     invite and deposits the pending workspace-share grant. Without this gate, sharing
          *     would email and grant future access to a typo'd address with no chance to back out.
+         *
+         *     resource_type + resource_ext_id (optional): set when this call came from sharing a
+         *     specific document or conversation by email rather than the workspace itself (the
+         *     "Share" action on a resource). Every recipient still goes through the normal
+         *     add-user flow above (same role, same confirm_invite gate) — this only attaches a
+         *     breadcrumb so the invite/notification carries a deep link to the resource instead
+         *     of just the workspace, and Contacts.shared_resource_* survives an unregistered
+         *     recipient's registration so their first login redirects straight there.
+         *
+         *     confirm_share (default False): required when the named resource is currently
+         *     private — sharing it externally makes it visible to every workspace member, not
+         *     just the recipients, so this mirrors confirm_invite's explicit-opt-in gate. A call
+         *     naming a private resource without this set does nothing and reports that a
+         *     confirmation is needed; the caller re-calls with it set once the owner confirms.
          */
         AddWorkspaceUsersRequest: {
             /** Emails */
@@ -3415,6 +3456,12 @@ interface components {
             session_pubkey_b64?: string | null;
             /** Confirm Invite */
             confirm_invite?: boolean | null;
+            /** Resource Type */
+            resource_type?: ('document' | 'conversation') | null;
+            /** Resource Ext Id */
+            resource_ext_id?: string | null;
+            /** Confirm Share */
+            confirm_share?: boolean | null;
         };
         /**
          * AgentControlStateEvent
@@ -3563,6 +3610,11 @@ interface components {
              * @description Lifecycle marker for a sub-agent lane: 'running' on the spawn step (carries the child's task in `content`), 'done'/'failed' on its completion. Absent on the child's own intermediate steps. Lets the frontend show each lane's status without inspecting its rows.
              */
             subagent_status?: ('running' | 'done' | 'failed') | null;
+            /**
+             * Task Message Ext Id
+             * @description The persisted branch this sub-agent's run lives in (a role='user' message in the SAME conversation, see subagent_conversation.py) — every delegation persists one (sub_agent, deep_research, run_skill, spawn_coding_agent are all the same underlying mechanism). Lets the frontend jump into the thread via branch navigation instead of only reading the lane.
+             */
+            task_message_ext_id?: string | null;
             /**
              * Step
              * @description Lifecycle step. Absent (None) for tool-call steps, which carry `detail` instead.
@@ -3672,7 +3724,7 @@ interface components {
             RUN_CODE_ENABLED: boolean;
             /**
              * Mcp Tools
-             * @description MCP tool names to enable from LiteLLM (e.g. ['read_wiki_contents', 'ask_question']).
+             * @description MCP tool names to enable from LiteLLM (e.g. ['firecrawl_scrape', 'firecrawl_search']).
              * @default []
              */
             MCP_TOOLS: string[];
@@ -3756,7 +3808,7 @@ interface components {
             SKILL_CREATION: boolean;
             /**
              * Workspace Tools Enabled
-             * @description Enable native user-action tools so the agent can act as an ARBI user within its active workspace: list_workspaces, upload_document, create_tag and tag_documents. In-process and RLS-native — bounded by the agent's workspace memberships. Off by default.
+             * @description Enable native user-action tools so the agent can act as an ARBI user within its active workspace: list_workspaces, upload_document, list_tags, create_tag and tag_documents. In-process and RLS-native — bounded by the agent's workspace memberships. Off by default.
              * @default false
              */
             WORKSPACE_TOOLS_ENABLED: boolean;
@@ -3945,7 +3997,7 @@ interface components {
             RUN_CODE_ENABLED: boolean;
             /**
              * Mcp Tools
-             * @description MCP tool names to enable from LiteLLM (e.g. ['read_wiki_contents', 'ask_question']).
+             * @description MCP tool names to enable from LiteLLM (e.g. ['firecrawl_scrape', 'firecrawl_search']).
              * @default []
              */
             MCP_TOOLS: string[];
@@ -4017,7 +4069,7 @@ interface components {
             SKILLS_ENABLED: boolean;
             /**
              * Workspace Tools Enabled
-             * @description Enable native user-action tools so the agent can act as an ARBI user within its active workspace: list_workspaces, upload_document, create_tag and tag_documents. In-process and RLS-native — bounded by the agent's workspace memberships. Off by default.
+             * @description Enable native user-action tools so the agent can act as an ARBI user within its active workspace: list_workspaces, upload_document, list_tags, create_tag and tag_documents. In-process and RLS-native — bounded by the agent's workspace memberships. Off by default.
              * @default false
              */
             WORKSPACE_TOOLS_ENABLED: boolean;
@@ -4124,7 +4176,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,
@@ -4136,7 +4188,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,
@@ -4148,7 +4200,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,
@@ -4163,7 +4215,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,
@@ -4175,7 +4227,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,
@@ -4189,7 +4241,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 strictly on 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- Only use information explicitly stated in the document; do not infer or assume information not present.\n- If the information is not found, respond with exactly \"Not found\".\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.",
              *       "MAX_TOKEN_CONTEXT_TO_ANSWER": 200000,
              *       "TEMPERATURE": 0.1,
@@ -4250,7 +4302,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,
@@ -4262,7 +4314,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,
@@ -4275,7 +4327,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
@@ -4286,7 +4338,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,
@@ -4307,7 +4359,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
@@ -4377,7 +4429,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"
              *     }
              */
@@ -4398,7 +4450,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": "",
@@ -4574,6 +4626,11 @@ interface components {
              * @description Lane lifecycle marker: 'running' opens the lane (the header — `content` carries the child's task), 'done'/'failed' closes it (`outcome` carries the run summary, `content` the child's synthesis). Absent on the child's own intermediate steps, so `!subagent_status` selects exactly the rows to render inside an expanded lane.
              */
             subagent_status?: ('running' | 'done' | 'failed') | null;
+            /**
+             * Task Message Ext Id
+             * @description The persisted branch this sub-agent's run lives in (a role='user' message in the SAME conversation, see subagent_conversation.py) — every delegation persists one (sub_agent, deep_research, run_skill, spawn_coding_agent are all the same underlying mechanism). Lets the frontend jump into the thread via branch navigation instead of only reading the lane.
+             */
+            task_message_ext_id?: string | null;
             /**
              * Model Recommendation
              * @description FilterPlan model tier (goal item, auto mode).
@@ -4584,6 +4641,16 @@ interface components {
              * @description Resolved model (goal item, auto mode).
              */
             selected_model?: string | null;
+            /**
+             * Kept Doc Ext Ids
+             * @description Goal step only: documents the planner kept for this turn.
+             */
+            kept_doc_ext_ids?: string[] | null;
+            /**
+             * Dropped Doc Ext Ids
+             * @description Goal step only: documents the planner dropped for this turn.
+             */
+            dropped_doc_ext_ids?: string[] | null;
         };
         /**
          * ArtifactEvent
@@ -5114,7 +5181,7 @@ interface components {
             /**
              * Model Name
              * @description Model for code generation. Should be a strong coding model.
-             * @default
+             * @default Premium
              */
             MODEL_NAME: string;
             /**
@@ -5455,6 +5522,11 @@ interface components {
              * @default false
              */
             auto_rename: boolean;
+            /**
+             * Shared
+             * @default false
+             */
+            shared: boolean;
             /**
              * Auto Sync
              * @default false
@@ -5890,6 +5962,14 @@ interface components {
             tag_ext_ids: string[];
             citations?: components['schemas']['CitationSources'] | null;
         };
+        /**
+         * CreateFactsRequest
+         * @description Create several facts in one transaction (all-or-nothing).
+         */
+        CreateFactsRequest: {
+            /** Facts */
+            facts: components['schemas']['CreateFactRequest'][];
+        };
         /**
          * CreatePlanDetail
          * @description Detail for a create_plan tool call.
@@ -6298,7 +6378,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -6557,7 +6637,7 @@ interface components {
             /**
              * Api Type
              * @description The inference type (local or remote).
-             * @default local
+             * @default remote
              * @enum {string}
              */
             API_TYPE: 'local' | 'remote';
@@ -6659,6 +6739,11 @@ interface components {
              * @default false
              */
             auto_rename: boolean;
+            /**
+             * Shared
+             * @default false
+             */
+            shared: boolean;
             /**
              * Auto Sync
              * @default false
@@ -6697,7 +6782,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -6807,6 +6892,12 @@ interface components {
             confirmed: boolean;
             /** Score */
             score: number;
+            citations?: components['schemas']['CitationSources'] | null;
+            /**
+             * Tags
+             * @default []
+             */
+            tags: components['schemas']['FactTagResponse'][];
         };
         /**
          * FactSearchRequest
@@ -6952,7 +7043,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -7508,6 +7599,11 @@ interface components {
              * @default false
              */
             auto_rename: boolean;
+            /**
+             * Shared
+             * @default false
+             */
+            shared: boolean;
             /**
              * Auto Sync
              * @default false
@@ -7561,7 +7657,7 @@ interface components {
             /**
              * Model Name
              * @description The model for note consolidation. Defaults to reasoning model.
-             * @default dummy
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -7640,7 +7736,7 @@ interface components {
             input: string;
             /** Tools */
             tools?: {
-                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['ImageGenerationTool'];
+                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['ImageGenerationTool'] | components['schemas']['SubagentTool'];
             };
             /**
              * Workspace Ext Id
@@ -7692,7 +7788,7 @@ interface components {
             content: string;
             /** Tools */
             tools?: {
-                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['ImageGenerationTool'];
+                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['ImageGenerationTool'] | components['schemas']['SubagentTool'];
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
@@ -7803,7 +7899,7 @@ interface components {
             content: string;
             /** Tools */
             tools?: {
-                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['ImageGenerationTool'];
+                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['ImageGenerationTool'] | components['schemas']['SubagentTool'];
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
@@ -8350,7 +8446,7 @@ interface components {
             /**
              * Model Name
              * @description The model for plan generation. Defaults to reasoning model.
-             * @default dummy
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -8743,7 +8839,7 @@ interface components {
             /**
              * Model Name
              * @description The model for query answering.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -9068,7 +9164,7 @@ interface components {
             /**
              * Api Type
              * @description The inference type (local or remote).
-             * @default local
+             * @default remote
              * @enum {string}
              */
             API_TYPE: 'local' | 'remote';
@@ -9851,7 +9947,7 @@ interface components {
             /**
              * Model Name
              * @description The model for reviewing agent draft answers. Defaults to reasoning model.
-             * @default dummy
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -10211,6 +10307,8 @@ interface components {
             access: string;
             /** Refresh */
             refresh?: string | null;
+            /** Auto Sync Workspace Ext Id */
+            auto_sync_workspace_ext_id?: string | null;
         };
         /** ShareConversationResponse */
         ShareConversationResponse: {
@@ -10389,6 +10487,42 @@ interface components {
                 [key: string]: unknown;
             }[];
         };
+        /** SubagentTool */
+        SubagentTool: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            name: 'subagent';
+            /**
+             * Description
+             * @default sub-agent delegation
+             */
+            description: string;
+            record: components['schemas']['SubagentToolRecord'];
+        };
+        /**
+         * SubagentToolRecord
+         * @description Marker stamped on the task message that branches a conversation into a
+         *     delegated sub-agent's own thread (see ``subagent_conversation.py``).
+         *
+         *     Lives on the TASK (role="user") message, not the reply, since it must be
+         *     readable while the reply doesn't exist yet — a `previous_response_id`
+         *     continuation targeting this thread checks `status` to decide whether to
+         *     steer the live child (Redis ``run_id``) or start an ordinary new turn.
+         */
+        SubagentToolRecord: {
+            /** Handle */
+            handle: string;
+            /** Run Id */
+            run_id: string;
+            /**
+             * Status
+             * @default running
+             * @enum {string}
+             */
+            status: 'running' | 'done' | 'failed';
+        };
         /**
          * SubscriptionInfo
          * @description Subscription info exposed to frontend in user settings.
@@ -10425,7 +10559,7 @@ interface components {
             /**
              * Model Name
              * @description The model for conversation summarisation. Defaults to reasoning model.
-             * @default dummy
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -10852,7 +10986,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -11305,6 +11439,8 @@ interface components {
             skip_duplicates?: boolean | null;
             /** Auto Rename */
             auto_rename?: boolean | null;
+            /** Shared */
+            shared?: boolean | null;
             /** Auto Sync */
             auto_sync?: boolean | null;
             /** Drive Sync Status */
@@ -11401,7 +11537,7 @@ interface components {
             content: string;
             /** Tools */
             tools?: {
-                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['ImageGenerationTool'];
+                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['ImageGenerationTool'] | components['schemas']['SubagentTool'];
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
@@ -11789,7 +11925,7 @@ interface components {
             /**
              * Model Name
              * @description The vision-capable model name (must support image inputs).
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -14848,6 +14984,39 @@ interface operations {
             };
         };
     };
+    create_facts_batch: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['CreateFactsRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['FactResponse'][];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     list_facts: {
         parameters: {
             query?: {
@@ -14858,6 +15027,14 @@ interface operations {
                 date_to?: string | null;
                 /** @description Only facts that carry a date — the timeline view */
                 dated_only?: boolean;
+                /** @description Only facts carrying ALL of these tags */
+                tag_ext_id?: string[] | null;
+                /** @description Only facts whose sources include this document */
+                doc_ext_id?: string | null;
+                /** @description Page size; omit for every matching fact */
+                limit?: number | null;
+                /** @description Facts to skip, for paging with limit */
+                offset?: number;
             };
             header?: never;
             path?: never;
@@ -16260,7 +16437,10 @@ interface operations {
     };
     authorize_connector: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Same-site path (+query) to land on after the grant, instead of the app root. */
+                return_to?: string | null;
+            };
             header?: never;
             path: {
                 vendor_key: components['schemas']['VendorKey'];

package/dist/index.d.ts

@@ -1988,6 +1988,30 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/facts/batch': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create Facts Batch Endpoint
+         * @description Create several facts in one transaction — all of them, or none.
+         *
+         *     Prefer this to a loop of single creates for an import: tags are resolved once and the facts are
+         *     embedded in batches after the commit, rather than one request, one tag lookup and one background
+         *     embedding task per fact. Responses come back in request order.
+         */
+        post: operations['create_facts_batch'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/facts/list': {
         parameters: {
             query?: never;
@@ -2003,6 +2027,9 @@ interface paths {
          *     into the timeline: only dated facts, ordered by when they happened. Each
          *     bound is read at its own precision and widened outward, so ``date_to=2019``
          *     runs through 31 December rather than stopping on 1 January.
+         *
+         *     Narrow with ``tag_ext_id`` (repeatable; a fact must carry all of them) and ``doc_ext_id``, and page
+         *     with ``limit``/``offset`` — a large workspace need not be fetched whole.
          */
         get: operations['list_facts'];
         put?: never;
@@ -3401,6 +3428,20 @@ interface components {
          *     follow-up call with this set to true for those specific emails actually sends the
          *     invite and deposits the pending workspace-share grant. Without this gate, sharing
          *     would email and grant future access to a typo'd address with no chance to back out.
+         *
+         *     resource_type + resource_ext_id (optional): set when this call came from sharing a
+         *     specific document or conversation by email rather than the workspace itself (the
+         *     "Share" action on a resource). Every recipient still goes through the normal
+         *     add-user flow above (same role, same confirm_invite gate) — this only attaches a
+         *     breadcrumb so the invite/notification carries a deep link to the resource instead
+         *     of just the workspace, and Contacts.shared_resource_* survives an unregistered
+         *     recipient's registration so their first login redirects straight there.
+         *
+         *     confirm_share (default False): required when the named resource is currently
+         *     private — sharing it externally makes it visible to every workspace member, not
+         *     just the recipients, so this mirrors confirm_invite's explicit-opt-in gate. A call
+         *     naming a private resource without this set does nothing and reports that a
+         *     confirmation is needed; the caller re-calls with it set once the owner confirms.
          */
         AddWorkspaceUsersRequest: {
             /** Emails */
@@ -3415,6 +3456,12 @@ interface components {
             session_pubkey_b64?: string | null;
             /** Confirm Invite */
             confirm_invite?: boolean | null;
+            /** Resource Type */
+            resource_type?: ('document' | 'conversation') | null;
+            /** Resource Ext Id */
+            resource_ext_id?: string | null;
+            /** Confirm Share */
+            confirm_share?: boolean | null;
         };
         /**
          * AgentControlStateEvent
@@ -3563,6 +3610,11 @@ interface components {
              * @description Lifecycle marker for a sub-agent lane: 'running' on the spawn step (carries the child's task in `content`), 'done'/'failed' on its completion. Absent on the child's own intermediate steps. Lets the frontend show each lane's status without inspecting its rows.
              */
             subagent_status?: ('running' | 'done' | 'failed') | null;
+            /**
+             * Task Message Ext Id
+             * @description The persisted branch this sub-agent's run lives in (a role='user' message in the SAME conversation, see subagent_conversation.py) — every delegation persists one (sub_agent, deep_research, run_skill, spawn_coding_agent are all the same underlying mechanism). Lets the frontend jump into the thread via branch navigation instead of only reading the lane.
+             */
+            task_message_ext_id?: string | null;
             /**
              * Step
              * @description Lifecycle step. Absent (None) for tool-call steps, which carry `detail` instead.
@@ -3672,7 +3724,7 @@ interface components {
             RUN_CODE_ENABLED: boolean;
             /**
              * Mcp Tools
-             * @description MCP tool names to enable from LiteLLM (e.g. ['read_wiki_contents', 'ask_question']).
+             * @description MCP tool names to enable from LiteLLM (e.g. ['firecrawl_scrape', 'firecrawl_search']).
              * @default []
              */
             MCP_TOOLS: string[];
@@ -3756,7 +3808,7 @@ interface components {
             SKILL_CREATION: boolean;
             /**
              * Workspace Tools Enabled
-             * @description Enable native user-action tools so the agent can act as an ARBI user within its active workspace: list_workspaces, upload_document, create_tag and tag_documents. In-process and RLS-native — bounded by the agent's workspace memberships. Off by default.
+             * @description Enable native user-action tools so the agent can act as an ARBI user within its active workspace: list_workspaces, upload_document, list_tags, create_tag and tag_documents. In-process and RLS-native — bounded by the agent's workspace memberships. Off by default.
              * @default false
              */
             WORKSPACE_TOOLS_ENABLED: boolean;
@@ -3945,7 +3997,7 @@ interface components {
             RUN_CODE_ENABLED: boolean;
             /**
              * Mcp Tools
-             * @description MCP tool names to enable from LiteLLM (e.g. ['read_wiki_contents', 'ask_question']).
+             * @description MCP tool names to enable from LiteLLM (e.g. ['firecrawl_scrape', 'firecrawl_search']).
              * @default []
              */
             MCP_TOOLS: string[];
@@ -4017,7 +4069,7 @@ interface components {
             SKILLS_ENABLED: boolean;
             /**
              * Workspace Tools Enabled
-             * @description Enable native user-action tools so the agent can act as an ARBI user within its active workspace: list_workspaces, upload_document, create_tag and tag_documents. In-process and RLS-native — bounded by the agent's workspace memberships. Off by default.
+             * @description Enable native user-action tools so the agent can act as an ARBI user within its active workspace: list_workspaces, upload_document, list_tags, create_tag and tag_documents. In-process and RLS-native — bounded by the agent's workspace memberships. Off by default.
              * @default false
              */
             WORKSPACE_TOOLS_ENABLED: boolean;
@@ -4124,7 +4176,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,
@@ -4136,7 +4188,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,
@@ -4148,7 +4200,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,
@@ -4163,7 +4215,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,
@@ -4175,7 +4227,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,
@@ -4189,7 +4241,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 strictly on 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- Only use information explicitly stated in the document; do not infer or assume information not present.\n- If the information is not found, respond with exactly \"Not found\".\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.",
              *       "MAX_TOKEN_CONTEXT_TO_ANSWER": 200000,
              *       "TEMPERATURE": 0.1,
@@ -4250,7 +4302,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,
@@ -4262,7 +4314,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,
@@ -4275,7 +4327,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
@@ -4286,7 +4338,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,
@@ -4307,7 +4359,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
@@ -4377,7 +4429,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"
              *     }
              */
@@ -4398,7 +4450,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": "",
@@ -4574,6 +4626,11 @@ interface components {
              * @description Lane lifecycle marker: 'running' opens the lane (the header — `content` carries the child's task), 'done'/'failed' closes it (`outcome` carries the run summary, `content` the child's synthesis). Absent on the child's own intermediate steps, so `!subagent_status` selects exactly the rows to render inside an expanded lane.
              */
             subagent_status?: ('running' | 'done' | 'failed') | null;
+            /**
+             * Task Message Ext Id
+             * @description The persisted branch this sub-agent's run lives in (a role='user' message in the SAME conversation, see subagent_conversation.py) — every delegation persists one (sub_agent, deep_research, run_skill, spawn_coding_agent are all the same underlying mechanism). Lets the frontend jump into the thread via branch navigation instead of only reading the lane.
+             */
+            task_message_ext_id?: string | null;
             /**
              * Model Recommendation
              * @description FilterPlan model tier (goal item, auto mode).
@@ -4584,6 +4641,16 @@ interface components {
              * @description Resolved model (goal item, auto mode).
              */
             selected_model?: string | null;
+            /**
+             * Kept Doc Ext Ids
+             * @description Goal step only: documents the planner kept for this turn.
+             */
+            kept_doc_ext_ids?: string[] | null;
+            /**
+             * Dropped Doc Ext Ids
+             * @description Goal step only: documents the planner dropped for this turn.
+             */
+            dropped_doc_ext_ids?: string[] | null;
         };
         /**
          * ArtifactEvent
@@ -5114,7 +5181,7 @@ interface components {
             /**
              * Model Name
              * @description Model for code generation. Should be a strong coding model.
-             * @default
+             * @default Premium
              */
             MODEL_NAME: string;
             /**
@@ -5455,6 +5522,11 @@ interface components {
              * @default false
              */
             auto_rename: boolean;
+            /**
+             * Shared
+             * @default false
+             */
+            shared: boolean;
             /**
              * Auto Sync
              * @default false
@@ -5890,6 +5962,14 @@ interface components {
             tag_ext_ids: string[];
             citations?: components['schemas']['CitationSources'] | null;
         };
+        /**
+         * CreateFactsRequest
+         * @description Create several facts in one transaction (all-or-nothing).
+         */
+        CreateFactsRequest: {
+            /** Facts */
+            facts: components['schemas']['CreateFactRequest'][];
+        };
         /**
          * CreatePlanDetail
          * @description Detail for a create_plan tool call.
@@ -6298,7 +6378,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -6557,7 +6637,7 @@ interface components {
             /**
              * Api Type
              * @description The inference type (local or remote).
-             * @default local
+             * @default remote
              * @enum {string}
              */
             API_TYPE: 'local' | 'remote';
@@ -6659,6 +6739,11 @@ interface components {
              * @default false
              */
             auto_rename: boolean;
+            /**
+             * Shared
+             * @default false
+             */
+            shared: boolean;
             /**
              * Auto Sync
              * @default false
@@ -6697,7 +6782,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -6807,6 +6892,12 @@ interface components {
             confirmed: boolean;
             /** Score */
             score: number;
+            citations?: components['schemas']['CitationSources'] | null;
+            /**
+             * Tags
+             * @default []
+             */
+            tags: components['schemas']['FactTagResponse'][];
         };
         /**
          * FactSearchRequest
@@ -6952,7 +7043,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -7508,6 +7599,11 @@ interface components {
              * @default false
              */
             auto_rename: boolean;
+            /**
+             * Shared
+             * @default false
+             */
+            shared: boolean;
             /**
              * Auto Sync
              * @default false
@@ -7561,7 +7657,7 @@ interface components {
             /**
              * Model Name
              * @description The model for note consolidation. Defaults to reasoning model.
-             * @default dummy
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -7640,7 +7736,7 @@ interface components {
             input: string;
             /** Tools */
             tools?: {
-                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['ImageGenerationTool'];
+                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['ImageGenerationTool'] | components['schemas']['SubagentTool'];
             };
             /**
              * Workspace Ext Id
@@ -7692,7 +7788,7 @@ interface components {
             content: string;
             /** Tools */
             tools?: {
-                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['ImageGenerationTool'];
+                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['ImageGenerationTool'] | components['schemas']['SubagentTool'];
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
@@ -7803,7 +7899,7 @@ interface components {
             content: string;
             /** Tools */
             tools?: {
-                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['ImageGenerationTool'];
+                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['ImageGenerationTool'] | components['schemas']['SubagentTool'];
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
@@ -8350,7 +8446,7 @@ interface components {
             /**
              * Model Name
              * @description The model for plan generation. Defaults to reasoning model.
-             * @default dummy
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -8743,7 +8839,7 @@ interface components {
             /**
              * Model Name
              * @description The model for query answering.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -9068,7 +9164,7 @@ interface components {
             /**
              * Api Type
              * @description The inference type (local or remote).
-             * @default local
+             * @default remote
              * @enum {string}
              */
             API_TYPE: 'local' | 'remote';
@@ -9851,7 +9947,7 @@ interface components {
             /**
              * Model Name
              * @description The model for reviewing agent draft answers. Defaults to reasoning model.
-             * @default dummy
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -10211,6 +10307,8 @@ interface components {
             access: string;
             /** Refresh */
             refresh?: string | null;
+            /** Auto Sync Workspace Ext Id */
+            auto_sync_workspace_ext_id?: string | null;
         };
         /** ShareConversationResponse */
         ShareConversationResponse: {
@@ -10389,6 +10487,42 @@ interface components {
                 [key: string]: unknown;
             }[];
         };
+        /** SubagentTool */
+        SubagentTool: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            name: 'subagent';
+            /**
+             * Description
+             * @default sub-agent delegation
+             */
+            description: string;
+            record: components['schemas']['SubagentToolRecord'];
+        };
+        /**
+         * SubagentToolRecord
+         * @description Marker stamped on the task message that branches a conversation into a
+         *     delegated sub-agent's own thread (see ``subagent_conversation.py``).
+         *
+         *     Lives on the TASK (role="user") message, not the reply, since it must be
+         *     readable while the reply doesn't exist yet — a `previous_response_id`
+         *     continuation targeting this thread checks `status` to decide whether to
+         *     steer the live child (Redis ``run_id``) or start an ordinary new turn.
+         */
+        SubagentToolRecord: {
+            /** Handle */
+            handle: string;
+            /** Run Id */
+            run_id: string;
+            /**
+             * Status
+             * @default running
+             * @enum {string}
+             */
+            status: 'running' | 'done' | 'failed';
+        };
         /**
          * SubscriptionInfo
          * @description Subscription info exposed to frontend in user settings.
@@ -10425,7 +10559,7 @@ interface components {
             /**
              * Model Name
              * @description The model for conversation summarisation. Defaults to reasoning model.
-             * @default dummy
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -10852,7 +10986,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -11305,6 +11439,8 @@ interface components {
             skip_duplicates?: boolean | null;
             /** Auto Rename */
             auto_rename?: boolean | null;
+            /** Shared */
+            shared?: boolean | null;
             /** Auto Sync */
             auto_sync?: boolean | null;
             /** Drive Sync Status */
@@ -11401,7 +11537,7 @@ interface components {
             content: string;
             /** Tools */
             tools?: {
-                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['ImageGenerationTool'];
+                [key: string]: components['schemas']['ModelCitationTool'] | components['schemas']['RetrievalChunkTool'] | components['schemas']['RetrievalFullContextTool'] | components['schemas']['RetrievalTOCTool'] | components['schemas']['TraceTool'] | components['schemas']['CompactionTool'] | components['schemas']['PersonalAgentTool'] | components['schemas']['StreamEventsTool'] | components['schemas']['MemoryTool'] | components['schemas']['GoalTool'] | components['schemas']['ImageGenerationTool'] | components['schemas']['SubagentTool'];
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
@@ -11789,7 +11925,7 @@ interface components {
             /**
              * Model Name
              * @description The vision-capable model name (must support image inputs).
-             * @default dummy
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -14848,6 +14984,39 @@ interface operations {
             };
         };
     };
+    create_facts_batch: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['CreateFactsRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['FactResponse'][];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
     list_facts: {
         parameters: {
             query?: {
@@ -14858,6 +15027,14 @@ interface operations {
                 date_to?: string | null;
                 /** @description Only facts that carry a date — the timeline view */
                 dated_only?: boolean;
+                /** @description Only facts carrying ALL of these tags */
+                tag_ext_id?: string[] | null;
+                /** @description Only facts whose sources include this document */
+                doc_ext_id?: string | null;
+                /** @description Page size; omit for every matching fact */
+                limit?: number | null;
+                /** @description Facts to skip, for paging with limit */
+                offset?: number;
             };
             header?: never;
             path?: never;
@@ -16260,7 +16437,10 @@ interface operations {
     };
     authorize_connector: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Same-site path (+query) to land on after the grant, instead of the app root. */
+                return_to?: string | null;
+            };
             header?: never;
             path: {
                 vendor_key: components['schemas']['VendorKey'];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbidocs/client",
-  "version": "0.3.181",
+  "version": "0.3.183",
   "description": "TypeScript SDK for the ARBI API — zero-knowledge auth, E2E encryption, and type-safe REST client",
   "type": "module",
   "main": "dist/index.cjs",