@vellumai/assistant 0.8.1 → 0.8.3

package/openapi.yaml

@@ -3,7 +3,7 @@
 openapi: 3.0.0
 info:
   title: Vellum Assistant API
-  version: 0.8.1
+  version: 0.8.3
   description: Auto-generated OpenAPI specification for the Vellum Assistant runtime HTTP server.
 servers:
   - url: http://127.0.0.1:7821
@@ -3075,6 +3075,71 @@ paths:
           schema:
             type: string
           description: Optional channel ID filter
+  /v1/channels/available:
+    get:
+      operationId: channels_available_get
+      summary: Get available channels
+      description:
+        Return the channels this assistant can surface to clients, with display metadata (label, icon, verification
+        capability, setup copy). Today this is a fixed base list plus `email` when an inbox is registered; will become
+        plugin/skill-driven in future.
+      tags:
+        - channels
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  channels:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                          enum:
+                            - telegram
+                            - phone
+                            - vellum
+                            - whatsapp
+                            - slack
+                            - email
+                            - platform
+                            - a2a
+                        label:
+                          type: string
+                        subtitle:
+                          type: string
+                        icon:
+                          type: string
+                        supportsVerification:
+                          type: boolean
+                        setupMessages:
+                          type: object
+                          properties:
+                            guardian:
+                              type: string
+                            contact:
+                              type: string
+                          required:
+                            - guardian
+                            - contact
+                          additionalProperties: false
+                      required:
+                        - id
+                        - label
+                        - subtitle
+                        - icon
+                        - supportsVerification
+                        - setupMessages
+                      additionalProperties: false
+                    description: Available channels in display order
+                required:
+                  - channels
+                additionalProperties: false
   /v1/channels/conversation:
     delete:
       operationId: channels_conversation_delete
@@ -3550,6 +3615,95 @@ paths:
                   - ran
                   - jobId
                 additionalProperties: false
+  /v1/consolidation/runs:
+    get:
+      operationId: consolidation_runs_get
+      summary: List consolidation runs
+      description:
+        "Return recent memory v2 consolidation conversations as run records. Each consolidation dispatch creates
+        exactly one background conversation tagged with `source = memory_v2_consolidation`; that conversation IS the
+        run. Synthetic fields: `id` mirrors `conversationId` (no separate run row exists), `scheduledFor` and
+        `startedAt` both equal `conversation.createdAt` (no separate schedule timestamp), `finishedAt` is the
+        `createdAt` of the latest assistant message in the conversation (NOT `conversation.lastMessageAt`, which the
+        kickoff user prompt bumps before the agent runs). `status` is `'ok'` when the conversation has at least one
+        assistant message — i.e. positive evidence the agent emitted output — otherwise `'running'`. This is a weaker
+        signal than heartbeat's `'ok'`: without a dedicated runs table we cannot distinguish 'ran cleanly' from 'crashed
+        after emitting at least one assistant message'. `skipReason` and `error` are always null — skipped runs (lock
+        held, disabled, empty buffer) never create a conversation, and run failure detail is not stored on the
+        conversation row. Shape mirrors `heartbeat/runs` so the schedules settings UI can reuse its run-row component."
+      tags:
+        - consolidation
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  runs:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        scheduledFor:
+                          type: number
+                        startedAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        finishedAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        durationMs:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        status:
+                          type: string
+                          enum:
+                            - ok
+                            - running
+                        skipReason:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        error:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        conversationId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        createdAt:
+                          type: number
+                      required:
+                        - id
+                        - scheduledFor
+                        - startedAt
+                        - finishedAt
+                        - durationMs
+                        - status
+                        - skipReason
+                        - error
+                        - conversationId
+                        - createdAt
+                      additionalProperties: false
+                    description: Consolidation run records
+                required:
+                  - runs
+                additionalProperties: false
+      parameters:
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: integer
+          description: Max runs to return (default 20, max 100)
   /v1/contact-channels/{contactChannelId}:
     patch:
       operationId: contactchannels_by_contactChannelId_patch
@@ -4696,7 +4850,7 @@ paths:
     post:
       operationId: conversations_cli_create_post
       summary: Create a conversation (CLI)
-      description: Create a new conversation with an optional title.
+      description: Create a new conversation with an optional title and seeded messages.
       tags:
         - conversations
       responses:
@@ -4711,9 +4865,17 @@ paths:
                     type: string
                   title:
                     type: string
+                  conversationKey:
+                    type: string
+                  messagesInserted:
+                    type: integer
+                    minimum: 0
+                    maximum: 9007199254740991
                 required:
                   - id
                   - title
+                  - conversationKey
+                  - messagesInserted
                 additionalProperties: false
       requestBody:
         required: true
@@ -4724,6 +4886,22 @@ paths:
               properties:
                 title:
                   type: string
+                messages:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      role:
+                        type: string
+                        enum:
+                          - user
+                          - assistant
+                      content:
+                        type: string
+                    required:
+                      - role
+                      - content
+                    additionalProperties: false
               additionalProperties: false
   /v1/conversations/cli/export:
     post:
@@ -7773,13 +7951,29 @@ paths:
                           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
-                        - title
                         - summary
                         - timestamp
                         - status
@@ -7922,13 +8116,29 @@ paths:
                     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
-                  - title
                   - summary
                   - timestamp
                   - status
@@ -8628,6 +8838,7 @@ paths:
                             - ollama
                             - fireworks
                             - openrouter
+                            - openai-compatible
                         auth:
                           oneOf:
                             - type: object
@@ -8692,6 +8903,27 @@ paths:
                             - type: string
                               minLength: 1
                             - type: "null"
+                        baseUrl:
+                          anyOf:
+                            - type: string
+                              format: uri
+                            - type: "null"
+                        models:
+                          anyOf:
+                            - type: array
+                              items:
+                                type: object
+                                properties:
+                                  id:
+                                    type: string
+                                    minLength: 1
+                                  displayName:
+                                    type: string
+                                    minLength: 1
+                                required:
+                                  - id
+                                additionalProperties: false
+                            - type: "null"
                         createdAt:
                           type: integer
                           minimum: -9007199254740991
@@ -8708,6 +8940,8 @@ paths:
                         - auth
                         - status
                         - label
+                        - baseUrl
+                        - models
                         - createdAt
                         - updatedAt
                         - isManaged
@@ -8721,7 +8955,7 @@ paths:
           required: false
           schema:
             type: string
-          description: "Filter by provider. One of: anthropic, openai, gemini, ollama, fireworks, openrouter"
+          description: "Filter by provider. One of: anthropic, openai, gemini, ollama, fireworks, openrouter, openai-compatible"
     post:
       operationId: inference_providerconnections_post
       summary: Create a provider connection
@@ -8748,6 +8982,7 @@ paths:
                       - ollama
                       - fireworks
                       - openrouter
+                      - openai-compatible
                   auth:
                     oneOf:
                       - type: object
@@ -8812,6 +9047,27 @@ paths:
                       - type: string
                         minLength: 1
                       - type: "null"
+                  baseUrl:
+                    anyOf:
+                      - type: string
+                        format: uri
+                      - type: "null"
+                  models:
+                    anyOf:
+                      - type: array
+                        items:
+                          type: object
+                          properties:
+                            id:
+                              type: string
+                              minLength: 1
+                            displayName:
+                              type: string
+                              minLength: 1
+                          required:
+                            - id
+                          additionalProperties: false
+                      - type: "null"
                   createdAt:
                     type: integer
                     minimum: -9007199254740991
@@ -8828,6 +9084,8 @@ paths:
                   - auth
                   - status
                   - label
+                  - baseUrl
+                  - models
                   - createdAt
                   - updatedAt
                   - isManaged
@@ -8855,6 +9113,7 @@ paths:
                     - ollama
                     - fireworks
                     - openrouter
+                    - openai-compatible
                 auth:
                   oneOf:
                     - type: object
@@ -8917,6 +9176,27 @@ paths:
                   enum:
                     - active
                     - disabled
+                base_url:
+                  anyOf:
+                    - type: string
+                      format: uri
+                    - type: "null"
+                models:
+                  anyOf:
+                    - type: array
+                      items:
+                        type: object
+                        properties:
+                          id:
+                            type: string
+                            minLength: 1
+                          displayName:
+                            type: string
+                            minLength: 1
+                        required:
+                          - id
+                        additionalProperties: false
+                    - type: "null"
               required:
                 - name
                 - provider
@@ -8984,6 +9264,7 @@ paths:
                       - ollama
                       - fireworks
                       - openrouter
+                      - openai-compatible
                   auth:
                     oneOf:
                       - type: object
@@ -9048,6 +9329,27 @@ paths:
                       - type: string
                         minLength: 1
                       - type: "null"
+                  baseUrl:
+                    anyOf:
+                      - type: string
+                        format: uri
+                      - type: "null"
+                  models:
+                    anyOf:
+                      - type: array
+                        items:
+                          type: object
+                          properties:
+                            id:
+                              type: string
+                              minLength: 1
+                            displayName:
+                              type: string
+                              minLength: 1
+                          required:
+                            - id
+                          additionalProperties: false
+                      - type: "null"
                   createdAt:
                     type: integer
                     minimum: -9007199254740991
@@ -9064,6 +9366,8 @@ paths:
                   - auth
                   - status
                   - label
+                  - baseUrl
+                  - models
                   - createdAt
                   - updatedAt
                   - isManaged
@@ -9105,6 +9409,7 @@ paths:
                       - ollama
                       - fireworks
                       - openrouter
+                      - openai-compatible
                   auth:
                     oneOf:
                       - type: object
@@ -9169,6 +9474,27 @@ paths:
                       - type: string
                         minLength: 1
                       - type: "null"
+                  baseUrl:
+                    anyOf:
+                      - type: string
+                        format: uri
+                      - type: "null"
+                  models:
+                    anyOf:
+                      - type: array
+                        items:
+                          type: object
+                          properties:
+                            id:
+                              type: string
+                              minLength: 1
+                            displayName:
+                              type: string
+                              minLength: 1
+                          required:
+                            - id
+                          additionalProperties: false
+                      - type: "null"
                   createdAt:
                     type: integer
                     minimum: -9007199254740991
@@ -9185,6 +9511,8 @@ paths:
                   - auth
                   - status
                   - label
+                  - baseUrl
+                  - models
                   - createdAt
                   - updatedAt
                   - isManaged
@@ -9270,6 +9598,27 @@ paths:
                     - type: string
                       minLength: 1
                     - type: "null"
+                base_url:
+                  anyOf:
+                    - type: string
+                      format: uri
+                    - type: "null"
+                models:
+                  anyOf:
+                    - type: array
+                      items:
+                        type: object
+                        properties:
+                          id:
+                            type: string
+                            minLength: 1
+                          displayName:
+                            type: string
+                            minLength: 1
+                        required:
+                          - id
+                        additionalProperties: false
+                    - type: "null"
               required:
                 - auth
               additionalProperties: false
@@ -9333,6 +9682,64 @@ paths:
               required:
                 - message
               additionalProperties: false
+  /v1/integrations/a2a/config:
+    delete:
+      operationId: integrations_a2a_config_delete
+      summary: Disable A2A channel
+      description: Disable the A2A channel.
+      tags:
+        - integrations
+      responses:
+        "200":
+          description: Successful response
+    get:
+      operationId: integrations_a2a_config_get
+      summary: Get A2A config
+      description: Check current A2A channel configuration status.
+      tags:
+        - integrations
+      responses:
+        "200":
+          description: Successful response
+    post:
+      operationId: integrations_a2a_config_post
+      summary: Enable A2A channel
+      description: Enable the A2A channel for inter-assistant communication.
+      tags:
+        - integrations
+      responses:
+        "200":
+          description: Successful response
+  /v1/integrations/a2a/invite:
+    post:
+      operationId: integrations_a2a_invite_post
+      summary: Create A2A invite
+      description: Create a shareable A2A invite token for link-based contact creation.
+      tags:
+        - integrations
+      responses:
+        "200":
+          description: Successful response
+  /v1/integrations/a2a/invite/complete:
+    post:
+      operationId: integrations_a2a_invite_complete_post
+      summary: Complete A2A invite (sender side)
+      description: Called by the platform to finalize the sender side of a link-based A2A connection.
+      tags:
+        - integrations
+      responses:
+        "200":
+          description: Successful response
+  /v1/integrations/a2a/invite/redeem:
+    post:
+      operationId: integrations_a2a_invite_redeem_post
+      summary: Redeem A2A invite (receiver side)
+      description: Called by the platform to create a trusted contact on the receiver side of a link-based A2A connection.
+      tags:
+        - integrations
+      responses:
+        "200":
+          description: Successful response
   /v1/integrations/ingress/config:
     get:
       operationId: integrations_ingress_config_get
@@ -10920,6 +11327,7 @@ paths:
                         - low
                         - medium
                         - high
+                        - critical
                     deadlineAt:
                       type: number
                     isAsyncBackground:
@@ -11128,6 +11536,26 @@ paths:
       responses:
         "200":
           description: Successful response
+  /v1/oauth/connection-changed:
+    post:
+      operationId: oauth_connectionchanged_post
+      summary: Notify the assistant that an OAuth connection changed
+      description: Invalidates the config cache so the assistant picks up mode and credential changes immediately.
+      tags:
+        - oauth
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  refreshed:
+                    type: boolean
+                required:
+                  - refreshed
+                additionalProperties: false
   /v1/oauth/connections/{id}:
     delete:
       operationId: oauth_connections_by_id_delete
@@ -11761,6 +12189,129 @@ paths:
                       - name
                       - status
                     additionalProperties: false
+  /v1/question-response:
+    post:
+      operationId: questionresponse_post
+      summary: Resolve a pending ask-question prompt
+      description:
+        Submit the user's batched response (or close the card) for a pending question prompt by requestId. Legacy
+        single-question payloads remain accepted as syntactic sugar for a one-element batch.
+      tags:
+        - approvals
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                required:
+                  - success
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              oneOf:
+                - type: object
+                  properties:
+                    requestId:
+                      type: string
+                    kind:
+                      type: string
+                      const: submit
+                    responses:
+                      minItems: 1
+                      type: array
+                      items:
+                        oneOf:
+                          - type: object
+                            properties:
+                              questionId:
+                                type: string
+                              kind:
+                                type: string
+                                const: option
+                              optionId:
+                                type: string
+                            required:
+                              - questionId
+                              - kind
+                              - optionId
+                            additionalProperties: false
+                          - type: object
+                            properties:
+                              questionId:
+                                type: string
+                              kind:
+                                type: string
+                                const: free_text
+                              text:
+                                type: string
+                            required:
+                              - questionId
+                              - kind
+                              - text
+                            additionalProperties: false
+                          - type: object
+                            properties:
+                              questionId:
+                                type: string
+                              kind:
+                                type: string
+                                const: skip
+                            required:
+                              - questionId
+                              - kind
+                            additionalProperties: false
+                  required:
+                    - requestId
+                    - kind
+                    - responses
+                  additionalProperties: false
+                - type: object
+                  properties:
+                    requestId:
+                      type: string
+                    kind:
+                      type: string
+                      const: close
+                  required:
+                    - requestId
+                    - kind
+                  additionalProperties: false
+                - type: object
+                  properties:
+                    requestId:
+                      type: string
+                    kind:
+                      type: string
+                      const: option
+                    optionId:
+                      type: string
+                  required:
+                    - requestId
+                    - kind
+                    - optionId
+                  additionalProperties: false
+                - type: object
+                  properties:
+                    requestId:
+                      type: string
+                    kind:
+                      type: string
+                      const: free_text
+                    text:
+                      type: string
+                  required:
+                    - requestId
+                    - kind
+                    - text
+                  additionalProperties: false
   /v1/recordings/pause:
     post:
       operationId: recordings_pause_post
@@ -14117,6 +14668,20 @@ paths:
                     type: string
                   objective:
                     type: string
+                  usage:
+                    type: object
+                    properties:
+                      inputTokens:
+                        type: number
+                      outputTokens:
+                        type: number
+                      estimatedCost:
+                        type: number
+                    required:
+                      - inputTokens
+                      - outputTokens
+                      - estimatedCost
+                    additionalProperties: false
                   events:
                     type: array
                     items: {}
@@ -14223,6 +14788,45 @@ paths:
                 - conversationId
                 - content
               additionalProperties: false
+  /v1/subagents/reconcile:
+    get:
+      operationId: subagents_reconcile_get
+      summary: Reconcile subagent live status
+      description:
+        Returns the live in-memory status of all subagents known to the daemon for a given parent conversation.
+        Subagents not in the response are orphaned.
+      tags:
+        - subagents
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  subagents:
+                    type: object
+                    propertyNames:
+                      type: string
+                    additionalProperties:
+                      type: object
+                      properties:
+                        status:
+                          type: string
+                      required:
+                        - status
+                      additionalProperties: false
+                required:
+                  - subagents
+                additionalProperties: false
+      parameters:
+        - name: parentConversationId
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Parent conversation ID
   /v1/suggestion:
     get:
       operationId: suggestion_get
@@ -14752,6 +15356,39 @@ paths:
                   type: string
                   minLength: 1
               additionalProperties: false
+  /v1/telemetry/flush:
+    post:
+      operationId: telemetry_flush_post
+      summary: Flush pending telemetry events
+      description: Force-flush all pending usage, turn, and lifecycle telemetry events to the platform.
+      tags:
+        - telemetry
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                anyOf:
+                  - type: object
+                    properties:
+                      flushed:
+                        type: boolean
+                        const: true
+                    required:
+                      - flushed
+                    additionalProperties: false
+                  - type: object
+                    properties:
+                      flushed:
+                        type: boolean
+                        const: false
+                      reason:
+                        type: string
+                    required:
+                      - flushed
+                      - reason
+                    additionalProperties: false
   /v1/telemetry/lifecycle:
     post:
       operationId: telemetry_lifecycle_post