@vellumai/assistant 0.8.4 → 0.8.6

package/openapi.yaml

@@ -3,7 +3,7 @@
 openapi: 3.0.0
 info:
   title: Vellum Assistant API
-  version: 0.8.4
+  version: 0.8.6
   description: Auto-generated OpenAPI specification for the Vellum Assistant runtime HTTP server.
 servers:
   - url: http://127.0.0.1:7821
@@ -460,8 +460,30 @@ paths:
                 properties:
                   apps:
                     type: array
-                    items: {}
-                    description: Array of app summary objects
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        name:
+                          type: string
+                        description:
+                          type: string
+                        icon:
+                          type: string
+                        createdAt:
+                          type: number
+                        version:
+                          type: string
+                        contentId:
+                          type: string
+                      required:
+                        - id
+                        - name
+                        - createdAt
+                        - version
+                        - contentId
+                      additionalProperties: false
                 required:
                   - apps
                 additionalProperties: false
@@ -540,6 +562,18 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  result: {}
+                required:
+                  - success
+                  - result
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -560,6 +594,18 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  result: {}
+                required:
+                  - success
+                  - result
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -597,6 +643,16 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                required:
+                  - success
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -613,6 +669,19 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  appId:
+                    type: string
+                  diff:
+                    type: string
+                required:
+                  - appId
+                  - diff
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -648,7 +717,20 @@ paths:
                     type: string
                   versions:
                     type: array
-                    items: {}
+                    items:
+                      type: object
+                      properties:
+                        commitHash:
+                          type: string
+                        message:
+                          type: string
+                        timestamp:
+                          type: number
+                      required:
+                        - commitHash
+                        - message
+                        - timestamp
+                      additionalProperties: false
                 required:
                   - appId
                   - versions
@@ -709,6 +791,21 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  appId:
+                    type: string
+                  preview:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                required:
+                  - appId
+                  - preview
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -724,6 +821,19 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  appId:
+                    type: string
+                required:
+                  - success
+                  - appId
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -819,6 +929,16 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                required:
+                  - success
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -907,6 +1027,23 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                    const: true
+                  appId:
+                    type: string
+                  name:
+                    type: string
+                required:
+                  - success
+                  - appId
+                  - name
+                additionalProperties: false
       requestBody:
         required: true
         content:
@@ -936,9 +1073,61 @@ paths:
                 type: object
                 properties:
                   gallery:
-                    type: array
-                    items: {}
-                    description: Gallery app entries
+                    type: object
+                    properties:
+                      version:
+                        type: number
+                      updatedAt:
+                        type: string
+                      categories:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            id:
+                              type: string
+                            name:
+                              type: string
+                            icon:
+                              type: string
+                          required:
+                            - id
+                            - name
+                            - icon
+                          additionalProperties: false
+                      apps:
+                        type: array
+                        items:
+                          type: object
+                          properties:
+                            id:
+                              type: string
+                            name:
+                              type: string
+                            description:
+                              type: string
+                            icon:
+                              type: string
+                            category:
+                              type: string
+                            version:
+                              type: string
+                            featured:
+                              type: boolean
+                          required:
+                            - id
+                            - name
+                            - description
+                            - icon
+                            - category
+                            - version
+                          additionalProperties: false
+                    required:
+                      - version
+                      - updatedAt
+                      - categories
+                      - apps
+                    additionalProperties: false
                 required:
                   - gallery
                 additionalProperties: false
@@ -952,6 +1141,23 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                    const: true
+                  appId:
+                    type: string
+                  name:
+                    type: string
+                required:
+                  - success
+                  - appId
+                  - name
+                additionalProperties: false
       requestBody:
         required: true
         content:
@@ -1034,6 +1240,55 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  manifest:
+                    type: object
+                    properties: {}
+                    additionalProperties: {}
+                  scanResult:
+                    type: object
+                    properties:
+                      passed:
+                        type: boolean
+                      blocked:
+                        type: array
+                        items:
+                          type: string
+                      warnings:
+                        type: array
+                        items:
+                          type: string
+                    required:
+                      - passed
+                      - blocked
+                      - warnings
+                    additionalProperties: false
+                  signatureResult:
+                    type: object
+                    properties:
+                      trustTier:
+                        type: string
+                      signerKeyId:
+                        type: string
+                      signerDisplayName:
+                        type: string
+                      signerAccount:
+                        type: string
+                    required:
+                      - trustTier
+                    additionalProperties: false
+                  bundleSizeBytes:
+                    type: number
+                required:
+                  - manifest
+                  - scanResult
+                  - signatureResult
+                  - bundleSizeBytes
+                additionalProperties: false
       requestBody:
         required: true
         content:
@@ -1090,29 +1345,64 @@ paths:
                 properties:
                   apps:
                     type: array
-                    items: {}
-                    description: Array of shared app objects
-                required:
-                  - apps
-                additionalProperties: false
-  /v1/apps/shared/{token}:
-    delete:
-      operationId: apps_shared_by_token_delete
-      summary: Delete shared app
-      description: Remove a shared app link.
-      tags:
-        - apps
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  success:
-                    type: boolean
-                required:
+                    items:
+                      type: object
+                      properties:
+                        uuid:
+                          type: string
+                        name:
+                          type: string
+                        description:
+                          type: string
+                        icon:
+                          type: string
+                        preview:
+                          type: string
+                        entry:
+                          type: string
+                        trustTier:
+                          type: string
+                        signerDisplayName:
+                          type: string
+                        bundleSizeBytes:
+                          type: number
+                        installedAt:
+                          type: string
+                        version:
+                          type: string
+                        contentId:
+                          type: string
+                        updateAvailable:
+                          type: boolean
+                      required:
+                        - uuid
+                        - name
+                        - entry
+                        - trustTier
+                        - bundleSizeBytes
+                        - installedAt
+                      additionalProperties: false
+                required:
+                  - apps
+                additionalProperties: false
+  /v1/apps/shared/{token}:
+    delete:
+      operationId: apps_shared_by_token_delete
+      summary: Delete shared app
+      description: Remove a shared app link.
+      tags:
+        - apps
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                required:
                   - success
                 additionalProperties: false
       parameters:
@@ -1181,6 +1471,22 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  signed:
+                    type: boolean
+                  signatureJson:
+                    type: object
+                    properties: {}
+                    additionalProperties: {}
+                  payload:
+                    type: string
+                  message:
+                    type: string
+                additionalProperties: false
       requestBody:
         required: true
         content:
@@ -1210,6 +1516,16 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  message:
+                    type: string
+                required:
+                  - message
+                additionalProperties: false
   /v1/attachments:
     delete:
       operationId: attachments_delete
@@ -1823,6 +2139,202 @@ paths:
               required:
                 - id
               additionalProperties: false
+  /v1/background-wake/drain-due:
+    post:
+      operationId: backgroundwake_draindue_post
+      summary: Drain due background wake work
+      description: Run due heartbeat and scheduler work for a background wake lease.
+      tags:
+        - background-wake
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  accepted:
+                    type: boolean
+                  leaseId:
+                    type: string
+                  reason:
+                    type: string
+                  sourceGeneration:
+                    type: string
+                  startedAt:
+                    type: number
+                  deadlineAt:
+                    type: number
+                required:
+                  - accepted
+                  - leaseId
+                  - reason
+                  - sourceGeneration
+                  - startedAt
+                  - deadlineAt
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              anyOf:
+                - type: object
+                  properties:
+                    leaseId:
+                      type: string
+                      minLength: 1
+                    reason:
+                      type: string
+                      minLength: 1
+                    sourceGeneration:
+                      type: string
+                      minLength: 1
+                    startedAt:
+                      anyOf:
+                        - type: number
+                        - type: string
+                    deadlineAt:
+                      anyOf:
+                        - type: number
+                        - type: string
+                  required:
+                    - leaseId
+                    - reason
+                    - sourceGeneration
+                    - startedAt
+                    - deadlineAt
+                  additionalProperties: false
+                - type: object
+                  properties:
+                    lease_id:
+                      type: string
+                      minLength: 1
+                    reason:
+                      type: string
+                      minLength: 1
+                    source_generation:
+                      type: string
+                      minLength: 1
+                    started_at:
+                      anyOf:
+                        - type: number
+                        - type: string
+                    deadline_at:
+                      anyOf:
+                        - type: number
+                        - type: string
+                  required:
+                    - lease_id
+                    - reason
+                    - source_generation
+                    - started_at
+                    - deadline_at
+                  additionalProperties: false
+  /v1/background-wake/intent:
+    get:
+      operationId: backgroundwake_intent_get
+      summary: Get background wake intent
+      description: Return the current computed background wake intent.
+      tags:
+        - background-wake
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  intent:
+                    anyOf:
+                      - type: object
+                        properties:
+                          nextWakeAt:
+                            type: number
+                          actualNextDueAt:
+                            type: number
+                          reason:
+                            type: string
+                            enum:
+                              - heartbeat
+                              - schedule
+                              - mixed
+                          sourceGeneration:
+                            type: string
+                          computedAt:
+                            type: number
+                          sourcePayload:
+                            type: object
+                            propertyNames:
+                              type: string
+                            additionalProperties: {}
+                        required:
+                          - nextWakeAt
+                          - actualNextDueAt
+                          - reason
+                          - sourceGeneration
+                          - computedAt
+                          - sourcePayload
+                        additionalProperties: false
+                      - type: "null"
+                required:
+                  - intent
+                additionalProperties: false
+  /v1/background-wake/prepare-sleep:
+    post:
+      operationId: backgroundwake_preparesleep_post
+      summary: Prepare for assistant sleep
+      description: Return the current background wake intent and whether sleep should be deferred.
+      tags:
+        - background-wake
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  intent:
+                    anyOf:
+                      - type: object
+                        properties:
+                          nextWakeAt:
+                            type: number
+                          actualNextDueAt:
+                            type: number
+                          reason:
+                            type: string
+                            enum:
+                              - heartbeat
+                              - schedule
+                              - mixed
+                          sourceGeneration:
+                            type: string
+                          computedAt:
+                            type: number
+                          sourcePayload:
+                            type: object
+                            propertyNames:
+                              type: string
+                            additionalProperties: {}
+                        required:
+                          - nextWakeAt
+                          - actualNextDueAt
+                          - reason
+                          - sourceGeneration
+                          - computedAt
+                          - sourcePayload
+                        additionalProperties: false
+                      - type: "null"
+                  deferSleep:
+                    type: boolean
+                required:
+                  - intent
+                  - deferSleep
+                additionalProperties: false
   /v1/backup/destinations:
     get:
       operationId: backup_destinations_get
@@ -2552,6 +3064,85 @@ paths:
               required:
                 - operation
               additionalProperties: false
+  /v1/browser/tabs:
+    post:
+      operationId: browser_tabs_post
+      summary: Manage browser tabs
+      description: List, create, select, or close browser tabs via the Chrome extension backend.
+      tags:
+        - browser
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                  tabs:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        tabId:
+                          type: number
+                        windowId:
+                          type: number
+                        url:
+                          type: string
+                        title:
+                          type: string
+                        active:
+                          type: boolean
+                        pinned:
+                          type: boolean
+                      required:
+                        - active
+                        - pinned
+                      additionalProperties: false
+                  tab: {}
+                  tabId:
+                    type: number
+                  clientId:
+                    type: string
+                  closed:
+                    type: boolean
+                required:
+                  - ok
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                command:
+                  type: string
+                  enum:
+                    - list
+                    - select
+                    - new
+                    - close
+                sessionId:
+                  default: default
+                  type: string
+                  minLength: 1
+                conversationId:
+                  type: string
+                  minLength: 1
+                tabId:
+                  type: number
+                url:
+                  type: string
+                targetClientId:
+                  type: string
+                  minLength: 1
+              required:
+                - command
+              additionalProperties: false
   /v1/btw:
     post:
       operationId: btw_post
@@ -3411,6 +4002,19 @@ paths:
       responses:
         "200":
           description: Successful response
+  /v1/config/llm/profiles:
+    get:
+      operationId: config_llm_profiles_get
+      summary: List defined LLM profiles
+      description:
+        Returns the sorted list of profile names defined in `llm.profiles` plus the workspace-wide active profile.
+        Used to populate per-call profile dropdowns (e.g. memory router playground) without requiring the caller to type
+        profile names.
+      tags:
+        - config
+      responses:
+        "200":
+          description: Successful response
   /v1/config/llm/profiles/{name}:
     put:
       operationId: config_llm_profiles_by_name_put
@@ -4341,15 +4945,6 @@ paths:
       operationId: conversations_get
       summary: List conversations
       description: Paginated list of conversations with attention state and display metadata.
-      tags:
-        - conversations
-      responses:
-        "200":
-          description: Successful response
-    post:
-      operationId: conversations_post
-      summary: Create a conversation
-      description: Create or get an existing conversation by key.
       tags:
         - conversations
       responses:
@@ -4360,10 +4955,248 @@ paths:
               schema:
                 type: object
                 properties:
-                  id:
+                  conversations:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        title:
+                          type: string
+                        createdAt:
+                          type: number
+                        updatedAt:
+                          type: number
+                        lastMessageAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        conversationType:
+                          type: string
+                          enum:
+                            - standard
+                            - background
+                            - scheduled
+                        source:
+                          type: string
+                        scheduleJobId:
+                          type: string
+                        channelBinding:
+                          type: object
+                          properties:
+                            sourceChannel:
+                              type: string
+                            externalChatId:
+                              type: string
+                            externalChatName:
+                              type: string
+                            externalThreadId:
+                              type: string
+                            externalUserId:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            displayName:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            username:
+                              anyOf:
+                                - type: string
+                                - type: "null"
+                            slackThread:
+                              type: object
+                              properties:
+                                channelId:
+                                  type: string
+                                threadTs:
+                                  type: string
+                                link:
+                                  type: object
+                                  properties:
+                                    appUrl:
+                                      type: string
+                                    webUrl:
+                                      type: string
+                                  additionalProperties: false
+                              required:
+                                - channelId
+                                - threadTs
+                              additionalProperties: false
+                            slackChannel:
+                              type: object
+                              properties:
+                                channelId:
+                                  type: string
+                                name:
+                                  type: string
+                                link:
+                                  type: object
+                                  properties:
+                                    webUrl:
+                                      type: string
+                                  required:
+                                    - webUrl
+                                  additionalProperties: false
+                              required:
+                                - channelId
+                              additionalProperties: false
+                          required:
+                            - sourceChannel
+                            - externalChatId
+                            - externalUserId
+                            - displayName
+                            - username
+                          additionalProperties: false
+                        conversationOriginChannel:
+                          anyOf:
+                            - type: string
+                              enum:
+                                - telegram
+                                - phone
+                                - vellum
+                                - whatsapp
+                                - slack
+                                - email
+                                - platform
+                                - a2a
+                            - type: "null"
+                        assistantAttention:
+                          type: object
+                          properties:
+                            hasUnseenLatestAssistantMessage:
+                              type: boolean
+                            latestAssistantMessageAt:
+                              type: number
+                            lastSeenAssistantMessageAt:
+                              type: number
+                            lastSeenConfidence:
+                              type: string
+                              enum:
+                                - explicit
+                                - inferred
+                            lastSeenSignalType:
+                              type: string
+                              enum:
+                                - macos_notification_view
+                                - macos_conversation_opened
+                                - ios_conversation_opened
+                                - telegram_inbound_message
+                                - telegram_callback
+                                - slack_inbound_message
+                                - slack_callback
+                          required:
+                            - hasUnseenLatestAssistantMessage
+                          additionalProperties: false
+                        isPinned:
+                          type: boolean
+                          const: true
+                        displayOrder:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        groupId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        forkParent:
+                          type: object
+                          properties:
+                            conversationId:
+                              type: string
+                            messageId:
+                              type: string
+                            title:
+                              type: string
+                          required:
+                            - conversationId
+                            - messageId
+                            - title
+                          additionalProperties: false
+                        archivedAt:
+                          type: number
+                        inferenceProfile:
+                          type: string
+                      required:
+                        - id
+                        - title
+                        - createdAt
+                        - updatedAt
+                        - lastMessageAt
+                        - conversationType
+                        - source
+                        - groupId
+                      additionalProperties: false
+                  nextOffset:
+                    type: number
+                  hasMore:
+                    type: boolean
+                  groups:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        name:
+                          type: string
+                        sortPosition:
+                          type: number
+                        isSystemGroup:
+                          type: boolean
+                      required:
+                        - id
+                        - name
+                        - sortPosition
+                        - isSystemGroup
+                      additionalProperties: false
+                required:
+                  - conversations
+                  - nextOffset
+                  - hasMore
+                additionalProperties: false
+      parameters:
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: integer
+          description: Maximum number of conversations to return (default 50).
+        - name: offset
+          in: query
+          required: false
+          schema:
+            type: integer
+          description: Number of conversations to skip (default 0).
+        - name: conversationType
+          in: query
+          required: false
+          schema:
+            type: string
+            enum:
+              - background
+          description: Filter by conversation type. Pass "background" to list only background/scheduled conversations.
+    post:
+      operationId: conversations_post
+      summary: Create a conversation
+      description: Create or get an existing conversation by key.
+      tags:
+        - conversations
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  id:
                     type: string
+                    description: Assistant-minted internal conversation id. The authoritative identifier for the conversation.
                   conversationKey:
                     type: string
+                    description: Echo of the optional external key supplied by the client.
                   conversationType:
                     type: string
                   created:
@@ -4382,14 +5215,15 @@ paths:
               type: object
               properties:
                 conversationKey:
+                  description:
+                    Optional external key. Echoed back in the response. Non-vellum channels (Telegram, WhatsApp) use this to
+                    scope to a logical channel thread; vellum-web clients can omit it and rely on the assistant-minted
+                    `id`.
                   type: string
-                  description: Idempotency key for the conversation
                 conversationType:
                   description: Only standard conversations are created by this endpoint
                   type: string
                   const: standard
-              required:
-                - conversationKey
               additionalProperties: false
   /v1/conversations/{conversationId}/slack-channel/resolve:
     post:
@@ -4426,57 +5260,415 @@ paths:
                       - rate_limit
                       - slack_error
                 required:
-                  - channelId
-                  - cached
-                  - resolved
+                  - channelId
+                  - cached
+                  - resolved
+                additionalProperties: false
+      parameters:
+        - name: conversationId
+          in: path
+          required: true
+          schema:
+            type: string
+  /v1/conversations/{id}:
+    delete:
+      operationId: conversations_by_id_delete
+      summary: Delete a conversation
+      description: Permanently delete a single conversation and its messages.
+      tags:
+        - conversations
+      responses:
+        "204":
+          description: Successful response
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+    get:
+      operationId: conversations_by_id_get
+      summary: Get conversation detail
+      description: Retrieve a single conversation with full metadata.
+      tags:
+        - conversations
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  conversation:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                      title:
+                        type: string
+                      createdAt:
+                        type: number
+                      updatedAt:
+                        type: number
+                      lastMessageAt:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      conversationType:
+                        type: string
+                        enum:
+                          - standard
+                          - background
+                          - scheduled
+                      source:
+                        type: string
+                      scheduleJobId:
+                        type: string
+                      channelBinding:
+                        type: object
+                        properties:
+                          sourceChannel:
+                            type: string
+                          externalChatId:
+                            type: string
+                          externalChatName:
+                            type: string
+                          externalThreadId:
+                            type: string
+                          externalUserId:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          displayName:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          username:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          slackThread:
+                            type: object
+                            properties:
+                              channelId:
+                                type: string
+                              threadTs:
+                                type: string
+                              link:
+                                type: object
+                                properties:
+                                  appUrl:
+                                    type: string
+                                  webUrl:
+                                    type: string
+                                additionalProperties: false
+                            required:
+                              - channelId
+                              - threadTs
+                            additionalProperties: false
+                          slackChannel:
+                            type: object
+                            properties:
+                              channelId:
+                                type: string
+                              name:
+                                type: string
+                              link:
+                                type: object
+                                properties:
+                                  webUrl:
+                                    type: string
+                                required:
+                                  - webUrl
+                                additionalProperties: false
+                            required:
+                              - channelId
+                            additionalProperties: false
+                        required:
+                          - sourceChannel
+                          - externalChatId
+                          - externalUserId
+                          - displayName
+                          - username
+                        additionalProperties: false
+                      conversationOriginChannel:
+                        anyOf:
+                          - type: string
+                            enum:
+                              - telegram
+                              - phone
+                              - vellum
+                              - whatsapp
+                              - slack
+                              - email
+                              - platform
+                              - a2a
+                          - type: "null"
+                      assistantAttention:
+                        type: object
+                        properties:
+                          hasUnseenLatestAssistantMessage:
+                            type: boolean
+                          latestAssistantMessageAt:
+                            type: number
+                          lastSeenAssistantMessageAt:
+                            type: number
+                          lastSeenConfidence:
+                            type: string
+                            enum:
+                              - explicit
+                              - inferred
+                          lastSeenSignalType:
+                            type: string
+                            enum:
+                              - macos_notification_view
+                              - macos_conversation_opened
+                              - ios_conversation_opened
+                              - telegram_inbound_message
+                              - telegram_callback
+                              - slack_inbound_message
+                              - slack_callback
+                        required:
+                          - hasUnseenLatestAssistantMessage
+                        additionalProperties: false
+                      isPinned:
+                        type: boolean
+                        const: true
+                      displayOrder:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      groupId:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                      forkParent:
+                        type: object
+                        properties:
+                          conversationId:
+                            type: string
+                          messageId:
+                            type: string
+                          title:
+                            type: string
+                        required:
+                          - conversationId
+                          - messageId
+                          - title
+                        additionalProperties: false
+                      archivedAt:
+                        type: number
+                      inferenceProfile:
+                        type: string
+                    required:
+                      - id
+                      - title
+                      - createdAt
+                      - updatedAt
+                      - lastMessageAt
+                      - conversationType
+                      - source
+                      - groupId
+                    additionalProperties: false
+                required:
+                  - conversation
+                additionalProperties: false
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+  /v1/conversations/{id}/analyze:
+    post:
+      operationId: conversations_by_id_analyze_post
+      summary: Analyze a conversation
+      description: Create a new conversation with a structured self-assessment of an existing conversation.
+      tags:
+        - conversations
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  conversation:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                      title:
+                        type: string
+                      createdAt:
+                        type: number
+                      updatedAt:
+                        type: number
+                      lastMessageAt:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      conversationType:
+                        type: string
+                        enum:
+                          - standard
+                          - background
+                          - scheduled
+                      source:
+                        type: string
+                      scheduleJobId:
+                        type: string
+                      channelBinding:
+                        type: object
+                        properties:
+                          sourceChannel:
+                            type: string
+                          externalChatId:
+                            type: string
+                          externalChatName:
+                            type: string
+                          externalThreadId:
+                            type: string
+                          externalUserId:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          displayName:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          username:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          slackThread:
+                            type: object
+                            properties:
+                              channelId:
+                                type: string
+                              threadTs:
+                                type: string
+                              link:
+                                type: object
+                                properties:
+                                  appUrl:
+                                    type: string
+                                  webUrl:
+                                    type: string
+                                additionalProperties: false
+                            required:
+                              - channelId
+                              - threadTs
+                            additionalProperties: false
+                          slackChannel:
+                            type: object
+                            properties:
+                              channelId:
+                                type: string
+                              name:
+                                type: string
+                              link:
+                                type: object
+                                properties:
+                                  webUrl:
+                                    type: string
+                                required:
+                                  - webUrl
+                                additionalProperties: false
+                            required:
+                              - channelId
+                            additionalProperties: false
+                        required:
+                          - sourceChannel
+                          - externalChatId
+                          - externalUserId
+                          - displayName
+                          - username
+                        additionalProperties: false
+                      conversationOriginChannel:
+                        anyOf:
+                          - type: string
+                            enum:
+                              - telegram
+                              - phone
+                              - vellum
+                              - whatsapp
+                              - slack
+                              - email
+                              - platform
+                              - a2a
+                          - type: "null"
+                      assistantAttention:
+                        type: object
+                        properties:
+                          hasUnseenLatestAssistantMessage:
+                            type: boolean
+                          latestAssistantMessageAt:
+                            type: number
+                          lastSeenAssistantMessageAt:
+                            type: number
+                          lastSeenConfidence:
+                            type: string
+                            enum:
+                              - explicit
+                              - inferred
+                          lastSeenSignalType:
+                            type: string
+                            enum:
+                              - macos_notification_view
+                              - macos_conversation_opened
+                              - ios_conversation_opened
+                              - telegram_inbound_message
+                              - telegram_callback
+                              - slack_inbound_message
+                              - slack_callback
+                        required:
+                          - hasUnseenLatestAssistantMessage
+                        additionalProperties: false
+                      isPinned:
+                        type: boolean
+                        const: true
+                      displayOrder:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      groupId:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                      forkParent:
+                        type: object
+                        properties:
+                          conversationId:
+                            type: string
+                          messageId:
+                            type: string
+                          title:
+                            type: string
+                        required:
+                          - conversationId
+                          - messageId
+                          - title
+                        additionalProperties: false
+                      archivedAt:
+                        type: number
+                      inferenceProfile:
+                        type: string
+                    required:
+                      - id
+                      - title
+                      - createdAt
+                      - updatedAt
+                      - lastMessageAt
+                      - conversationType
+                      - source
+                      - groupId
+                    additionalProperties: false
+                required:
+                  - conversation
                 additionalProperties: false
-      parameters:
-        - name: conversationId
-          in: path
-          required: true
-          schema:
-            type: string
-  /v1/conversations/{id}:
-    delete:
-      operationId: conversations_by_id_delete
-      summary: Delete a conversation
-      description: Permanently delete a single conversation and its messages.
-      tags:
-        - conversations
-      responses:
-        "204":
-          description: Successful response
-      parameters:
-        - name: id
-          in: path
-          required: true
-          schema:
-            type: string
-    get:
-      operationId: conversations_by_id_get
-      summary: Get conversation detail
-      description: Retrieve a single conversation with full metadata.
-      tags:
-        - conversations
-      responses:
-        "200":
-          description: Successful response
-      parameters:
-        - name: id
-          in: path
-          required: true
-          schema:
-            type: string
-  /v1/conversations/{id}/analyze:
-    post:
-      operationId: conversations_by_id_analyze_post
-      summary: Analyze a conversation
-      description: Create a new conversation with a structured self-assessment of an existing conversation.
-      tags:
-        - conversations
-      responses:
-        "200":
-          description: Successful response
       parameters:
         - name: id
           in: path
@@ -4493,6 +5685,19 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                  conversationId:
+                    type: string
+                required:
+                  - ok
+                  - conversationId
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -4531,6 +5736,105 @@ paths:
           required: true
           schema:
             type: string
+  /v1/conversations/{id}/compaction:
+    get:
+      operationId: conversations_by_id_compaction_get
+      summary: Get the compaction trail leading up to an LLM call
+      description:
+        Return the chronological list of compaction events that ran in this conversation in the open window between
+        the previous non-`compactionAgent` LLM call and the call identified by `callId`. Projected from
+        `llm_request_logs` rows where `call_site = "compactionAgent"`. When the selected call is the first real call in
+        the conversation, every preceding compaction is in scope. Drives the Inspector's Compaction tab.
+      tags:
+        - conversations
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  conversationId:
+                    type: string
+                  events:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        createdAt:
+                          type: number
+                        model:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        provider:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        inputTokens:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        outputTokens:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        durationMs:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        responsePreview:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        requestMessageCount:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        stopReason:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        estimatedCostUsd:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                      required:
+                        - id
+                        - createdAt
+                        - model
+                        - provider
+                        - inputTokens
+                        - outputTokens
+                        - durationMs
+                        - responsePreview
+                        - requestMessageCount
+                        - stopReason
+                        - estimatedCostUsd
+                      additionalProperties: false
+                required:
+                  - conversationId
+                  - events
+                additionalProperties: false
+        "400":
+          description: Returned when the callId is missing or refers to a call in a different conversation.
+        "404":
+          description: Returned when the conversation or the referenced LLM call does not exist.
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: callId
+          in: query
+          required: true
+          schema:
+            type: string
+          description: ID of the selected LLM call from the rail. Defines the chronological cutoff for the trail.
   /v1/conversations/{id}/inference-profile:
     put:
       operationId: conversations_by_id_inferenceprofile_put
@@ -4634,6 +5938,16 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                required:
+                  - ok
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -4754,6 +6068,19 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                  conversationId:
+                    type: string
+                required:
+                  - ok
+                  - conversationId
+                additionalProperties: false
       parameters:
         - name: id
           in: path
@@ -5087,38 +6414,217 @@ paths:
                   conversationId:
                     type: string
                 required:
-                  - detached
-                  - channelId
-                  - threadTs
-                  - source
+                  - detached
+                  - channelId
+                  - threadTs
+                  - source
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                conversationId:
+                  type: string
+                  minLength: 1
+                channelId:
+                  type: string
+                  minLength: 1
+                threadTs:
+                  type: string
+                  minLength: 1
+              additionalProperties: false
+  /v1/conversations/fork:
+    post:
+      operationId: conversations_fork_post
+      summary: Fork a conversation
+      description: Create a copy of a conversation, optionally truncated at a specific message.
+      tags:
+        - conversations
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  conversation:
+                    type: object
+                    properties:
+                      id:
+                        type: string
+                      title:
+                        type: string
+                      createdAt:
+                        type: number
+                      updatedAt:
+                        type: number
+                      lastMessageAt:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      conversationType:
+                        type: string
+                        enum:
+                          - standard
+                          - background
+                          - scheduled
+                      source:
+                        type: string
+                      scheduleJobId:
+                        type: string
+                      channelBinding:
+                        type: object
+                        properties:
+                          sourceChannel:
+                            type: string
+                          externalChatId:
+                            type: string
+                          externalChatName:
+                            type: string
+                          externalThreadId:
+                            type: string
+                          externalUserId:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          displayName:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          username:
+                            anyOf:
+                              - type: string
+                              - type: "null"
+                          slackThread:
+                            type: object
+                            properties:
+                              channelId:
+                                type: string
+                              threadTs:
+                                type: string
+                              link:
+                                type: object
+                                properties:
+                                  appUrl:
+                                    type: string
+                                  webUrl:
+                                    type: string
+                                additionalProperties: false
+                            required:
+                              - channelId
+                              - threadTs
+                            additionalProperties: false
+                          slackChannel:
+                            type: object
+                            properties:
+                              channelId:
+                                type: string
+                              name:
+                                type: string
+                              link:
+                                type: object
+                                properties:
+                                  webUrl:
+                                    type: string
+                                required:
+                                  - webUrl
+                                additionalProperties: false
+                            required:
+                              - channelId
+                            additionalProperties: false
+                        required:
+                          - sourceChannel
+                          - externalChatId
+                          - externalUserId
+                          - displayName
+                          - username
+                        additionalProperties: false
+                      conversationOriginChannel:
+                        anyOf:
+                          - type: string
+                            enum:
+                              - telegram
+                              - phone
+                              - vellum
+                              - whatsapp
+                              - slack
+                              - email
+                              - platform
+                              - a2a
+                          - type: "null"
+                      assistantAttention:
+                        type: object
+                        properties:
+                          hasUnseenLatestAssistantMessage:
+                            type: boolean
+                          latestAssistantMessageAt:
+                            type: number
+                          lastSeenAssistantMessageAt:
+                            type: number
+                          lastSeenConfidence:
+                            type: string
+                            enum:
+                              - explicit
+                              - inferred
+                          lastSeenSignalType:
+                            type: string
+                            enum:
+                              - macos_notification_view
+                              - macos_conversation_opened
+                              - ios_conversation_opened
+                              - telegram_inbound_message
+                              - telegram_callback
+                              - slack_inbound_message
+                              - slack_callback
+                        required:
+                          - hasUnseenLatestAssistantMessage
+                        additionalProperties: false
+                      isPinned:
+                        type: boolean
+                        const: true
+                      displayOrder:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                      groupId:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                      forkParent:
+                        type: object
+                        properties:
+                          conversationId:
+                            type: string
+                          messageId:
+                            type: string
+                          title:
+                            type: string
+                        required:
+                          - conversationId
+                          - messageId
+                          - title
+                        additionalProperties: false
+                      archivedAt:
+                        type: number
+                      inferenceProfile:
+                        type: string
+                    required:
+                      - id
+                      - title
+                      - createdAt
+                      - updatedAt
+                      - lastMessageAt
+                      - conversationType
+                      - source
+                      - groupId
+                    additionalProperties: false
+                required:
+                  - conversation
                 additionalProperties: false
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                conversationId:
-                  type: string
-                  minLength: 1
-                channelId:
-                  type: string
-                  minLength: 1
-                threadTs:
-                  type: string
-                  minLength: 1
-              additionalProperties: false
-  /v1/conversations/fork:
-    post:
-      operationId: conversations_fork_post
-      summary: Fork a conversation
-      description: Create a copy of a conversation, optionally truncated at a specific message.
-      tags:
-        - conversations
-      responses:
-        "200":
-          description: Successful response
       requestBody:
         required: true
         content:
@@ -5432,6 +6938,76 @@ paths:
           schema:
             type: string
           description: Optional conversation ID filter
+  /v1/conversations/llm-context:
+    get:
+      operationId: conversations_llmcontext_get
+      summary: Get LLM context for a conversation
+      description: Returns normalized LLM request/response logs for an entire conversation.
+      tags:
+        - conversations
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  conversationKey:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  conversationId:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  conversationKind:
+                    type: string
+                    enum:
+                      - user
+                      - background
+                      - background_memory_consolidation
+                      - scheduled
+                  conversationTotalEstimatedCostUsd:
+                    anyOf:
+                      - type: number
+                      - type: "null"
+                  logs:
+                    type: array
+                    items: {}
+                  memoryRecall:
+                    anyOf:
+                      - type: object
+                        properties: {}
+                        additionalProperties: {}
+                      - type: "null"
+                  memoryV2Activation:
+                    anyOf:
+                      - type: object
+                        properties: {}
+                        additionalProperties: {}
+                      - type: "null"
+                required:
+                  - conversationId
+                  - conversationKind
+                  - conversationTotalEstimatedCostUsd
+                  - logs
+                  - memoryRecall
+                  - memoryV2Activation
+                additionalProperties: false
+      parameters:
+        - name: conversationKey
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Stable external conversation key.
+        - name: conversationId
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Internal conversation identifier.
   /v1/conversations/rename:
     post:
       operationId: conversations_rename_post
@@ -5469,6 +7045,16 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                required:
+                  - ok
+                additionalProperties: false
       requestBody:
         required: true
         content:
@@ -5478,8 +7064,22 @@ paths:
               properties:
                 updates:
                   type: array
-                  items: {}
-                  description: Array of { conversationId, displayOrder?, isPinned? } objects
+                  items:
+                    type: object
+                    properties:
+                      conversationId:
+                        type: string
+                      displayOrder:
+                        type: number
+                      isPinned:
+                        type: boolean
+                      groupId:
+                        anyOf:
+                          - type: string
+                          - type: "null"
+                    required:
+                      - conversationId
+                    additionalProperties: false
               required:
                 - updates
               additionalProperties: false
@@ -5536,6 +7136,48 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                required:
+                  - ok
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                conversationId:
+                  type: string
+                sourceChannel:
+                  type: string
+                signalType:
+                  type: string
+                confidence:
+                  type: string
+                  enum:
+                    - explicit
+                    - inferred
+                source:
+                  type: string
+                evidenceText:
+                  type: string
+                metadata:
+                  type: object
+                  propertyNames:
+                    type: string
+                  additionalProperties: {}
+                observedAt:
+                  type: number
+              required:
+                - conversationId
+              additionalProperties: false
   /v1/conversations/switch:
     post:
       operationId: conversations_switch_post
@@ -5589,6 +7231,28 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                required:
+                  - ok
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                conversationId:
+                  type: string
+              required:
+                - conversationId
+              additionalProperties: false
   /v1/conversations/wake:
     post:
       operationId: conversations_wake_post
@@ -6338,6 +8002,7 @@ paths:
                         enum:
                           - disabled
                           - ok
+                          - warning
                           - critical
                           - unknown
                       locked:
@@ -6423,6 +8088,7 @@ paths:
                         enum:
                           - disabled
                           - ok
+                          - warning
                           - critical
                           - unknown
                       locked:
@@ -6524,6 +8190,7 @@ paths:
                         enum:
                           - disabled
                           - ok
+                          - warning
                           - critical
                           - unknown
                       locked:
@@ -6599,8 +8266,29 @@ paths:
                 properties:
                   documents:
                     type: array
-                    items: {}
-                    description: Document summary objects
+                    items:
+                      type: object
+                      properties:
+                        surfaceId:
+                          type: string
+                        conversationId:
+                          type: string
+                        title:
+                          type: string
+                        wordCount:
+                          type: number
+                        createdAt:
+                          type: number
+                        updatedAt:
+                          type: number
+                      required:
+                        - surfaceId
+                        - conversationId
+                        - title
+                        - wordCount
+                        - createdAt
+                        - updatedAt
+                      additionalProperties: false
                 required:
                   - documents
                 additionalProperties: false
@@ -7006,6 +8694,15 @@ paths:
       responses:
         "200":
           description: Successful response
+  /v1/domain/verification-status:
+    post:
+      operationId: domain_verificationstatus_post
+      summary: Get live DNS verification status for a domain
+      tags:
+        - domain
+      responses:
+        "200":
+          description: Successful response
   /v1/email/attachment-get:
     get:
       operationId: email_attachmentget_get
@@ -7327,12 +9024,20 @@ paths:
         "200":
           description: Successful response
       parameters:
+        - name: conversationId
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Scope to a single conversation by its assistant-minted internal id. 404s if no such conversation exists.
         - name: conversationKey
           in: query
           required: false
           schema:
             type: string
-          description: Scope to a single conversation
+          description:
+            Scope to a single conversation by an external key (non-vellum channels) or the web idempotency key.
+            Materializes a row on first use. Ignored when conversationId is also provided.
   /v1/events/emit:
     post:
       operationId: events_emit_post
@@ -7508,6 +9213,33 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  groups:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        name:
+                          type: string
+                        sortPosition:
+                          type: number
+                        isSystemGroup:
+                          type: boolean
+                      required:
+                        - id
+                        - name
+                        - sortPosition
+                        - isSystemGroup
+                      additionalProperties: false
+                required:
+                  - groups
+                additionalProperties: false
     post:
       operationId: groups_post
       summary: Create group
@@ -7517,6 +9249,25 @@ paths:
       responses:
         "201":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  id:
+                    type: string
+                  name:
+                    type: string
+                  sortPosition:
+                    type: number
+                  isSystemGroup:
+                    type: boolean
+                required:
+                  - id
+                  - name
+                  - sortPosition
+                  - isSystemGroup
+                additionalProperties: false
         "400":
           description: Missing or invalid name, or sort_position ceiling reached
       requestBody:
@@ -7561,6 +9312,25 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  id:
+                    type: string
+                  name:
+                    type: string
+                  sortPosition:
+                    type: number
+                  isSystemGroup:
+                    type: boolean
+                required:
+                  - id
+                  - name
+                  - sortPosition
+                  - isSystemGroup
+                additionalProperties: false
         "403":
           description: System group sort position cannot be changed
         "404":
@@ -7593,6 +9363,16 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                required:
+                  - ok
+                additionalProperties: false
         "403":
           description: Cannot reorder system groups
       requestBody:
@@ -8605,6 +10385,197 @@ paths:
           required: true
           schema:
             type: string
+  /v1/home/feed/query:
+    post:
+      operationId: home_feed_query_post
+      summary: List home feed items with filters
+      description:
+        Return home feed items filtered by status, urgency, category, conversation, and date range. Defaults to
+        excluding dismissed items. Used by the assistant CLI to inspect what notifications have been surfaced to the
+        user.
+      tags:
+        - home
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  items:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        type:
+                          type: string
+                          const: notification
+                        priority:
+                          type: integer
+                          minimum: 0
+                          maximum: 100
+                        title:
+                          type: string
+                        summary:
+                          type: string
+                        timestamp:
+                          type: string
+                        status:
+                          default: new
+                          type: string
+                          enum:
+                            - new
+                            - seen
+                            - acted_on
+                            - dismissed
+                        expiresAt:
+                          type: string
+                        actions:
+                          type: array
+                          items:
+                            type: object
+                            properties:
+                              id:
+                                type: string
+                              label:
+                                type: string
+                              prompt:
+                                type: string
+                            required:
+                              - id
+                              - label
+                              - prompt
+                            additionalProperties: false
+                        urgency:
+                          type: string
+                          enum:
+                            - low
+                            - medium
+                            - high
+                            - critical
+                        conversationId:
+                          type: string
+                        detailPanel:
+                          type: object
+                          properties:
+                            kind:
+                              type: string
+                              enum:
+                                - emailDraft
+                                - documentPreview
+                                - permissionChat
+                                - paymentAuth
+                                - toolPermission
+                                - updatesList
+                          required:
+                            - kind
+                          additionalProperties: false
+                        category:
+                          type: string
+                          enum:
+                            - security
+                            - scheduling
+                            - background
+                            - email
+                            - system
+                        noteworthy:
+                          type: boolean
+                        fromAssistant:
+                          type: boolean
+                        metadata:
+                          type: object
+                          propertyNames:
+                            type: string
+                          additionalProperties: {}
+                        createdAt:
+                          type: string
+                      required:
+                        - id
+                        - type
+                        - priority
+                        - summary
+                        - timestamp
+                        - status
+                        - createdAt
+                      additionalProperties: false
+                  total:
+                    type: integer
+                    minimum: 0
+                    maximum: 9007199254740991
+                  returned:
+                    type: integer
+                    minimum: 0
+                    maximum: 9007199254740991
+                  hasMore:
+                    type: boolean
+                  updatedAt:
+                    type: string
+                required:
+                  - items
+                  - total
+                  - returned
+                  - hasMore
+                  - updatedAt
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                includeDismissed:
+                  type: boolean
+                statuses:
+                  type: array
+                  items:
+                    type: string
+                    enum:
+                      - new
+                      - seen
+                      - acted_on
+                      - dismissed
+                before:
+                  type: string
+                after:
+                  type: string
+                urgencies:
+                  type: array
+                  items:
+                    type: string
+                    enum:
+                      - low
+                      - medium
+                      - high
+                      - critical
+                categories:
+                  type: array
+                  items:
+                    type: string
+                    enum:
+                      - security
+                      - scheduling
+                      - background
+                      - email
+                      - system
+                conversationId:
+                  type: string
+                fromAssistant:
+                  type: boolean
+                noteworthy:
+                  type: boolean
+                limit:
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 200
+                offset:
+                  type: integer
+                  minimum: 0
+                  maximum: 9007199254740991
+              additionalProperties: false
   /v1/home/state:
     get:
       operationId: home_state_get
@@ -8967,6 +10938,9 @@ paths:
                 reason:
                   description: Detach reason
                   type: string
+                clientId:
+                  description: Extension client ID that reported the invalidation
+                  type: string
               additionalProperties: false
   /v1/host-cu-result:
     post:
@@ -9174,10 +11148,8 @@ paths:
   /v1/identity/intro:
     get:
       operationId: identity_intro_get
-      summary: Get identity intro text
-      description:
-        Returns a deterministic greeting derived from the assistant name in IDENTITY.md, falling back to
-        LLM-generated cache.
+      summary: Get identity greetings
+      description: Returns an array of greetings sourced from SOUL.md, LLM cache, or static fallbacks.
       tags:
         - identity
       responses:
@@ -9188,9 +11160,14 @@ paths:
               schema:
                 type: object
                 properties:
+                  greetings:
+                    type: array
+                    items:
+                      type: string
                   text:
                     type: string
                 required:
+                  - greetings
                   - text
                 additionalProperties: false
   /v1/image-generation/generate:
@@ -9298,6 +11275,7 @@ paths:
                             - fireworks
                             - openrouter
                             - openai-compatible
+                            - minimax
                         auth:
                           oneOf:
                             - type: object
@@ -9352,11 +11330,6 @@ paths:
                                 - type
                                 - credential
                               additionalProperties: false
-                        status:
-                          type: string
-                          enum:
-                            - active
-                            - disabled
                         label:
                           anyOf:
                             - type: string
@@ -9397,7 +11370,6 @@ paths:
                         - name
                         - provider
                         - auth
-                        - status
                         - label
                         - baseUrl
                         - models
@@ -9414,7 +11386,9 @@ paths:
           required: false
           schema:
             type: string
-          description: "Filter by provider. One of: anthropic, openai, gemini, ollama, fireworks, openrouter, openai-compatible"
+          description:
+            "Filter by provider. One of: anthropic, openai, gemini, ollama, fireworks, openrouter, openai-compatible,
+            minimax"
     post:
       operationId: inference_providerconnections_post
       summary: Create a provider connection
@@ -9442,6 +11416,7 @@ paths:
                       - fireworks
                       - openrouter
                       - openai-compatible
+                      - minimax
                   auth:
                     oneOf:
                       - type: object
@@ -9493,14 +11468,9 @@ paths:
                             type: string
                             minLength: 1
                         required:
-                          - type
-                          - credential
-                        additionalProperties: false
-                  status:
-                    type: string
-                    enum:
-                      - active
-                      - disabled
+                          - type
+                          - credential
+                        additionalProperties: false
                   label:
                     anyOf:
                       - type: string
@@ -9541,7 +11511,6 @@ paths:
                   - name
                   - provider
                   - auth
-                  - status
                   - label
                   - baseUrl
                   - models
@@ -9573,6 +11542,7 @@ paths:
                     - fireworks
                     - openrouter
                     - openai-compatible
+                    - minimax
                 auth:
                   oneOf:
                     - type: object
@@ -9630,11 +11600,6 @@ paths:
                 label:
                   type: string
                   minLength: 1
-                status:
-                  type: string
-                  enum:
-                    - active
-                    - disabled
                 base_url:
                   anyOf:
                     - type: string
@@ -9724,6 +11689,7 @@ paths:
                       - fireworks
                       - openrouter
                       - openai-compatible
+                      - minimax
                   auth:
                     oneOf:
                       - type: object
@@ -9778,11 +11744,6 @@ paths:
                           - type
                           - credential
                         additionalProperties: false
-                  status:
-                    type: string
-                    enum:
-                      - active
-                      - disabled
                   label:
                     anyOf:
                       - type: string
@@ -9823,7 +11784,6 @@ paths:
                   - name
                   - provider
                   - auth
-                  - status
                   - label
                   - baseUrl
                   - models
@@ -9844,8 +11804,7 @@ paths:
       summary: Update a provider connection
       description:
         Update an existing connection. Cannot rename or change the provider. For managed connections
-        (anthropic-managed, openai-managed, gemini-managed) the auth is locked to platform; label and status remain
-        editable.
+        (anthropic-managed, openai-managed, gemini-managed) the auth is locked to platform; label remains editable.
       tags:
         - inference
       responses:
@@ -9869,6 +11828,7 @@ paths:
                       - fireworks
                       - openrouter
                       - openai-compatible
+                      - minimax
                   auth:
                     oneOf:
                       - type: object
@@ -9923,11 +11883,6 @@ paths:
                           - type
                           - credential
                         additionalProperties: false
-                  status:
-                    type: string
-                    enum:
-                      - active
-                      - disabled
                   label:
                     anyOf:
                       - type: string
@@ -9968,7 +11923,6 @@ paths:
                   - name
                   - provider
                   - auth
-                  - status
                   - label
                   - baseUrl
                   - models
@@ -10047,11 +12001,6 @@ paths:
                         - type
                         - credential
                       additionalProperties: false
-                status:
-                  type: string
-                  enum:
-                    - active
-                    - disabled
                 label:
                   anyOf:
                     - type: string
@@ -10447,6 +12396,21 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  hasToken:
+                    type: boolean
+                  success:
+                    type: boolean
+                  error:
+                    type: string
+                required:
+                  - hasToken
+                  - success
+                additionalProperties: false
     get:
       operationId: integrations_vercel_config_get
       summary: Get Vercel config
@@ -10456,6 +12420,21 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  hasToken:
+                    type: boolean
+                  success:
+                    type: boolean
+                  error:
+                    type: string
+                required:
+                  - hasToken
+                  - success
+                additionalProperties: false
     post:
       operationId: integrations_vercel_config_post
       summary: Set or delete Vercel config
@@ -10465,6 +12444,37 @@ paths:
       responses:
         "200":
           description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  hasToken:
+                    type: boolean
+                  success:
+                    type: boolean
+                  error:
+                    type: string
+                required:
+                  - hasToken
+                  - success
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                action:
+                  type: string
+                  enum:
+                    - get
+                    - set
+                    - delete
+                apiToken:
+                  type: string
+              additionalProperties: false
   /v1/internal/mcp/add:
     post:
       operationId: internal_mcp_add_post
@@ -11000,6 +13010,50 @@ paths:
               required:
                 - op
               additionalProperties: false
+  /v1/memory/v2/compare-retrievers:
+    post:
+      operationId: memory_v2_compareretrievers_post
+      summary: Compare retrievers against the router's logged selections (read-only)
+      description:
+        Runs one or more retrievers over a sample of historical turns (memory_v2_activation_logs, mode='router')
+        and scores their selected pages against the logged selections as ground truth, reconstructing each turn's inputs
+        from the messages table + current NOW. Read-only — writes nothing. Each scored turn re-runs the router (one LLM
+        call), so keep `limit` modest. Today the only retriever is the router itself, so this is the harness self-test.
+      tags:
+        - memory
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                limit:
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 9007199254740991
+                strategy:
+                  type: string
+                  enum:
+                    - recent
+                    - random
+                conversationIds:
+                  type: array
+                  items:
+                    type: string
+                    minLength: 1
+                ks:
+                  type: array
+                  items:
+                    type: integer
+                    exclusiveMinimum: 0
+                    maximum: 9007199254740991
+                includeNotInjected:
+                  type: boolean
+              additionalProperties: false
   /v1/memory/v2/concept-frequency:
     post:
       operationId: memory_v2_conceptfrequency_post
@@ -11096,6 +13150,18 @@ paths:
               type: object
               properties: {}
               additionalProperties: false
+  /v1/memory/v2/now-text:
+    get:
+      operationId: memory_v2_nowtext_get
+      summary: Return the current rendered `<now>` body
+      description:
+        Returns the current NOW.md (autoloaded essentials/threads/recent). Used by the memory router playground to
+        seed its `<now>` text area with a production-like default so callers can edit from a realistic baseline.
+      tags:
+        - memory
+      responses:
+        "200":
+          description: Successful response
   /v1/memory/v2/reembed-skills:
     post:
       operationId: memory_v2_reembedskills_post
@@ -11112,17 +13178,236 @@ paths:
           application/json:
             schema:
               type: object
-              properties: {}
+              properties: {}
+              additionalProperties: false
+  /v1/memory/v2/router-prompt-template:
+    get:
+      operationId: memory_v2_routerprompttemplate_get
+      summary: Return the bundled router system-prompt template
+      description:
+        Returns the bundled `ROUTER_PROMPT` body with placeholders intact (`{{ASSISTANT_NAME}}`, `{{USER_NAME}}`,
+        `{{PAGE_INDEX}}`). Used by the memory router playground's 'Load default' affordance so users have a known-good
+        starting point when authoring an inline prompt override.
+      tags:
+        - memory
+      responses:
+        "200":
+          description: Successful response
+  /v1/memory/v2/simulate-router:
+    post:
+      operationId: memory_v2_simulaterouter_post
+      summary: Dry-run the v4 router with config overrides (read-only)
+      description:
+        Runs the memory router against the live page index + EMA scores with optional tier_size / batch_size
+        overrides, without recording an injection event or writing an activation log. Returns the slugs that would have
+        been selected, per-slug tier provenance, EMA scores, and the effective router config so operators can validate
+        knob changes before flipping them in workspace config.
+      tags:
+        - memory
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                recentTurnPairs:
+                  minItems: 1
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      assistantMessage:
+                        type: string
+                      userMessage:
+                        type: string
+                    required:
+                      - assistantMessage
+                      - userMessage
+                    additionalProperties: false
+                nowText:
+                  type: string
+                configOverrides:
+                  type: object
+                  properties:
+                    tier1_size:
+                      anyOf:
+                        - type: integer
+                          minimum: 1
+                          maximum: 9007199254740991
+                        - type: "null"
+                    tier2_size:
+                      anyOf:
+                        - type: integer
+                          minimum: 1
+                          maximum: 9007199254740991
+                        - type: "null"
+                    batch_size:
+                      anyOf:
+                        - type: integer
+                          minimum: 1
+                          maximum: 9007199254740991
+                        - type: "null"
+                  additionalProperties: false
+                profileOverride:
+                  type: string
+                  minLength: 1
+                routerPromptOverride:
+                  type: string
+                  maxLength: 1000000
+              required:
+                - recentTurnPairs
+              additionalProperties: false
+  /v1/memory/v2/validate:
+    post:
+      operationId: memory_v2_validate_post
+      summary: Validate memory v2 workspace state
+      description:
+        Read-only structural validation of the v2 workspace — reports orphan edges, oversized pages, and parse
+        failures. Runnable regardless of memory.v2.enabled so operators can dry-run validation before flipping the flag.
+      tags:
+        - memory
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties: {}
+              additionalProperties: false
+  /v1/memory/v3/seed-edges:
+    post:
+      operationId: memory_v3_seededges_post
+      summary: Seed the learned co-retrieval edge graph from v2 router history
+      description:
+        Builds an NPMI-scored co-retrieval graph from the v2 router's per-turn selections
+        (memory_v2_activation_logs, status='injected') and persists it into memory_v3_auto_edges, warm-starting the
+        learned edge graph that the v3 edge-expansion lane merges with curated edges when
+        memory.v3.edges.learnedAdjacencyThreshold > 0. NPMI plus a min co-occurrence floor and an always-on frequency
+        ceiling keep the neighborhoods associative rather than base-rate noise. Idempotent (upserts to a flat seed
+        weight). Runs no LLM; the only write among the v3 routes.
+      tags:
+        - memory
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                minCount:
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 9007199254740991
+                topK:
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 9007199254740991
+                maxNeighborFreqRatio:
+                  type: number
+                  exclusiveMinimum: 0
+                  maximum: 1
+                seedWeight:
+                  type: number
+                  exclusiveMinimum: 0
+              additionalProperties: false
+  /v1/memory/v3/shadow-diff:
+    post:
+      operationId: memory_v3_shadowdiff_post
+      summary: Diff v3 shadow selections against live v2 router selections (read-only)
+      description:
+        Compares the v3 shadow-mode selections against the live v2 router selections turn-for-turn, from the memory
+        activation log. Pairs each v3_shadow row with the nearest v2 router row in the same conversation (by timestamp,
+        within a tolerance — the turn columns use different counters), then reports per-turn and aggregate overlap, what
+        v3 surfaced that v2 did not, and what v2 had that v3 dropped, broken down by v3 provenance lane. The v2
+        comparand is the router's fresh per-turn pick (status='injected'), not its accumulated in-context set. Requires
+        that v3 shadow mode has been running so v3_shadow rows exist; the route runs no LLM and writes nothing.
+      tags:
+        - memory
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                sinceDays:
+                  type: number
+                  exclusiveMinimum: 0
+                toleranceSec:
+                  type: number
+                  exclusiveMinimum: 0
+                limit:
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 9007199254740991
+              additionalProperties: false
+  /v1/memory/v3/simulate:
+    post:
+      operationId: memory_v3_simulate_post
+      summary: Dry-run the v3 retrieval loop against an ad-hoc query (read-only)
+      description:
+        Runs the v3 multi-lane bounded-descent retrieval loop read-only against a single synthetic turn built from
+        the supplied query plus the live (or supplied) NOW context. Returns the selected page slugs, per-lane
+        provenance, the full multi-pass descent trace, and accumulated cost. Optional passCap / lane-allowlist overrides
+        apply on top of live config. Invoked directly (not gated by memory.v3.enabled/shadow) so operators can probe v3
+        retrieval before flipping the flags; writes nothing (co-activation persistence is forced off), though each pass
+        still spends the loop's filter + gate LLM calls.
+      tags:
+        - memory
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                query:
+                  type: string
+                  minLength: 1
+                nowText:
+                  type: string
+                passCap:
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 9007199254740991
+                lanes:
+                  minItems: 1
+                  type: array
+                  items:
+                    type: string
+                    enum:
+                      - hot
+                      - sparse
+                      - dense
+                      - tree
+                      - edges
+              required:
+                - query
               additionalProperties: false
-  /v1/memory/v2/simulate-router:
+  /v1/memory/v3/tree:
     post:
-      operationId: memory_v2_simulaterouter_post
-      summary: Dry-run the v4 router with config overrides (read-only)
+      operationId: memory_v3_tree_post
+      summary: Return a serializable view of the memory v3 tree DAG (read-only)
       description:
-        Runs the memory router against the live page index + EMA scores with optional tier_size / batch_size
-        overrides, without recording an injection event or writing an activation log. Returns the slugs that would have
-        been selected, per-slug tier provenance, EMA scores, and the effective router config so operators can validate
-        knob changes before flipping them in workspace config.
+        Returns the v3 tree root id plus every node and its ordered child refs (page:/node:) as a JSON-serializable
+        projection of the in-memory TreeIndex. Read-only; the CLI uses it to print an indented tree with shared-DAG
+        re-entries marked.
       tags:
         - memory
       responses:
@@ -11134,42 +13419,16 @@ paths:
           application/json:
             schema:
               type: object
-              properties:
-                query:
-                  type: string
-                  minLength: 1
-                configOverrides:
-                  type: object
-                  properties:
-                    tier1_size:
-                      anyOf:
-                        - type: integer
-                          minimum: 1
-                          maximum: 9007199254740991
-                        - type: "null"
-                    tier2_size:
-                      anyOf:
-                        - type: integer
-                          minimum: 1
-                          maximum: 9007199254740991
-                        - type: "null"
-                    batch_size:
-                      anyOf:
-                        - type: integer
-                          minimum: 1
-                          maximum: 9007199254740991
-                        - type: "null"
-                  additionalProperties: false
-              required:
-                - query
+              properties: {}
               additionalProperties: false
-  /v1/memory/v2/validate:
+  /v1/memory/v3/validate:
     post:
-      operationId: memory_v2_validate_post
-      summary: Validate memory v2 workspace state
+      operationId: memory_v3_validate_post
+      summary: Validate the memory v3 tree structure (read-only)
       description:
-        Read-only structural validation of the v2 workspace — reports orphan edges, oversized pages, and parse
-        failures. Runnable regardless of memory.v2.enabled so operators can dry-run validation before flipping the flag.
+        Read-only structural validation of the hand-authored v3 tree DAG. Reports dangling child refs, orphan
+        pages, cycles, stale compositional indexes, and unknown edge targets. Writes nothing and runs no LLM — operators
+        dry-run it while the v2 → v3 migration is in flight.
       tags:
         - memory
       responses:
@@ -11813,6 +14072,92 @@ paths:
               required:
                 - deliveryId
               additionalProperties: false
+  /v1/notifications/edit:
+    post:
+      operationId: notifications_edit_post
+      summary: Edit an already-sent notification
+      description:
+        Patch the home-feed entry for a notification and, where supported (Slack today), update the delivered
+        message in place.
+      tags:
+        - notifications
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                  feedItem:
+                    type: object
+                    propertyNames:
+                      type: string
+                    additionalProperties: {}
+                  channels:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        channel:
+                          type: string
+                        deliveryId:
+                          type: string
+                        outcome:
+                          type: string
+                          enum:
+                            - updated
+                            - unsupported
+                            - skipped
+                            - failed
+                        reason:
+                          type: string
+                      required:
+                        - channel
+                        - deliveryId
+                        - outcome
+                      additionalProperties: false
+                required:
+                  - ok
+                  - feedItem
+                  - channels
+                additionalProperties: false
+        "404":
+          description: No notification found for the supplied id
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                id:
+                  type: string
+                  minLength: 1
+                  description: Feed item id (notif:<uuid>) or bare uuid
+                title:
+                  type: string
+                body:
+                  type: string
+                urgency:
+                  type: string
+                  enum:
+                    - low
+                    - medium
+                    - high
+                    - critical
+                status:
+                  type: string
+                  enum:
+                    - new
+                    - seen
+                    - acted_on
+                    - dismissed
+              required:
+                - id
+              additionalProperties: false
   /v1/notifications/emit:
     post:
       operationId: notifications_emit_post
@@ -12522,6 +14867,168 @@ paths:
           required: true
           schema:
             type: string
+  /v1/plugins:
+    get:
+      operationId: plugins_get
+      summary: List installed plugins
+      description:
+        Return one entry per directory under `<workspaceDir>/plugins/`, sorted alphabetically. Matches the CLI's
+        `assistant plugins list`. Supports `?q=<text>` for case-insensitive substring matching across plugin id, name,
+        and description.
+      tags:
+        - plugins
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  plugins:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                          description: Plugin's directory name (kebab-case). Matches `assistant plugins install <id>`.
+                        name:
+                          type: string
+                          description: Display name. Equal to `id` today.
+                        description:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                          description: From `package.json#description`; `null` when unknown.
+                        version:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                          description: From `package.json#version`; `null` when unknown.
+                        path:
+                          description: Absolute path to the plugin directory on the assistant host.
+                          type: string
+                        issues:
+                          description: Non-fatal issues with this entry (missing `package.json`, malformed JSON, ...). Omitted when clean.
+                          type: array
+                          items:
+                            type: string
+                      required:
+                        - id
+                        - name
+                        - description
+                        - version
+                      additionalProperties: false
+                required:
+                  - plugins
+                additionalProperties: false
+      parameters:
+        - name: q
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Optional substring filter applied to plugin id, name, and description.
+  /v1/plugins/{name}:
+    delete:
+      operationId: plugins_by_name_delete
+      summary: Uninstall a plugin
+      description:
+        Remove the directory at `<workspaceDir>/plugins/<name>/`. Mirrors the CLI's `assistant plugins uninstall
+        <name>` (without the interactive confirmation — the API caller is responsible for any prompt). The plugin name
+        is sanitized by the same regex the CLI uses; `../escape`-style values, hidden names, and absolute paths return
+        400. Missing plugins return 404. The assistant must be restarted to drop the plugin from the running runtime.
+      tags:
+        - plugins
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  name:
+                    type: string
+                    description: Directory name that was removed. Echoes the request's `:name` path parameter after sanitization.
+                  target:
+                    type: string
+                    description: Absolute path that was removed on the assistant host. Useful for audit logs and confirmation toasts.
+                required:
+                  - name
+                  - target
+                additionalProperties: false
+        "400":
+          description: The plugin name failed sanitization (e.g. contained slashes, dots, or uppercase letters).
+        "404":
+          description: No plugin directory exists with the given name.
+      parameters:
+        - name: name
+          in: path
+          required: true
+          schema:
+            type: string
+  /v1/plugins/search:
+    get:
+      operationId: plugins_search_get
+      summary: Search the plugin catalog
+      description:
+        List installable plugins from the canonical `vellum-ai/vellum-assistant` catalog at
+        `experimental/plugins/`. The query is an ECMAScript regex matched case-insensitively against the directory name
+        (e.g. `memory`, `^simple`). Empty query returns every entry. Mirrors the CLI's `assistant plugins search`.
+      tags:
+        - plugins
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  query:
+                    type: string
+                    description: Echo of the requested query (ECMAScript regex source).
+                  ref:
+                    type: string
+                    description: Git ref the catalog was listed at.
+                  matches:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        name:
+                          type: string
+                          description: Directory name under `experimental/plugins/`. Matches `assistant plugins install <name>`.
+                        path:
+                          type: string
+                          description: Repo-relative path of the match (e.g. `experimental/plugins/<name>`).
+                      required:
+                        - name
+                        - path
+                      additionalProperties: false
+                    description: Directory matches, sorted alphabetically by name.
+                required:
+                  - query
+                  - ref
+                  - matches
+                additionalProperties: false
+      parameters:
+        - name: q
+          in: query
+          required: false
+          schema:
+            type: string
+          description:
+            ECMAScript regex pattern matched case-insensitively against catalog directory names. Empty/missing matches
+            everything.
+        - name: ref
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Optional git ref to list the catalog at. Defaults to the CLI's `DEFAULT_PLUGIN_REF` (typically `main`).
   /v1/profiler/runs:
     get:
       operationId: profiler_runs_get
@@ -15437,16 +17944,41 @@ paths:
                 type: object
                 properties:
                   suggestion:
-                    type: string
+                    anyOf:
+                      - type: string
+                      - type: "null"
                   messageId:
-                    type: string
+                    anyOf:
+                      - type: string
+                      - type: "null"
                   source:
                     type: string
+                  stale:
+                    type: boolean
                 required:
                   - suggestion
                   - messageId
                   - source
                 additionalProperties: false
+      parameters:
+        - name: conversationId
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Conversation ID to fetch a suggestion for. Either this or conversationKey is required.
+        - name: conversationKey
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Legacy conversation key. Either this or conversationId is required.
+        - name: messageId
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Optional. Latest assistant message ID the client has seen — used to detect staleness.
   /v1/surface-actions:
     post:
       operationId: surfaceactions_post