@arbidocs/client 0.3.11 → 0.3.14

package/dist/index.d.ts

@@ -580,6 +580,7 @@ interface paths {
          *     - parent_ext_id: Links new document as child of parent (version chain)
          *     - wp_type: Document type (source, skill, memory, artifact). Defaults to 'source'.
          *     - tag_ext_id: Links document to a tag
+         *     - folder: Logical folder path for grouping (URL safe, e.g., 'skills/weather')
          *
          *     Requires active subscription (paid/trial/dev) if Stripe is configured.
          */
@@ -889,10 +890,7 @@ interface paths {
         put?: never;
         /**
          * Submit human input to an active agent workflow
-         * @description Send a user message to an active agent workflow.
-         *
-         *     Works for both ask_user responses (agent is paused) and interjections
-         *     (agent is actively working). Both use the same unified message queue.
+         * @description Send a user response to an active agent workflow (ask_user tool).
          */
         post: operations['respond_to_agent'];
         delete?: never;
@@ -1336,13 +1334,40 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Query
-         * @description Process a user query against documents in a workspace.
-         *     Performs retrieval augmented generation with streaming response.
+         * Create Response
+         * @description Create a model response (OpenAI Responses API).
          *
-         *     Requires active subscription (paid/trial/dev) if Stripe is configured.
+         *     Supports all combinations of ``stream`` and ``background``:
+         *     - ``stream=false, background=false``: blocks, returns completed JSON
+         *     - ``stream=true,  background=false``: SSE stream (resilient to disconnect)
+         *     - ``background=true``: 202 immediately, task runs to completion
          */
-        post: operations['query_v1_responses_post'];
+        post: operations['create_response'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/responses/{response_id}': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Response
+         * @description Retrieve a response by ID.
+         *
+         *     Returns the current state with progressive event accumulation:
+         *     - ``in_progress`` with accumulated events if the task is still active
+         *     - ``completed`` with output and persisted events if in the database
+         *     - 404 if not found
+         */
+        get: operations['get_response'];
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
@@ -1388,7 +1413,7 @@ interface components {
          *          "focus": "Searching for force majeure clauses across the selected contracts.",
          *          "detail": [
          *             {"tool": "search_documents", "query": "force majeure", "search_mode": "hybrid"},
-         *             {"tool": "get_table_of_contents", "doc_count": 2}
+         *             {"tool": "get_table_of_contents", "doc_count": 2, "doc_ext_ids": ["doc-abc12345", "doc-def67890"]}
          *         ]}
          *         {"type": "arbi.agent_step", "index": 3,
          *          "focus": "Comparing the provisions found in Contract A with Contract B.",
@@ -1401,6 +1426,9 @@ interface components {
          *         {"type": "arbi.agent_step", "index": 3, "detail": [
          *             {"tool": "personal_agent", "task": "Execute Python code to compute the SHA256 hash..."}
          *         ]}
+         *         {"type": "arbi.agent_step", "index": 3, "detail": [
+         *             {"tool": "read_url", "url": "https://example.com/article"}
+         *         ]}
          *         {"type": "arbi.agent_step", "index": 4, "step": "evaluation", "detail": [
          *             {"statement": "Newton prosecuted 28 coiners", "chunk_ids": ["chunk-abc"]},
          *             {"statement": "Counterfeiting was high treason", "chunk_ids": ["chunk-def"]}
@@ -1450,6 +1478,8 @@ interface components {
             detail?: {
                 [key: string]: unknown;
             }[] | null;
+            /** @description Token usage for the LLM call in this step. */
+            usage?: components['schemas']['StepUsage'] | null;
             /** @description Token budget context snapshot. Present when retrieval counts change. */
             context?: components['schemas']['TokenBudgetContext'] | null;
         };
@@ -1467,11 +1497,13 @@ interface components {
             /**
              * Human In The Loop
              * @description Enable the ask_user tool, allowing the agent to pause and ask the user a question with options.
-             * @default true
+             * @default false
              */
             HUMAN_IN_THE_LOOP: boolean;
             /** @description Web search tool configuration. */
             WEB_SEARCH?: components['schemas']['WebSearchConfig'];
+            /** @description Configuration for the run_code tool (Docker sandbox code execution). */
+            RUN_CODE?: components['schemas']['RunCodeConfig'];
             /**
              * Mcp Tools
              * @description MCP tool names to enable from LiteLLM (e.g. ['read_wiki_contents', 'ask_question']).
@@ -1502,12 +1534,42 @@ interface components {
              * @default false
              */
             VISION_ENABLED: boolean;
+            /**
+             * Doc Index Compact Threshold
+             * @description When the workspace has more documents than this, omit the Subject column from the document index to save tokens.
+             * @default 20
+             */
+            DOC_INDEX_COMPACT_THRESHOLD: number;
+            /**
+             * Doc Index Skip Threshold
+             * @description When the workspace has more documents than this, omit the document index entirely. The agent discovers documents via search_documents instead.
+             * @default 200
+             */
+            DOC_INDEX_SKIP_THRESHOLD: number;
             /**
              * Personal Agent
              * @description Enable the personal_agent tool for delegating tasks to an external agent via OpenClaw.
              * @default false
              */
             PERSONAL_AGENT: boolean;
+            /**
+             * Memory Enabled
+             * @description Run memory synthesis (skills, memories) after agent queries.
+             * @default false
+             */
+            MEMORY_ENABLED: boolean;
+            /**
+             * Skills Enabled
+             * @description Enable the skills system: /skill (create) and /<skill-name> (invoke) commands.
+             * @default false
+             */
+            SKILLS_ENABLED: boolean;
+            /**
+             * Skill Creation
+             * @description Transient flag set by /skill command to enable the save_skill agent tool.
+             * @default false
+             */
+            SKILL_CREATION: boolean;
             /**
              * Review Enabled
              * @description Enable ReviewLLM to review agent draft answers against source material before sending to the user. Uses the reasoning model for higher quality.
@@ -1517,15 +1579,13 @@ interface components {
             /**
              * Persona
              * @description Agent persona prepended to the system prompt. Customise to change the agent's identity and tone.
-             * @default You are ARBI, an AI assistant created by ARBI CITY.
-             *
-             *     You maintain formal, objective tone appropriate for professional/legal contexts. If any part of the answer is based on general knowledge instead of the supplied sources, you must state so clearly and recognise that it may not be accurate.
+             * @default You are ARBI, an AI assistant created by ARBI CITY. Be proactive, helpful and professional.
              */
             PERSONA: string;
             /**
              * Agent Model Name
              * @description The name of the model to be used for the agent decision-making.
-             * @default Q3VL@ARBICITY
+             * @default Fast
              */
             AGENT_MODEL_NAME: string;
             /**
@@ -1538,19 +1598,19 @@ interface components {
             /**
              * Llm Agent Temperature
              * @description Temperature value for agent LLM.
-             * @default 0.7
+             * @default 1
              */
             LLM_AGENT_TEMPERATURE: number;
             /**
              * Agent Max Tokens
              * @description Maximum tokens for the agent LLM response.
-             * @default 20000
+             * @default 10000
              */
             AGENT_MAX_TOKENS: number;
             /**
              * Agent Max Iterations
              * @description Maximum number of tool call iterations before forcing an answer.
-             * @default 10
+             * @default 20
              */
             AGENT_MAX_ITERATIONS: number;
             /**
@@ -1568,41 +1628,31 @@ interface components {
             /**
              * Agent System Prompt
              * @description System prompt for the agent. Dynamic context is appended automatically.
-             * @default YOU ARE:
-             *     ARBI — an AI assistant made by Arbitration City Ltd (https://arbicity.com), capable of helping with a wide variety of tasks using workspace documents, web search, and general knowledge.
-             *     Always respond in first person. Be helpful and natural, not overly formal.
+             * @default Answer any question the user asks. You have access to workspace documents — use them when relevant. When no documents are relevant, answer from your own knowledge. Always provide a helpful answer.
              *
-             *     YOUR TASK:
-             *     Answer the user's query. Use workspace documents when relevant. If appropriate, you may use available tools to perform external research.
+             *     IMPORTANT: Never say "I don't have information in the available documents" or refuse to answer. If documents are not relevant, just answer the question directly from your own knowledge.
              *
-             *     ANSWERING GUIDELINES:
-             *     - If the answer comes from workspace documents, cite them normally.
-             *     - If the answer comes from external research, say so.
-             *     - If the answer is based on general knowledge (no tool results), state that
-             *       it is based on general knowledge and may not be fully accurate.
-             *     - You are allowed to answer questions that are not about the documents.
+             *     When using documents, retrieve actual document content — do not rely on metadata or headings alone. Cross-check information across sources. Not all assertions in sources are factual — some are arguments by a party. Attribute claims to their source where parties disagree.
              *
-             *     EFFICIENCY GUIDELINES:
-             *     1. PARALLEL CALLS: When a query has multiple aspects, call multiple tools in parallel (e.g., search different keywords simultaneously)
-             *     2. AVOID DUPLICATION: Before searching, review learnings from previous results. Do not repeat searches for information you already have
-             *     3. TARGETED SEARCHES: Use specific, focused queries rather than broad ones
-             *     4. NARROW RETRIEVALS: When retrieving document passages, use sub-page references (e.g. 5.3-8.1) where available from search results or table of contents. Request narrow ranges per call and fetch additional ranges in subsequent iterations if needed — avoid fetching entire documents at once
-             *     5. STOP WHEN READY: Provide your answer when you have sufficient evidence. Signs you have enough:
-             *        - Multiple sources confirm the same facts
-             *        - Key questions from the query are addressed
-             *        - Additional searches return redundant information
+             *     DOCUMENT STRATEGY:
+             *     - For overview/summary requests: use get_table_of_contents first, then read key sections with get_document_passages.
+             *     - For specific questions: use search_documents to find relevant sections, then read those sections.
+             *     - Never search for meta-queries like "summary" or "overview" — search for the actual subject matter.
              *
-             *     WORKFLOW:
-             *     1. For complex multi-document queries, plan your approach before executing searches
-             *     2. Choose the right tool for each need — documents for uploaded content, web for external/current info
-             *     3. Execute parallel searches for different aspects when appropriate
-             *     4. Evaluate results - extract learnings, note gaps
-             *     5. Only search again if specific gaps remain unfilled
-             *     6. Answer when confident (no tool call) - do not over-research
+             *     FORMATTING:
+             *     - Start your answer directly with the content — never open with a description of what you searched for or read (e.g. never write "Searching for X", "Reading Y", "I found Z documents" as the first lines of an answer).
+             *     - Use markdown: headings, bold, bullet points, numbered lists
+             *     - Main conclusion first, followed by supporting points
+             *     - Bullet points for lists of discrete items
+             *     - Numbering for sequential steps or prioritized items
+             *     - Bold text for critical conclusions or decision points
              *
-             *     IMPORTANT:
-             *     - The document index contains metadata only - you must retrieve actual content
-             *     - Do not add inline citation markers - the system handles citations automatically
+             *     EFFICIENCY:
+             *     1. Before each step, review the results of prior steps. Adapt your approach based on what you learned — if a call was rejected or returned poor results, adjust your strategy.
+             *     2. Call multiple tools in parallel when a query has several aspects.
+             *     3. NEVER repeat a tool call with the same arguments.
+             *     4. Use targeted queries and narrow page ranges per retrieval call.
+             *     5. Stop when you have sufficient evidence — do not over-research.
              */
             AGENT_SYSTEM_PROMPT: string;
         };
@@ -1611,35 +1661,47 @@ interface components {
             /**
              * @default {
              *       "ENABLED": true,
-             *       "HUMAN_IN_THE_LOOP": true,
+             *       "HUMAN_IN_THE_LOOP": false,
              *       "WEB_SEARCH": {
              *         "ENABLED": false,
              *         "SAVE_SOURCES": true
              *       },
+             *       "RUN_CODE": {
+             *         "ENABLED": false,
+             *         "IMAGE": "arbi-sandbox:bookworm-slim",
+             *         "MEMORY_LIMIT": "512m",
+             *         "NETWORK": "bridge",
+             *         "TIMEOUT_SECONDS": 60
+             *       },
              *       "MCP_TOOLS": [],
              *       "PLANNING_ENABLED": false,
              *       "SUGGESTED_QUERIES": false,
              *       "ARTIFACTS_ENABLED": false,
              *       "VISION_ENABLED": false,
+             *       "DOC_INDEX_COMPACT_THRESHOLD": 20,
+             *       "DOC_INDEX_SKIP_THRESHOLD": 200,
              *       "PERSONAL_AGENT": false,
+             *       "MEMORY_ENABLED": false,
+             *       "SKILLS_ENABLED": false,
+             *       "SKILL_CREATION": false,
              *       "REVIEW_ENABLED": false,
-             *       "PERSONA": "You are ARBI, an AI assistant created by ARBI CITY.\n\nYou maintain formal, objective tone appropriate for professional/legal contexts. If any part of the answer is based on general knowledge instead of the supplied sources, you must state so clearly and recognise that it may not be accurate.",
-             *       "AGENT_MODEL_NAME": "Q3VL@ARBICITY",
+             *       "PERSONA": "You are ARBI, an AI assistant created by ARBI CITY. Be proactive, helpful and professional.",
+             *       "AGENT_MODEL_NAME": "Fast",
              *       "AGENT_API_TYPE": "remote",
-             *       "LLM_AGENT_TEMPERATURE": 0.7,
-             *       "AGENT_MAX_TOKENS": 20000,
-             *       "AGENT_MAX_ITERATIONS": 10,
+             *       "LLM_AGENT_TEMPERATURE": 1,
+             *       "AGENT_MAX_TOKENS": 10000,
+             *       "AGENT_MAX_ITERATIONS": 20,
              *       "MAX_PASSAGE_PAGES": 10,
              *       "AGENT_HISTORY_CHAR_THRESHOLD": 8000,
-             *       "AGENT_SYSTEM_PROMPT": "YOU ARE:\nARBI — an AI assistant made by Arbitration City Ltd (https://arbicity.com), capable of helping with a wide variety of tasks using workspace documents, web search, and general knowledge.\nAlways respond in first person. Be helpful and natural, not overly formal.\n\nYOUR TASK:\nAnswer the user's query. Use workspace documents when relevant. If appropriate, you may use available tools to perform external research.\n\nANSWERING GUIDELINES:\n- If the answer comes from workspace documents, cite them normally.\n- If the answer comes from external research, say so.\n- If the answer is based on general knowledge (no tool results), state that\n  it is based on general knowledge and may not be fully accurate.\n- You are allowed to answer questions that are not about the documents.\n\nEFFICIENCY GUIDELINES:\n1. PARALLEL CALLS: When a query has multiple aspects, call multiple tools in parallel (e.g., search different keywords simultaneously)\n2. AVOID DUPLICATION: Before searching, review learnings from previous results. Do not repeat searches for information you already have\n3. TARGETED SEARCHES: Use specific, focused queries rather than broad ones\n4. NARROW RETRIEVALS: When retrieving document passages, use sub-page references (e.g. 5.3-8.1) where available from search results or table of contents. Request narrow ranges per call and fetch additional ranges in subsequent iterations if needed — avoid fetching entire documents at once\n5. STOP WHEN READY: Provide your answer when you have sufficient evidence. Signs you have enough:\n   - Multiple sources confirm the same facts\n   - Key questions from the query are addressed\n   - Additional searches return redundant information\n\nWORKFLOW:\n1. For complex multi-document queries, plan your approach before executing searches\n2. Choose the right tool for each need — documents for uploaded content, web for external/current info\n3. Execute parallel searches for different aspects when appropriate\n4. Evaluate results - extract learnings, note gaps\n5. Only search again if specific gaps remain unfilled\n6. Answer when confident (no tool call) - do not over-research\n\nIMPORTANT:\n- The document index contains metadata only - you must retrieve actual content\n- Do not add inline citation markers - the system handles citations automatically"
+             *       "AGENT_SYSTEM_PROMPT": "Answer any question the user asks. You have access to workspace documents — use them when relevant. When no documents are relevant, answer from your own knowledge. Always provide a helpful answer.\n\nIMPORTANT: Never say \"I don't have information in the available documents\" or refuse to answer. If documents are not relevant, just answer the question directly from your own knowledge.\n\nWhen using documents, retrieve actual document content — do not rely on metadata or headings alone. Cross-check information across sources. Not all assertions in sources are factual — some are arguments by a party. Attribute claims to their source where parties disagree.\n\nDOCUMENT STRATEGY:\n- For overview/summary requests: use get_table_of_contents first, then read key sections with get_document_passages.\n- For specific questions: use search_documents to find relevant sections, then read those sections.\n- Never search for meta-queries like \"summary\" or \"overview\" — search for the actual subject matter.\n\nFORMATTING:\n- Start your answer directly with the content — never open with a description of what you searched for or read (e.g. never write \"Searching for X\", \"Reading Y\", \"I found Z documents\" as the first lines of an answer).\n- Use markdown: headings, bold, bullet points, numbered lists\n- Main conclusion first, followed by supporting points\n- Bullet points for lists of discrete items\n- Numbering for sequential steps or prioritized items\n- Bold text for critical conclusions or decision points\n\nEFFICIENCY:\n1. Before each step, review the results of prior steps. Adapt your approach based on what you learned — if a call was rejected or returned poor results, adjust your strategy.\n2. Call multiple tools in parallel when a query has several aspects.\n3. NEVER repeat a tool call with the same arguments.\n4. Use targeted queries and narrow page ranges per retrieval call.\n5. Stop when you have sufficient evidence — do not over-research."
              *     }
              */
             Agents: components['schemas']['AgentsConfig'];
             /**
              * @default {
              *       "API_TYPE": "remote",
-             *       "MODEL_NAME": "Q3VL@ARBICITY",
-             *       "SYSTEM_INSTRUCTION": "You are ARBI, an AI assistant created by ARBI CITY.\n\nYou maintain formal, objective tone appropriate for professional/legal contexts. If any part of the answer is based on general knowledge instead of the supplied sources, you must state so clearly and recognise that it may not be accurate.You can ask a follow-up question instead of answering immediately if you are confused by the question and unable to intuit the user's intent.\n\nStructure responses with clear headings and logical organization:\n- Use hierarchical organization: main conclusion first, followed by supporting points\n- Bullet points for lists of discrete items\n- Numbering for sequential steps or prioritized items\n- Bold text for critical conclusions or decision points\n\nYou should recognise that not all assertions in the sources are factual. Some are mere assertions/arguments by the author, particularly in a legal context where different parties may express different opinions or even contradict each other's factual narrative.  The best way to handle this is usually to attribute where the information comes from. I.e. according to xx document, or xx party.\n\nYou should avoid generalisations and provide exact quotations where possible.   Never make up citations, facts or other information.   Acknowledge uncertainty where source materials are insufficient or ambiguous.",
+             *       "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_CHAR_SIZE_TO_ANSWER": 200000,
              *       "TEMPERATURE": 0.1,
              *       "MAX_TOKENS": 5000
@@ -1649,7 +1711,7 @@ interface components {
             /**
              * @default {
              *       "API_TYPE": "remote",
-             *       "MODEL_NAME": "GPTOSS120@ARBICITY",
+             *       "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": 5000,
@@ -1660,7 +1722,7 @@ interface components {
             /**
              * @default {
              *       "API_TYPE": "remote",
-             *       "MODEL_NAME": "Q3VL@ARBICITY",
+             *       "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": 20000,
@@ -1671,7 +1733,7 @@ interface components {
             /**
              * @default {
              *       "API_TYPE": "remote",
-             *       "MODEL_NAME": "Q3VL@ARBICITY",
+             *       "MODEL_NAME": "Fast",
              *       "SYSTEM_INSTRUCTION": "You are a title generator that creates concise, descriptive titles.",
              *       "MAX_CHAR_SIZE_TO_ANSWER": 50,
              *       "TEMPERATURE": 0.3,
@@ -1682,7 +1744,7 @@ interface components {
             /**
              * @default {
              *       "API_TYPE": "remote",
-             *       "MODEL_NAME": "GPTOSS120@ARBICITY",
+             *       "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": 2000,
@@ -1695,7 +1757,7 @@ interface components {
             /**
              * @default {
              *       "API_TYPE": "remote",
-             *       "MODEL_NAME": "Q3VL@ARBICITY",
+             *       "MODEL_NAME": "Fast",
              *       "SYSTEM_INSTRUCTION": "You are a document analysis assistant. Answer questions based strictly on document content.\n\nGuidelines:\n- Only use information explicitly stated in the document\n- Do not infer or assume information not present\n- If information is not found, respond with \"Information not found in document.\"\n- Follow format instructions exactly for each answer\n- Be concise and precise",
              *       "MAX_CHAR_CONTEXT_TO_ANSWER": 100000,
              *       "TEMPERATURE": 0.1,
@@ -1753,8 +1815,7 @@ interface components {
             /**
              * @default {
              *       "API_TYPE": "remote",
-             *       "MODEL_NAME": "GPTOSS120@ARBICITY",
-             *       "ENABLED": true,
+             *       "MODEL_NAME": "Wise",
              *       "SYSTEM_INSTRUCTION": "You are a knowledge synthesizer. You receive the full agent scratchpad from a completed conversation and decide what, if anything, is worth saving.\n\n## Work Product Types\n- **\"memory\"**: Facts, findings, reference data — for *looking up* information.\n- **\"skill\"**: Procedures, workflows, step-by-step instructions — for *doing* something.\n\nWhen ambiguous, default to memory.\n\n## Rules\n- Return an empty work_products array if the conversation is trivial or produced nothing substantive.\n- Each work product must cover ONE coherent topic. Never combine disparate subjects into a single document — create separate documents for each distinct topic.\n- Ground everything in the provided context. Do not invent information.\n- Be concise. These are reference documents, not essays.\n\n## Output Format\nJSON with a `work_products` array. Each item has `wp_type`, `title`, and `content` (markdown).\n\nMemory content: `# Title`, date, source, key findings as bullets, source documents.\nSkill content: `# Title`, prerequisites, numbered steps, when to apply.",
              *       "TEMPERATURE": 0.3,
              *       "MAX_TOKENS": 8000,
@@ -1766,7 +1827,7 @@ interface components {
             /**
              * @default {
              *       "API_TYPE": "remote",
-             *       "MODEL_NAME": "GPTOSS120@ARBICITY",
+             *       "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_documents: Search workspace documents for relevant passages (semantic, keyword, or hybrid)\n- get_document_passages: Read a specific page range from a document\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": 4000,
@@ -1778,7 +1839,7 @@ interface components {
             /**
              * @default {
              *       "API_TYPE": "remote",
-             *       "MODEL_NAME": "Q3VL@ARBICITY",
+             *       "MODEL_NAME": "Fast",
              *       "TEMPERATURE": 0.1,
              *       "MAX_TOKENS": 4000,
              *       "MAX_PAGES_PER_CALL": 5,
@@ -1788,7 +1849,18 @@ interface components {
             VisionLLM: components['schemas']['VisionLLMConfig'];
             /**
              * @default {
-             *       "SIM_THREASHOLD": 0.1,
+             *       "API_TYPE": "remote",
+             *       "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": 8000,
+             *       "MAX_ITERATIONS": 3
+             *     }
+             */
+            CodeAgent: components['schemas']['CodeAgentConfig'];
+            /**
+             * @default {
+             *       "SIM_THREASHOLD": 0.5,
              *       "MIN_CHAR_SIZE_TO_ANSWER": 30,
              *       "MAX_NUMB_CITATIONS": 5
              *     }
@@ -1809,19 +1881,25 @@ interface components {
             Retriever: components['schemas']['RetrieverConfig'];
             /**
              * @default {
+             *       "MIN_SCORE": 0.01,
              *       "MAX_NUMB_OF_CHUNKS": 30,
              *       "MAX_CONCURRENT_REQUESTS": 64,
              *       "MODEL_NAME": "Qwen/Qwen3-Reranker-0.6B",
-             *       "API_TYPE": "remote",
-             *       "QUERY_INSTRUCTION": "Given a user query, retrieve relevant passages from documents that answer the query"
+             *       "API_TYPE": "remote"
              *     }
              */
             Reranker: components['schemas']['RerankerConfig'];
-            /** @default {} */
+            /**
+             * @default {
+             *       "SKIP_DUPLICATES": false
+             *     }
+             */
             Parser: components['schemas']['ParserConfig'];
             /**
              * @default {
-             *       "MAX_CHUNK_TOKENS": 8000
+             *       "MAX_CHUNK_TOKENS": 1200,
+             *       "TOKENIZER_TYPE": "huggingface",
+             *       "TOKENIZER_NAME": "Qwen/Qwen3-Embedding-0.6B"
              *     }
              */
             Chunker: components['schemas']['ChunkerConfig'];
@@ -1847,6 +1925,42 @@ interface components {
              */
             KeywordEmbedder: components['schemas']['KeywordEmbedderConfig'];
         };
+        /**
+         * AllLlmCallsAggregate
+         * @description Aggregate token usage across all LLM calls within a single request.
+         */
+        AllLlmCallsAggregate: {
+            /**
+             * Count
+             * @description Number of LLM calls made
+             */
+            count: number;
+            /**
+             * Input Tokens
+             * @description Sum of prompt tokens across all calls
+             */
+            input_tokens: number;
+            /**
+             * Output Tokens
+             * @description Sum of completion tokens across all calls
+             */
+            output_tokens: number;
+            /**
+             * Reasoning Tokens
+             * @description Sum of reasoning tokens across all calls
+             */
+            reasoning_tokens: number;
+            /**
+             * Total Tokens
+             * @description Sum of all tokens across all calls
+             */
+            total_tokens: number;
+            /**
+             * Last Input Tokens
+             * @description Input tokens from the most recent LLM call (= current thread size)
+             */
+            last_input_tokens: number;
+        };
         /**
          * ArtifactEvent
          * @description A generated artifact (document/draft) for the artifact panel.
@@ -1918,6 +2032,23 @@ interface components {
              */
             message_ext_id?: string | null;
         };
+        /**
+         * AskUserDetail
+         * @description Detail for an ask_user tool call.
+         */
+        AskUserDetail: {
+            /**
+             * Tool
+             * @default ask_user
+             * @constant
+             */
+            tool: 'ask_user';
+            /**
+             * Question
+             * @description Question for the user (truncated to 80 chars)
+             */
+            question: string;
+        };
         /**
          * AuthMessage
          * @description Client authentication message.
@@ -2116,10 +2247,23 @@ interface components {
         ChunkerConfig: {
             /**
              * Max Chunk Tokens
-             * @description Maximum tokens per chunk. Chunks exceeding this are force-split at token boundaries.
-             * @default 8000
+             * @description Maximum tokens per chunk. The tokenizer used depends on TOKENIZER_TYPE.
+             * @default 1200
              */
             MAX_CHUNK_TOKENS: number;
+            /**
+             * Tokenizer Type
+             * @description Tokenizer backend: 'tiktoken' for OpenAI models (cl100k_base, etc.) or 'huggingface' for HF models (Qwen3-Embedding, etc.).
+             * @default huggingface
+             * @enum {string}
+             */
+            TOKENIZER_TYPE: 'tiktoken' | 'huggingface';
+            /**
+             * Tokenizer Name
+             * @description Tokenizer name. For tiktoken: 'cl100k_base', 'o200k_base', etc. For huggingface: model name like 'Qwen/Qwen3-Embedding-0.6B'.
+             * @default Qwen/Qwen3-Embedding-0.6B
+             */
+            TOKENIZER_NAME: string;
         };
         /**
          * CitationData
@@ -2128,6 +2272,11 @@ interface components {
         CitationData: {
             /** Chunk Ids */
             chunk_ids: string[];
+            /**
+             * Scores
+             * @default []
+             */
+            scores: number[];
             /** Statement */
             statement: string;
             /** Offset Start */
@@ -2135,6 +2284,64 @@ interface components {
             /** Offset End */
             offset_end: number;
         };
+        /**
+         * CodeAgentConfig
+         * @description Configuration for CodeAgent — sub-agent that writes and executes code via sandbox.
+         */
+        CodeAgentConfig: {
+            /**
+             * Api Type
+             * @description The inference type (local or remote).
+             * @default remote
+             * @enum {string}
+             */
+            API_TYPE: 'local' | 'remote';
+            /**
+             * Model Name
+             * @description Model for code generation. Should be a strong coding model.
+             * @default Premium
+             */
+            MODEL_NAME: string;
+            /**
+             * System Instruction
+             * @description System prompt for the code execution agent.
+             * @default You are a code execution agent. You write and run code to accomplish tasks.
+             *
+             *     You have access to an execute_code tool that runs code in a sandboxed Docker container.
+             *
+             *     The sandbox has:
+             *     - Python 3.12 with numpy, pandas, matplotlib, requests, beautifulsoup4,
+             *       httpx, pillow, sympy, pyyaml (plus uv for installing more)
+             *     - Node.js 22 with TypeScript (ts-node) and npm
+             *     - Bash with git, curl, wget, jq, sqlite3, build-essential
+             *     - Network access (can pip/npm install additional packages)
+             *
+             *     Instructions:
+             *     1. Write clean, correct code to accomplish the user's task
+             *     2. Always call execute_code to run your code — never guess the output
+             *     3. If execution errors, analyze the traceback, fix the code, and retry
+             *     4. Once you have the correct output, respond with ONLY the final result
+             *
+             *     Keep code simple and direct. Prefer Python unless the task specifically requires another language.
+             */
+            SYSTEM_INSTRUCTION: string;
+            /**
+             * Temperature
+             * @default 0.2
+             */
+            TEMPERATURE: number;
+            /**
+             * Max Tokens
+             * @default 8000
+             */
+            MAX_TOKENS: number;
+            /**
+             * Max Iterations
+             * @description Maximum code-execute-fix retry cycles.
+             * @default 3
+             */
+            MAX_ITERATIONS: number;
+        };
         /** CompactionTool */
         CompactionTool: {
             /**
@@ -2391,6 +2598,29 @@ interface components {
              */
             results: components['schemas']['CopyDocumentResult'][];
         };
+        /**
+         * CreateArtifactDetail
+         * @description Detail for a create_artifact tool call.
+         */
+        CreateArtifactDetail: {
+            /**
+             * Tool
+             * @default create_artifact
+             * @constant
+             */
+            tool: 'create_artifact';
+            /**
+             * Title
+             * @description Artifact title (truncated to 80 chars)
+             */
+            title: string;
+            /**
+             * Mode
+             * @description Rendering mode: markdown, html, text
+             * @default markdown
+             */
+            mode: string;
+        };
         /**
          * CreateDocTagRequest
          * @description Apply a tag to one or more documents.
@@ -2407,6 +2637,23 @@ interface components {
                 [key: string]: components['schemas']['CitationData'];
             } | null;
         };
+        /**
+         * CreatePlanDetail
+         * @description Detail for a create_plan tool call.
+         */
+        CreatePlanDetail: {
+            /**
+             * Tool
+             * @default create_plan
+             * @constant
+             */
+            tool: 'create_plan';
+            /**
+             * Query
+             * @description Planning query (truncated to 80 chars)
+             */
+            query: string;
+        };
         /**
          * CreateSubscriptionRequest
          * @description Request to create a new subscription checkout session.
@@ -2551,6 +2798,8 @@ interface components {
             updated_at: string;
             /** Wp Type */
             wp_type?: string | null;
+            /** Folder */
+            folder?: string | null;
             /**
              * Doctags
              * @default []
@@ -2602,6 +2851,11 @@ interface components {
             status?: 'processing' | null;
             /** Content */
             content?: string | null;
+            /**
+             * Folder
+             * @description Logical folder path (URL safe)
+             */
+            folder?: string | null;
         };
         /**
          * DoctagLLMConfig
@@ -2618,7 +2872,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default Q3VL@ARBICITY
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -2764,6 +3018,17 @@ interface components {
             /** Message */
             message: string;
         };
+        /**
+         * EvaluationDetail
+         * @description Detail for an evaluation learning entry.
+         */
+        EvaluationDetail: {
+            /**
+             * Statement
+             * @description Citation/finding statement
+             */
+            statement: string;
+        };
         /** EvaluatorLLMConfig */
         EvaluatorLLMConfig: {
             /**
@@ -2776,7 +3041,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default Q3VL@ARBICITY
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -2911,6 +3176,72 @@ interface components {
              */
             tag_ext_ids: string[];
         };
+        /**
+         * GetDocumentPassagesDetail
+         * @description Detail for a get_document_passages tool call.
+         */
+        GetDocumentPassagesDetail: {
+            /**
+             * Tool
+             * @default get_document_passages
+             * @constant
+             */
+            tool: 'get_document_passages';
+            /**
+             * Doc Ext Id
+             * @description Document external ID
+             */
+            doc_ext_id: string;
+            /**
+             * From Ref
+             * @description Start reference (page.chunk)
+             */
+            from_ref: string;
+            /**
+             * To Ref
+             * @description End reference (page.chunk)
+             */
+            to_ref: string;
+        };
+        /**
+         * GetFullDocumentDetail
+         * @description Detail for a get_full_document tool call.
+         */
+        GetFullDocumentDetail: {
+            /**
+             * Tool
+             * @default get_full_document
+             * @constant
+             */
+            tool: 'get_full_document';
+            /**
+             * Doc Ext Id
+             * @description Document external ID
+             */
+            doc_ext_id: string;
+        };
+        /**
+         * GetTableOfContentsDetail
+         * @description Detail for a get_table_of_contents tool call.
+         */
+        GetTableOfContentsDetail: {
+            /**
+             * Tool
+             * @default get_table_of_contents
+             * @constant
+             */
+            tool: 'get_table_of_contents';
+            /**
+             * Doc Count
+             * @description Number of documents requested
+             */
+            doc_count: number;
+            /**
+             * Doc Ext Ids
+             * @description Document external IDs
+             */
+            doc_ext_ids: string[];
+        };
         /** HTTPValidationError */
         HTTPValidationError: {
             /** Detail */
@@ -3029,15 +3360,9 @@ interface components {
             /**
              * Model Name
              * @description The model for memory synthesis. Defaults to reasoning model.
-             * @default GPTOSS120@ARBICITY
+             * @default Wise
              */
             MODEL_NAME: string;
-            /**
-             * Enabled
-             * @description Whether to run memory synthesis (skills, memories) after agent queries.
-             * @default true
-             */
-            ENABLED: boolean;
             /**
              * System Instruction
              * @description System instruction for memory classification and synthesis.
@@ -3101,7 +3426,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'];
+                [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'];
             };
             /**
              * Workspace Ext Id
@@ -3117,6 +3442,16 @@ interface components {
              * @default false
              */
             stream: boolean;
+            /**
+             * Background
+             * @default false
+             */
+            background: boolean;
+            /**
+             * Store
+             * @default true
+             */
+            store: boolean;
             /** Instructions */
             instructions?: string | null;
             /** Max Output Tokens */
@@ -3143,7 +3478,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'];
+                [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'];
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
@@ -3204,7 +3539,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'];
+                [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'];
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
@@ -3236,8 +3571,8 @@ interface components {
         ModelCitationConfig: {
             /**
              * Sim Threashold
-             * @description How similar does the statement needs to be to be considered as citation.
-             * @default 0.1
+             * @description Minimum similarity score for a chunk to be cited.
+             * @default 0.5
              */
             SIM_THREASHOLD: number;
             /**
@@ -3279,6 +3614,8 @@ interface components {
             model_name: string;
             /** Api Type */
             api_type: string;
+            /** Tags */
+            tags?: string[] | null;
             /** Max Input Tokens */
             max_input_tokens?: number | null;
             /** Max Output Tokens */
@@ -3330,10 +3667,6 @@ interface components {
             Agents: {
                 [key: string]: string | boolean;
             };
-            /** Memoryllm */
-            MemoryLLM: {
-                [key: string]: boolean;
-            };
         };
         /**
          * NotificationResponse
@@ -3501,7 +3834,60 @@ interface components {
          */
         ParsedStage: 'marker' | 'subchunk' | 'final';
         /** ParserConfig */
-        ParserConfig: Record<string, never>;
+        ParserConfig: {
+            /**
+             * Skip Duplicates
+             * @description Skip files with identical content already in the workspace.
+             * @default false
+             */
+            SKIP_DUPLICATES: boolean;
+        };
+        /**
+         * PersonalAgentDetail
+         * @description Detail for a personal_agent tool call.
+         */
+        PersonalAgentDetail: {
+            /**
+             * Tool
+             * @default personal_agent
+             * @constant
+             */
+            tool: 'personal_agent';
+            /**
+             * Task
+             * @description Task description (truncated to 120 chars)
+             */
+            task: string;
+        };
+        /** PersonalAgentTool */
+        PersonalAgentTool: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            name: 'personal_agent';
+            /**
+             * Description
+             * @default personal agent
+             */
+            description: string;
+            tool_args: components['schemas']['PersonalAgentToolArgs'];
+            /**
+             * Tool Responses
+             * @default {}
+             */
+            tool_responses: {
+                [key: string]: unknown;
+            };
+        };
+        /**
+         * PersonalAgentToolArgs
+         * @description Typed arguments for personal agent tool.
+         */
+        PersonalAgentToolArgs: {
+            /** Task */
+            task: string;
+        };
         /**
          * PlanningLLMConfig
          * @description Configuration for PlanningLLM — generates research plans on demand.
@@ -3520,7 +3906,7 @@ interface components {
             /**
              * Model Name
              * @description The model for plan generation. Defaults to reasoning model.
-             * @default GPTOSS120@ARBICITY
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -3633,25 +4019,13 @@ interface components {
             /**
              * Model Name
              * @description The model for query answering.
-             * @default Q3VL@ARBICITY
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
              * System Instruction
              * @description The system instruction string.
-             * @default You are ARBI, an AI assistant created by ARBI CITY.
-             *
-             *     You maintain formal, objective tone appropriate for professional/legal contexts. If any part of the answer is based on general knowledge instead of the supplied sources, you must state so clearly and recognise that it may not be accurate.You can ask a follow-up question instead of answering immediately if you are confused by the question and unable to intuit the user's intent.
-             *
-             *     Structure responses with clear headings and logical organization:
-             *     - Use hierarchical organization: main conclusion first, followed by supporting points
-             *     - Bullet points for lists of discrete items
-             *     - Numbering for sequential steps or prioritized items
-             *     - Bold text for critical conclusions or decision points
-             *
-             *     You should recognise that not all assertions in the sources are factual. Some are mere assertions/arguments by the author, particularly in a legal context where different parties may express different opinions or even contradict each other's factual narrative.  The best way to handle this is usually to attribute where the information comes from. I.e. according to xx document, or xx party.
-             *
-             *     You should avoid generalisations and provide exact quotations where possible.   Never make up citations, facts or other information.   Acknowledge uncertainty where source materials are insufficient or ambiguous.
+             * @default 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.
              */
             SYSTEM_INSTRUCTION: string;
             /**
@@ -3673,6 +4047,23 @@ interface components {
              */
             MAX_TOKENS: number;
         };
+        /**
+         * ReadUrlDetail
+         * @description Detail for a read_url tool call.
+         */
+        ReadUrlDetail: {
+            /**
+             * Tool
+             * @default read_url
+             * @constant
+             */
+            tool: 'read_url';
+            /**
+             * Url
+             * @description URL to fetch (truncated to 120 chars)
+             */
+            url: string;
+        };
         /**
          * RegisterRequest
          * @description Unified user registration request (local and SSO).
@@ -3726,6 +4117,12 @@ interface components {
         };
         /** RerankerConfig */
         RerankerConfig: {
+            /**
+             * Min Score
+             * @description Minimum reranker score for a chunk to be kept. With the Qwen3 strict fact-matching instruction, relevant chunks score 0.1+ and noise is typically < 0.005.
+             * @default 0.01
+             */
+            MIN_SCORE: number;
             /**
              * Max Numb Of Chunks
              * @description Maximum number of chunks to return after reranking.
@@ -3751,12 +4148,25 @@ interface components {
              * @enum {string}
              */
             API_TYPE: 'local' | 'remote';
+        };
+        /**
+         * ResponseCompleteMessage
+         * @description Background response finished — frontend can reload the conversation.
+         */
+        ResponseCompleteMessage: {
+            /**
+             * Type
+             * @default response_complete
+             * @constant
+             */
+            type: 'response_complete';
+            /** Response Id */
+            response_id: string;
             /**
-             * Query Instruction
-             * @description Instruction for Qwen3-style reranker models. Set empty to disable instruction formatting.
-             * @default Given a user query, retrieve relevant passages from documents that answer the query
+             * Status
+             * @enum {string}
              */
-            QUERY_INSTRUCTION: string;
+            status: 'completed' | 'failed';
         };
         /**
          * ResponseCompletedEvent
@@ -4120,6 +4530,113 @@ interface components {
             /** @description Detailed breakdown of output tokens */
             output_tokens_details?: components['schemas']['OutputTokensDetails'];
         };
+        /**
+         * ResponsesAPIOutputMessage
+         * @description Message output item.
+         */
+        ResponsesAPIOutputMessage: {
+            /**
+             * Type
+             * @default message
+             * @constant
+             */
+            type: 'message';
+            /** Id */
+            id: string;
+            /**
+             * Status
+             * @enum {string}
+             */
+            status: 'completed' | 'in_progress';
+            /**
+             * Role
+             * @default assistant
+             * @constant
+             */
+            role: 'assistant';
+            /**
+             * Content
+             * @default []
+             */
+            content: (components['schemas']['ResponsesAPIOutputText'] | {
+                [key: string]: unknown;
+            })[];
+        };
+        /**
+         * ResponsesAPIOutputText
+         * @description Text output content item.
+         */
+        ResponsesAPIOutputText: {
+            /**
+             * Type
+             * @default output_text
+             * @constant
+             */
+            type: 'output_text';
+            /** Text */
+            text: string;
+            /**
+             * Annotations
+             * @default []
+             */
+            annotations: {
+                [key: string]: unknown;
+            }[];
+        };
+        /**
+         * ResponsesAPIResponse
+         * @description OpenAI Responses API response envelope.
+         */
+        ResponsesAPIResponse: {
+            /** Id */
+            id: string;
+            /**
+             * Object
+             * @default response
+             * @constant
+             */
+            object: 'response';
+            /**
+             * Status
+             * @enum {string}
+             */
+            status: 'completed' | 'in_progress' | 'queued' | 'cancelled' | 'failed' | 'incomplete';
+            /** Created At */
+            created_at?: number | null;
+            /** Model */
+            model?: string | null;
+            /**
+             * Background
+             * @default false
+             */
+            background: boolean;
+            /**
+             * Output
+             * @default []
+             */
+            output: components['schemas']['ResponsesAPIOutputMessage'][];
+            usage?: components['schemas']['ResponsesAPIUsage'] | null;
+            /** Error */
+            error?: {
+                [key: string]: unknown;
+            } | null;
+            /** Metadata */
+            metadata?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        /**
+         * ResponsesAPIUsage
+         * @description Token usage stats.
+         */
+        ResponsesAPIUsage: {
+            /** Input Tokens */
+            input_tokens: number;
+            /** Output Tokens */
+            output_tokens: number;
+            /** Total Tokens */
+            total_tokens: number;
+        };
         /** RetrievalChunkTool */
         RetrievalChunkTool: {
             /**
@@ -4304,7 +4821,7 @@ interface components {
             /**
              * Model Name
              * @description The model for reviewing agent draft answers. Defaults to reasoning model.
-             * @default GPTOSS120@ARBICITY
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -4342,6 +4859,59 @@ interface components {
              */
             MAX_CHAR_SIZE_TO_ANSWER: number;
         };
+        /**
+         * RunCodeConfig
+         * @description Configuration for the run_code agent tool (Docker sandbox).
+         */
+        RunCodeConfig: {
+            /**
+             * Enabled
+             * @description Enable the run_code tool for sandboxed code execution.
+             * @default false
+             */
+            ENABLED: boolean;
+            /**
+             * Image
+             * @description Docker image for sandbox containers.
+             * @default arbi-sandbox:bookworm-slim
+             */
+            IMAGE: string;
+            /**
+             * Timeout Seconds
+             * @description Maximum execution time per run_code call (seconds).
+             * @default 60
+             */
+            TIMEOUT_SECONDS: number;
+            /**
+             * Memory Limit
+             * @description Container memory limit (Docker format, e.g. '256m', '1g').
+             * @default 512m
+             */
+            MEMORY_LIMIT: string;
+            /**
+             * Network
+             * @description Container network mode. 'bridge' allows internet (pip/npm install). 'none' for full isolation.
+             * @default bridge
+             */
+            NETWORK: string;
+        };
+        /**
+         * RunCodeDetail
+         * @description Detail for a run_code tool call.
+         */
+        RunCodeDetail: {
+            /**
+             * Tool
+             * @default run_code
+             * @constant
+             */
+            tool: 'run_code';
+            /**
+             * Task Length
+             * @description Length of the task description
+             */
+            task_length: number;
+        };
         /**
          * SSESchemas
          * @description Container for all SSE event schemas — drives OpenAPI component generation.
@@ -4372,6 +4942,21 @@ interface components {
             output_tokens_details?: components['schemas']['OutputTokensDetails'] | null;
             context_usage?: components['schemas']['ContextUsage'] | null;
             message_metadata?: components['schemas']['MessageMetadataPayload'] | null;
+            detail_search_documents?: components['schemas']['SearchDocumentsDetail'] | null;
+            detail_get_document_passages?: components['schemas']['GetDocumentPassagesDetail'] | null;
+            detail_get_table_of_contents?: components['schemas']['GetTableOfContentsDetail'] | null;
+            detail_view_document_pages?: components['schemas']['ViewDocumentPagesDetail'] | null;
+            detail_get_full_document?: components['schemas']['GetFullDocumentDetail'] | null;
+            detail_web_search?: components['schemas']['WebSearchDetail'] | null;
+            detail_personal_agent?: components['schemas']['PersonalAgentDetail'] | null;
+            detail_read_url?: components['schemas']['ReadUrlDetail'] | null;
+            detail_create_plan?: components['schemas']['CreatePlanDetail'] | null;
+            detail_save_skill?: components['schemas']['SaveSkillDetail'] | null;
+            detail_run_code?: components['schemas']['RunCodeDetail'] | null;
+            detail_create_artifact?: components['schemas']['CreateArtifactDetail'] | null;
+            detail_ask_user?: components['schemas']['AskUserDetail'] | null;
+            detail_evaluation?: components['schemas']['EvaluationDetail'] | null;
+            detail_tool_progress?: components['schemas']['ToolProgressDetail'] | null;
         };
         /** SSOSendVerificationEmailRequest */
         SSOSendVerificationEmailRequest: {
@@ -4427,6 +5012,50 @@ interface components {
             /** Family Name */
             family_name?: string | null;
         };
+        /**
+         * SaveSkillDetail
+         * @description Detail for a save_skill tool call.
+         */
+        SaveSkillDetail: {
+            /**
+             * Tool
+             * @default save_skill
+             * @constant
+             */
+            tool: 'save_skill';
+            /**
+             * Name
+             * @description Skill name
+             */
+            name: string;
+            /**
+             * Title
+             * @description Skill title (truncated to 80 chars)
+             */
+            title: string;
+        };
+        /**
+         * SearchDocumentsDetail
+         * @description Detail for a search_documents tool call.
+         */
+        SearchDocumentsDetail: {
+            /**
+             * Tool
+             * @default search_documents
+             * @constant
+             */
+            tool: 'search_documents';
+            /**
+             * Query
+             * @description Search query (truncated to 80 chars)
+             */
+            query: string;
+            /**
+             * Search Mode
+             * @description Search mode: hybrid, semantic, keyword
+             */
+            search_mode: string;
+        };
         /**
          * SearchMode
          * @description Search mode for retrieval.
@@ -4465,6 +5094,48 @@ interface components {
              */
             detail: string;
         };
+        /**
+         * StepUsage
+         * @description Per-step token usage from a single LLM call.
+         */
+        StepUsage: {
+            /**
+             * Input Tokens
+             * @description Prompt tokens for this step
+             */
+            input_tokens: number;
+            /**
+             * Output Tokens
+             * @description Completion tokens for this step
+             */
+            output_tokens: number;
+            /**
+             * Reasoning Tokens
+             * @description Reasoning tokens for this step
+             * @default 0
+             */
+            reasoning_tokens: number;
+            /**
+             * Model
+             * @description LLM model used for this step
+             */
+            model?: string | null;
+        };
+        /** StreamEventsTool */
+        StreamEventsTool: {
+            /**
+             * @description discriminator enum property added by openapi-typescript
+             * @enum {string}
+             */
+            name: 'stream_events';
+            /**
+             * Events
+             * @default []
+             */
+            events: {
+                [key: string]: unknown;
+            }[];
+        };
         /**
          * SubscriptionInfo
          * @description Subscription info exposed to frontend in user settings.
@@ -4539,7 +5210,7 @@ interface components {
             /**
              * Model Name
              * @description The model for conversation summarisation. Defaults to reasoning model.
-             * @default GPTOSS120@ARBICITY
+             * @default Wise
              */
             MODEL_NAME: string;
             /**
@@ -4608,7 +5279,7 @@ interface components {
          *     Type-specific fields:
          *     - select: options (list of choices, can be single or multi-select)
          *     - search: tag name is the query, chunks include relevance scores
-         *     - checkbox, text, number, folder: type only
+         *     - checkbox, text, number: type only
          */
         TagFormat: {
             /**
@@ -4616,7 +5287,7 @@ interface components {
              * @default checkbox
              * @enum {string}
              */
-            type: 'checkbox' | 'text' | 'number' | 'select' | 'folder' | 'search' | 'date';
+            type: 'checkbox' | 'text' | 'number' | 'select' | 'search' | 'date';
             /**
              * Options
              * @default []
@@ -4717,7 +5388,7 @@ interface components {
             /**
              * Model Name
              * @description The name of the non-reasoning model to be used.
-             * @default Q3VL@ARBICITY
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -4854,6 +5525,24 @@ interface components {
              * @description Model used for the LLM call
              */
             model_name?: string | null;
+            /** @description Aggregate usage across all LLM calls in the request */
+            all_llm_calls?: components['schemas']['AllLlmCallsAggregate'] | null;
+        };
+        /**
+         * ToolProgressDetail
+         * @description Detail for a tool progress update.
+         */
+        ToolProgressDetail: {
+            /**
+             * Tool
+             * @description Tool name
+             */
+            tool: string;
+            /**
+             * Message
+             * @description Progress message
+             */
+            message: string;
         };
         /**
          * TraceTool
@@ -5030,7 +5719,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'];
+                [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'];
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
@@ -5097,6 +5786,11 @@ interface components {
              * @default []
              */
             pinned_workspaces: string[];
+            /**
+             * Pinned Templates
+             * @default []
+             */
+            pinned_templates: string[];
             /**
              * Tableviews
              * @default []
@@ -5139,9 +5833,14 @@ interface components {
             show_help_page: boolean;
             /**
              * Show Templates
-             * @default false
+             * @default true
              */
             show_templates: boolean;
+            /**
+             * Show Pa Mode
+             * @default false
+             */
+            show_pa_mode: boolean;
             /**
              * Hide Online Status
              * @default false
@@ -5166,6 +5865,8 @@ interface components {
             subscription?: components['schemas']['TrialUpdate'] | null;
             /** Pinned Workspaces */
             pinned_workspaces?: string[] | null;
+            /** Pinned Templates */
+            pinned_templates?: string[] | null;
             /** Tableviews */
             tableviews?: components['schemas']['TableView'][] | null;
             /** Show Document Navigator */
@@ -5182,6 +5883,8 @@ interface components {
             show_help_page?: boolean | null;
             /** Show Templates */
             show_templates?: boolean | null;
+            /** Show Pa Mode */
+            show_pa_mode?: boolean | null;
             /** Hide Online Status */
             hide_online_status?: boolean | null;
             /** Muted Users */
@@ -5195,6 +5898,10 @@ interface components {
             msg: string;
             /** Error Type */
             type: string;
+            /** Input */
+            input?: unknown;
+            /** Context */
+            ctx?: Record<string, never>;
         };
         /** VerifyEmailRequest */
         VerifyEmailRequest: {
@@ -5209,6 +5916,33 @@ interface components {
             /** Detail */
             detail: string;
         };
+        /**
+         * ViewDocumentPagesDetail
+         * @description Detail for a view_document_pages tool call.
+         */
+        ViewDocumentPagesDetail: {
+            /**
+             * Tool
+             * @default view_document_pages
+             * @constant
+             */
+            tool: 'view_document_pages';
+            /**
+             * Doc Ext Id
+             * @description Document external ID
+             */
+            doc_ext_id: string;
+            /**
+             * From Page
+             * @description Start page number
+             */
+            from_page: number;
+            /**
+             * To Page
+             * @description End page number
+             */
+            to_page: number;
+        };
         /**
          * VisionLLMConfig
          * @description Configuration for VisionLLM — visually inspects document pages.
@@ -5228,7 +5962,7 @@ interface components {
             /**
              * Model Name
              * @description The vision-capable model name (must support image inputs).
-             * @default Q3VL@ARBICITY
+             * @default Fast
              */
             MODEL_NAME: string;
             /**
@@ -5274,6 +6008,23 @@ interface components {
              */
             SAVE_SOURCES: boolean;
         };
+        /**
+         * WebSearchDetail
+         * @description Detail for a web_search tool call.
+         */
+        WebSearchDetail: {
+            /**
+             * Tool
+             * @default web_search
+             * @constant
+             */
+            tool: 'web_search';
+            /**
+             * Query
+             * @description Search query (truncated to 80 chars)
+             */
+            query: string;
+        };
         /**
          * WebSocketSchemas
          * @description Container for all WebSocket message schemas.
@@ -5289,6 +6040,7 @@ interface components {
             error?: components['schemas']['ErrorMessage'] | null;
             task_update?: components['schemas']['TaskUpdateMessage'] | null;
             batch_complete?: components['schemas']['BatchCompleteMessage'] | null;
+            response_complete?: components['schemas']['ResponseCompleteMessage'] | null;
             notification?: components['schemas']['NotificationResponse'] | null;
             auth?: components['schemas']['AuthMessage'] | null;
             send_message?: components['schemas']['SendMessageRequest'] | null;
@@ -6387,6 +7139,8 @@ interface operations {
                 wp_type?: string | null;
                 /** @description Tag to link the document to */
                 tag_ext_id?: string | null;
+                /** @description Optional logical folder path (URL safe) */
+                folder?: string | null;
             };
             header?: never;
             path?: never;
@@ -7587,7 +8341,7 @@ interface operations {
             };
         };
     };
-    query_v1_responses_post: {
+    create_response: {
         parameters: {
             query?: never;
             header?: never;
@@ -7606,7 +8360,47 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': unknown;
+                    'text/event-stream': unknown;
+                };
+            };
+            /** @description Accepted */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ResponsesAPIResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    get_response: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                response_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ResponsesAPIResponse'];
                 };
             };
             /** @description Validation Error */
@@ -8316,8 +9110,9 @@ type WsConnectionClosedMessage = components['schemas']['ConnectionClosedMessage'
 type WsErrorMessage = components['schemas']['ErrorMessage'];
 type WsPresenceUpdateMessage = components['schemas']['PresenceUpdateMessage'];
 type WsNotificationResponse = components['schemas']['NotificationResponse'];
+type WsResponseCompleteMessage = components['schemas']['ResponseCompleteMessage'];
 /** Union of all server → client message types (discriminated on `type` field). */
-type WebSocketServerMessage = WsTaskUpdateMessage | WsAuthResultMessage | WsConnectionClosedMessage | WsPresenceUpdateMessage | WsErrorMessage | WsNotificationResponse | WsBatchCompleteMessage;
+type WebSocketServerMessage = WsTaskUpdateMessage | WsAuthResultMessage | WsConnectionClosedMessage | WsPresenceUpdateMessage | WsErrorMessage | WsNotificationResponse | WsBatchCompleteMessage | WsResponseCompleteMessage;
 /** Union of all client → server message types. */
 type WebSocketClientMessage = WsAuthMessage;
 /**
@@ -8370,4 +9165,4 @@ declare function isMessageType<T extends WebSocketServerMessage>(msg: WebSocketS
  */
 declare function createReloginHandler(deps: ReloginDeps): () => Promise<string | null>;
 
-export { type $defs, API_PREFIX, type ArbiClient, type ArbiClientOptions, type AuthStateProvider, type AutoReloginMiddlewareConfig, type BearerAuthMiddlewareConfig, type ChangePasswordParams, type ChangePasswordRequest, type ChangePasswordResult, type CryptoProvider, type KeyPair, type LoginCredentials, type LoginParams, type LoginProvider, type LoginRequest, type LoginResult, type LoginWithKeyParams, type OnReloginSuccess, type PasswordChangeCredentials, type RegisterParams, type RegisterRequest, type RegisterResult, type RegistrationCredentials, type ReloginDeps, type ReloginHandler, type SessionData, type SessionKeys, type SessionManager, type SessionState, type SessionStorageProvider, type SsoTokenProvider, type TokenProvider, type UserKeypairs, type WebSocketClientMessage, type WebSocketServerMessage, type WorkspaceKeyMiddlewareConfig, type WorkspaceKeyProvider, type WorkspaceKeyRefreshProvider, type WorkspaceKeyUrlConfig, type WorkspaceOpenProvider, type WsAuthMessage, type WsAuthResultMessage, type WsBatchCompleteMessage, type WsConnectionClosedMessage, type WsErrorMessage, type WsNotificationResponse, type WsPresenceUpdateMessage, type WsTaskUpdateMessage, base64Decode, base64Encode, base64ToBytes, buildWebSocketUrl, bytesToBase64, clearAllData, clearSession, type components, computeSharedSecret, createArbiClient, createAuthMessage, createAutoReloginMiddleware, createBearerAuthMiddleware, createReloginHandler, createSessionManager, createWorkspaceKeyHeader, createWorkspaceKeyMiddleware, decryptMessage, decryptMessageWithSharedSecret, deriveEncryptionKeypairFromSigning, derivePublicKey, encryptMessage, encryptMessageWithSharedSecret, generateKeyPairs, generateLoginCredentials, generateLoginCredentialsFromKey, generatePasswordChangeCredentials, generateRecoveryPasswordChangeCredentials, generateRegistrationCredentials, generateUserKeypairs, getSession, hasSession, initSodium, initializeDatabase, isMessageType, needsWorkspaceKey, type operations, parseServerMessage, type paths, saveSession, sealedBoxDecrypt, sealedBoxEncrypt, signMessage, updateSigningPrivateKey, type webhooks };
+export { type $defs, API_PREFIX, type ArbiClient, type ArbiClientOptions, type AuthStateProvider, type AutoReloginMiddlewareConfig, type BearerAuthMiddlewareConfig, type ChangePasswordParams, type ChangePasswordRequest, type ChangePasswordResult, type CryptoProvider, type KeyPair, type LoginCredentials, type LoginParams, type LoginProvider, type LoginRequest, type LoginResult, type LoginWithKeyParams, type OnReloginSuccess, type PasswordChangeCredentials, type RegisterParams, type RegisterRequest, type RegisterResult, type RegistrationCredentials, type ReloginDeps, type ReloginHandler, type SessionData, type SessionKeys, type SessionManager, type SessionState, type SessionStorageProvider, type SsoTokenProvider, type TokenProvider, type UserKeypairs, type WebSocketClientMessage, type WebSocketServerMessage, type WorkspaceKeyMiddlewareConfig, type WorkspaceKeyProvider, type WorkspaceKeyRefreshProvider, type WorkspaceKeyUrlConfig, type WorkspaceOpenProvider, type WsAuthMessage, type WsAuthResultMessage, type WsBatchCompleteMessage, type WsConnectionClosedMessage, type WsErrorMessage, type WsNotificationResponse, type WsPresenceUpdateMessage, type WsResponseCompleteMessage, type WsTaskUpdateMessage, base64Decode, base64Encode, base64ToBytes, buildWebSocketUrl, bytesToBase64, clearAllData, clearSession, type components, computeSharedSecret, createArbiClient, createAuthMessage, createAutoReloginMiddleware, createBearerAuthMiddleware, createReloginHandler, createSessionManager, createWorkspaceKeyHeader, createWorkspaceKeyMiddleware, decryptMessage, decryptMessageWithSharedSecret, deriveEncryptionKeypairFromSigning, derivePublicKey, encryptMessage, encryptMessageWithSharedSecret, generateKeyPairs, generateLoginCredentials, generateLoginCredentialsFromKey, generatePasswordChangeCredentials, generateRecoveryPasswordChangeCredentials, generateRegistrationCredentials, generateUserKeypairs, getSession, hasSession, initSodium, initializeDatabase, isMessageType, needsWorkspaceKey, type operations, parseServerMessage, type paths, saveSession, sealedBoxDecrypt, sealedBoxEncrypt, signMessage, updateSigningPrivateKey, type webhooks };