@arbidocs/client 0.3.138 → 0.3.140

package/dist/index.d.cts

@@ -1942,7 +1942,7 @@ interface paths {
         patch: operations['update_tag'];
         trace?: never;
     };
-    '/v1/memory/': {
+    '/v1/notes/': {
         parameters: {
             query?: never;
             header?: never;
@@ -1952,17 +1952,17 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Create Memory Endpoint
-         * @description Create a memory in the active workspace.
+         * Create Note Endpoint
+         * @description Create a note in the active workspace.
          */
-        post: operations['create_memory'];
+        post: operations['create_note'];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    '/v1/memory/list': {
+    '/v1/notes/list': {
         parameters: {
             query?: never;
             header?: never;
@@ -1970,10 +1970,10 @@ interface paths {
             cookie?: never;
         };
         /**
-         * List Memories Endpoint
-         * @description List memories visible in the active workspace (newest first).
+         * List Notes Endpoint
+         * @description List notes visible in the active workspace (newest first).
          */
-        get: operations['list_memories'];
+        get: operations['list_notes'];
         put?: never;
         post?: never;
         delete?: never;
@@ -1982,7 +1982,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    '/v1/memory/search': {
+    '/v1/notes/search': {
         parameters: {
             query?: never;
             header?: never;
@@ -1992,17 +1992,17 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Search Memories Endpoint
-         * @description Hybrid recall over the workspace's memories.
+         * Search Notes Endpoint
+         * @description Hybrid recall over the workspace's notes.
          */
-        post: operations['search_memories'];
+        post: operations['search_notes'];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    '/v1/memory/{memory_ext_id}': {
+    '/v1/notes/{note_ext_id}': {
         parameters: {
             query?: never;
             header?: never;
@@ -2013,17 +2013,17 @@ interface paths {
         put?: never;
         post?: never;
         /**
-         * Delete Memory Endpoint
-         * @description Soft-delete a memory. RLS governs permission; a blocked delete returns 403.
+         * Delete Note Endpoint
+         * @description Soft-delete a note. RLS governs permission; a blocked delete returns 403.
          */
-        delete: operations['delete_memory'];
+        delete: operations['delete_note'];
         options?: never;
         head?: never;
         /**
-         * Update Memory Endpoint
-         * @description Patch a memory. A content edit replaces it (append + soft-delete); pin/share toggle in place.
+         * Update Note Endpoint
+         * @description Patch a note. A content edit replaces it (append + soft-delete); pin/share toggle in place.
          */
-        patch: operations['update_memory'];
+        patch: operations['update_note'];
         trace?: never;
     };
     '/v1/notifications/ws-schemas': {
@@ -3376,6 +3376,11 @@ interface components {
              * @description Per-step token cost (input + output + reasoning) for the LLM call that produced this step.
              */
             step_tokens?: number | null;
+            /**
+             * Step Credits
+             * @description This step's own AI-credit cost, priced from cached model pricing — an estimate, not the authoritative LiteLLM cost (which is captured once per call into the turn-level ledger total, not correlated back to a specific step).
+             */
+            step_credits?: number | null;
             /** @description Token budget context snapshot. Present when retrieval counts change. */
             context?: components['schemas']['TokenBudgetContext'] | null;
             /**
@@ -3500,14 +3505,14 @@ interface components {
              */
             PERSONAL_AGENT: boolean;
             /**
-             * Memory Enabled
-             * @description Workspace memory is readable AND writable by the agent: pinned core memories are injected into the prompt, and the agent gets the memory_search (recall) and memory_update (write) tools.
+             * Notes Enabled
+             * @description Workspace memory is readable AND writable by the agent: pinned core memories are injected into the prompt, and the agent gets the note_search (recall) and note_update (write) tools.
              * @default false
              */
-            MEMORY_ENABLED: boolean;
+            NOTES_ENABLED: boolean;
             /**
              * Persist Learnings
-             * @description After each turn, the curator consolidates this turn's learnings into durable memories (dedupe + supersede). Independent of MEMORY_ENABLED.
+             * @description After each turn, the curator consolidates this turn's learnings into durable memories (dedupe + supersede). Independent of NOTES_ENABLED.
              * @default false
              */
             PERSIST_LEARNINGS: boolean;
@@ -3536,7 +3541,7 @@ interface components {
             ENABLED_SKILLS?: string[] | null;
             /**
              * Memory Creation
-             * @description Transient flag set by /setup command to enable the save_memory agent tool (authors the per-workspace practice-profile memory document).
+             * @description Transient flag set by /setup command to enable the save_profile agent tool (authors the per-workspace practice-profile memory document).
              * @default false
              */
             MEMORY_CREATION: boolean;
@@ -3601,6 +3606,12 @@ interface components {
              * @default 20
              */
             AGENT_MAX_ITERATIONS: number;
+            /**
+             * Agent Turn Credit Budget
+             * @description Maximum AI credits (1 credit = $0.01) a turn may spend, shared across the main agent and every deep_research/run_code/sub_agent child it spawns — priced per call using each call's own model, since different stages run different models. Agents get a heads-up in their own scratchpad at 50% and 90% so they can wrap up before being forced to answer with what they have. Default is half FREE_AI_CREDITS (100) — a free account's entire grant, so one turn can't consume it all. 0 = uncapped.
+             * @default 50
+             */
+            AGENT_TURN_CREDIT_BUDGET: number;
             /**
              * Agent Max Parallel Tool Calls
              * @description Maximum number of tool calls the agent can make in a single iteration. Extra calls beyond this limit are silently dropped.
@@ -3737,14 +3748,14 @@ interface components {
              */
             CONVERSATION_SEARCH_ENABLED: boolean;
             /**
-             * Memory Enabled
-             * @description Workspace memory is readable AND writable by the agent: pinned core memories are injected into the prompt, and the agent gets the memory_search (recall) and memory_update (write) tools.
+             * Notes Enabled
+             * @description Workspace memory is readable AND writable by the agent: pinned core memories are injected into the prompt, and the agent gets the note_search (recall) and note_update (write) tools.
              * @default false
              */
-            MEMORY_ENABLED: boolean;
+            NOTES_ENABLED: boolean;
             /**
              * Persist Learnings
-             * @description After each turn, the curator consolidates this turn's learnings into durable memories (dedupe + supersede). Independent of MEMORY_ENABLED.
+             * @description After each turn, the curator consolidates this turn's learnings into durable memories (dedupe + supersede). Independent of NOTES_ENABLED.
              * @default false
              */
             PERSIST_LEARNINGS: boolean;
@@ -3801,6 +3812,12 @@ interface components {
              * @default 20
              */
             AGENT_MAX_ITERATIONS: number;
+            /**
+             * Agent Turn Credit Budget
+             * @description Maximum AI credits (1 credit = $0.01) a turn may spend, shared across the main agent and every deep_research/run_code/sub_agent child it spawns — priced per call using each call's own model, since different stages run different models. Agents get a heads-up in their own scratchpad at 50% and 90% so they can wrap up before being forced to answer with what they have. Default is half FREE_AI_CREDITS (100) — a free account's entire grant, so one turn can't consume it all. 0 = uncapped.
+             * @default 50
+             */
+            AGENT_TURN_CREDIT_BUDGET: number;
         };
         /** AllConfigs */
         AllConfigs: {
@@ -3820,7 +3837,7 @@ interface components {
              *       "VISION_ENABLED": false,
              *       "CONVERSATION_SEARCH_ENABLED": false,
              *       "PERSONAL_AGENT": false,
-             *       "MEMORY_ENABLED": false,
+             *       "NOTES_ENABLED": false,
              *       "PERSIST_LEARNINGS": false,
              *       "SKILLS_ENABLED": false,
              *       "SKILL_CREATION": false,
@@ -3836,6 +3853,7 @@ interface components {
              *       "ENABLE_THINKING": false,
              *       "AGENT_STRICT_TOOL_CALLS": true,
              *       "AGENT_MAX_ITERATIONS": 20,
+             *       "AGENT_TURN_CREDIT_BUDGET": 50,
              *       "AGENT_MAX_PARALLEL_TOOL_CALLS": 10,
              *       "AGENT_HISTORY_CHAR_THRESHOLD": 8000,
              *       "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. If the user asks about a specific workspace document, call read_document or get_table_of_contents — never answer from memory.\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 INDEX:\nThe \"Workspace Documents\" table in your system prompt lists every document with its Id, Title, Date, and Pages. The Subject field is a brief navigation label only — it does not contain enough information to answer questions about a document's content. Use this table directly when the user asks to list, catalogue, or tabulate documents — do NOT call any tools for that. Only use tools when you need to read or search document content.\n\nDOCUMENT STRATEGY:\n- For listing/cataloguing documents: use the document index already in your prompt — no tool calls needed.\n- For overview/summary requests: use get_table_of_contents first, then read key sections with read_document.\n- For specific questions: use search_inside_documents to find relevant sections, then read those sections with read_document.\n- For translation, deep analysis, or detailed summaries of a single document: use read_document with no ranges to load the complete text.\n- For extracting structured findings from passages: use read_document with digest=true or search_inside_documents with digest=true.\n- For open-ended investigative queries (\"find interesting things\", \"what's notable\", \"what stands out\", \"explore X\", \"what should I know about\", \"any findings\", \"anything unusual\", \"key insights\"): ALWAYS call search_inside_documents with multiple diverse queries covering different aspects of the documents before answering. The document index is never sufficient for investigative answers — you must retrieve actual content.\n- Never search for meta-queries like \"summary\", \"overview\", or \"all documents\" — 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\nTOOL CALLING:\n- Your job is to gather context by calling tools, then answer only once every reasonable tool call has been made. Do not give a final answer while there is still relevant context you could retrieve.\n- Always invoke tools using the tool-calling mechanism. NEVER write text that describes or simulates a tool call (e.g. never write \"Searching for X...\", \"Reading document Y...\", \"Calling search_inside_documents\" as prose — actually call the tool).\n- If you intend to search or read, issue the tool call immediately. Do not narrate your intent first.\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."
@@ -3973,7 +3991,6 @@ interface components {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
              *       "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": 0,
              *       "MAX_TOKEN_CONTEXT": 200000,
@@ -4033,8 +4050,7 @@ interface components {
              *       "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,
-             *       "MAX_ITERATIONS": 3
+             *       "MAX_TOKENS": 0
              *     }
              */
             CodeAgent: components['schemas']['CodeAgentConfig'];
@@ -4101,7 +4117,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"
              *     }
              */
@@ -4122,7 +4138,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": "",
@@ -4242,6 +4258,11 @@ interface components {
              * @description The agent's own words for what this item is doing.
              */
             focus?: string | null;
+            /**
+             * Content
+             * @description Extended text a one-line focus can't carry — e.g. a sub-agent spawn marker's own task description, or a planning step's checklist.
+             */
+            content?: string | null;
             /**
              * Detail
              * @description Enriched tool-call display shape (resolved summary, page ranges, digest flags) — richer than the raw `arguments` JSON, for the trace UI. One entry per call on a function_call item.
@@ -4261,6 +4282,11 @@ interface components {
              * @description Per-item token cost.
              */
             step_tokens?: number | null;
+            /**
+             * Step Credits
+             * @description This item's own AI-credit cost, priced from cached model pricing for its usage — not the authoritative LiteLLM cost (that's captured once per call into the turn-level ledger, not correlated back to a specific step). An estimate for relative step-to-step cost while streaming.
+             */
+            step_credits?: number | null;
             /**
              * Total Tokens
              * @description Cumulative tokens across the response so far.
@@ -4647,7 +4673,14 @@ interface components {
         };
         /**
          * CitationData
-         * @description Data for a single citation - shared by DocTags and ModelCitationTool.
+         * @description Data for a single citation — one statement anchored inside a longer text.
+         *
+         *     Used by ModelCitationTool for assistant answers, where a multi-paragraph
+         *     reply makes many separate claims and each needs its own span + sources so
+         *     the client can render inline, per-claim citation markers.
+         *
+         *     Grounded *notes* (memories, DocTags) do NOT use this — see
+         *     :class:`CitationSources`.
          */
         CitationData: {
             /** Chunk Ids */
@@ -4664,6 +4697,51 @@ interface components {
             /** Offset End */
             offset_end: number;
         };
+        /**
+         * CitationSources
+         * @description Flat provenance for a grounded note: the passages that back it.
+         *
+         *     A note or a DocTag answers ONE question, so the per-statement
+         *     :class:`CitationData` map it used to carry was almost entirely redundant —
+         *     the ``statement`` duplicated the note text and the offsets spanned it end to
+         *     end. All a reader needs is *which passages support this*, best-first.
+         *
+         *     One object per passage, deliberately, rather than parallel arrays: document
+         *     and page belong to a specific chunk, and keeping them together removes any
+         *     alignment invariant to maintain. Everything a client renders derives from
+         *     this single list — document pills by deduping ``doc_ext_id``, page ranges by
+         *     grouping on it — so there is exactly one way to express provenance.
+         *
+         *     Rerank scores are NOT stored. Nothing ever read them back, and a score is
+         *     not comparable across reranker versions, so persisting one would imply a
+         *     precision it does not have. Order carries the only durable signal.
+         *
+         *     Holds no document text, so it is **plaintext at rest** — chunk and doc ext
+         *     ids are opaque identifiers, and the passage content behind them stays
+         *     SecretBox-encrypted in Qdrant.
+         */
+        CitationSources: {
+            /** Passages */
+            passages: components['schemas']['CitedPassage'][];
+        };
+        /**
+         * CitedPassage
+         * @description One passage backing a grounded note, with enough to render it.
+         *
+         *     ``doc_ext_id`` is captured at grounding time from the chunk's metadata so a
+         *     client can show the source as a document pill without resolving every chunk
+         *     against Qdrant first. It is optional only because citations written before
+         *     that capture existed carry the chunk alone — a missing value means "not
+         *     recorded", never "no document" (every chunk belongs to exactly one).
+         */
+        CitedPassage: {
+            /** Chunk Id */
+            chunk_id: string;
+            /** Doc Ext Id */
+            doc_ext_id?: string | null;
+            /** Page */
+            page?: number | null;
+        };
         /**
          * CodeAgentConfig
          * @description Configuration for CodeAgent — sub-agent that writes and executes code via sandbox.
@@ -4722,12 +4800,6 @@ interface components {
              * @default 0
              */
             MAX_TOKENS: number;
-            /**
-             * Max Iterations
-             * @description Maximum code-execute-fix retry cycles.
-             * @default 3
-             */
-            MAX_ITERATIONS: number;
         };
         /**
          * CommandDescriptorResponse
@@ -5389,18 +5461,15 @@ interface components {
             doc_ext_ids: string[];
             /** Note */
             note?: string | null;
-            /** Citations */
-            citations?: {
-                [key: string]: components['schemas']['CitationData'];
-            } | null;
+            citations?: components['schemas']['CitationSources'] | null;
         };
         /**
-         * CreateMemoryRequest
-         * @description Create a memory in the active workspace.
+         * CreateNoteRequest
+         * @description Create a note in the active workspace.
          */
-        CreateMemoryRequest: {
-            /** Note */
-            note: string;
+        CreateNoteRequest: {
+            /** Text */
+            text: string;
             /**
              * Pinned
              * @default false
@@ -5417,6 +5486,14 @@ interface components {
              * @enum {string}
              */
             source: 'manual' | 'learning' | 'curator';
+            /** Note Date */
+            note_date?: string | null;
+            /**
+             * Tag Ext Ids
+             * @default []
+             */
+            tag_ext_ids: string[];
+            citations?: components['schemas']['CitationSources'] | null;
         };
         /**
          * CreatePlanDetail
@@ -5752,15 +5829,13 @@ interface components {
          * @description Response for doctag operations - the link between a document and a tag.
          *
          *     ``note`` + ``citations`` are inherited from :class:`GroundedText` (the shared
-         *     grounded-text payload a DocTag note and a memory both carry).
+         *     grounded-text payload a DocTag note and a memory both carry) — free text plus
+         *     the source passages backing it.
          */
         DocTagResponse: {
             /** Note */
             note?: string | null;
-            /** Citations */
-            citations?: {
-                [key: string]: components['schemas']['CitationData'];
-            } | null;
+            citations?: components['schemas']['CitationSources'] | null;
             /** Doc Ext Id */
             doc_ext_id: string;
             /** Tag Ext Id */
@@ -6082,7 +6157,7 @@ interface components {
             /**
              * Api Type
              * @description The inference type (local or remote).
-             * @default local
+             * @default remote
              * @enum {string}
              */
             API_TYPE: 'local' | 'remote';
@@ -6882,21 +6957,19 @@ interface components {
             /** Tools */
             tools: components['schemas']['McpToolInfo'][];
         };
-        /** MemoryDeleteResponse */
-        MemoryDeleteResponse: {
-            /**
-             * Detail
-             * @default Memory deleted successfully
-             */
-            detail: string;
-        };
         /**
          * MemoryLLMConfig
-         * @description Configuration for MemoryLLM - synthesizes memory documents (skills, memories, reports).
+         * @description Configuration for MemoryLLM — the post-turn curator.
          *
-         *     Produces markdown documents from gathered context (learnings, retrieval results,
-         *     conversation history). Output is saved as a document through the standard
-         *     upload pipeline with wp_type indicating the document category.
+         *     Judges which of a turn's learnings are worth keeping as durable Notes and
+         *     reconciles them against existing ones (dedupe + supersede). It never
+         *     re-authors text: each kept learning is stored verbatim.
+         *
+         *     It used to also synthesize whole markdown *documents* (a "memory" or a
+         *     "skill") from the scratchpad after every turn. That path is gone — its
+         *     "memory" output was discarded by the caller, and skills are authored
+         *     deliberately via ``save_skill`` / ``/skill``. Hence no SYSTEM_INSTRUCTION
+         *     here: the consolidation prompts are rendered per-call.
          */
         MemoryLLMConfig: {
             /**
@@ -6914,43 +6987,19 @@ interface components {
             ENABLE_THINKING: boolean;
             /**
              * Model Name
-             * @description The model for memory synthesis. Defaults to reasoning model.
+             * @description The model for note consolidation. Defaults to reasoning model.
              * @default Wise
              */
             MODEL_NAME: string;
-            /**
-             * System Instruction
-             * @description System instruction for memory classification and synthesis.
-             * @default You are a knowledge synthesizer. You receive the full agent scratchpad from a completed conversation and decide what, if anything, is worth saving.
-             *
-             *     ## Work Product Types
-             *     - **"memory"**: Facts, findings, reference data — for *looking up* information.
-             *     - **"skill"**: Procedures, workflows, step-by-step instructions — for *doing* something.
-             *
-             *     When ambiguous, default to memory.
-             *
-             *     ## Rules
-             *     - Return an empty work_products array if the conversation is trivial or produced nothing substantive.
-             *     - Each work product must cover ONE coherent topic. Never combine disparate subjects into a single document — create separate documents for each distinct topic.
-             *     - Ground everything in the provided context. Do not invent information.
-             *     - Be concise. These are reference documents, not essays.
-             *
-             *     ## Output Format
-             *     JSON with a `work_products` array. Each item has `wp_type`, `title`, and `content` (markdown).
-             *
-             *     Memory content: `# Title`, date, source, key findings as bullets, source documents.
-             *     Skill content: `# Title`, prerequisites, numbered steps, when to apply.
-             */
-            SYSTEM_INSTRUCTION: string;
             /**
              * Temperature
-             * @description Temperature for synthesis.
+             * @description Temperature for consolidation.
              * @default 0.3
              */
             TEMPERATURE: number;
             /**
              * Max Tokens
-             * @description Max output tokens for memory content; 0 = uncapped (run to EOS).
+             * @description Max output tokens; 0 = uncapped (run to EOS).
              * @default 0
              */
             MAX_TOKENS: number;
@@ -6962,87 +7011,11 @@ interface components {
             MAX_TOKEN_CONTEXT: number;
             /**
              * Max Concurrent
-             * @description Maximum concurrent synthesis operations.
+             * @description Maximum concurrent consolidation operations.
              * @default 5
              */
             MAX_CONCURRENT: number;
         };
-        /** MemoryResponse */
-        MemoryResponse: {
-            /** Note */
-            note?: string | null;
-            /** Citations */
-            citations?: {
-                [key: string]: components['schemas']['CitationData'];
-            } | null;
-            /** External Id */
-            external_id: string;
-            /** Workspace Ext Id */
-            workspace_ext_id: string;
-            /** Pinned */
-            pinned: boolean;
-            /** Shared */
-            shared: boolean;
-            /** Source */
-            source: string;
-            /** Created By Ext Id */
-            created_by_ext_id: string;
-            /**
-             * Created At
-             * Format: date-time
-             */
-            created_at: string;
-            /**
-             * Updated At
-             * Format: date-time
-             */
-            updated_at: string;
-        };
-        /** MemorySearchHit */
-        MemorySearchHit: {
-            /** External Id */
-            external_id: string;
-            /** Note */
-            note: string;
-            /** Pinned */
-            pinned: boolean;
-            /** Source */
-            source: string;
-            /** Score */
-            score: number;
-        };
-        /**
-         * MemorySearchRequest
-         * @description Hybrid recall over the workspace's memories.
-         */
-        MemorySearchRequest: {
-            /**
-             * Query
-             * @description Search query text
-             */
-            query: string;
-            /**
-             * Search Mode
-             * @description Retrieval mode
-             * @default hybrid
-             * @enum {string}
-             */
-            search_mode: 'semantic' | 'keyword' | 'hybrid';
-            /**
-             * Limit
-             * @description Maximum number of memories to return
-             * @default 10
-             */
-            limit: number;
-        };
-        /** MemorySearchResponse */
-        MemorySearchResponse: {
-            /**
-             * Memories
-             * @default []
-             */
-            memories: components['schemas']['MemorySearchHit'][];
-        };
         /** MemoryTool */
         MemoryTool: {
             /**
@@ -7489,6 +7462,104 @@ interface components {
             DoctagLLM: components['schemas']['DoctagLLMUserConfig'];
             Parser: components['schemas']['ParserUserConfig'];
         };
+        /** NoteDeleteResponse */
+        NoteDeleteResponse: {
+            /**
+             * Detail
+             * @default Note deleted successfully
+             */
+            detail: string;
+        };
+        /** NoteResponse */
+        NoteResponse: {
+            /** Text */
+            text: string;
+            citations?: components['schemas']['CitationSources'] | null;
+            /** External Id */
+            external_id: string;
+            /** Workspace Ext Id */
+            workspace_ext_id: string;
+            /** Pinned */
+            pinned: boolean;
+            /** Shared */
+            shared: boolean;
+            /** Source */
+            source: string;
+            /** Note Date */
+            note_date?: string | null;
+            /**
+             * Tags
+             * @default []
+             */
+            tags: components['schemas']['NoteTagResponse'][];
+            /** Created By Ext Id */
+            created_by_ext_id: string;
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+            /**
+             * Updated At
+             * Format: date-time
+             */
+            updated_at: string;
+        };
+        /** NoteSearchHit */
+        NoteSearchHit: {
+            /** External Id */
+            external_id: string;
+            /** Text */
+            text: string;
+            /** Pinned */
+            pinned: boolean;
+            /** Source */
+            source: string;
+            /** Score */
+            score: number;
+        };
+        /**
+         * NoteSearchRequest
+         * @description Hybrid recall over the workspace's notes.
+         */
+        NoteSearchRequest: {
+            /**
+             * Query
+             * @description Search query text
+             */
+            query: string;
+            /**
+             * Search Mode
+             * @description Retrieval mode
+             * @default hybrid
+             * @enum {string}
+             */
+            search_mode: 'semantic' | 'keyword' | 'hybrid';
+            /**
+             * Limit
+             * @description Maximum number of notes to return
+             * @default 10
+             */
+            limit: number;
+        };
+        /** NoteSearchResponse */
+        NoteSearchResponse: {
+            /**
+             * Notes
+             * @default []
+             */
+            notes: components['schemas']['NoteSearchHit'][];
+        };
+        /**
+         * NoteTagResponse
+         * @description A tag attached to a note — the tag's identity, decrypted name included.
+         */
+        NoteTagResponse: {
+            /** Tag Ext Id */
+            tag_ext_id: string;
+            /** Name */
+            name: string;
+        };
         /**
          * NotificationResponse
          * @description Notification response model for API and WebSocket.
@@ -8423,7 +8494,7 @@ interface components {
             /**
              * Api Type
              * @description The inference type (local or remote).
-             * @default local
+             * @default remote
              * @enum {string}
              */
             API_TYPE: 'local' | 'remote';
@@ -10316,6 +10387,16 @@ interface components {
              * @description Total cost: input_cost + output_cost (USD)
              */
             total_cost?: number | null;
+            /**
+             * Credits Spent
+             * @description AI credits spent so far this turn (1 credit = $0.01), priced per LLM call using each call's own model — unlike total_cost above (single-rate, main query LLM only), this is correct across a turn that mixes models (agent LLM, deep_research/run_code child LLMs, evaluator, judge). Updates live as the turn progresses, not just a final total.
+             */
+            credits_spent?: number | null;
+            /**
+             * Credit Budget
+             * @description This turn's shared credit budget (AGENT_TURN_CREDIT_BUDGET) — same value across the parent and every child it spawns. Absent when uncapped (budget=0).
+             */
+            credit_budget?: number | null;
             /**
              * Elapsed Seconds
              * @description Wall-clock time for the LLM call(s)
@@ -10409,10 +10490,7 @@ interface components {
             doc_ext_id: string;
             /** Note */
             note?: string | null;
-            /** Citations */
-            citations?: {
-                [key: string]: components['schemas']['CitationData'];
-            } | null;
+            citations?: components['schemas']['CitationSources'] | null;
         };
         /**
          * UpdateDocumentsRequest
@@ -10423,18 +10501,23 @@ interface components {
             documents: components['schemas']['DocUpdateRequest'][];
         };
         /**
-         * UpdateMemoryRequest
-         * @description Patch a memory. An edit to ``note`` soft-deletes the old row and
-         *     inserts a replacement (append + soft-delete lifecycle); ``pinned``/``shared``
-         *     toggles update in place.
+         * UpdateNoteRequest
+         * @description Patch a note. An edit to ``text`` soft-deletes the old row and
+         *     inserts a replacement (append + soft-delete lifecycle); ``pinned``/``shared``/
+         *     ``note_date``/``tag_ext_ids`` update in place.
          */
-        UpdateMemoryRequest: {
-            /** Note */
-            note?: string | null;
+        UpdateNoteRequest: {
+            /** Text */
+            text?: string | null;
             /** Pinned */
             pinned?: boolean | null;
             /** Shared */
             shared?: boolean | null;
+            /** Note Date */
+            note_date?: string | null;
+            /** Tag Ext Ids */
+            tag_ext_ids?: string[] | null;
+            citations?: components['schemas']['CitationSources'] | null;
         };
         /**
          * UpdateNotificationsRequest
@@ -14154,7 +14237,7 @@ interface operations {
             };
         };
     };
-    create_memory: {
+    create_note: {
         parameters: {
             query?: never;
             header?: never;
@@ -14163,7 +14246,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['CreateMemoryRequest'];
+                'application/json': components['schemas']['CreateNoteRequest'];
             };
         };
         responses: {
@@ -14173,7 +14256,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['MemoryResponse'];
+                    'application/json': components['schemas']['NoteResponse'];
                 };
             };
             /** @description Validation Error */
@@ -14187,7 +14270,7 @@ interface operations {
             };
         };
     };
-    list_memories: {
+    list_notes: {
         parameters: {
             query?: {
                 pinned_only?: boolean;
@@ -14204,7 +14287,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['MemoryResponse'][];
+                    'application/json': components['schemas']['NoteResponse'][];
                 };
             };
             /** @description Validation Error */
@@ -14218,7 +14301,7 @@ interface operations {
             };
         };
     };
-    search_memories: {
+    search_notes: {
         parameters: {
             query?: never;
             header?: never;
@@ -14227,7 +14310,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['MemorySearchRequest'];
+                'application/json': components['schemas']['NoteSearchRequest'];
             };
         };
         responses: {
@@ -14237,7 +14320,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['MemorySearchResponse'];
+                    'application/json': components['schemas']['NoteSearchResponse'];
                 };
             };
             /** @description Validation Error */
@@ -14251,12 +14334,12 @@ interface operations {
             };
         };
     };
-    delete_memory: {
+    delete_note: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                memory_ext_id: string;
+                note_ext_id: string;
             };
             cookie?: never;
         };
@@ -14268,7 +14351,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['MemoryDeleteResponse'];
+                    'application/json': components['schemas']['NoteDeleteResponse'];
                 };
             };
             /** @description Validation Error */
@@ -14282,18 +14365,18 @@ interface operations {
             };
         };
     };
-    update_memory: {
+    update_note: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                memory_ext_id: string;
+                note_ext_id: string;
             };
             cookie?: never;
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['UpdateMemoryRequest'];
+                'application/json': components['schemas']['UpdateNoteRequest'];
             };
         };
         responses: {
@@ -14303,7 +14386,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['MemoryResponse'];
+                    'application/json': components['schemas']['NoteResponse'];
                 };
             };
             /** @description Validation Error */