@vellumai/assistant 0.10.8 → 0.10.9-dev.202607152225.ec6fdbf

package/openapi.yaml

@@ -3,7 +3,7 @@
 openapi: 3.1.0
 info:
   title: Vellum Assistant API
-  version: 0.10.8
+  version: 0.10.9
   description: Auto-generated OpenAPI specification for the Vellum Assistant runtime HTTP server.
 servers:
   - url: http://127.0.0.1:7821
@@ -606,6 +606,8 @@ paths:
                           type: string
                         contentId:
                           type: string
+                        origin:
+                          type: string
                       required:
                         - id
                         - name
@@ -613,10 +615,32 @@ paths:
                         - updatedAt
                         - version
                         - contentId
+                        - origin
                       additionalProperties: false
                 required:
                   - apps
                 additionalProperties: false
+  /v1/apps/{appId}/asset/{path}:
+    get:
+      operationId: apps_by_appId_asset_by_path_get
+      summary: Serve app asset
+      description: Serve a bundled binary asset (image, audio, video, font) from anywhere in an app's directory.
+      tags:
+        - apps
+      parameters:
+        - name: appId
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: path
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
   /v1/apps/{appId}/dist/{filename}:
     get:
       operationId: apps_by_appId_dist_by_filename_get
@@ -810,11 +834,14 @@ paths:
                     type: string
                   html:
                     type: string
+                  origin:
+                    type: string
                 required:
                   - appId
                   - dirName
                   - name
                   - html
+                  - origin
                 additionalProperties: false
   /v1/apps/{id}/preview:
     get:
@@ -5801,6 +5828,7 @@ paths:
                   ok:
                     type: boolean
                   contact:
+                    description: Merged (surviving) contact
                     type: object
                     properties:
                       id:
@@ -5905,10 +5933,8 @@ paths:
                       - updatedAt
                       - channels
                     additionalProperties: false
-                    description: Merged contact
                 required:
                   - ok
-                  - contact
                 additionalProperties: false
   /v1/contacts/prompt:
     post:
@@ -9520,7 +9546,9 @@ paths:
     post:
       operationId: credentials_reveal_post
       summary: Reveal a credential's plaintext value
-      description: Return the raw plaintext value of a stored credential. Blocked in untrusted shell mode.
+      description:
+        Return the raw plaintext value of a stored credential. Blocked in untrusted shell mode. With forChat,
+        returns a chat-safe redaction sentinel instead of the plaintext.
       tags:
         - credentials
       requestBody:
@@ -9539,6 +9567,17 @@ paths:
                 id:
                   description: Credential UUID for lookup by ID
                   type: string
+                forChat:
+                  description:
+                    Return the credential's redaction sentinel (renders as a click-to-reveal chip in chat) instead of the
+                    plaintext. Requires the chat-credential-reveal feature flag.
+                  type: boolean
+                revealNonce:
+                  description:
+                    Conversation-bound reveal nonce from the tool-shell environment. Scopes any recorded chat-redaction
+                    authority (plaintext proof or forChat mint) to the conversation whose tool executed this reveal;
+                    without it the reveal succeeds but records no authority.
+                  type: string
       responses:
         "200":
           description: Successful response
@@ -9549,7 +9588,7 @@ paths:
                 properties:
                   value:
                     type: string
-                    description: The plaintext credential value
+                    description: The plaintext credential value (or its redaction sentinel when forChat is set)
                 required:
                   - value
                 additionalProperties: false
@@ -11150,6 +11189,23 @@ paths:
                   type: array
                   items:
                     type: string
+                attachments:
+                  description: File attachments
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      filename:
+                        type: string
+                      content_type:
+                        type: string
+                      content:
+                        type: string
+                        description: Base64-encoded file content
+                    required:
+                      - filename
+                      - content_type
+                      - content
                 reply_to:
                   description: Reply-to email ID
                   type: string
@@ -11534,6 +11590,27 @@ paths:
                   - lines
                   - truncated
                 additionalProperties: false
+  /v1/gateway/status:
+    get:
+      operationId: gateway_status_get
+      summary: Get gateway status
+      description:
+        Reports the gateway's public tunnel status. `tunnel` holds the active public URL when a tunnel is connected
+        and is omitted otherwise. Errors with 503 when the gateway is not running. The tunnel only matters for routing
+        inbound Twilio webhooks and live voice/audio WebSockets.
+      tags:
+        - gateway
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  tunnel:
+                    type: string
+                additionalProperties: false
   /v1/groups:
     get:
       operationId: groups_get
@@ -13688,6 +13765,57 @@ paths:
           description:
             Submitting client does not match the targeted client, or the submitting actor's principal does not match
             the target client's actor.
+  /v1/host-ui-snapshot-result:
+    post:
+      operationId: hostuisnapshotresult_post
+      summary: Submit host UI-snapshot result
+      description:
+        Resolve a pending UI-snapshot request by requestId. Returns 200 even when no pending interaction matches
+        (late delivery is tolerated).
+      tags:
+        - host
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                requestId:
+                  type: string
+                  description: Pending UI-snapshot request ID
+                pngBase64:
+                  type: string
+                  description: Base64 PNG capture of the staged view
+                widthPx:
+                  type: number
+                heightPx:
+                  type: number
+                isError:
+                  type: boolean
+                errorMessage:
+                  type: string
+              required:
+                - requestId
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  accepted:
+                    type: boolean
+                required:
+                  - accepted
+                additionalProperties: false
+        "400":
+          description: x-vellum-client-id header is missing for a targeted UI-snapshot request.
+        "403":
+          description:
+            Submitting client does not match the targeted client, or the submitting actor's principal does not match
+            the target client's actor.
   /v1/identity:
     get:
       operationId: identity_get
@@ -14213,7 +14341,10 @@ paths:
     post:
       operationId: inference_providerconnections_post
       summary: Create a provider connection
-      description: Create a new named provider connection. Fails with 409 if a connection with this name already exists.
+      description:
+        Create a new named provider connection. When auth is omitted it is derived from the provider (keyless
+        providers get none, vellum gets platform, everything else needs credential for api_key auth). Fails with 409 if
+        a connection with this name already exists.
       tags:
         - inference
       requestBody:
@@ -14230,6 +14361,9 @@ paths:
                   $ref: "#/components/schemas/ConnectionProvider"
                 auth:
                   $ref: "#/components/schemas/Auth"
+                credential:
+                  type: string
+                  minLength: 1
                 label:
                   type: string
                   minLength: 1
@@ -14247,7 +14381,6 @@ paths:
               required:
                 - name
                 - provider
-                - auth
       responses:
         "201":
           description: Successful response
@@ -14319,7 +14452,8 @@ paths:
       operationId: inference_providerconnections_by_name_patch
       summary: Update a provider connection
       description:
-        Update an existing connection. Cannot rename or change the provider. For the Vellum-managed connection
+        Update an existing connection. Cannot rename or change the provider. Omitting auth keeps the stored auth;
+        passing credential alone rotates the key via provider-derived api_key auth. For the Vellum-managed connection
         (vellum) the auth is locked to platform; label remains editable.
       tags:
         - inference
@@ -14338,6 +14472,9 @@ paths:
               properties:
                 auth:
                   $ref: "#/components/schemas/Auth"
+                credential:
+                  type: string
+                  minLength: 1
                 label:
                   anyOf:
                     - type: string
@@ -14354,8 +14491,6 @@ paths:
                       items:
                         $ref: "#/components/schemas/ConnectionModel"
                     - type: "null"
-              required:
-                - auth
       responses:
         "200":
           description: Successful response
@@ -17535,7 +17670,7 @@ paths:
     post:
       operationId: memory_worker_start_post
       summary: Start the memory worker
-      description: Spawns (or reuses) the memory worker process as a child of the daemon and enables memory.worker.enabled.
+      description: Spawns (or reuses) the memory worker process as a child of the daemon.
       tags:
         - system
       responses:
@@ -17550,15 +17685,11 @@ paths:
                     type: number
                   alreadyRunning:
                     type: boolean
-                  workerEnabled:
-                    type: boolean
-                    const: true
                   pidPath:
                     type: string
                 required:
                   - pid
                   - alreadyRunning
-                  - workerEnabled
                   - pidPath
                 additionalProperties: false
   /v1/memory/worker/status:
@@ -17566,8 +17697,8 @@ paths:
       operationId: memory_worker_status_get
       summary: Memory worker status
       description:
-        Reports the memory worker process state, memory.worker.enabled, the synchronous in-process runner, and the
-        embedding-backend status (including a degraded flag and reason when no backend resolves).
+        Reports the memory worker process liveness and the embedding-backend status (including a degraded flag and
+        reason when no backend resolves).
       tags:
         - system
       responses:
@@ -17585,21 +17716,6 @@ paths:
                       - not_running
                   pid:
                     type: number
-                  workerEnabled:
-                    type: boolean
-                  syncRunner:
-                    type: object
-                    properties:
-                      status:
-                        type: string
-                        enum:
-                          - running
-                          - not_running
-                      pid:
-                        type: number
-                    required:
-                      - status
-                    additionalProperties: false
                   embedding:
                     type: object
                     properties:
@@ -17633,15 +17749,13 @@ paths:
                     additionalProperties: false
                 required:
                   - status
-                  - workerEnabled
-                  - syncRunner
                   - embedding
                 additionalProperties: false
   /v1/memory/worker/stop:
     post:
       operationId: memory_worker_stop_post
       summary: Stop the memory worker
-      description: Disables memory.worker.enabled and SIGTERMs the memory worker process if it is running.
+      description: SIGTERMs the memory worker process if it is running.
       tags:
         - system
       responses:
@@ -17656,12 +17770,8 @@ paths:
                     type: boolean
                   pid:
                     type: number
-                  workerEnabled:
-                    type: boolean
-                    const: false
                 required:
                   - workerWasRunning
-                  - workerEnabled
                 additionalProperties: false
   /v1/messages:
     get:
@@ -21879,7 +21989,9 @@ paths:
     get:
       operationId: platform_status_get
       summary: Get platform deployment context and connection status
-      description: Aggregates platform context, credentials, assistant ID, webhook secret, and Velay tunnel status.
+      description:
+        Aggregates platform context, credentials, assistant ID, and webhook secret. Velay tunnel status is reported
+        separately by gateway_status.
       tags:
         - platform
       responses:
@@ -21914,21 +22026,6 @@ paths:
                     anyOf:
                       - type: string
                       - type: "null"
-                  velayTunnel:
-                    anyOf:
-                      - type: object
-                        properties:
-                          connected:
-                            type: boolean
-                          publicUrl:
-                            anyOf:
-                              - type: string
-                              - type: "null"
-                        required:
-                          - connected
-                          - publicUrl
-                        additionalProperties: false
-                      - type: "null"
                 required:
                   - isPlatform
                   - baseUrl
@@ -21939,7 +22036,6 @@ paths:
                   - available
                   - organizationId
                   - userId
-                  - velayTunnel
                 additionalProperties: false
   /v1/playground/seed-conversation:
     post:
@@ -23063,7 +23159,10 @@ paths:
           required: false
           schema:
             type: string
-          description: Optional git ref to list the catalog at. Defaults to the CLI's `DEFAULT_PLUGIN_REF` (typically `main`).
+          description:
+            Accepted for backward compatibility. The catalog is resolved from the Vellum platform (or the bundled
+            manifest when platform features are disabled); this ref does not select a git revision — it is echoed back
+            and used as the cache key. Defaults to the CLI's `DEFAULT_PLUGIN_REF` (typically `main`).
       responses:
         "200":
           description: Successful response
@@ -23092,6 +23191,11 @@ paths:
                         description:
                           description: Short description, when known (external entries only today).
                           type: string
+                        icon:
+                          description:
+                            "Plugin icon: a curated emoji from the marketplace entry, or an icon URL served by the platform catalog
+                            when the plugin ships a bundled image."
+                          type: string
                         category:
                           anyOf:
                             - type: string
@@ -25450,9 +25554,7 @@ paths:
     post:
       operationId: schedules_worker_start_post
       summary: Start the schedule worker
-      description:
-        Spawns (or reuses) the schedule worker process as a child of the daemon and enables
-        schedules.worker.enabled, so scheduled jobs run out of process.
+      description: Spawns (or reuses) the schedule worker process as a child of the daemon.
       tags:
         - system
       responses:
@@ -25467,24 +25569,18 @@ paths:
                     type: number
                   alreadyRunning:
                     type: boolean
-                  workerEnabled:
-                    type: boolean
-                    const: true
                   pidPath:
                     type: string
                 required:
                   - pid
                   - alreadyRunning
-                  - workerEnabled
                   - pidPath
                 additionalProperties: false
   /v1/schedules/worker/status:
     get:
       operationId: schedules_worker_status_get
       summary: Schedule worker status
-      description:
-        Reports the schedule worker process state, schedules.worker.enabled, and whether the daemon's in-process
-        scheduler is currently executing schedules.
+      description: Reports the schedule worker process liveness.
       tags:
         - system
       responses:
@@ -25502,33 +25598,14 @@ paths:
                       - not_running
                   pid:
                     type: number
-                  workerEnabled:
-                    type: boolean
-                  inProcessScheduler:
-                    type: object
-                    properties:
-                      status:
-                        type: string
-                        enum:
-                          - running
-                          - not_running
-                      pid:
-                        type: number
-                    required:
-                      - status
-                    additionalProperties: false
                 required:
                   - status
-                  - workerEnabled
-                  - inProcessScheduler
                 additionalProperties: false
   /v1/schedules/worker/stop:
     post:
       operationId: schedules_worker_stop_post
       summary: Stop the schedule worker
-      description:
-        Disables schedules.worker.enabled (handing schedule execution back to the in-process scheduler) and
-        SIGTERMs the schedule worker process if it is running.
+      description: SIGTERMs the schedule worker process if it is running.
       tags:
         - system
       responses:
@@ -25543,12 +25620,8 @@ paths:
                     type: boolean
                   pid:
                     type: number
-                  workerEnabled:
-                    type: boolean
-                    const: false
                 required:
                   - workerWasRunning
-                  - workerEnabled
                 additionalProperties: false
   /v1/search:
     get:
@@ -28952,74 +29025,98 @@ paths:
                   - title
                   - data
                 additionalProperties: false
-  /v1/tasks/delete:
+  /v1/telemetry/flush:
     post:
-      operationId: tasks_delete_post
-      summary: Delete task templates
-      description: Delete one or more task templates by ID.
+      operationId: telemetry_flush_post
+      summary: Flush pending telemetry events
+      description:
+        Force-flush the telemetry events owned by the assistant process (turn events) to the platform. Other event
+        types are flushed on their own cycle by the resource monitor process.
       tags:
-        - tasks
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                task_ids:
-                  minItems: 1
-                  type: array
-                  items:
-                    type: string
-                    minLength: 1
-              required:
-                - task_ids
+        - telemetry
       responses:
         "200":
           description: Successful response
           content:
             application/json:
               schema:
-                type: object
-                properties:
-                  ok:
-                    type: boolean
-                  content:
-                    type: string
-                required:
-                  - ok
-                  - content
-                additionalProperties: false
-  /v1/tasks/list:
+                anyOf:
+                  - type: object
+                    properties:
+                      flushed:
+                        type: boolean
+                        const: true
+                    required:
+                      - flushed
+                    additionalProperties: false
+                  - type: object
+                    properties:
+                      flushed:
+                        type: boolean
+                        const: false
+                      reason:
+                        type: string
+                    required:
+                      - flushed
+                      - reason
+                    additionalProperties: false
+  /v1/telemetry/lifecycle:
     post:
-      operationId: tasks_list_post
-      summary: List task templates
-      description: List all saved task templates.
+      operationId: telemetry_lifecycle_post
+      summary: Record lifecycle event
+      description: Record a telemetry lifecycle event (app_open, hatch).
       tags:
-        - tasks
+        - telemetry
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                event_name:
+                  type: string
+                  description: "Event name: app_open or hatch"
+              required:
+                - event_name
       responses:
         "200":
           description: Successful response
           content:
             application/json:
               schema:
-                type: object
-                properties:
-                  ok:
-                    type: boolean
-                  content:
-                    type: string
-                required:
-                  - ok
-                  - content
-                additionalProperties: false
-  /v1/tasks/queue/add:
+                anyOf:
+                  - type: object
+                    properties:
+                      id:
+                        type: string
+                        description: Event ID
+                      event_name:
+                        type: string
+                    required:
+                      - id
+                      - event_name
+                    additionalProperties: false
+                  - type: object
+                    properties:
+                      skipped:
+                        type: boolean
+                        const: true
+                        description: Event skipped due to usage data collection being disabled
+                    required:
+                      - skipped
+                    additionalProperties: false
+  /v1/telemetry/onboarding-research:
     post:
-      operationId: tasks_queue_add_post
-      summary: Add to task queue
-      description: Add a new work item to the task queue.
+      operationId: telemetry_onboardingresearch_post
+      summary: Record onboarding-research event
+      description:
+        'Record the settled result of an onboarding "research me" web-search turn (claims, suggestions, and
+        plugin picks). Client-orchestrated: the web client reports this once it has observed the turn complete. Gated on
+        share_diagnostics consent (in addition to share_analytics) since the payload carries the model''s raw inferred
+        claims about the user.'
       tags:
-        - tasks
+        - telemetry
       requestBody:
         required: true
         content:
@@ -29027,347 +29124,63 @@ paths:
             schema:
               type: object
               properties:
-                task_id:
-                  type: string
-                task_name:
-                  type: string
-                title:
-                  type: string
-                execution_prompt:
-                  type: string
-                notes:
-                  type: string
-                priority_tier:
-                  type: number
-                sort_index:
-                  type: number
-                if_exists:
+                conversation_id:
+                  anyOf:
+                    - type: string
+                    - type: "null"
+                status:
                   type: string
                   enum:
-                    - create_duplicate
-                    - reuse_existing
-                    - update_existing
-                required_tools:
+                    - done
+                    - error
+                claims:
                   type: array
                   items:
-                    type: string
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  content:
-                    type: string
-                  isError:
-                    type: boolean
-                required:
-                  - content
-                additionalProperties: false
-  /v1/tasks/queue/remove:
-    post:
-      operationId: tasks_queue_remove_post
-      summary: Remove from task queue
-      description: Remove a work item from the task queue.
-      tags:
-        - tasks
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                work_item_id:
-                  type: string
-                task_id:
-                  type: string
-                task_name:
-                  type: string
-                title:
-                  type: string
-                priority_tier:
-                  type: number
-                status:
-                  type: string
-                created_order:
-                  type: number
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  content:
-                    type: string
-                  isError:
-                    type: boolean
-                required:
-                  - content
-                additionalProperties: false
-  /v1/tasks/queue/run:
-    post:
-      operationId: tasks_queue_run_post
-      summary: Run next task queue item
-      description: Pick up and execute the next work item from the queue.
-      tags:
-        - tasks
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                work_item_id:
-                  type: string
-                task_name:
-                  type: string
-                title:
-                  type: string
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  content:
-                    type: string
-                  isError:
-                    type: boolean
-                required:
-                  - content
-                additionalProperties: false
-  /v1/tasks/queue/show:
-    post:
-      operationId: tasks_queue_show_post
-      summary: Show task queue
-      description: List work items in the task queue, optionally filtered by status.
-      tags:
-        - tasks
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                status:
-                  anyOf:
-                    - type: string
-                    - type: array
-                      items:
-                        type: string
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  content:
-                    type: string
-                  isError:
-                    type: boolean
-                required:
-                  - content
-                additionalProperties: false
-  /v1/tasks/queue/update:
-    post:
-      operationId: tasks_queue_update_post
-      summary: Update a task queue item
-      description: Update an existing work item in the task queue.
-      tags:
-        - tasks
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                work_item_id:
-                  type: string
-                task_id:
-                  type: string
-                task_name:
-                  type: string
-                title:
-                  type: string
-                priority_tier:
-                  type: number
-                notes:
-                  type: string
-                status:
-                  type: string
-                  enum:
-                    - queued
-                    - running
-                    - awaiting_review
-                    - done
-                    - failed
-                    - cancelled
-                    - archived
-                sort_index:
-                  type: number
-                filter_priority_tier:
-                  type: number
-                filter_status:
-                  type: string
-                created_order:
-                  type: number
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  content:
-                    type: string
-                  isError:
-                    type: boolean
-                required:
-                  - content
-                additionalProperties: false
-  /v1/tasks/run:
-    post:
-      operationId: tasks_run_post
-      summary: Run a task template
-      description: Execute a saved task template by name or ID.
-      tags:
-        - tasks
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                task_name:
-                  type: string
-                  minLength: 1
-                task_id:
-                  type: string
-                  minLength: 1
-                inputs:
-                  type: object
-                  propertyNames:
-                    type: string
-                  additionalProperties:
-                    type: string
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  ok:
-                    type: boolean
-                  content:
-                    type: string
-                required:
-                  - ok
-                  - content
-                additionalProperties: false
-  /v1/tasks/save:
-    post:
-      operationId: tasks_save_post
-      summary: Save a task template
-      description: Save the current conversation as a reusable task template.
-      tags:
-        - tasks
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                conversation_id:
-                  type: string
-                  minLength: 1
-                title:
-                  type: string
-                  minLength: 1
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  ok:
-                    type: boolean
-                  content:
-                    type: string
-                required:
-                  - ok
-                  - content
-                additionalProperties: false
-  /v1/telemetry/flush:
-    post:
-      operationId: telemetry_flush_post
-      summary: Flush pending telemetry events
-      description: Force-flush all pending usage, turn, and lifecycle telemetry events to the platform.
-      tags:
-        - telemetry
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
-                anyOf:
-                  - type: object
-                    properties:
-                      flushed:
-                        type: boolean
-                        const: true
-                    required:
-                      - flushed
-                    additionalProperties: false
-                  - type: object
+                    type: object
                     properties:
-                      flushed:
-                        type: boolean
-                        const: false
-                      reason:
+                      claim:
+                        type: string
+                      confidence:
                         type: string
+                        enum:
+                          - confident
+                          - maybe
+                          - guessing
+                      sources:
+                        type: array
+                        items:
+                          type: string
                     required:
-                      - flushed
-                      - reason
-                    additionalProperties: false
-  /v1/telemetry/lifecycle:
-    post:
-      operationId: telemetry_lifecycle_post
-      summary: Record lifecycle event
-      description: Record a telemetry lifecycle event (app_open, hatch).
-      tags:
-        - telemetry
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                event_name:
-                  type: string
-                  description: "Event name: app_open or hatch"
+                      - claim
+                      - confidence
+                      - sources
+                suggestions:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      suggestion:
+                        type: string
+                      prompt:
+                        type: string
+                    required:
+                      - suggestion
+                      - prompt
+                plugins:
+                  type: array
+                  items:
+                    type: string
+                installed_plugins:
+                  type: array
+                  items:
+                    type: string
               required:
-                - event_name
+                - conversation_id
+                - status
+                - claims
+                - suggestions
+                - plugins
+                - installed_plugins
       responses:
         "200":
           description: Successful response
@@ -29380,18 +29193,15 @@ paths:
                       id:
                         type: string
                         description: Event ID
-                      event_name:
-                        type: string
                     required:
                       - id
-                      - event_name
                     additionalProperties: false
                   - type: object
                     properties:
                       skipped:
                         type: boolean
                         const: true
-                        description: Event skipped due to usage data collection being disabled
+                        description: "Event skipped: usage data collection or diagnostics consent is disabled/ineligible"
                     required:
                       - skipped
                     additionalProperties: false
@@ -29952,6 +29762,71 @@ paths:
       responses:
         "200":
           description: Successful response
+  /v1/ui/snapshot:
+    post:
+      operationId: ui_snapshot_post
+      summary: Capture a staged UI snapshot
+      description:
+        Ask the connected desktop client to render a staged view of the app (sampler or chat) with the current
+        workspace-theme tokens applied and return a PNG capture. The staged views contain only fixed generic content.
+        Blocks until the client responds or the timeout elapses.
+      tags:
+        - host
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                view:
+                  default: sampler
+                  description: Which staged composition to capture
+                  type: string
+                  enum:
+                    - sampler
+                    - chat
+                timeoutMs:
+                  description: How long to wait for the client capture
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 120000
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                  pngBase64:
+                    type: string
+                    description: Base64 PNG capture of the staged view
+                  widthPx:
+                    type: number
+                  heightPx:
+                    type: number
+                  themeSource:
+                    type: string
+                    enum:
+                      - workspace
+                      - invalid
+                      - none
+                  themeIssues:
+                    type: array
+                    items:
+                      type: string
+                  timedOut:
+                    type: boolean
+                  error:
+                    type: string
+                required:
+                  - ok
+                  - themeSource
+                  - themeIssues
+                additionalProperties: false
   /v1/usage/breakdown:
     get:
       operationId: usage_breakdown_get
@@ -30607,270 +30482,6 @@ paths:
                   - path
                   - mode
                 additionalProperties: false
-  /v1/work-items:
-    get:
-      operationId: workitems_get
-      summary: List work items
-      description: Return work items, optionally filtered by status.
-      tags:
-        - work-items
-      parameters:
-        - name: status
-          in: query
-          required: false
-          schema:
-            type: string
-            enum:
-              - pending
-              - running
-              - awaiting_review
-              - done
-              - failed
-              - cancelled
-              - archived
-          description: Filter by work item status
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  items:
-                    type: array
-                    items: {}
-                required:
-                  - items
-                additionalProperties: false
-  /v1/work-items/{id}:
-    delete:
-      operationId: workitems_by_id_delete
-      summary: Delete a work item
-      description: Permanently remove a work item.
-      tags:
-        - work-items
-      parameters:
-        - name: id
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        "200":
-          description: Successful response
-    get:
-      operationId: workitems_by_id_get
-      summary: Get a work item
-      description: Return a single work item by ID.
-      tags:
-        - work-items
-      parameters:
-        - name: id
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        "200":
-          description: Successful response
-    patch:
-      operationId: workitems_by_id_patch
-      summary: Update a work item
-      description: Partially update a work item's title, notes, status, or priority.
-      tags:
-        - work-items
-      parameters:
-        - name: id
-          in: path
-          required: true
-          schema:
-            type: string
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                title:
-                  type: string
-                notes:
-                  type: string
-                status:
-                  type: string
-                priorityTier:
-                  type: integer
-                  minimum: -9007199254740991
-                  maximum: 9007199254740991
-                sortIndex:
-                  type: integer
-                  minimum: -9007199254740991
-                  maximum: 9007199254740991
-              required:
-                - title
-                - notes
-                - status
-                - priorityTier
-                - sortIndex
-      responses:
-        "200":
-          description: Successful response
-  /v1/work-items/{id}/approve-permissions:
-    post:
-      operationId: workitems_by_id_approvepermissions_post
-      summary: Approve tool permissions
-      description: Pre-approve a set of tools for a work item before it runs.
-      tags:
-        - work-items
-      parameters:
-        - name: id
-          in: path
-          required: true
-          schema:
-            type: string
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                approvedTools:
-                  type: array
-                  items: {}
-                  description: Array of tool names to approve
-              required:
-                - approvedTools
-      responses:
-        "200":
-          description: Successful response
-  /v1/work-items/{id}/cancel:
-    post:
-      operationId: workitems_by_id_cancel_post
-      summary: Cancel a running work item
-      description: Abort a running work item and set its status to cancelled.
-      tags:
-        - work-items
-      parameters:
-        - name: id
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        "200":
-          description: Successful response
-        "404":
-          description: Work item not found
-        "409":
-          description: Work item is not running
-  /v1/work-items/{id}/complete:
-    post:
-      operationId: workitems_by_id_complete_post
-      summary: Complete a work item
-      description: Transition a work item from awaiting_review to done.
-      tags:
-        - work-items
-      parameters:
-        - name: id
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        "200":
-          description: Successful response
-  /v1/work-items/{id}/output:
-    get:
-      operationId: workitems_by_id_output_get
-      summary: Get work item output
-      description: Return the final output of a completed work item run.
-      tags:
-        - work-items
-      parameters:
-        - name: id
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  id:
-                    type: string
-                  success:
-                    type: boolean
-                  output:
-                    type: object
-                    properties: {}
-                    additionalProperties: {}
-                required:
-                  - id
-                  - success
-                  - output
-                additionalProperties: false
-  /v1/work-items/{id}/preflight:
-    post:
-      operationId: workitems_by_id_preflight_post
-      summary: Preflight check
-      description: Check tool permissions needed before running a work item.
-      tags:
-        - work-items
-      parameters:
-        - name: id
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  id:
-                    type: string
-                  success:
-                    type: boolean
-                  permissions:
-                    type: object
-                    properties: {}
-                    additionalProperties: {}
-                required:
-                  - id
-                  - success
-                  - permissions
-                additionalProperties: false
-  /v1/work-items/{id}/run:
-    post:
-      operationId: workitems_by_id_run_post
-      summary: Run a work item
-      description: Execute the task associated with a work item. Returns immediately; execution happens in the background.
-      tags:
-        - work-items
-      parameters:
-        - name: id
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        "200":
-          description: Successful response
-        "403":
-          description: Required tool permissions not approved
-        "404":
-          description: Work item or associated task not found
-        "409":
-          description: Work item is already running or not runnable
   /v1/workflows:
     get:
       operationId: workflows_get