@vellumai/assistant 0.8.3 → 0.8.5

package/openapi.yaml

@@ -3,7 +3,7 @@
 openapi: 3.0.0
 info:
   title: Vellum Assistant API
-  version: 0.8.3
+  version: 0.8.5
   description: Auto-generated OpenAPI specification for the Vellum Assistant runtime HTTP server.
 servers:
   - url: http://127.0.0.1:7821
@@ -1823,6 +1823,247 @@ 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:
+                  leaseId:
+                    type: string
+                  reason:
+                    type: string
+                  sourceGeneration:
+                    type: string
+                  startedAt:
+                    type: number
+                  deadlineAt:
+                    type: number
+                  counts:
+                    type: object
+                    properties:
+                      heartbeat:
+                        type: number
+                      scheduler:
+                        type: number
+                      total:
+                        type: number
+                    required:
+                      - heartbeat
+                      - scheduler
+                      - total
+                    additionalProperties: false
+                  nextIntent:
+                    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:
+                  - leaseId
+                  - reason
+                  - sourceGeneration
+                  - startedAt
+                  - deadlineAt
+                  - counts
+                  - nextIntent
+                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 +2793,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 +3731,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
@@ -4219,6 +4552,27 @@ paths:
                 limit:
                   type: number
               additionalProperties: false
+  /v1/content-source:
+    post:
+      operationId: contentsource_post
+      summary: Validate and persist a content source URL
+      tags:
+        - content-source
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                url:
+                  type: string
+              required:
+                - url
+              additionalProperties: false
   /v1/conversation-starters:
     get:
       operationId: conversationstarters_get
@@ -4341,8 +4695,10 @@ paths:
                 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:
@@ -4361,15 +4717,61 @@ 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:
+      operationId: conversations_by_conversationId_slackchannel_resolve_post
+      summary: Resolve Slack channel name
+      description: Resolve and persist a friendly Slack channel name for an external conversation binding.
+      tags:
+        - conversations
+        - slack
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  channelId:
+                    type: string
+                  channelName:
+                    type: string
+                  cached:
+                    type: boolean
+                  resolved:
+                    type: boolean
+                  reason:
+                    type: string
+                    enum:
+                      - auth
+                      - dm
+                      - no_name
+                      - not_found
+                      - permission
+                      - rate_limit
+                      - slack_error
+                required:
+                  - channelId
+                  - cached
+                  - resolved
+                additionalProperties: false
+      parameters:
+        - name: conversationId
+          in: path
+          required: true
+          schema:
+            type: string
   /v1/conversations/{id}:
     delete:
       operationId: conversations_by_id_delete
@@ -4992,22 +5394,73 @@ paths:
                 includeArchived:
                   type: boolean
               additionalProperties: false
-  /v1/conversations/fork:
+  /v1/conversations/cli/slack/detach:
     post:
-      operationId: conversations_fork_post
-      summary: Fork a conversation
-      description: Create a copy of a conversation, optionally truncated at a specific message.
+      operationId: conversations_cli_slack_detach_post
+      summary: Detach the assistant from a Slack thread (CLI)
+      description: Stops Slack active-thread listening for a Slack thread. The CLI resolves current conversation defaults.
       tags:
         - conversations
       responses:
         "200":
           description: Successful response
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  detached:
+                    type: boolean
+                  channelId:
+                    type: string
+                  threadTs:
+                    type: string
+                  source:
+                    type: string
+                    enum:
+                      - explicit
+                      - conversation_binding
+                  conversationId:
+                    type: string
+                required:
+                  - 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
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
               properties:
                 conversationId:
                   type: string
@@ -5315,6 +5768,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
@@ -6221,6 +6744,7 @@ paths:
                         enum:
                           - disabled
                           - ok
+                          - warning
                           - critical
                           - unknown
                       locked:
@@ -6306,6 +6830,7 @@ paths:
                         enum:
                           - disabled
                           - ok
+                          - warning
                           - critical
                           - unknown
                       locked:
@@ -6407,6 +6932,7 @@ paths:
                         enum:
                           - disabled
                           - ok
+                          - warning
                           - critical
                           - unknown
                       locked:
@@ -6593,6 +7119,268 @@ paths:
           required: true
           schema:
             type: string
+  /v1/documents/{id}/comments:
+    get:
+      operationId: documents_by_id_comments_get
+      summary: List comments for a document
+      description: Return comments for a document, optionally filtered by status.
+      tags:
+        - documents
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  comments:
+                    type: array
+                    items: {}
+                    description: Comment records
+                required:
+                  - comments
+                additionalProperties: false
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: status
+          in: query
+          required: false
+          schema:
+            type: string
+            enum:
+              - open
+              - resolved
+              - all
+          description: "Filter by comment status (default: all)"
+    post:
+      operationId: documents_by_id_comments_post
+      summary: Create a comment on a document
+      description: Add a new comment to a document.
+      tags:
+        - documents
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  id:
+                    type: string
+                  surfaceId:
+                    type: string
+                  conversationId:
+                    type: string
+                  author:
+                    type: string
+                  content:
+                    type: string
+                  status:
+                    type: string
+                  createdAt:
+                    type: number
+                  updatedAt:
+                    type: number
+                required:
+                  - id
+                  - surfaceId
+                  - conversationId
+                  - author
+                  - content
+                  - status
+                  - createdAt
+                  - updatedAt
+                additionalProperties: false
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                content:
+                  type: string
+                  minLength: 1
+                  description: Comment text content
+                author:
+                  default: user
+                  description: Comment author
+                  type: string
+                  const: user
+                anchorStart:
+                  description: Selection start offset
+                  anyOf:
+                    - type: number
+                    - type: "null"
+                anchorEnd:
+                  description: Selection end offset
+                  anyOf:
+                    - type: number
+                    - type: "null"
+                anchorText:
+                  description: Anchored text snippet
+                  anyOf:
+                    - type: string
+                    - type: "null"
+                parentCommentId:
+                  description: Parent comment ID for replies
+                  anyOf:
+                    - type: string
+                    - type: "null"
+                conversationId:
+                  type: string
+                  description: Owning conversation ID
+              required:
+                - content
+                - conversationId
+              additionalProperties: false
+  /v1/documents/{id}/comments/{commentId}:
+    delete:
+      operationId: documents_by_id_comments_by_commentId_delete
+      summary: Delete a document comment
+      description: Permanently delete a comment.
+      tags:
+        - documents
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                    const: true
+                required:
+                  - success
+                additionalProperties: false
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: commentId
+          in: path
+          required: true
+          schema:
+            type: string
+    patch:
+      operationId: documents_by_id_comments_by_commentId_patch
+      summary: Update a document comment
+      description: Update the status or content of a comment.
+      tags:
+        - documents
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  id:
+                    type: string
+                  surfaceId:
+                    type: string
+                  content:
+                    type: string
+                  status:
+                    type: string
+                  updatedAt:
+                    type: number
+                required:
+                  - id
+                  - surfaceId
+                  - content
+                  - status
+                  - updatedAt
+                additionalProperties: false
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: commentId
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                status:
+                  description: New comment status
+                  type: string
+                  enum:
+                    - open
+                    - resolved
+                content:
+                  description: Updated comment text
+                  type: string
+                  minLength: 1
+                resolvedBy:
+                  description: Who resolved the comment
+                  type: string
+              additionalProperties: false
+  /v1/documents/{id}/conversations:
+    post:
+      operationId: documents_by_id_conversations_post
+      summary: Link a document to a conversation
+      description: Associate a document with a conversation so the assistant sees it as context.
+      tags:
+        - documents
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                    const: true
+                required:
+                  - success
+                additionalProperties: false
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                conversationId:
+                  type: string
+                  description: Conversation to link
+              required:
+                - conversationId
+              additionalProperties: false
   /v1/documents/{id}/pdf:
     get:
       operationId: documents_by_id_pdf_get
@@ -6627,6 +7415,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
@@ -6948,12 +7745,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
@@ -7358,6 +8163,14 @@ paths:
                     type: object
                     properties: {}
                     additionalProperties: {}
+                  ces:
+                    type: object
+                    properties:
+                      connected:
+                        type: boolean
+                    required:
+                      - connected
+                    additionalProperties: false
                   profiler:
                     type: object
                     properties:
@@ -7441,6 +8254,7 @@ paths:
                   - memory
                   - cpu
                   - migrations
+                  - ces
                 additionalProperties: false
   /v1/healthz:
     get:
@@ -7479,6 +8293,14 @@ paths:
                     type: object
                     properties: {}
                     additionalProperties: {}
+                  ces:
+                    type: object
+                    properties:
+                      connected:
+                        type: boolean
+                    required:
+                      - connected
+                    additionalProperties: false
                   profiler:
                     type: object
                     properties:
@@ -7562,6 +8384,7 @@ paths:
                   - memory
                   - cpu
                   - migrations
+                  - ces
                 additionalProperties: false
   /v1/heartbeat/checklist:
     get:
@@ -8570,6 +9393,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:
@@ -8779,10 +9605,42 @@ paths:
       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.
+        Returns a deterministic greeting derived from the assistant name in IDENTITY.md, falling back to
+        LLM-generated cache.
+      tags:
+        - identity
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  text:
+                    type: string
+                required:
+                  - text
+                additionalProperties: false
+  /v1/image-generation/generate:
+    post:
+      operationId: imagegeneration_generate_post
+      summary: Generate or edit images using AI
+      description: Calls the configured image-generation provider (Gemini or OpenAI) to produce one or more images.
+      tags:
+        - image-generation
+      responses:
+        "200":
+          description: Successful response
+  /v1/inference/chatgpt-subscription/auth:
+    post:
+      operationId: inference_chatgptsubscription_auth_post
+      summary: Start ChatGPT subscription OAuth PKCE flow
+      description:
+        Generate a PKCE authorize URL for ChatGPT subscription auth. Returns the URL and state for the client to
+        open in a browser.
       tags:
-        - identity
+        - inference
       responses:
         "200":
           description: Successful response
@@ -8791,21 +9649,51 @@ paths:
               schema:
                 type: object
                 properties:
-                  text:
+                  authorize_url:
+                    type: string
+                  state:
                     type: string
                 required:
-                  - text
+                  - authorize_url
+                  - state
                 additionalProperties: false
-  /v1/image-generation/generate:
+  /v1/inference/chatgpt-subscription/auth/exchange:
     post:
-      operationId: imagegeneration_generate_post
-      summary: Generate or edit images using AI
-      description: Calls the configured image-generation provider (Gemini or OpenAI) to produce one or more images.
+      operationId: inference_chatgptsubscription_auth_exchange_post
+      summary: Exchange ChatGPT subscription OAuth authorization code
+      description:
+        Accept an authorization code and state from the OAuth redirect, exchange it for tokens, store them in CES,
+        and upsert the provider connection.
       tags:
-        - image-generation
+        - inference
       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:
+                code:
+                  type: string
+                state:
+                  type: string
+              required:
+                - code
+                - state
+              additionalProperties: false
   /v1/inference/provider-connections:
     get:
       operationId: inference_providerconnections_get
@@ -8839,6 +9727,7 @@ paths:
                             - fireworks
                             - openrouter
                             - openai-compatible
+                            - minimax
                         auth:
                           oneOf:
                             - type: object
@@ -8955,7 +9844,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
@@ -8983,6 +9874,7 @@ paths:
                       - fireworks
                       - openrouter
                       - openai-compatible
+                      - minimax
                   auth:
                     oneOf:
                       - type: object
@@ -9114,6 +10006,7 @@ paths:
                     - fireworks
                     - openrouter
                     - openai-compatible
+                    - minimax
                 auth:
                   oneOf:
                     - type: object
@@ -9265,6 +10158,7 @@ paths:
                       - fireworks
                       - openrouter
                       - openai-compatible
+                      - minimax
                   auth:
                     oneOf:
                       - type: object
@@ -9410,6 +10304,7 @@ paths:
                       - fireworks
                       - openrouter
                       - openai-compatible
+                      - minimax
                   auth:
                     oneOf:
                       - type: object
@@ -9720,6 +10615,18 @@ paths:
       responses:
         "200":
           description: Successful response
+  /v1/integrations/a2a/invite/accept:
+    post:
+      operationId: integrations_a2a_invite_accept_post
+      summary: Accept A2A invite (self-hosted broker)
+      description:
+        Orchestrate cross-daemon invite acceptance for self-hosted deployments. Calls the sender's invite/complete,
+        then creates a local contact via invite/redeem.
+      tags:
+        - integrations
+      responses:
+        "200":
+          description: Successful response
   /v1/integrations/a2a/invite/complete:
     post:
       operationId: integrations_a2a_invite_complete_post
@@ -9994,21 +10901,6 @@ paths:
       responses:
         "200":
           description: Successful response
-  /v1/interfaces/{path}:
-    get:
-      operationId: interfaces_by_path_get
-      summary: Serve an interface definition file
-      tags:
-        - interfaces
-      responses:
-        "200":
-          description: Successful response
-      parameters:
-        - name: path
-          in: path
-          required: true
-          schema:
-            type: string
   /v1/internal/mcp/add:
     post:
       operationId: internal_mcp_add_post
@@ -10535,24 +11427,273 @@ paths:
               properties:
                 op:
                   type: string
-                  enum:
-                    - migrate
-                    - reembed
-                    - activation-recompute
-                force:
-                  type: boolean
+                  enum:
+                    - migrate
+                    - reembed
+                    - activation-recompute
+                force:
+                  type: boolean
+              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
+      summary: Aggregate per-concept injection frequency from activation logs
+      description:
+        "Debug-only. Aggregates the existing memory_v2_activation_logs table by (slug, status) and cross-references
+        on-disk concept pages so an operator can see which concepts get injected often, which get scored but rejected,
+        and which on-disk pages never even surface as candidates. Optional filters: conversationId narrows to a single
+        conversation; sinceMs restricts to logs created at-or-after the given epoch ms timestamp."
+      tags:
+        - memory
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                conversationId:
+                  type: string
+                  minLength: 1
+                sinceMs:
+                  type: integer
+                  minimum: 0
+                  maximum: 9007199254740991
+              additionalProperties: false
+  /v1/memory/v2/concept-page:
+    post:
+      operationId: memory_v2_conceptpage_post
+      summary: Read a single memory v2 concept page
+      description:
+        Returns the rendered (frontmatter + body) markdown for a slug. 404 when the slug has no on-disk page — the
+        activation log inspector uses this to show what got injected.
+      tags:
+        - memory
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                slug:
+                  type: string
+                  minLength: 1
+              required:
+                - slug
+              additionalProperties: false
+  /v1/memory/v2/ema-scores:
+    post:
+      operationId: memory_v2_emascores_post
+      summary: List every concept page with its injection-frequency EMA score
+      description:
+        Computes the time-decayed injection frequency (3-day half-life) for every entry in the current page index
+        by reading memory_v2_injection_events. Returns entries sorted by score descending then slug ASCII, including
+        zero-score pages so callers can decide whether to filter. Read-only; tier 2 of the v4 router uses the same
+        computation to pick its top-M.
+      tags:
+        - memory
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties: {}
+              additionalProperties: false
+  /v1/memory/v2/list-concept-pages:
+    post:
+      operationId: memory_v2_listconceptpages_post
+      summary: List all memory v2 concept pages with metadata
+      description:
+        Returns slugs, body sizes, edge counts, and last-modified timestamps for every concept page on disk.
+        Read-only; used by the desktop About → Memories surface to render a browse-able list.
+      tags:
+        - memory
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              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
+      summary: Re-seed v2 skill entries from the current skill catalog
+      description: Synchronously re-runs seedV2SkillEntries against the current skill catalog. Gated on config.memory.v2.enabled.
+      tags:
+        - memory
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              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:
-                - op
+                - recentTurnPairs
               additionalProperties: false
-  /v1/memory/v2/concept-frequency:
+  /v1/memory/v2/validate:
     post:
-      operationId: memory_v2_conceptfrequency_post
-      summary: Aggregate per-concept injection frequency from activation logs
+      operationId: memory_v2_validate_post
+      summary: Validate memory v2 workspace state
       description:
-        "Debug-only. Aggregates the existing memory_v2_activation_logs table by (slug, status) and cross-references
-        on-disk concept pages so an operator can see which concepts get injected often, which get scored but rejected,
-        and which on-disk pages never even surface as candidates. Optional filters: conversationId narrows to a single
-        conversation; sinceMs restricts to logs created at-or-after the given epoch ms timestamp."
+        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:
@@ -10564,22 +11705,19 @@ paths:
           application/json:
             schema:
               type: object
-              properties:
-                conversationId:
-                  type: string
-                  minLength: 1
-                sinceMs:
-                  type: integer
-                  minimum: 0
-                  maximum: 9007199254740991
+              properties: {}
               additionalProperties: false
-  /v1/memory/v2/concept-page:
+  /v1/memory/v3/simulate:
     post:
-      operationId: memory_v2_conceptpage_post
-      summary: Read a single memory v2 concept page
+      operationId: memory_v3_simulate_post
+      summary: Dry-run the v3 retrieval loop against an ad-hoc query (read-only)
       description:
-        Returns the rendered (frontmatter + body) markdown for a slug. 404 when the slug has no on-disk page — the
-        activation log inspector uses this to show what got injected.
+        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:
@@ -10592,37 +11730,36 @@ paths:
             schema:
               type: object
               properties:
-                slug:
+                query:
                   type: string
                   minLength: 1
+                nowText:
+                  type: string
+                passCap:
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 9007199254740991
+                lanes:
+                  type: array
+                  items:
+                    type: string
+                    enum:
+                      - hot
+                      - sparse
+                      - dense
+                      - tree
+                      - edges
               required:
-                - slug
+                - query
               additionalProperties: false
-  /v1/memory/v2/list-concept-pages:
+  /v1/memory/v3/tree:
     post:
-      operationId: memory_v2_listconceptpages_post
-      summary: List all memory v2 concept pages with metadata
+      operationId: memory_v3_tree_post
+      summary: Return a serializable view of the memory v3 tree DAG (read-only)
       description:
-        Returns slugs, body sizes, edge counts, and last-modified timestamps for every concept page on disk.
-        Read-only; used by the desktop About → Memories surface to render a browse-able list.
-      tags:
-        - memory
-      responses:
-        "200":
-          description: Successful response
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties: {}
-              additionalProperties: false
-  /v1/memory/v2/reembed-skills:
-    post:
-      operationId: memory_v2_reembedskills_post
-      summary: Re-seed v2 skill entries from the current skill catalog
-      description: Synchronously re-runs seedV2SkillEntries against the current skill catalog. Gated on config.memory.v2.enabled.
+        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:
@@ -10636,13 +11773,14 @@ paths:
               type: object
               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:
@@ -10861,6 +11999,28 @@ paths:
           schema:
             type: string
           description: Conversation ID (required)
+  /v1/messages/queued/{id}/steer:
+    post:
+      operationId: messages_queued_by_id_steer_post
+      summary: Steer to a queued message
+      description: Promote a queued message to the head of the queue and abort the current generation so it is processed next.
+      tags:
+        - messages
+      responses:
+        "200":
+          description: Successful response
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: conversationId
+          in: query
+          required: true
+          schema:
+            type: string
+          description: Conversation ID (required)
   /v1/migrations/export:
     post:
       operationId: migrations_export_post
@@ -11361,6 +12521,8 @@ paths:
                   type: string
                 throwOnError:
                   type: boolean
+                originatingConversationId:
+                  type: string
               required:
                 - sourceEventName
                 - sourceChannel
@@ -11971,6 +13133,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
@@ -12532,6 +13856,49 @@ paths:
       responses:
         "200":
           description: Successful response
+  /v1/sanity/connect:
+    post:
+      operationId: sanity_connect_post
+      summary: Finalise Sanity connection and write sidecar file
+      tags:
+        - sanity
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                projectId:
+                  type: string
+                dataset:
+                  type: string
+              required:
+                - projectId
+                - dataset
+              additionalProperties: false
+  /v1/sanity/discover:
+    post:
+      operationId: sanity_discover_post
+      summary: Discover Sanity projects and datasets using the stored API token
+      tags:
+        - sanity
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                projectId:
+                  type: string
+              additionalProperties: false
   /v1/schedules:
     get:
       operationId: schedules_get
@@ -14843,16 +16210,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