@vellumai/assistant 0.8.3 → 0.8.4

package/openapi.yaml

@@ -3,7 +3,7 @@
 openapi: 3.0.0
 info:
   title: Vellum Assistant API
-  version: 0.8.3
+  version: 0.8.4
   description: Auto-generated OpenAPI specification for the Vellum Assistant runtime HTTP server.
 servers:
   - url: http://127.0.0.1:7821
@@ -4219,6 +4219,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
@@ -4370,6 +4391,51 @@ paths:
               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,6 +5058,57 @@ paths:
                 includeArchived:
                   type: boolean
               additionalProperties: false
+  /v1/conversations/cli/slack/detach:
+    post:
+      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
+          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
@@ -6593,6 +6710,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
@@ -7358,6 +7737,14 @@ paths:
                     type: object
                     properties: {}
                     additionalProperties: {}
+                  ces:
+                    type: object
+                    properties:
+                      connected:
+                        type: boolean
+                    required:
+                      - connected
+                    additionalProperties: false
                   profiler:
                     type: object
                     properties:
@@ -7441,6 +7828,7 @@ paths:
                   - memory
                   - cpu
                   - migrations
+                  - ces
                 additionalProperties: false
   /v1/healthz:
     get:
@@ -7479,6 +7867,14 @@ paths:
                     type: object
                     properties: {}
                     additionalProperties: {}
+                  ces:
+                    type: object
+                    properties:
+                      connected:
+                        type: boolean
+                    required:
+                      - connected
+                    additionalProperties: false
                   profiler:
                     type: object
                     properties:
@@ -7562,6 +7958,7 @@ paths:
                   - memory
                   - cpu
                   - migrations
+                  - ces
                 additionalProperties: false
   /v1/heartbeat/checklist:
     get:
@@ -8806,6 +9203,68 @@ paths:
       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:
+        - inference
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  authorize_url:
+                    type: string
+                  state:
+                    type: string
+                required:
+                  - authorize_url
+                  - state
+                additionalProperties: false
+  /v1/inference/chatgpt-subscription/auth/exchange:
+    post:
+      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:
+        - 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
@@ -9720,6 +10179,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 +10465,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
@@ -10598,6 +11054,28 @@ paths:
               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
@@ -10636,6 +11114,55 @@ paths:
               type: object
               properties: {}
               additionalProperties: false
+  /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:
+                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
+              additionalProperties: false
   /v1/memory/v2/validate:
     post:
       operationId: memory_v2_validate_post
@@ -10861,6 +11388,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 +11910,8 @@ paths:
                   type: string
                 throwOnError:
                   type: boolean
+                originatingConversationId:
+                  type: string
               required:
                 - sourceEventName
                 - sourceChannel
@@ -12532,6 +13083,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