@arbidocs/client 0.4.16 → 0.4.18

package/dist/index.d.ts

@@ -1531,10 +1531,126 @@ interface paths {
         delete: operations['delete_conversation'];
         options?: never;
         head?: never;
+        /**
+         * Update Conversation
+         * @description Change a conversation: its title, sharing, and its work fields. Every field is optional.
+         *
+         *     * ``shared`` — its creator only (a row nobody else can see cannot be written by them): nobody else decides.
+         *     * everything else — the owner, or a collaborator of the workspace on a shared item.
+         *     * ``status`` — ``todo`` or ``done`` only. ``done`` is human-only (the sign-off person); ``todo`` reopens.
+         *       ``generating`` / ``ready_for_review`` are set only by runs and review.
+         *     * ``parent_conversation_ext_id`` — cycle-checked; ``null`` detaches.
+         *     * ``signoff_user_ext_id`` — a human who can edit the workspace; ``null`` falls back to the owner.
+         */
+        patch: operations['update_conversation'];
+        trace?: never;
+    };
+    '/v1/conversation/message': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Post Conversation Message
+         * @description Post a human message to a conversation WITHOUT running the assistant.
+         *
+         *     This is how people talk to each other in a ``mentioned``-mode conversation:
+         *     the message is stored and shown, and no LLM run starts. To get an answer,
+         *     @mention the assistant and send through ``POST /v1/assistant/query`` instead
+         *     (with ``mentions``); that endpoint keeps streaming the reply as today.
+         *
+         *     - ``mentions`` of people must name current members of the workspace (422
+         *       otherwise). Mentioning someone in a conversation that is not shared yet
+         *       shares it with the workspace, atomically with this post, and notifies them.
+         *     - Rejects (409) a conversation in ``always`` mode: there every message gets a
+         *       reply, so a reply-less comment would break that promise.
+         *     - Rejects (422) an assistant mention: that message is meant to run it.
+         */
+        post: operations['post_conversation_message'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/conversation/{conversation_ext_id}/assistant-mode': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        /**
+         * Update Conversation Assistant Mode
+         * @description Switch when the assistant answers in a conversation.
+         *
+         *     ``always``: every message gets a reply (an ordinary chat). ``mentioned``: only
+         *     messages that @mention the assistant do; everything else is a comment between
+         *     people. RLS decides who may change it (the same rule as renaming).
+         */
+        patch: operations['update_conversation_assistant_mode'];
+        trace?: never;
+    };
+    '/v1/conversation/work': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Create Work
+         * @description Create a work item (a conversation with a status) in the active workspace.
+         *
+         *     No ``prompt``/``skill_ref`` (and no ``plan``) → a plain to-do (``todo``). With one → the conversation is
+         *     created ``generating`` and the run starts now, in the conversation's own thread. The caller is present, so
+         *     there is no access question: with no ``agent_ext_id`` the run is the caller's own, under their session and
+         *     capability; with one, the agent's run session is granted from the caller's workspace key.
+         */
+        post: operations['create_work'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/conversation/work/plan': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Plan Work
+         * @description Draft a reviewable ``TaskPlan`` for the active workspace from a plain objective.
+         *
+         *     The unified planner (``filter_and_plan`` → ``author_checklist``): formulates the goal, proposes the doc
+         *     set, and authors the acceptance criteria. Stateless — the caller attaches the returned plan to a create
+         *     body (new work) or a PATCH (re-plan).
+         */
+        post: operations['plan_work'];
+        delete?: never;
+        options?: never;
+        head?: never;
         patch?: never;
         trace?: never;
     };
-    '/v1/conversation/{conversation_ext_id}/share': {
+    '/v1/conversation/{conversation_ext_id}/run': {
         parameters: {
             query?: never;
             header?: never;
@@ -1544,19 +1660,22 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Share Conversation
-         * @description Share all messages in a conversation by setting their shared flag to true.
+         * Run Conversation
+         * @description Run the work now (or retry it): the agent works in this conversation's own thread.
          *
-         *     Only the conversation creator can share a conversation.
+         *     The caller is present, so the run's session is granted from their own workspace key — no access
+         *     question (``auth_mode`` only matters for unattended runs). 409 while a run is live. When the run cannot
+         *     start (no assistant, ...) the 409 carries the reason; an unattended-style park is not an error here:
+         *     the response then has ``pending_auth_request_id`` (see ``GET /{id}/pending-auth``).
          */
-        post: operations['share_conversation'];
+        post: operations['run_conversation'];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    '/v1/conversation/{conversation_ext_id}/title': {
+    '/v1/conversation/{conversation_ext_id}/review': {
         parameters: {
             query?: never;
             header?: never;
@@ -1565,16 +1684,89 @@ interface paths {
         };
         get?: never;
         put?: never;
+        /**
+         * Review Conversation
+         * @description A person's verdict on prepared work (``ready_for_review``). Never an agent.
+         *
+         *     ``approve`` (sign-off person only) marks it done and emits ``conversation_done`` so workflows waiting
+         *     on it can start.
+         *     ``request_changes`` sends ``feedback`` back to the agent as the next turn of the SAME thread and the
+         *     status goes back to ``generating``.
+         */
+        post: operations['review_conversation'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/conversation/{conversation_ext_id}/activity': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get Conversation Activity
+         * @description The task's history, oldest first: when it started, went through each stage, was handed on or sent back.
+         *
+         *     Anyone who can see the conversation can read it. Notes (feedback, hand-off messages) are decrypted for the
+         *     caller; who did what is shown by external id.
+         */
+        get: operations['get_conversation_activity'];
+        put?: never;
         post?: never;
         delete?: never;
         options?: never;
         head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/conversation/{conversation_ext_id}/request-approval': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Request Conversation Approval
+         * @description Ask another person to approve this work item.
+         *
+         *     Anyone who can edit it can pass it on (nobody can take a work item for themselves): the person asked
+         *     becomes its sign-off person and gets a ``conversation_approval_request`` notification, and only they (not
+         *     the person who asked) can approve it from then on. They can pass it on again the same way.
+         */
+        post: operations['request_conversation_approval'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/conversation/{conversation_ext_id}/pending-auth': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
         /**
-         * Update Conversation Title
-         * @description Update a conversation title.
-         *     RLS ensures the user can only update conversations they have access to.
+         * Get Pending Auth
+         * @description The agent run-session key a parked run is waiting for the owner to allow.
+         *
+         *     404 when the run is not waiting for access. Owner group only, like running the work.
          */
-        patch: operations['update_conversation_title'];
+        get: operations['get_conversation_pending_auth'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
         trace?: never;
     };
     '/v1/assistant/sse-schema': {
@@ -1754,7 +1946,7 @@ interface paths {
          *
          *     A scheduled/goal run accumulates its step events into the same ``resp:events``
          *     machine a foreground turn uses, keyed by the run's pre-minted assistant msg id
-         *     (exposed as ``Task.active_response_id``). This endpoint foregrounds that stream:
+         *     (exposed as ``Convos.active_response_id``). This endpoint foregrounds that stream:
          *     it replays the events accumulated so far, then tails new ones until the run
          *     finishes — emitting the exact same ``arbi.agent_step`` / ``response.completed``
          *     frames the chat stream does, so the client reuses its normal SSE consumer.
@@ -1790,6 +1982,29 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/health/live': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Liveness
+         * @description Process liveness for orchestrators: answers 200 with no dependency checks.
+         *
+         *     ``GET /v1/health/`` checks Postgres and LiteLLM, so using it as a liveness probe would restart healthy pods
+         *     during a dependency blip. Use this for liveness and ``/v1/health/`` for readiness.
+         */
+        get: operations['get_health_live'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/health/': {
         parameters: {
             query?: never;
@@ -2102,7 +2317,7 @@ interface paths {
          *     be reminded about — there is nothing to fire relative to otherwise.
          *
          *     The reminder is deliberately CONTENT-FREE: it names the note by external id
-         *     and nothing else. ``tasks.name`` is plaintext while ``facts.content`` is
+         *     and nothing else. ``workflows.name`` is plaintext while ``facts.content`` is
          *     encrypted under the workspace key, so copying the text into the reminder
          *     would leak the very thing the note protects. The client resolves the text
          *     from the note when it displays the notification.
@@ -2114,6 +2329,66 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/workflow': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List Workflows */
+        get: operations['list_workflows'];
+        put?: never;
+        /** Create Workflow */
+        post: operations['create_workflow'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/workflow/{workflow_id}': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get Workflow */
+        get: operations['get_workflow'];
+        put?: never;
+        post?: never;
+        /** Delete Workflow */
+        delete: operations['delete_workflow'];
+        options?: never;
+        head?: never;
+        /** Update Workflow */
+        patch: operations['update_workflow'];
+        trace?: never;
+    };
+    '/v1/workflow/{workflow_id}/run': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Run Workflow
+         * @description Fire the workflow now as a test run: creates a conversation exactly as a trigger would.
+         *
+         *     Ignores the armed switch and the clock and leaves the schedule untouched (no advance, no disarm). A person
+         *     pressing Run authorizes the agent's run from their own session when the workspace is open on it.
+         */
+        post: operations['run_workflow'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/notifications/ws-schemas': {
         parameters: {
             query?: never;
@@ -2207,7 +2482,7 @@ interface paths {
          *     the recipient's workspaces and names none, so the notification is agnostic and
          *     the recipient's client picks the workspace; but a requester who already knows
          *     the target (e.g. the email gateway receiving mail at wrk-xxxx@arbidocs.com) may
-         *     attach it so the recipient's UI pre-selects it. The id only sticks if the
+         *     attach it so the recipient's UI preselects it. The id only sticks if the
          *     requester's session can resolve it under RLS — otherwise it silently falls back
          *     to agnostic. Either way the recipient drives role + temporary/permanent and
          *     then calls POST /workspace/{ext_id}/users to actually grant.
@@ -2530,93 +2805,105 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    '/v1/tasks': {
+    '/v1/files': {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** List Tasks */
-        get: operations['list_tasks'];
+        /**
+         * List Files
+         * @description List files in the workspace (OpenAI-compatible) with cursor pagination.
+         */
+        get: operations['list_files'];
         put?: never;
-        /** Create Task */
-        post: operations['create_task'];
+        /**
+         * Upload File
+         * @description Upload a file (OpenAI-compatible).
+         *
+         *     Accepts a multipart form with 'file' (binary) and 'purpose' (string) fields.
+         */
+        post: operations['upload_file'];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    '/v1/tasks/plan': {
+    '/v1/files/{file_id}': {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
+        /**
+         * Get File
+         * @description Retrieve a single file by ID (OpenAI-compatible).
+         */
+        get: operations['get_file'];
         put?: never;
+        post?: never;
         /**
-         * Plan Task
-         * @description Draft a reviewable ``TaskPlan`` for the active workspace from a plain objective.
-         *
-         *     The unified planner (``filter_and_plan`` → ``author_checklist``): formulates the
-         *     goal, proposes the doc set, and authors the acceptance criteria. Stateless — the
-         *     caller attaches the returned plan to a create body (new task) or a PATCH (re-plan).
+         * Delete File
+         * @description Delete a file by ID (OpenAI-compatible).
          */
-        post: operations['plan_task'];
-        delete?: never;
+        delete: operations['delete_file'];
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    '/v1/tasks/{task_id}': {
+    '/v1/files/{file_id}/content': {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** Get Task */
-        get: operations['get_task'];
+        /**
+         * Get File Content
+         * @description Retrieve the contents of a file (OpenAI-compatible).
+         *
+         *     Returns the raw file bytes with the appropriate content type.
+         */
+        get: operations['get_file_content'];
         put?: never;
         post?: never;
-        /** Delete Task */
-        delete: operations['delete_task'];
+        delete?: never;
         options?: never;
         head?: never;
-        /** Update Task */
-        patch: operations['update_task'];
+        patch?: never;
         trace?: never;
     };
-    '/v1/tasks/{task_id}/runs': {
+    '/v1/chat/completions': {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
+        get?: never;
+        put?: never;
         /**
-         * List Task Runs
-         * @description A task's run history, newest first — derived from its bookend notifications.
+         * Chat Completions
+         * @description OpenAI-compatible chat completions endpoint.
          *
-         *     There is no runs table: each ``task_completed`` notification tagged with this
-         *     task IS a run record, carrying the run's conversation (open it to watch/read)
-         *     and status. The current in-flight run (if any) is prepended from the task's
-         *     live pointers.
+         *     Supports:
+         *     - Standard chat completion (pure LLM proxy)
+         *     - file_search tool interception for RAG-augmented responses
+         *     - Both streaming (SSE) and non-streaming modes
+         *     - Citation generation when retrieval is used
          */
-        get: operations['list_task_runs'];
-        put?: never;
-        post?: never;
+        post: operations['chat_completions'];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    '/v1/tasks/{task_id}/run': {
+    '/v1/oauth/create_code': {
         parameters: {
             query?: never;
             header?: never;
@@ -2626,29 +2913,20 @@ interface paths {
         get?: never;
         put?: never;
         /**
-         * Run Now
-         * @description Fire the task immediately (wake the agent / notify), without changing its schedule.
-         *
-         *     Authorization is chosen by the task's ``auth_mode`` and resolved by the shared
-         *     dispatch path (``fire_task``): a tier-3 ``scheduled_permanent`` task runs via the
-         *     agent's standing membership; a temporary-tier task without a standing key mints
-         *     an agent run-session and asks the owner to authorize (reusing the
-         *     workspace-access-request flow), landing the task in a pending-auth state.
+         * Create Oauth Code
+         * @description Create an OAuth authorization code after user consent.
          *
-         *     When pending, the response carries the agent run-session's PUBLIC key + email so
-         *     the owner's client can grant a temporary, session-scoped key to it via
-         *     ``POST /v1/workspace/{id}/users`` (its ``session_pubkey_b64`` path) and then
-         *     re-trigger this endpoint — dispatch then resumes the run on that granted session.
-         *     No task-specific endpoint; the owner is present so this is effectively synchronous.
+         *     Called by the /mcp-connect frontend page when the user clicks Allow.
+         *     Requires the user's active browser session JWT as the Bearer token.
          */
-        post: operations['run_task'];
+        post: operations['create_oauth_code_v1_oauth_create_code_post'];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    '/v1/files': {
+    '/v1/connectors': {
         parameters: {
             query?: never;
             header?: never;
@@ -2656,133 +2934,12 @@ interface paths {
             cookie?: never;
         };
         /**
-         * List Files
-         * @description List files in the workspace (OpenAI-compatible) with cursor pagination.
+         * List active connector catalog entries
+         * @description Return all active connector catalog entries (code-defined, no secrets).
          */
-        get: operations['list_files'];
+        get: operations['list_connectors'];
         put?: never;
-        /**
-         * Upload File
-         * @description Upload a file (OpenAI-compatible).
-         *
-         *     Accepts a multipart form with 'file' (binary) and 'purpose' (string) fields.
-         */
-        post: operations['upload_file'];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    '/v1/files/{file_id}': {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get File
-         * @description Retrieve a single file by ID (OpenAI-compatible).
-         */
-        get: operations['get_file'];
-        put?: never;
-        post?: never;
-        /**
-         * Delete File
-         * @description Delete a file by ID (OpenAI-compatible).
-         */
-        delete: operations['delete_file'];
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    '/v1/files/{file_id}/content': {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * Get File Content
-         * @description Retrieve the contents of a file (OpenAI-compatible).
-         *
-         *     Returns the raw file bytes with the appropriate content type.
-         */
-        get: operations['get_file_content'];
-        put?: never;
-        post?: never;
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    '/v1/chat/completions': {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Chat Completions
-         * @description OpenAI-compatible chat completions endpoint.
-         *
-         *     Supports:
-         *     - Standard chat completion (pure LLM proxy)
-         *     - file_search tool interception for RAG-augmented responses
-         *     - Both streaming (SSE) and non-streaming modes
-         *     - Citation generation when retrieval is used
-         */
-        post: operations['chat_completions'];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    '/v1/oauth/create_code': {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Create Oauth Code
-         * @description Create an OAuth authorization code after user consent.
-         *
-         *     Called by the /mcp-connect frontend page when the user clicks Allow.
-         *     Requires the user's active browser session JWT as the Bearer token.
-         */
-        post: operations['create_oauth_code_v1_oauth_create_code_post'];
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
-    '/v1/connectors': {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        /**
-         * List active connector catalog entries
-         * @description Return all active connector catalog entries (code-defined, no secrets).
-         */
-        get: operations['list_connectors'];
-        put?: never;
-        post?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
@@ -3339,6 +3496,75 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    '/v1/slack/me': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get Slack Connection */
+        get: operations['get_slack_connection_v1_slack_me_get'];
+        put?: never;
+        post?: never;
+        /** Disconnect Slack */
+        delete: operations['disconnect_slack_v1_slack_me_delete'];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/slack/authorize': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Authorize Slack */
+        get: operations['authorize_slack_v1_slack_authorize_get'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/slack/callback': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Slack Callback */
+        get: operations['slack_callback_v1_slack_callback_get'];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    '/v1/slack/events': {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Slack Events */
+        post: operations['slack_events_v1_slack_events_post'];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     '/v1/responses': {
         parameters: {
             query?: never;
@@ -3392,10 +3618,35 @@ type webhooks = Record<string, never>;
 interface components {
     schemas: {
         /**
-         * ActionType
+         * ActivityKind
+         * @description What happened to a task, in the order a person reads its history.
          * @enum {string}
          */
-        ActionType: 'notify' | 'agent_prompt' | 'run_skill';
+        ActivityKind: 'created' | 'run_started' | 'awaiting_access' | 'access_granted' | 'ready_for_review' | 'handed_off' | 'changes_requested' | 'done' | 'reopened' | 'failed';
+        /**
+         * ActivityResponse
+         * @description One entry of ``GET /v1/conversation/{id}/activity``.
+         */
+        ActivityResponse: {
+            /** External Id */
+            external_id: string;
+            kind: components['schemas']['ActivityKind'];
+            /** Actor Ext Id */
+            actor_ext_id?: string | null;
+            /** To Ext Id */
+            to_ext_id?: string | null;
+            /** Note */
+            note?: string | null;
+            /** Detail */
+            detail?: {
+                [key: string]: unknown;
+            } | null;
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+        };
         /**
          * AddContactsRequest
          * @description Request model for adding contacts by email.
@@ -3679,7 +3930,7 @@ interface components {
         };
         /**
          * AgentWorkspaceResponse
-         * @description One workspace an agent can access, with its role.
+         * @description One live workspace grant and whether it can wake an agent persistently.
          */
         AgentWorkspaceResponse: {
             /** Workspace Ext Id */
@@ -3692,9 +3943,9 @@ interface components {
              * Format: date-time
              */
             joined_at: string;
-            /** Whether the grant has a persistent wrapped workspace key. */
+            /** Permanent */
             permanent: boolean;
-            /** Whether this is the workspace selected for agent wakeups. */
+            /** Is Default */
             is_default: boolean;
         };
         /**
@@ -4246,7 +4497,7 @@ interface components {
              *       "API_TYPE": "remote",
              *       "ENABLE_THINKING": false,
              *       "MODEL_NAME": "Fast",
-             *       "SYSTEM_INSTRUCTION": "You are a document analysis assistant. Answer questions based strictly on document content.\n\nYour answers are displayed directly as cell values in a table, so keep every answer as short as possible.\n\nGuidelines:\n- Answer with the value only — never a full sentence. Do not restate the question or add lead-ins such as \"This document is...\" or \"The document describes...\". Good: \"German\". Bad: \"This document is written in German.\"\n- When an answer has multiple values, put each value on its own line: separate values with a newline character. Do not separate them with commas, bullets, dashes, numbering, or by writing them as a sentence.\n- Only use information explicitly stated in the document; do not infer or assume information not present.\n- If the information is not found, respond with exactly \"Not found\".\n- Follow the format instructions exactly for each answer.\n- Output answers as plain text only. Do not use Markdown or any other formatting: no bold, italics, asterisks (*), underscores (_), backticks (`), bullets, or numbered/lettered enumeration.",
+             *       "SYSTEM_INSTRUCTION": "You are a document analysis assistant. Answer questions based on the document content.\n\nYour answers are displayed directly as cell values in a table, so keep every answer as short as possible.\n\nGuidelines:\n- Answer with the value only — never a full sentence. Do not restate the question or add lead-ins such as \"This document is...\" or \"The document describes...\". Good: \"German\". Bad: \"This document is written in German.\"\n- When an answer has multiple values, put each value on its own line: separate values with a newline character. Do not separate them with commas, bullets, dashes, numbering, or by writing them as a sentence.\n- Answer from the document. Reasonable inferences are fine; if the document gives no basis for an answer, the value is null and sources is empty.\n- Follow the format instructions exactly for each answer.\n- Output answers as plain text only. Do not use Markdown or any other formatting: no bold, italics, asterisks (*), underscores (_), backticks (`), bullets, or numbered/lettered enumeration.\n- Passages may be preceded by markers like [p3.2]: not document content. Cite them in \"sources\", never in a value.",
              *       "MAX_TOKEN_CONTEXT_TO_ANSWER": 200000,
              *       "TEMPERATURE": 0.1,
              *       "MAX_TOKENS": 0,
@@ -4699,11 +4950,11 @@ interface components {
             title: string;
             /**
              * Mode
-             * @description Rendering mode: markdown (default, supports redlines), html, plain text, or image (a generated image artifact — render the doc via the image viewer)
+             * @description Rendering mode: markdown (default, supports redlines), html (single-file page, rendered in a sandboxed preview), react (single-file JSX component, rendered in a sandboxed preview), plain text, or image (a generated image artifact — render the doc via the image viewer)
              * @default markdown
              * @enum {string}
              */
-            mode: 'markdown' | 'html' | 'text' | 'image';
+            mode: 'markdown' | 'html' | 'text' | 'react' | 'image';
             /**
              * Content
              * @description The artifact content (markdown/html/text; empty for image mode)
@@ -4727,6 +4978,11 @@ interface components {
              * @default 1
              */
             version: number;
+            /**
+             * Parent Doc Ext Id
+             * @description Document this artifact updates; it is saved as the next version in that document's chain
+             */
+            parent_doc_ext_id?: string | null;
             /**
              * Message Ext Id
              * @description External ID of the assistant message that generated this artifact
@@ -4750,6 +5006,28 @@ interface components {
              */
             question: string;
         };
+        /**
+         * AssistantMode
+         * @description When the assistant answers a message in a conversation (``convos.assistant_mode``).
+         *
+         *     - ``always``: every message runs the assistant. The default, and what every
+         *       pre-existing conversation is, so an ordinary 1:1 chat behaves as before.
+         *     - ``mentioned``: a thread between people. A message runs the assistant only
+         *       when it @mentions the assistant; any other message is a plain comment
+         *       (stored, shown, no LLM run). Set by callers that want threads.
+         * @enum {string}
+         */
+        AssistantMode: 'always' | 'mentioned';
+        /** AssistantModeUpdateRequest */
+        AssistantModeUpdateRequest: {
+            assistant_mode: components['schemas']['AssistantMode'];
+        };
+        /** AssistantModeUpdateResponse */
+        AssistantModeUpdateResponse: {
+            /** Conversation Ext Id */
+            conversation_ext_id: string;
+            assistant_mode: components['schemas']['AssistantMode'];
+        };
         /**
          * AuthMessage
          * @description Client authentication message.
@@ -4764,34 +5042,6 @@ interface components {
             /** Token */
             token: string;
         };
-        /**
-         * AuthMode
-         * @description How a task's agent obtains the workspace key it needs to act — a per-task,
-         *     least-privilege authorization choice. See ``docs/agent_scheduler_design.md`` and
-         *     the per-tier threat model in ``src/core/agent_headless.py``.
-         *
-         *     ``run_now_temp`` (default, tier 1) — RUN NOW with the owner present. The agent
-         *         has no standing key, so the run reuses the shipped **workspace-access-request**
-         *         flow: the agent asks the owner, who — being online — grants immediately via
-         *         the ordinary ``POST /v1/workspace/{id}/users`` (a temporary, session-scoped
-         *         key, or permanent, their choice). **No task-specific handshake** and, for a
-         *         temporary grant, no durable ``WorkspaceUsers`` membership. Least privilege:
-         *         a compromised agent host at rest holds no standing key.
-         *
-         *     ``scheduled_require_auth`` (tier 2) — the SAME workspace-access-request flow, but
-         *         the owner grants whenever they get to it: the run does not proceed until a key
-         *         is granted, landing in a pending-auth state (``pending_auth_request_id``)
-         *         rather than running unauthorized.
-         *
-         *     ``scheduled_permanent`` (tier 3, advanced) — standing ``WorkspaceUsers``
-         *         membership: the server can derive the workspace key from the agent's own
-         *         deployment-wrapped identity at any time, owner offline. Convenient for
-         *         unattended recurring runs, but the agent's environment can reach the
-         *         workspace key whenever it likes — an explicit "I trust this agent's
-         *         environment" opt-in, NOT the default.
-         * @enum {string}
-         */
-        AuthMode: 'run_now_temp' | 'scheduled_require_auth' | 'scheduled_permanent';
         /**
          * AuthResultMessage
          * @description Server response to authentication.
@@ -5660,6 +5910,58 @@ interface components {
             message_count: number;
             /** Last Message Status */
             last_message_status?: string | null;
+            /** @default always */
+            assistant_mode: components['schemas']['AssistantMode'];
+            status?: components['schemas']['WorkStatus'] | null;
+            /** Description */
+            description?: string | null;
+            /** Due At */
+            due_at?: string | null;
+            /** Signoff Ext Id */
+            signoff_ext_id?: string | null;
+            /**
+             * Can Signoff
+             * @default false
+             */
+            can_signoff: boolean;
+            /** Completed At */
+            completed_at?: string | null;
+            /** Completed By Ext Id */
+            completed_by_ext_id?: string | null;
+            /** Parent Conversation Ext Id */
+            parent_conversation_ext_id?: string | null;
+            /** Workflow Ext Id */
+            workflow_ext_id?: string | null;
+            /** Agent Ext Id */
+            agent_ext_id?: string | null;
+            /** Skill Ref */
+            skill_ref?: string | null;
+            auth_mode?: components['schemas']['src__models__work__AuthMode'] | null;
+            plan?: components['schemas']['TaskPlan'] | null;
+            /** Goal State */
+            goal_state?: {
+                [key: string]: unknown;
+            } | null;
+            /** Last Error */
+            last_error?: string | null;
+            /** Pending Auth Request Id */
+            pending_auth_request_id?: string | null;
+            /**
+             * In Progress
+             * @default false
+             */
+            in_progress: boolean;
+            /** Active Response Id */
+            active_response_id?: string | null;
+            /** Run Started At */
+            run_started_at?: string | null;
+            /** Owner Ext Id */
+            owner_ext_id?: string | null;
+            /**
+             * Is Owner
+             * @default true
+             */
+            is_owner: boolean;
         };
         /**
          * ConversationSearchGroup
@@ -5711,24 +6013,6 @@ interface components {
             /** Results */
             results: components['schemas']['ConversationSearchGroup'][];
         };
-        /** ConversationTitleUpdateRequest */
-        ConversationTitleUpdateRequest: {
-            /**
-             * Title
-             * @description New conversation title (1-60 characters)
-             */
-            title: string;
-        };
-        /** ConversationTitleUpdateResponse */
-        ConversationTitleUpdateResponse: {
-            /**
-             * Detail
-             * @default Conversation title updated successfully
-             */
-            detail: string;
-            /** Title */
-            title: string;
-        };
         /**
          * ConversationTitleUpdatedMessage
          * @description Conversation title regenerated server-side — frontend should refresh.
@@ -6006,41 +6290,102 @@ interface components {
             /** Parent Ext Id */
             parent_ext_id?: string | null;
         };
-        /** CreateTaskRequest */
-        CreateTaskRequest: {
-            /** Name */
-            name: string;
-            /** @default one_time */
-            trigger_type: components['schemas']['TriggerType'];
-            /** Rrule */
-            rrule?: string | null;
-            /** Run At */
-            run_at?: string | null;
-            /**
-             * Timezone
-             * @default UTC
-             */
-            timezone: string;
-            /** Event Kind */
-            event_kind?: string | null;
-            /** @default notify */
-            action_type: components['schemas']['ActionType'];
-            /**
-             * Prompt
-             * @default
-             */
-            prompt: string;
+        /**
+         * CreateWorkRequest
+         * @description Create a work item in the active workspace (``POST /v1/conversation/work``).
+         *
+         *     No ``prompt`` and no ``skill_ref`` → a plain to-do (``todo``). With one → the conversation is
+         *     created ``generating`` and the agent run starts now (the caller is present: the run's session is
+         *     granted from the caller's own workspace key; no access question).
+         */
+        CreateWorkRequest: {
+            /** Title */
+            title?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Due At */
+            due_at?: string | null;
+            /** Signoff User Ext Id */
+            signoff_user_ext_id?: string | null;
+            /** Parent Conversation Ext Id */
+            parent_conversation_ext_id?: string | null;
+            /** Shared */
+            shared?: boolean | null;
+            /** Prompt */
+            prompt?: string | null;
             /** Skill Ref */
             skill_ref?: string | null;
-            /** Notify On Complete */
-            notify_on_complete?: boolean | null;
+            /** Skill Inputs */
+            skill_inputs?: {
+                [key: string]: unknown;
+            } | null;
+            /** Agent Ext Id */
+            agent_ext_id?: string | null;
             /** @default run_now_temp */
-            auth_mode: components['schemas']['AuthMode'];
+            auth_mode: components['schemas']['src__models__work__AuthMode'];
+            plan?: components['schemas']['TaskPlan'] | null;
+        };
+        /** CreateWorkflowRequest */
+        CreateWorkflowRequest: {
             /** Workspace Ext Id */
-            workspace_ext_id?: string | null;
+            workspace_ext_id: string;
+            /** Name */
+            name: string;
+            /**
+             * Description
+             * @default
+             */
+            description: string;
+            /**
+             * Active
+             * @default true
+             */
+            active: boolean;
+            /**
+             * Shared
+             * @default false
+             */
+            shared: boolean;
+            /** Rrule */
+            rrule?: string | null;
+            /**
+             * Timezone
+             * @default UTC
+             */
+            timezone: string;
+            /** Run At */
+            run_at?: string | null;
+            /** Event Kind */
+            event_kind?: string | null;
+            /** Event Filter */
+            event_filter?: {
+                [key: string]: string | number | boolean;
+            } | null;
+            /** After Conversation Ext Id */
+            after_conversation_ext_id?: string | null;
+            /**
+             * On Demand
+             * @default false
+             */
+            on_demand: boolean;
+            /**
+             * Prompt
+             * @default
+             */
+            prompt: string;
+            /** Skill Ref */
+            skill_ref?: string | null;
+            /** Skill Inputs */
+            skill_inputs?: {
+                [key: string]: unknown;
+            } | null;
+            plan?: components['schemas']['TaskPlan'] | null;
             /** Agent Ext Id */
             agent_ext_id?: string | null;
-            task_plan?: components['schemas']['TaskPlan'] | null;
+            /** @default run_now_temp */
+            auth_mode: components['schemas']['src__models__workflow__AuthMode'];
+            /** Signoff User Ext Id */
+            signoff_user_ext_id?: string | null;
         };
         /**
          * DailyUsage
@@ -6246,6 +6591,10 @@ interface components {
             config_ext_id?: string | null;
             /** Parent Ext Id */
             parent_ext_id?: string | null;
+            /** Source Message Ext Id */
+            source_message_ext_id?: string | null;
+            /** Conversation Ext Id */
+            conversation_ext_id?: string | null;
             /** Created By Ext Id */
             created_by_ext_id: string;
             /** Updated By Ext Id */
@@ -6387,17 +6736,17 @@ interface components {
             MODEL_NAME: string;
             /**
              * System Instruction
-             * @default You are a document analysis assistant. Answer questions based strictly on document content.
+             * @default You are a document analysis assistant. Answer questions based on the document content.
              *
              *     Your answers are displayed directly as cell values in a table, so keep every answer as short as possible.
              *
              *     Guidelines:
              *     - Answer with the value only — never a full sentence. Do not restate the question or add lead-ins such as "This document is..." or "The document describes...". Good: "German". Bad: "This document is written in German."
              *     - When an answer has multiple values, put each value on its own line: separate values with a newline character. Do not separate them with commas, bullets, dashes, numbering, or by writing them as a sentence.
-             *     - Only use information explicitly stated in the document; do not infer or assume information not present.
-             *     - If the information is not found, respond with exactly "Not found".
+             *     - Answer from the document. Reasonable inferences are fine; if the document gives no basis for an answer, the value is null and sources is empty.
              *     - Follow the format instructions exactly for each answer.
              *     - Output answers as plain text only. Do not use Markdown or any other formatting: no bold, italics, asterisks (*), underscores (_), backticks (`), bullets, or numbered/lettered enumeration.
+             *     - Passages may be preceded by markers like [p3.2]: not document content. Cite them in "sources", never in a value.
              */
             SYSTEM_INSTRUCTION: string;
             /**
@@ -7318,7 +7667,7 @@ interface components {
          *     each criterion's running verdict + accumulated learnings + pass count + done flag.
          *     This ``messages.tools`` entry is the **canonical** per-drive record: the grade-in-turn
          *     step stamps it at finalize, and the scheduler reads it back (by response id) to
-         *     advance the plaintext ``Task.goal_state`` summary.
+         *     advance the plaintext ``Convos.goal_state`` summary.
          *
          *     Sensitive paths are SecretBox-encrypted at rest exactly like
          *     ``trace.steps.*.learning``: ``record.learnings.*``, ``record.criteria.*.note``, and
@@ -7749,10 +8098,16 @@ interface components {
             workspace_ext_id: string;
             /** Previous Response Id */
             previous_response_id?: string | null;
+            /** Conversation Ext Id */
+            conversation_ext_id?: string | null;
             /** Model */
             model?: string | null;
             /** Active Artifact Ext Id */
             active_artifact_ext_id?: string | null;
+            /** Mentions */
+            mentions?: components['schemas']['MessageMention'][];
+            assistant_mode?: components['schemas']['AssistantMode'] | null;
+            task?: components['schemas']['TaskOptions'] | null;
             /**
              * Stream
              * @default false
@@ -7777,6 +8132,31 @@ interface components {
             /** Top P */
             top_p?: number | null;
         };
+        /**
+         * MessageMention
+         * @description One structured @mention on a message (``messages.mentions``).
+         *
+         *     Stored PLAINTEXT next to the encrypted content: the server must read who was
+         *     mentioned to share the conversation and notify them, exactly like
+         *     ``created_by``. ``label`` is never taken from the client: the server fills it
+         *     from the mentioned user's name (``users.given_name``/``family_name``, already
+         *     plaintext) or the fixed assistant label, so no message text can leak through
+         *     it. Renderers find ``@<label>`` in the decrypted content to draw the chip.
+         */
+        MessageMention: {
+            /**
+             * Type
+             * @enum {string}
+             */
+            type: 'user' | 'assistant';
+            /** User Ext Id */
+            user_ext_id?: string | null;
+            /**
+             * Label
+             * @description Display name, filled in by the server
+             */
+            label?: string | null;
+        };
         /**
          * MessageMetadataPayload
          * @description ``message_metadata`` payload within ``response.completed.response.metadata``.
@@ -7798,11 +8178,6 @@ interface components {
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
-            /**
-             * Shared
-             * @default false
-             */
-            shared: boolean;
             /**
              * Tokens
              * @default 0
@@ -7813,6 +8188,8 @@ interface components {
              * @default completed
              */
             status: string;
+            /** Mentions */
+            mentions?: components['schemas']['MessageMention'][];
             /** External Id */
             external_id: string;
             /**
@@ -7909,11 +8286,6 @@ interface components {
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
-            /**
-             * Shared
-             * @default false
-             */
-            shared: boolean;
             /**
              * Tokens
              * @default 0
@@ -7924,6 +8296,8 @@ interface components {
              * @default completed
              */
             status: string;
+            /** Mentions */
+            mentions?: components['schemas']['MessageMention'][];
             /** External Id */
             external_id: string;
             /**
@@ -8158,8 +8532,8 @@ interface components {
             content?: string | null;
             /** Conversation Ext Id */
             conversation_ext_id?: string | null;
-            /** Task Ext Id */
-            task_ext_id?: string | null;
+            /** Message Ext Id */
+            message_ext_id?: string | null;
             /**
              * Read
              * @default false
@@ -8183,7 +8557,7 @@ interface components {
          *     Type is self-descriptive, no need to parse content field.
          * @enum {string}
          */
-        NotificationType: 'user_message' | 'workspaceuser_added_owner' | 'workspaceuser_added_collaborator' | 'workspaceuser_added_guest' | 'workspaceuser_removed' | 'workspaceuser_updated_owner' | 'workspaceuser_updated_collaborator' | 'workspaceuser_updated_guest' | 'contact_accepted' | 'signup_reward' | 'referral_reward' | 'email_reply' | 'quota_threshold_50' | 'quota_threshold_90' | 'quota_threshold_100' | 'doc_shared' | 'workspace_access_request' | 'task_started' | 'task_completed' | 'mailbox_sync_complete' | 'drive_sync_complete' | 'activity';
+        NotificationType: 'user_message' | 'workspaceuser_added_owner' | 'workspaceuser_added_collaborator' | 'workspaceuser_added_guest' | 'workspaceuser_removed' | 'workspaceuser_updated_owner' | 'workspaceuser_updated_collaborator' | 'workspaceuser_updated_guest' | 'contact_accepted' | 'signup_reward' | 'referral_reward' | 'email_reply' | 'quota_threshold_50' | 'quota_threshold_90' | 'quota_threshold_100' | 'doc_shared' | 'workspace_access_request' | 'conversation_ready_for_review' | 'conversation_done' | 'conversation_approval_request' | 'workflow_failed' | 'mailbox_sync_complete' | 'drive_sync_complete' | 'activity' | 'mention';
         /**
          * NotificationUpdate
          * @description Single notification update for bulk PATCH.
@@ -8350,6 +8724,22 @@ interface components {
              */
             SKIP_DUPLICATES: boolean;
         };
+        /**
+         * PendingAuthResponse
+         * @description What the owner needs to allow a parked agent run: the agent's run-session PUBLIC key and email.
+         *
+         *     Non-secret. Lets a client that only has the access-request notification (which carries no
+         *     encrypted note for an agent-originated request) grant the temporary key via
+         *     ``POST /v1/workspace/{id}/users``.
+         */
+        PendingAuthResponse: {
+            /** Session Pubkey */
+            session_pubkey: string;
+            /** Agent Email */
+            agent_email: string;
+            /** Workspace Ext Id */
+            workspace_ext_id?: string | null;
+        };
         /**
          * PendingWorkspaceShare
          * @description A workspace share from an invite whose Redis-deposited key expired
@@ -8412,14 +8802,13 @@ interface components {
             task: string;
         };
         /**
-         * PlanTaskRequest
-         * @description Draft a ``TaskPlan`` from a plain objective (the stateless ``/plan`` endpoint).
+         * PlanWorkRequest
+         * @description Draft a ``TaskPlan`` from a plain objective (the stateless ``/work/plan`` endpoint).
          *
-         *     No task row involved — the returned plan is attached to a create body (new
-         *     task) or a PATCH (re-plan an existing one), matching the build-then-submit
-         *     task edit flow.
+         *     No row involved — the returned plan is attached to a create body (new work) or a PATCH
+         *     (re-plan an existing one), matching the build-then-submit edit flow.
          */
-        PlanTaskRequest: {
+        PlanWorkRequest: {
             /** Objective */
             objective: string;
             /**
@@ -8500,6 +8889,40 @@ interface components {
              */
             APPROVAL_TIMEOUT: number;
         };
+        /**
+         * PostMessageRequest
+         * @description A human message posted WITHOUT running the assistant (a comment in a thread).
+         *
+         *     Where it goes, in order of precedence:
+         *     - ``previous_message_ext_id``: reply under that exact message (a branch point).
+         *     - ``conversation_ext_id``: append after the conversation's most recent message.
+         *     - neither: start a new conversation in ``assistant_mode`` (default ``mentioned``).
+         *
+         *     Only valid in a ``mentioned`` conversation: an ``always`` conversation promises
+         *     a reply to every message, so its messages go through ``POST /v1/assistant/query``.
+         *     Mentioning the assistant is rejected here for the same reason: that message is
+         *     meant to run it, so send it through the query endpoint (with ``mentions``).
+         */
+        PostMessageRequest: {
+            /** Content */
+            content: string;
+            /** Mentions */
+            mentions?: components['schemas']['MessageMention'][];
+            /** Conversation Ext Id */
+            conversation_ext_id?: string | null;
+            /** Previous Message Ext Id */
+            previous_message_ext_id?: string | null;
+            /**
+             * @description Mode of a conversation this message creates; ignored when posting into an existing one
+             * @default mentioned
+             */
+            assistant_mode: components['schemas']['AssistantMode'];
+            /**
+             * Title
+             * @description Title of a conversation this message creates (defaults to the start of the content)
+             */
+            title?: string | null;
+        };
         /**
          * PresenceUpdateMessage
          * @description Sent when a contact's online status changes or is no longer tracked.
@@ -9095,6 +9518,19 @@ interface components {
             /** Users */
             users: components['schemas']['RemoveWorkspaceUserItem'][];
         };
+        /**
+         * RequestApprovalRequest
+         * @description Ask a person to approve a work item. They become its sign-off person and are notified.
+         */
+        RequestApprovalRequest: {
+            /** User Ext Id */
+            user_ext_id: string;
+            /**
+             * Note
+             * @default
+             */
+            note: string;
+        };
         /**
          * RequestDeletionResponse
          * @description Response for POST /v1/user/request-deletion.
@@ -9123,7 +9559,7 @@ interface components {
          *     ``workspace_ext_id`` is optional: omit it when the requester can't see the
          *     recipient's workspaces under RLS (the recipient's client picks one), or pass
          *     it when the requester already knows the target (e.g. the email gateway, which
-         *     learns it from a wrk-xxxx@… address) so the recipient's UI pre-selects it. It
+         *     learns it from a wrk-xxxx@… address) so the recipient's UI preselects it. It
          *     only sticks if the requester's session can actually resolve the workspace —
          *     an unresolvable id silently falls back to agnostic, never leaking existence.
          *
@@ -9932,6 +10368,11 @@ interface components {
              */
             HYBRID_SPARSE_WEIGHT: number;
         };
+        /**
+         * ReviewAction
+         * @enum {string}
+         */
+        ReviewAction: 'approve' | 'request_changes';
         /**
          * ReviewLLMConfig
          * @description Configuration for ReviewLLM - reviews agent draft answers against source material.
@@ -9991,6 +10432,18 @@ interface components {
              */
             MAX_TOKEN_SIZE_TO_ANSWER: number;
         };
+        /**
+         * ReviewWorkRequest
+         * @description A human's verdict on prepared work (``ready_for_review``).
+         */
+        ReviewWorkRequest: {
+            action: components['schemas']['ReviewAction'];
+            /**
+             * Feedback
+             * @default
+             */
+            feedback: string;
+        };
         /**
          * RunCodeConfig
          * @description spawn_coding_agent sandbox tuning (developer-only — image/network/limits are infra,
@@ -10316,14 +10769,6 @@ interface components {
             /** Auto Sync Workspace Ext Id */
             auto_sync_workspace_ext_id?: string | null;
         };
-        /** ShareConversationResponse */
-        ShareConversationResponse: {
-            /**
-             * Detail
-             * @default Conversation shared successfully
-             */
-            detail: string;
-        };
         /**
          * SkillSummaryResponse
          * @description One row of ``GET /v1/assistant/skills``.
@@ -10759,20 +11204,42 @@ interface components {
             instruction?: string | null;
             tag_type?: components['schemas']['TagFormat'];
         };
+        /**
+         * TaskOptions
+         * @description Make the conversation an assistant query starts a task: ``POST /v1/assistant/query`` with ``task`` set.
+         *
+         *     The query IS the run (as the person asking, with their own access). The conversation gets a status of
+         *     ``generating`` while the assistant works and ``ready_for_review`` when it finishes; every field here is optional.
+         *     Only read when the query starts a conversation (or a conversation that is not a task yet).
+         */
+        TaskOptions: {
+            /** Title */
+            title?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Due At */
+            due_at?: string | null;
+            /** Signoff User Ext Id */
+            signoff_user_ext_id?: string | null;
+            /** Parent Conversation Ext Id */
+            parent_conversation_ext_id?: string | null;
+            /** Shared */
+            shared?: boolean | null;
+            plan?: components['schemas']['TaskPlan'] | null;
+        };
         /**
          * TaskPlan
-         * @description The reviewable definition-of-done for a goal task.
+         * @description The reviewable definition-of-done for a goal run.
          *
-         *     Authored by ``/plan`` (or hand-written), user-editable, stored on
-         *     ``Task.task_plan``, and consumed at execution to (a) seed the intra-turn
-         *     ``/goal`` gate with a frozen checklist and (b) scope retrieval to
-         *     ``documents``. This is the *input* half (what "done" means + which docs);
-         *     ``Task.goal_state`` is the runtime *status* projection (done/pass_count).
+         *     Authored by ``POST /v1/conversation/work/plan`` (or hand-written), user-editable, stored
+         *     (encrypted) on ``Convos.plan``, and consumed at execution to (a) seed the intra-turn ``/goal``
+         *     gate with a frozen checklist and (b) scope retrieval to ``documents``. This is the *input* half
+         *     (what "done" means + which docs); ``Convos.goal_state`` is the runtime *status* projection.
          *
-         *     There is no ``scope`` field. Open-web vs. closed-corpus is a *capability* of
-         *     the task's agent/workspace (whether web-search / read-url tools are enabled),
-         *     resolved at execution — not a plan attribute. ``documents`` is orthogonal: it
-         *     narrows *retrieval* to a subset of the workspace, it doesn't gate the web.
+         *     There is no ``scope`` field. Open-web vs. closed-corpus is a *capability* of the agent/workspace
+         *     (whether web-search / read-url tools are enabled), resolved at execution — not a plan attribute.
+         *     ``documents`` is orthogonal: it narrows *retrieval* to a subset of the workspace, it doesn't gate
+         *     the web.
          */
         TaskPlan: {
             /**
@@ -10798,7 +11265,7 @@ interface components {
         };
         /**
          * TaskPlanCriterion
-         * @description One acceptance criterion in a task plan (mirrors instruments.llm.GoalCriterion,
+         * @description One acceptance criterion in a plan (mirrors instruments.llm.GoalCriterion,
          *     redeclared here so the model layer needn't import the LLM instruments).
          */
         TaskPlanCriterion: {
@@ -10807,111 +11274,6 @@ interface components {
             /** Text */
             text: string;
         };
-        /** TaskResponse */
-        TaskResponse: {
-            /** External Id */
-            external_id: string;
-            /** Name */
-            name: string;
-            /** Trigger Type */
-            trigger_type: string;
-            /** Rrule */
-            rrule: string | null;
-            /** Run At */
-            run_at: string | null;
-            /** Timezone */
-            timezone: string;
-            /** Event Kind */
-            event_kind: string | null;
-            /** Action Type */
-            action_type: string;
-            /** Prompt */
-            prompt: string;
-            /** Skill Ref */
-            skill_ref: string | null;
-            /** Status */
-            status: string;
-            /** Next Run At */
-            next_run_at: string | null;
-            /** Last Run At */
-            last_run_at: string | null;
-            /** Last Error */
-            last_error: string | null;
-            /** In Progress */
-            in_progress: boolean;
-            /** Active Run Id */
-            active_run_id: string | null;
-            /** Agent Session */
-            agent_session: string | null;
-            /** Active Response Id */
-            active_response_id?: string | null;
-            /** Active Conversation Ext Id */
-            active_conversation_ext_id?: string | null;
-            /** Run Started At */
-            run_started_at: string | null;
-            /** Notify On Complete */
-            notify_on_complete: boolean;
-            auth_mode: components['schemas']['AuthMode'];
-            /** Pending Auth Request Id */
-            pending_auth_request_id?: string | null;
-            /** Pending Auth Session Pubkey */
-            pending_auth_session_pubkey?: string | null;
-            /** Pending Auth Agent Email */
-            pending_auth_agent_email?: string | null;
-            /** Created By Kind */
-            created_by_kind: string;
-            /** Workspace Ext Id */
-            workspace_ext_id?: string | null;
-            /** Agent Ext Id */
-            agent_ext_id?: string | null;
-            task_plan?: components['schemas']['TaskPlan'] | null;
-            /**
-             * Is Goal Task
-             * @default false
-             */
-            is_goal_task: boolean;
-            /** Goal State */
-            goal_state?: {
-                [key: string]: unknown;
-            } | null;
-            /**
-             * Created At
-             * Format: date-time
-             */
-            created_at: string;
-            /**
-             * Updated At
-             * Format: date-time
-             */
-            updated_at: string;
-        };
-        /**
-         * TaskRunResponse
-         * @description One execution of a task, derived from its run bookend notifications.
-         *
-         *     There is no runs table: history comes from the ``task_started`` /
-         *     ``task_completed`` notifications tagged with this task. Each entry links to the
-         *     run's conversation (``conversation_ext_id``) — open it to watch/read the run.
-         */
-        TaskRunResponse: {
-            /** Run Id */
-            run_id?: string | null;
-            /** Conversation Ext Id */
-            conversation_ext_id?: string | null;
-            /** Status */
-            status: string;
-            /** Error */
-            error?: string | null;
-            /** Started At */
-            started_at?: string | null;
-            /** Finished At */
-            finished_at?: string | null;
-        };
-        /**
-         * TaskStatus
-         * @enum {string}
-         */
-        TaskStatus: 'active' | 'paused' | 'completed' | 'failed';
         /**
          * TaskUpdateMessage
          * @description Document processing progress update.
@@ -10954,6 +11316,8 @@ interface components {
             conversation_ext_id: string;
             /** Threads */
             threads: components['schemas']['Thread'][];
+            /** @default always */
+            assistant_mode: components['schemas']['AssistantMode'];
         };
         /**
          * ThumbnailsRequest
@@ -11182,11 +11546,6 @@ interface components {
             /** Text */
             text: string;
         };
-        /**
-         * TriggerType
-         * @enum {string}
-         */
-        TriggerType: 'one_time' | 'recurring' | 'event';
         /**
          * UpdateAgentRequest
          * @description Mutable agent fields. Only appearance for now — identity (name/email/keys)
@@ -11196,6 +11555,32 @@ interface components {
             /** Picture */
             picture?: string | null;
         };
+        /**
+         * UpdateConversationRequest
+         * @description ``PATCH /v1/conversation/{id}`` — every field optional; only the ones sent change.
+         *
+         *     ``shared`` is owner only. ``status`` accepts ``todo`` and ``done`` only: ``done`` is human-only
+         *     (by the sign-off person) and ``todo`` reopens; ``generating`` / ``ready_for_review`` are set
+         *     only by runs and review. ``parent_conversation_ext_id`` is cycle-checked; send ``null`` to
+         *     detach. ``signoff_user_ext_id`` must be a human who can edit the workspace.
+         */
+        UpdateConversationRequest: {
+            /** Title */
+            title?: string | null;
+            /** Shared */
+            shared?: boolean | null;
+            /** Description */
+            description?: string | null;
+            /** Due At */
+            due_at?: string | null;
+            /** Signoff User Ext Id */
+            signoff_user_ext_id?: string | null;
+            /** Parent Conversation Ext Id */
+            parent_conversation_ext_id?: string | null;
+            /** Status */
+            status?: ('todo' | 'done') | null;
+            plan?: components['schemas']['TaskPlan'] | null;
+        };
         /**
          * UpdateDocTagRequest
          * @description Update a doctag's note or citations. Identified by (tag_ext_id, doc_ext_id) pair.
@@ -11292,25 +11677,50 @@ interface components {
              */
             parent_ext_id?: string | null;
         };
-        /** UpdateTaskRequest */
-        UpdateTaskRequest: {
+        /**
+         * UpdateWorkflowRequest
+         * @description Every field optional. Sending any trigger field replaces the whole trigger: exactly one of the four
+         *     must then be non-null (the others are cleared). ``agent_ext_id``/``signoff_user_ext_id`` null clears.
+         */
+        UpdateWorkflowRequest: {
             /** Name */
             name?: string | null;
+            /** Description */
+            description?: string | null;
+            /** Active */
+            active?: boolean | null;
+            /** Shared */
+            shared?: boolean | null;
             /** Rrule */
             rrule?: string | null;
-            /** Run At */
-            run_at?: string | null;
             /** Timezone */
             timezone?: string | null;
+            /** Run At */
+            run_at?: string | null;
+            /** Event Kind */
+            event_kind?: string | null;
+            /** Event Filter */
+            event_filter?: {
+                [key: string]: string | number | boolean;
+            } | null;
+            /** After Conversation Ext Id */
+            after_conversation_ext_id?: string | null;
+            /** On Demand */
+            on_demand?: boolean | null;
             /** Prompt */
             prompt?: string | null;
             /** Skill Ref */
             skill_ref?: string | null;
-            /** Notify On Complete */
-            notify_on_complete?: boolean | null;
-            status?: components['schemas']['TaskStatus'] | null;
-            auth_mode?: components['schemas']['AuthMode'] | null;
-            task_plan?: components['schemas']['TaskPlan'] | null;
+            /** Skill Inputs */
+            skill_inputs?: {
+                [key: string]: unknown;
+            } | null;
+            plan?: components['schemas']['TaskPlan'] | null;
+            /** Agent Ext Id */
+            agent_ext_id?: string | null;
+            auth_mode?: components['schemas']['src__models__workflow__AuthMode'] | null;
+            /** Signoff User Ext Id */
+            signoff_user_ext_id?: string | null;
         };
         /**
          * UpdateWorkspaceUserRolesRequest
@@ -11547,11 +11957,6 @@ interface components {
             };
             /** Config Ext Id */
             config_ext_id?: string | null;
-            /**
-             * Shared
-             * @default false
-             */
-            shared: boolean;
             /**
              * Tokens
              * @default 0
@@ -11562,6 +11967,8 @@ interface components {
              * @default completed
              */
             status: string;
+            /** Mentions */
+            mentions?: components['schemas']['MessageMention'][];
             /** External Id */
             external_id: string;
             /**
@@ -11765,10 +12172,7 @@ interface components {
             email_notifications?: components['schemas']['EmailNotificationSettings'];
             /** Premium Model */
             premium_model?: string | null;
-            /**
-             * Retired Premium Model
-             * @description One-shot notice: set only on the response that cleared a stored premium_model which is no longer an available Premium model. Never persisted; the choice is already cleared.
-             */
+            /** Retired Premium Model */
             retired_premium_model?: string | null;
             /** Retired Premium Model Suggestion */
             retired_premium_model_suggestion?: string | null;
@@ -12019,16 +12423,128 @@ interface components {
             auth?: components['schemas']['AuthMessage'] | null;
             send_message?: components['schemas']['SendMessageRequest'] | null;
         };
-        /** WorkspaceCreateRequest */
-        WorkspaceCreateRequest: {
+        /**
+         * WorkStatus
+         * @description Where a work conversation is in the human workflow. Agents prepare work; **only a human
+         *     marks it ``done``** (enforced in the router, never by the runner).
+         *
+         *     ``todo``              — nothing automated pending; a human (or Run) moves it on.
+         *     ``generating``        — an agent run is in flight (``active_run_id`` is set).
+         *     ``ready_for_review``  — the agent finished; it waits for a human (the sign-off person).
+         *     ``done``              — a human accepted it.
+         *
+         *     Only ``todo`` and ``done`` can be set by a client (PATCH). ``generating`` and
+         *     ``ready_for_review`` are set only by runs and by review.
+         * @enum {string}
+         */
+        WorkStatus: 'todo' | 'generating' | 'ready_for_review' | 'done';
+        /** WorkflowResponse */
+        WorkflowResponse: {
+            /** External Id */
+            external_id: string;
             /** Name */
             name: string;
-            /** Description */
-            description?: string | null;
             /**
-             * Is Public
-             * @default false
-             */
+             * Description
+             * @default
+             */
+            description: string;
+            /** Active */
+            active: boolean;
+            /**
+             * Shared
+             * @default false
+             */
+            shared: boolean;
+            /** Workspace Ext Id */
+            workspace_ext_id?: string | null;
+            /** Rrule */
+            rrule?: string | null;
+            /** Timezone */
+            timezone: string;
+            /** Run At */
+            run_at?: string | null;
+            /** Next Fire At */
+            next_fire_at?: string | null;
+            /** Event Kind */
+            event_kind?: string | null;
+            /** Event Filter */
+            event_filter?: {
+                [key: string]: unknown;
+            } | null;
+            /** After Conversation Ext Id */
+            after_conversation_ext_id?: string | null;
+            /**
+             * On Demand
+             * @default false
+             */
+            on_demand: boolean;
+            /**
+             * Prompt
+             * @default
+             */
+            prompt: string;
+            /** Skill Ref */
+            skill_ref?: string | null;
+            /** Skill Inputs */
+            skill_inputs?: {
+                [key: string]: unknown;
+            } | null;
+            plan?: components['schemas']['TaskPlan'] | null;
+            /** Agent Ext Id */
+            agent_ext_id?: string | null;
+            auth_mode: components['schemas']['src__models__workflow__AuthMode'];
+            /** Signoff Ext Id */
+            signoff_ext_id?: string | null;
+            /** Fact Ext Id */
+            fact_ext_id?: string | null;
+            /** Last Fired At */
+            last_fired_at?: string | null;
+            /** Last Error */
+            last_error?: string | null;
+            /** Owner Ext Id */
+            owner_ext_id?: string | null;
+            /**
+             * Is Owner
+             * @default true
+             */
+            is_owner: boolean;
+            /**
+             * Created At
+             * Format: date-time
+             */
+            created_at: string;
+            /**
+             * Updated At
+             * Format: date-time
+             */
+            updated_at: string;
+        };
+        /**
+         * WorkflowRunResponse
+         * @description Result of ``POST /v1/workflow/{id}/run``: the conversation the test run created.
+         */
+        WorkflowRunResponse: {
+            /** Conversation Ext Id */
+            conversation_ext_id?: string | null;
+            /**
+             * Started
+             * @default false
+             */
+            started: boolean;
+            /** Error */
+            error?: string | null;
+        };
+        /** WorkspaceCreateRequest */
+        WorkspaceCreateRequest: {
+            /** Name */
+            name: string;
+            /** Description */
+            description?: string | null;
+            /**
+             * Is Public
+             * @default false
+             */
             is_public: boolean;
             workspace_type?: components['schemas']['WorkspaceType'] | null;
             /** Workspace Key */
@@ -12210,6 +12726,42 @@ interface components {
              */
             is_temporary: boolean;
         };
+        /**
+         * AuthMode
+         * @description How a run's agent obtains the workspace key it needs to act — a per-work, least-privilege
+         *     authorization choice. See the per-tier threat model in ``src/core/agent_headless.py``.
+         *
+         *     ``run_now_temp`` (default, tier 1) — RUN NOW with a person present. The agent has no standing
+         *         key; the run's session is granted the workspace key from the invoker's OWN session (no
+         *         access question). Unattended, the same flow becomes a workspace-access request to the owner.
+         *         No durable ``WorkspaceUsers`` membership. Least privilege: a compromised agent host at rest
+         *         holds no standing key.
+         *
+         *     ``scheduled_require_auth`` (tier 2) — the run does not proceed until the owner grants a key; it
+         *         parks with ``pending_auth_request_id`` and a ``workspace_access_request`` notification
+         *         (carrying ``conversation_ext_id``) rather than running unauthorized.
+         *
+         *     ``scheduled_permanent`` (tier 3, advanced) — standing ``WorkspaceUsers`` membership: the server
+         *         can derive the workspace key from the agent's own deployment-wrapped identity at any time,
+         *         owner offline. An explicit "I trust this agent's environment" opt-in, NOT the default.
+         * @enum {string}
+         */
+        src__models__work__AuthMode: 'run_now_temp' | 'scheduled_require_auth' | 'scheduled_permanent';
+        /**
+         * AuthMode
+         * @description How a workflow's agent obtains the workspace key it needs to act (least privilege).
+         *
+         *     NOTE: the same concept as ``src.models.work.AuthMode`` (work-core); the names and values are identical so
+         *     the two can be deduplicated.
+         *
+         *     ``run_now_temp`` (default) — a person is present (Run / review feedback): the run session is granted
+         *         from their own workspace key. No standing membership.
+         *     ``scheduled_require_auth`` — an unattended run parks (``pending_auth_request_id`` + a
+         *         ``workspace_access_request`` notification) until the owner grants a key.
+         *     ``scheduled_permanent`` — the agent holds a standing membership; the server derives the key at any time.
+         * @enum {string}
+         */
+        src__models__workflow__AuthMode: 'run_now_temp' | 'scheduled_require_auth' | 'scheduled_permanent';
     };
     responses: never;
     parameters: never;
@@ -14442,7 +14994,7 @@ interface operations {
             };
         };
     };
-    share_conversation: {
+    update_conversation: {
         parameters: {
             query?: never;
             header?: never;
@@ -14451,7 +15003,11 @@ interface operations {
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['UpdateConversationRequest'];
+            };
+        };
         responses: {
             /** @description Successful Response */
             200: {
@@ -14459,7 +15015,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['ShareConversationResponse'];
+                    'application/json': components['schemas']['ConversationResponse'];
                 };
             };
             /** @description Validation Error */
@@ -14473,28 +15029,26 @@ interface operations {
             };
         };
     };
-    update_conversation_title: {
+    post_conversation_message: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                conversation_ext_id: string;
-            };
+            path?: never;
             cookie?: never;
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['ConversationTitleUpdateRequest'];
+                'application/json': components['schemas']['PostMessageRequest'];
             };
         };
         responses: {
             /** @description Successful Response */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['ConversationTitleUpdateResponse'];
+                    'application/json': components['schemas']['MessageResponse'];
                 };
             };
             /** @description Validation Error */
@@ -14508,37 +15062,20 @@ interface operations {
             };
         };
     };
-    get_sse_schema: {
+    update_conversation_assistant_mode: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Successful Response */
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    'application/json': components['schemas']['SSESchemas'];
-                };
+            path: {
+                conversation_ext_id: string;
             };
+            cookie?: never;
         };
-    };
-    list_skills: {
-        parameters: {
-            query?: {
-                /** @description Include skills whose frontmatter sets ``user-invocable: false``. Off by default — those are typically agent-only or in-progress skills that shouldn't surface in slash-command menus. */
-                include_hidden?: boolean;
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['AssistantModeUpdateRequest'];
             };
-            header?: never;
-            path?: never;
-            cookie?: never;
         };
-        requestBody?: never;
         responses: {
             /** @description Successful Response */
             200: {
@@ -14546,7 +15083,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['SkillsListResponse'];
+                    'application/json': components['schemas']['AssistantModeUpdateResponse'];
                 };
             };
             /** @description Validation Error */
@@ -14560,27 +15097,40 @@ interface operations {
             };
         };
     };
-    list_commands: {
+    create_work: {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['CreateWorkRequest'];
+            };
+        };
         responses: {
             /** @description Successful Response */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['CommandsListResponse'];
+                    'application/json': components['schemas']['ConversationResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
                 };
             };
         };
     };
-    transcribe_audio: {
+    plan_work: {
         parameters: {
             query?: never;
             header?: never;
@@ -14589,7 +15139,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                'multipart/form-data': components['schemas']['Body_transcribe_audio'];
+                'application/json': components['schemas']['PlanWorkRequest'];
             };
         };
         responses: {
@@ -14599,7 +15149,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['TranscribeResponse'];
+                    'application/json': components['schemas']['TaskPlan'];
                 };
             };
             /** @description Validation Error */
@@ -14613,18 +15163,16 @@ interface operations {
             };
         };
     };
-    generate: {
+    run_conversation: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                'application/json': components['schemas']['MessageInput'];
+            path: {
+                conversation_ext_id: string;
             };
+            cookie?: never;
         };
+        requestBody?: never;
         responses: {
             /** @description Successful Response */
             200: {
@@ -14632,7 +15180,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'text/event-stream': unknown;
+                    'application/json': components['schemas']['ConversationResponse'];
                 };
             };
             /** @description Validation Error */
@@ -14646,16 +15194,18 @@ interface operations {
             };
         };
     };
-    interject: {
+    review_conversation: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                conversation_ext_id: string;
+            };
             cookie?: never;
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['UserInputBody'];
+                'application/json': components['schemas']['ReviewWorkRequest'];
             };
         };
         responses: {
@@ -14665,7 +15215,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': unknown;
+                    'application/json': components['schemas']['ConversationResponse'];
                 };
             };
             /** @description Validation Error */
@@ -14679,12 +15229,12 @@ interface operations {
             };
         };
     };
-    watch_run: {
+    get_conversation_activity: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                response_id: string;
+                conversation_ext_id: string;
             };
             cookie?: never;
         };
@@ -14696,7 +15246,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'text/event-stream': unknown;
+                    'application/json': components['schemas']['ActivityResponse'][];
                 };
             };
             /** @description Validation Error */
@@ -14710,16 +15260,18 @@ interface operations {
             };
         };
     };
-    retrieve: {
+    request_conversation_approval: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                conversation_ext_id: string;
+            };
             cookie?: never;
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['MessageInput'];
+                'application/json': components['schemas']['RequestApprovalRequest'];
             };
         };
         responses: {
@@ -14729,7 +15281,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': unknown;
+                    'application/json': components['schemas']['ConversationResponse'];
                 };
             };
             /** @description Validation Error */
@@ -14743,11 +15295,13 @@ interface operations {
             };
         };
     };
-    get_health: {
+    get_conversation_pending_auth: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                conversation_ext_id: string;
+            };
             cookie?: never;
         };
         requestBody?: never;
@@ -14758,32 +15312,21 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['ConsolidatedHealthResponse'];
+                    'application/json': components['schemas']['PendingAuthResponse'];
                 };
             };
-        };
-    };
-    check_remote_models: {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Successful Response */
-            200: {
+            /** @description Validation Error */
+            422: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['ModelsHealthStatus'];
+                    'application/json': components['schemas']['HTTPValidationError'];
                 };
             };
         };
     };
-    get_models: {
+    get_sse_schema: {
         parameters: {
             query?: never;
             header?: never;
@@ -14798,14 +15341,17 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['ModelsResponse'];
+                    'application/json': components['schemas']['SSESchemas'];
                 };
             };
         };
     };
-    get_mcp_tools: {
+    list_skills: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Include skills whose frontmatter sets ``user-invocable: false``. Off by default — those are typically agent-only or in-progress skills that shouldn't surface in slash-command menus. */
+                include_hidden?: boolean;
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -14818,12 +15364,21 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['McpToolsResponse'];
+                    'application/json': components['schemas']['SkillsListResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
                 };
             };
         };
     };
-    get_metrics: {
+    list_commands: {
         parameters: {
             query?: never;
             header?: never;
@@ -14838,21 +15393,23 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': {
-                        [key: string]: unknown;
-                    };
+                    'application/json': components['schemas']['CommandsListResponse'];
                 };
             };
         };
     };
-    list_tags: {
+    transcribe_audio: {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                'multipart/form-data': components['schemas']['Body_transcribe_audio'];
+            };
+        };
         responses: {
             /** @description Successful Response */
             200: {
@@ -14860,12 +15417,21 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['TagResponse'][];
+                    'application/json': components['schemas']['TranscribeResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
                 };
             };
         };
     };
-    create_tag: {
+    generate: {
         parameters: {
             query?: never;
             header?: never;
@@ -14874,17 +15440,17 @@ interface operations {
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['CreateTagRequest'];
+                'application/json': components['schemas']['MessageInput'];
             };
         };
         responses: {
             /** @description Successful Response */
-            201: {
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['TagResponse'];
+                    'text/event-stream': unknown;
                 };
             };
             /** @description Validation Error */
@@ -14898,16 +15464,18 @@ interface operations {
             };
         };
     };
-    delete_tag: {
+    interject: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                tag_ext_id: string;
-            };
+            path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['UserInputBody'];
+            };
+        };
         responses: {
             /** @description Successful Response */
             200: {
@@ -14915,7 +15483,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['DeleteTagResponse'];
+                    'application/json': unknown;
                 };
             };
             /** @description Validation Error */
@@ -14929,20 +15497,16 @@ interface operations {
             };
         };
     };
-    update_tag: {
+    watch_run: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                tag_ext_id: string;
+                response_id: string;
             };
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                'application/json': components['schemas']['UpdateTagRequest'];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description Successful Response */
             200: {
@@ -14950,7 +15514,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['TagResponse'];
+                    'text/event-stream': unknown;
                 };
             };
             /** @description Validation Error */
@@ -14964,7 +15528,7 @@ interface operations {
             };
         };
     };
-    create_fact: {
+    retrieve: {
         parameters: {
             query?: never;
             header?: never;
@@ -14973,7 +15537,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['CreateFactRequest'];
+                'application/json': components['schemas']['MessageInput'];
             };
         };
         responses: {
@@ -14983,7 +15547,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['FactResponse'];
+                    'application/json': unknown;
                 };
             };
             /** @description Validation Error */
@@ -14997,18 +15561,36 @@ interface operations {
             };
         };
     };
-    create_facts_batch: {
+    get_health_live: {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                'application/json': components['schemas']['CreateFactsRequest'];
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': {
+                        [key: string]: string;
+                    };
+                };
             };
         };
+    };
+    get_health: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
         responses: {
             /** @description Successful Response */
             200: {
@@ -15016,39 +15598,54 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['FactResponse'][];
+                    'application/json': components['schemas']['ConsolidatedHealthResponse'];
                 };
             };
-            /** @description Validation Error */
-            422: {
+        };
+    };
+    check_remote_models: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['HTTPValidationError'];
+                    'application/json': components['schemas']['ModelsHealthStatus'];
                 };
             };
         };
     };
-    list_facts: {
+    get_models: {
         parameters: {
-            query?: {
-                pinned_only?: boolean;
-                /** @description Range start, any precision ("2019", "2019-10") */
-                date_from?: string | null;
-                /** @description Range end, any precision */
-                date_to?: string | null;
-                /** @description Only facts that carry a date — the timeline view */
-                dated_only?: boolean;
-                /** @description Only facts carrying ALL of these tags */
-                tag_ext_id?: string[] | null;
-                /** @description Only facts whose sources include this document */
-                doc_ext_id?: string | null;
-                /** @description Page size; omit for every matching fact */
-                limit?: number | null;
-                /** @description Facts to skip, for paging with limit */
-                offset?: number;
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['ModelsResponse'];
+                };
             };
+        };
+    };
+    get_mcp_tools: {
+        parameters: {
+            query?: never;
             header?: never;
             path?: never;
             cookie?: never;
@@ -15061,21 +15658,54 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['FactResponse'][];
+                    'application/json': components['schemas']['McpToolsResponse'];
                 };
             };
-            /** @description Validation Error */
-            422: {
+        };
+    };
+    get_metrics: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['HTTPValidationError'];
+                    'application/json': {
+                        [key: string]: unknown;
+                    };
                 };
             };
         };
     };
-    search_facts: {
+    list_tags: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['TagResponse'][];
+                };
+            };
+        };
+    };
+    create_tag: {
         parameters: {
             query?: never;
             header?: never;
@@ -15084,17 +15714,17 @@ interface operations {
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['FactSearchRequest'];
+                'application/json': components['schemas']['CreateTagRequest'];
             };
         };
         responses: {
             /** @description Successful Response */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['FactSearchResponse'];
+                    'application/json': components['schemas']['TagResponse'];
                 };
             };
             /** @description Validation Error */
@@ -15108,12 +15738,12 @@ interface operations {
             };
         };
     };
-    delete_fact: {
+    delete_tag: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                fact_ext_id: string;
+                tag_ext_id: string;
             };
             cookie?: never;
         };
@@ -15125,7 +15755,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['FactDeleteResponse'];
+                    'application/json': components['schemas']['DeleteTagResponse'];
                 };
             };
             /** @description Validation Error */
@@ -15139,18 +15769,18 @@ interface operations {
             };
         };
     };
-    update_fact: {
+    update_tag: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                fact_ext_id: string;
+                tag_ext_id: string;
             };
             cookie?: never;
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['UpdateFactRequest'];
+                'application/json': components['schemas']['UpdateTagRequest'];
             };
         };
         responses: {
@@ -15160,7 +15790,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['FactResponse'];
+                    'application/json': components['schemas']['TagResponse'];
                 };
             };
             /** @description Validation Error */
@@ -15174,18 +15804,16 @@ interface operations {
             };
         };
     };
-    remind_fact: {
+    create_fact: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                fact_ext_id: string;
-            };
+            path?: never;
             cookie?: never;
         };
-        requestBody?: {
+        requestBody: {
             content: {
-                'application/json': components['schemas']['RemindFactRequest'];
+                'application/json': components['schemas']['CreateFactRequest'];
             };
         };
         responses: {
@@ -15209,14 +15837,18 @@ interface operations {
             };
         };
     };
-    get_websocket_schema: {
+    create_facts_batch: {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['CreateFactsRequest'];
+            };
+        };
         responses: {
             /** @description Successful Response */
             200: {
@@ -15224,20 +15856,38 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['WebSocketSchemas'];
+                    'application/json': components['schemas']['FactResponse'][];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
                 };
             };
         };
     };
-    get_notifications: {
+    list_facts: {
         parameters: {
             query?: {
-                /** @description Maximum number of notifications to return, newest first. Defaults to 100 — almost everyone only cares about the latest. Increase or page via offset to walk further back in history. */
-                limit?: number;
-                /** @description Number of notifications to skip from the newest, for paging. */
+                pinned_only?: boolean;
+                /** @description Range start, any precision ("2019", "2019-10") */
+                date_from?: string | null;
+                /** @description Range end, any precision */
+                date_to?: string | null;
+                /** @description Only facts that carry a date — the timeline view */
+                dated_only?: boolean;
+                /** @description Only facts carrying ALL of these tags */
+                tag_ext_id?: string[] | null;
+                /** @description Only facts whose sources include this document */
+                doc_ext_id?: string | null;
+                /** @description Page size; omit for every matching fact */
+                limit?: number | null;
+                /** @description Facts to skip, for paging with limit */
                 offset?: number;
-                /** @description Filter to a single notification type. Pass ``activity`` to read the durable activity feed (to-self, always-read log lines). When omitted, ``activity`` rows are EXCLUDED so they never pollute the normal notifications/unread UX. */
-                type?: components['schemas']['NotificationType'] | null;
             };
             header?: never;
             path?: never;
@@ -15251,7 +15901,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['NotificationResponse'][];
+                    'application/json': components['schemas']['FactResponse'][];
                 };
             };
             /** @description Validation Error */
@@ -15265,7 +15915,7 @@ interface operations {
             };
         };
     };
-    send_messages: {
+    search_facts: {
         parameters: {
             query?: never;
             header?: never;
@@ -15274,17 +15924,17 @@ interface operations {
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['SendMessageRequest'];
+                'application/json': components['schemas']['FactSearchRequest'];
             };
         };
         responses: {
             /** @description Successful Response */
-            201: {
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['NotificationResponse'][];
+                    'application/json': components['schemas']['FactSearchResponse'];
                 };
             };
             /** @description Validation Error */
@@ -15298,25 +15948,25 @@ interface operations {
             };
         };
     };
-    delete_notifications: {
+    delete_fact: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                'application/json': components['schemas']['DeleteNotificationsRequest'];
+            path: {
+                fact_ext_id: string;
             };
+            cookie?: never;
         };
+        requestBody?: never;
         responses: {
             /** @description Successful Response */
-            204: {
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    'application/json': components['schemas']['FactDeleteResponse'];
+                };
             };
             /** @description Validation Error */
             422: {
@@ -15329,16 +15979,18 @@ interface operations {
             };
         };
     };
-    update_notifications: {
+    update_fact: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                fact_ext_id: string;
+            };
             cookie?: never;
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['UpdateNotificationsRequest'];
+                'application/json': components['schemas']['UpdateFactRequest'];
             };
         };
         responses: {
@@ -15348,7 +16000,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['NotificationResponse'][];
+                    'application/json': components['schemas']['FactResponse'];
                 };
             };
             /** @description Validation Error */
@@ -15362,26 +16014,28 @@ interface operations {
             };
         };
     };
-    create_access_request: {
+    remind_fact: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                fact_ext_id: string;
+            };
             cookie?: never;
         };
-        requestBody: {
+        requestBody?: {
             content: {
-                'application/json': components['schemas']['RequestWorkspaceAccessRequest'];
+                'application/json': components['schemas']['RemindFactRequest'];
             };
         };
         responses: {
             /** @description Successful Response */
-            201: {
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['NotificationResponse'];
+                    'application/json': components['schemas']['FactResponse'];
                 };
             };
             /** @description Validation Error */
@@ -15395,7 +16049,7 @@ interface operations {
             };
         };
     };
-    get_config_schema: {
+    list_workflows: {
         parameters: {
             query?: never;
             header?: never;
@@ -15410,38 +16064,50 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': unknown;
+                    'application/json': components['schemas']['WorkflowResponse'][];
                 };
             };
         };
     };
-    get_config_versions: {
+    create_workflow: {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['CreateWorkflowRequest'];
+            };
+        };
         responses: {
             /** @description Successful Response */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['ConfigVersionsResponse'];
+                    'application/json': components['schemas']['WorkflowResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
                 };
             };
         };
     };
-    get_config: {
+    get_workflow: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                /** @description Config name: 'cfg-XXXXXXXX' or 'default' for system default */
-                config_ext_id: string;
+                workflow_id: string;
             };
             cookie?: never;
         };
@@ -15453,7 +16119,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['AllConfigs'] | components['schemas']['NonDeveloperConfig'];
+                    'application/json': components['schemas']['WorkflowResponse'];
                 };
             };
             /** @description Validation Error */
@@ -15467,25 +16133,23 @@ interface operations {
             };
         };
     };
-    delete_config: {
+    delete_workflow: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                config_ext_id: string;
+                workflow_id: string;
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
             /** @description Successful Response */
-            200: {
+            204: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    'application/json': components['schemas']['ConfigDeleteResponse'];
-                };
+                content?: never;
             };
             /** @description Validation Error */
             422: {
@@ -15498,16 +16162,18 @@ interface operations {
             };
         };
     };
-    save_config: {
+    update_workflow: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                workflow_id: string;
+            };
             cookie?: never;
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['ConfigUpdateData'];
+                'application/json': components['schemas']['UpdateWorkflowRequest'];
             };
         };
         responses: {
@@ -15517,7 +16183,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['ConfigSaveResponse'];
+                    'application/json': components['schemas']['WorkflowResponse'];
                 };
             };
             /** @description Validation Error */
@@ -15531,11 +16197,13 @@ interface operations {
             };
         };
     };
-    list_agents: {
+    run_workflow: {
         parameters: {
             query?: never;
             header?: never;
-            path?: never;
+            path: {
+                workflow_id: string;
+            };
             cookie?: never;
         };
         requestBody?: never;
@@ -15546,31 +16214,63 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['UserResponse'][];
+                    'application/json': components['schemas']['WorkflowRunResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
                 };
             };
         };
     };
-    create_agent: {
+    get_websocket_schema: {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                'application/json': components['schemas']['CreateAgentRequest'];
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['WebSocketSchemas'];
+                };
+            };
+        };
+    };
+    get_notifications: {
+        parameters: {
+            query?: {
+                /** @description Maximum number of notifications to return, newest first. Defaults to 100 — almost everyone only cares about the latest. Increase or page via offset to walk further back in history. */
+                limit?: number;
+                /** @description Number of notifications to skip from the newest, for paging. */
+                offset?: number;
+                /** @description Filter to a single notification type. Pass ``activity`` to read the durable activity feed (to-self, always-read log lines). When omitted, ``activity`` rows are EXCLUDED so they never pollute the normal notifications/unread UX. */
+                type?: components['schemas']['NotificationType'] | null;
             };
+            header?: never;
+            path?: never;
+            cookie?: never;
         };
+        requestBody?: never;
         responses: {
             /** @description Successful Response */
-            201: {
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['CreateAgentResponse'];
+                    'application/json': components['schemas']['NotificationResponse'][];
                 };
             };
             /** @description Validation Error */
@@ -15584,7 +16284,7 @@ interface operations {
             };
         };
     };
-    delete_agents: {
+    send_messages: {
         parameters: {
             query?: never;
             header?: never;
@@ -15593,19 +16293,17 @@ interface operations {
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['DeleteAgentsRequest'];
+                'application/json': components['schemas']['SendMessageRequest'];
             };
         };
         responses: {
             /** @description Successful Response */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': {
-                        [key: string]: unknown;
-                    };
+                    'application/json': components['schemas']['NotificationResponse'][];
                 };
             };
             /** @description Validation Error */
@@ -15619,26 +16317,25 @@ interface operations {
             };
         };
     };
-    get_agent_config: {
+    delete_notifications: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description Agent external id (agt-XXXXXXXX) */
-                agent_ext_id: string;
-            };
+            path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['DeleteNotificationsRequest'];
+            };
+        };
         responses: {
             /** @description Successful Response */
-            200: {
+            204: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    'application/json': components['schemas']['AllConfigs'] | components['schemas']['NonDeveloperConfig'];
-                };
+                content?: never;
             };
             /** @description Validation Error */
             422: {
@@ -15651,17 +16348,18 @@ interface operations {
             };
         };
     };
-    list_agent_workspaces: {
+    update_notifications: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description Agent external id (agt-XXXXXXXX) */
-                agent_ext_id: string;
-            };
+            path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['UpdateNotificationsRequest'];
+            };
+        };
         responses: {
             /** @description Successful Response */
             200: {
@@ -15669,7 +16367,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['AgentWorkspaceResponse'][];
+                    'application/json': components['schemas']['NotificationResponse'][];
                 };
             };
             /** @description Validation Error */
@@ -15683,41 +16381,47 @@ interface operations {
             };
         };
     };
-    get_authorize_limits: {
+    create_access_request: {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['RequestWorkspaceAccessRequest'];
+            };
+        };
         responses: {
             /** @description Successful Response */
-            200: {
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['AuthorizeLimitsResponse'];
+                    'application/json': components['schemas']['NotificationResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
                 };
             };
         };
     };
-    authorize_agent: {
+    get_config_schema: {
         parameters: {
             query?: never;
             header?: never;
-            path: {
-                /** @description Agent external id (agt-XXXXXXXX) */
-                agent_ext_id: string;
-            };
+            path?: never;
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                'application/json': components['schemas']['AuthorizeAgentRequest'];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description Successful Response */
             200: {
@@ -15725,35 +16429,42 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['AuthorizeAgentResponse'];
+                    'application/json': unknown;
                 };
             };
-            /** @description Validation Error */
-            422: {
+        };
+    };
+    get_config_versions: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['HTTPValidationError'];
+                    'application/json': components['schemas']['ConfigVersionsResponse'];
                 };
             };
         };
     };
-    update_agent: {
+    get_config: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                /** @description Agent external id (agt-XXXXXXXX) */
-                agent_ext_id: string;
+                /** @description Config name: 'cfg-XXXXXXXX' or 'default' for system default */
+                config_ext_id: string;
             };
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                'application/json': components['schemas']['UpdateAgentRequest'];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description Successful Response */
             200: {
@@ -15761,7 +16472,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['UserResponse'];
+                    'application/json': components['schemas']['AllConfigs'] | components['schemas']['NonDeveloperConfig'];
                 };
             };
             /** @description Validation Error */
@@ -15775,21 +16486,16 @@ interface operations {
             };
         };
     };
-    generate_agent_avatar: {
+    delete_config: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                /** @description Agent external id (agt-XXXXXXXX) */
-                agent_ext_id: string;
+                config_ext_id: string;
             };
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                'application/json': components['schemas']['GenerateAgentAvatarRequest'];
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description Successful Response */
             200: {
@@ -15797,7 +16503,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['GenerateAgentAvatarResponse'];
+                    'application/json': components['schemas']['ConfigDeleteResponse'];
                 };
             };
             /** @description Validation Error */
@@ -15811,23 +16517,18 @@ interface operations {
             };
         };
     };
-    inbound_email: {
+    save_config: {
         parameters: {
-            query: {
-                /** @description The sender (a registered human user) */
-                user_email: string;
-                /** @description Email subject */
-                subject?: string;
-                /** @description Set when the gateway received mail at a workspace-scoped address (wrk-xxxxxxxx@<deployment>) — act in that specific workspace, requesting access first if the agent isn't a member yet. */
-                workspace_ext_id?: string | null;
-                /** @description The inbound email's own Message-ID header, if any */
-                message_id?: string;
-            };
+            query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['ConfigUpdateData'];
+            };
+        };
         responses: {
             /** @description Successful Response */
             200: {
@@ -15835,7 +16536,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': unknown;
+                    'application/json': components['schemas']['ConfigSaveResponse'];
                 };
             };
             /** @description Validation Error */
@@ -15849,7 +16550,7 @@ interface operations {
             };
         };
     };
-    list_tasks: {
+    list_agents: {
         parameters: {
             query?: never;
             header?: never;
@@ -15864,12 +16565,12 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['TaskResponse'][];
+                    'application/json': components['schemas']['UserResponse'][];
                 };
             };
         };
     };
-    create_task: {
+    create_agent: {
         parameters: {
             query?: never;
             header?: never;
@@ -15878,7 +16579,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['CreateTaskRequest'];
+                'application/json': components['schemas']['CreateAgentRequest'];
             };
         };
         responses: {
@@ -15888,7 +16589,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['TaskResponse'];
+                    'application/json': components['schemas']['CreateAgentResponse'];
                 };
             };
             /** @description Validation Error */
@@ -15902,7 +16603,7 @@ interface operations {
             };
         };
     };
-    plan_task: {
+    delete_agents: {
         parameters: {
             query?: never;
             header?: never;
@@ -15911,7 +16612,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['PlanTaskRequest'];
+                'application/json': components['schemas']['DeleteAgentsRequest'];
             };
         };
         responses: {
@@ -15921,7 +16622,9 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['TaskPlan'];
+                    'application/json': {
+                        [key: string]: unknown;
+                    };
                 };
             };
             /** @description Validation Error */
@@ -15935,12 +16638,13 @@ interface operations {
             };
         };
     };
-    get_task: {
+    get_agent_config: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                task_id: string;
+                /** @description Agent external id (agt-XXXXXXXX) */
+                agent_ext_id: string;
             };
             cookie?: never;
         };
@@ -15952,7 +16656,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['TaskResponse'];
+                    'application/json': components['schemas']['AllConfigs'] | components['schemas']['NonDeveloperConfig'];
                 };
             };
             /** @description Validation Error */
@@ -15966,23 +16670,26 @@ interface operations {
             };
         };
     };
-    delete_task: {
+    list_agent_workspaces: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                task_id: string;
+                /** @description Agent external id (agt-XXXXXXXX) */
+                agent_ext_id: string;
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
             /** @description Successful Response */
-            204: {
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    'application/json': components['schemas']['AgentWorkspaceResponse'][];
+                };
             };
             /** @description Validation Error */
             422: {
@@ -15995,18 +16702,39 @@ interface operations {
             };
         };
     };
-    update_task: {
+    get_authorize_limits: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['AuthorizeLimitsResponse'];
+                };
+            };
+        };
+    };
+    authorize_agent: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                task_id: string;
+                /** @description Agent external id (agt-XXXXXXXX) */
+                agent_ext_id: string;
             };
             cookie?: never;
         };
         requestBody: {
             content: {
-                'application/json': components['schemas']['UpdateTaskRequest'];
+                'application/json': components['schemas']['AuthorizeAgentRequest'];
             };
         };
         responses: {
@@ -16016,7 +16744,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['TaskResponse'];
+                    'application/json': components['schemas']['AuthorizeAgentResponse'];
                 };
             };
             /** @description Validation Error */
@@ -16030,16 +16758,21 @@ interface operations {
             };
         };
     };
-    list_task_runs: {
+    update_agent: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                task_id: string;
+                /** @description Agent external id (agt-XXXXXXXX) */
+                agent_ext_id: string;
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['UpdateAgentRequest'];
+            };
+        };
         responses: {
             /** @description Successful Response */
             200: {
@@ -16047,7 +16780,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['TaskRunResponse'][];
+                    'application/json': components['schemas']['UserResponse'];
                 };
             };
             /** @description Validation Error */
@@ -16061,13 +16794,56 @@ interface operations {
             };
         };
     };
-    run_task: {
+    generate_agent_avatar: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                task_id: string;
+                /** @description Agent external id (agt-XXXXXXXX) */
+                agent_ext_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                'application/json': components['schemas']['GenerateAgentAvatarRequest'];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['GenerateAgentAvatarResponse'];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    inbound_email: {
+        parameters: {
+            query: {
+                /** @description The sender (a registered human user) */
+                user_email: string;
+                /** @description Email subject */
+                subject?: string;
+                /** @description Set when the gateway received mail at a workspace-scoped address (wrk-xxxxxxxx@<deployment>) — act in that specific workspace, requesting access first if the agent isn't a member yet. */
+                workspace_ext_id?: string | null;
+                /** @description The inbound email's own Message-ID header, if any */
+                message_id?: string;
             };
+            header?: never;
+            path?: never;
             cookie?: never;
         };
         requestBody?: never;
@@ -16078,7 +16854,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    'application/json': components['schemas']['TaskResponse'];
+                    'application/json': unknown;
                 };
             };
             /** @description Validation Error */
@@ -17106,6 +17882,132 @@ interface operations {
             };
         };
     };
+    get_slack_connection_v1_slack_me_get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': {
+                        [key: string]: unknown;
+                    };
+                };
+            };
+        };
+    };
+    disconnect_slack_v1_slack_me_delete: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    authorize_slack_v1_slack_authorize_get: {
+        parameters: {
+            query: {
+                agent_ext_id: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': {
+                        [key: string]: unknown;
+                    };
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    slack_callback_v1_slack_callback_get: {
+        parameters: {
+            query?: {
+                code?: string | null;
+                state?: string | null;
+                error?: string | null;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': unknown;
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': components['schemas']['HTTPValidationError'];
+                };
+            };
+        };
+    };
+    slack_events_v1_slack_events_post: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    'application/json': unknown;
+                };
+            };
+        };
+    };
     create_response: {
         parameters: {
             query?: never;