@vellumai/assistant 0.11.0 → 0.11.1-dev.202608010047.2cfe358

package/openapi.yaml

@@ -3,7 +3,7 @@
 openapi: 3.1.0
 info:
   title: Vellum Assistant API
-  version: 0.11.0
+  version: 0.11.1
   description: Auto-generated OpenAPI specification for the Vellum Assistant runtime HTTP server.
 servers:
   - url: http://127.0.0.1:7821
@@ -4743,6 +4743,12 @@ paths:
                     - fireworks
                     - openrouter
                     - vellum
+                    - together
+                    - vercel-ai-gateway
+                    - minimax
+                    - atlascloud
+                    - baseten
+                    - poolside
                 connectionName:
                   type: string
                   minLength: 1
@@ -6126,6 +6132,9 @@ paths:
                 placeholder:
                   description: Placeholder text for the address input field.
                   type: string
+                defaultValue:
+                  description: Suggested address to pre-fill the input with (e.g. a known email). The user can edit it before submitting.
+                  type: string
                 label:
                   description: Display label shown in the prompt UI.
                   type: string
@@ -8264,7 +8273,10 @@ paths:
     post:
       operationId: conversations_import_post
       summary: Import conversations
-      description: Import conversations from a standard JSON payload.
+      description:
+        Import conversations from a standard JSON payload. Created conversations record a provenance source of
+        `import:<provider>` derived from the `sourceKey` prefix (e.g. `chatgpt:abc123` -> `import:chatgpt`), or
+        `import:unknown` when no prefix is present.
       tags:
         - conversations
       requestBody:
@@ -11875,6 +11887,11 @@ paths:
                           type: string
                         name:
                           type: string
+                        icon:
+                          description: Client-chosen icon name; null when the group has none
+                          anyOf:
+                            - type: string
+                            - type: "null"
                         sortPosition:
                           type: number
                         isSystemGroup:
@@ -11904,6 +11921,11 @@ paths:
                 name:
                   type: string
                   description: Group name
+                icon:
+                  description: Client-chosen icon name
+                  anyOf:
+                    - type: string
+                    - type: "null"
               required:
                 - name
       responses:
@@ -11918,6 +11940,11 @@ paths:
                     type: string
                   name:
                     type: string
+                  icon:
+                    description: Client-chosen icon name; null when the group has none
+                    anyOf:
+                      - type: string
+                      - type: "null"
                   sortPosition:
                     type: number
                   isSystemGroup:
@@ -11953,7 +11980,7 @@ paths:
     patch:
       operationId: groups_by_groupId_patch
       summary: Update group
-      description: Update a conversation group's name or sort position.
+      description: Update a conversation group's name, icon, or sort position.
       tags:
         - groups
       parameters:
@@ -11971,6 +11998,11 @@ paths:
               properties:
                 name:
                   type: string
+                icon:
+                  description: Client-chosen icon name; null clears it
+                  anyOf:
+                    - type: string
+                    - type: "null"
                 sortPosition:
                   type: number
       responses:
@@ -11985,6 +12017,11 @@ paths:
                     type: string
                   name:
                     type: string
+                  icon:
+                    description: Client-chosen icon name; null when the group has none
+                    anyOf:
+                      - type: string
+                      - type: "null"
                   sortPosition:
                     type: number
                   isSystemGroup:
@@ -13621,6 +13658,7 @@ paths:
               properties:
                 requestId:
                   type: string
+                  minLength: 1
                   description: Pending app-control request ID
                 state:
                   type: string
@@ -13690,13 +13728,17 @@ paths:
               properties:
                 requestId:
                   type: string
+                  minLength: 1
                   description: Pending bash request ID
                 stdout:
                   type: string
                 stderr:
                   type: string
                 exitCode:
-                  type: number
+                  anyOf:
+                    - type: number
+                    - type: "null"
+                  description: Process exit status, or null when terminated by a signal
                 timedOut:
                   type: boolean
               required:
@@ -13859,6 +13901,7 @@ paths:
               properties:
                 requestId:
                   type: string
+                  minLength: 1
                   description: Pending CU request ID
                 axTree:
                   type: string
@@ -13926,6 +13969,7 @@ paths:
               properties:
                 requestId:
                   type: string
+                  minLength: 1
                   description: Pending request ID to resolve
                 content:
                   type: string
@@ -14807,6 +14851,25 @@ paths:
                     properties:
                       resolved_endpoint:
                         type: string
+                      resolved_url:
+                        type: string
+                      model_id:
+                        type: string
+                      connection_name:
+                        type: string
+                      http_status:
+                        type: number
+                      upstream_error_body:
+                        type: string
+                      upstream_error_body_state:
+                        type: string
+                        enum:
+                          - captured
+                          - empty
+                          - truncated
+                          - unavailable
+                      upstream_error_body_bytes:
+                        type: number
                     additionalProperties: false
                 required:
                   - response
@@ -17697,6 +17760,88 @@ paths:
                   - confident
                   - notes
                 additionalProperties: false
+  /v1/memory/ingest:
+    post:
+      operationId: memory_ingest_post
+      summary:
+        Batch-ingest fully-formed concept pages directly into memory/concepts/ (bypassing the consolidation buffer) and
+        enqueue reindex jobs
+      tags:
+        - memory
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                pages:
+                  minItems: 1
+                  maxItems: 200
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      slug:
+                        type: string
+                      content:
+                        type: string
+                    required:
+                      - slug
+                      - content
+                dryRun:
+                  type: boolean
+                overwrite:
+                  type: boolean
+              required:
+                - pages
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  results:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        slug:
+                          type: string
+                        action:
+                          type: string
+                          enum:
+                            - written
+                            - skipped_exists
+                            - invalid
+                        warnings:
+                          type: array
+                          items:
+                            type: string
+                        error:
+                          type: string
+                      required:
+                        - slug
+                        - action
+                        - warnings
+                      additionalProperties: false
+                  written:
+                    type: number
+                  skipped:
+                    type: number
+                  invalid:
+                    type: number
+                  dryRun:
+                    type: boolean
+                required:
+                  - results
+                  - written
+                  - skipped
+                  - invalid
+                  - dryRun
+                additionalProperties: false
   /v1/memory/remember:
     post:
       operationId: memory_remember_post
@@ -18573,6 +18718,7 @@ paths:
                                           - brave
                                           - perplexity
                                           - tavily
+                                          - keenable
                                           - firecrawl
                                       resultCount:
                                         type: number
@@ -19011,6 +19157,7 @@ paths:
                                                   - brave
                                                   - perplexity
                                                   - tavily
+                                                  - keenable
                                                   - firecrawl
                                               resultCount:
                                                 type: number
@@ -20312,7 +20459,9 @@ paths:
     delete:
       operationId: messages_queued_by_id_delete
       summary: Delete a queued message
-      description: Remove a pending message from the conversation queue before it is processed.
+      description:
+        Remove a pending message from the conversation queue before it is processed. Broadcasts
+        `message_queued_deleted` so every client can close out the pending row.
       tags:
         - messages
       parameters:
@@ -20330,6 +20479,10 @@ paths:
       responses:
         "200":
           description: Successful response
+        "403":
+          description: The queued message was enqueued by a different actor principal.
+        "404":
+          description: Conversation or queued message not found.
   /v1/messages/queued/{id}/steer:
     post:
       operationId: messages_queued_by_id_steer_post
@@ -22612,6 +22765,172 @@ paths:
                   - disconnected
                   - previousBaseUrl
                 additionalProperties: false
+  /v1/platform/invoices:
+    get:
+      operationId: platform_invoices_get
+      summary: List one page of the organization's Stripe invoices
+      description:
+        Fetches one page of the org's Stripe invoice history (newest first) from the platform billing invoices
+        endpoint. Amounts are in the currency's minor units. When has_more is true, pass the last invoice's id as
+        starting_after to fetch the next page.
+      tags:
+        - platform
+      parameters:
+        - name: starting_after
+          in: query
+          required: false
+          schema:
+            type: string
+          description: "Cursor: return invoices older than the invoice with this id (from the previous page's last entry)."
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  invoices:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        number:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        status:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        currency:
+                          type: string
+                        amount_due:
+                          type: number
+                        amount_paid:
+                          type: number
+                        amount_remaining:
+                          type: number
+                        created:
+                          type: number
+                        hosted_invoice_url:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        invoice_pdf:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                      required:
+                        - id
+                        - number
+                        - status
+                        - currency
+                        - amount_due
+                        - amount_paid
+                        - amount_remaining
+                        - created
+                        - hosted_invoice_url
+                        - invoice_pdf
+                      additionalProperties: false
+                  has_more:
+                    type: boolean
+                required:
+                  - invoices
+                  - has_more
+                additionalProperties: false
+  /v1/platform/invoices/{id}:
+    get:
+      operationId: platform_invoices_by_id_get
+      summary: Get a single Stripe invoice by ID
+      description:
+        Pages through the org's invoice list from the platform and returns the invoice matching the given Stripe
+        invoice ID (e.g. in_xxx). 404 if no such invoice.
+      tags:
+        - platform
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  id:
+                    type: string
+                  number:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  status:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  currency:
+                    type: string
+                  amount_due:
+                    type: number
+                  amount_paid:
+                    type: number
+                  amount_remaining:
+                    type: number
+                  created:
+                    type: number
+                  hosted_invoice_url:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  invoice_pdf:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                required:
+                  - id
+                  - number
+                  - status
+                  - currency
+                  - amount_due
+                  - amount_paid
+                  - amount_remaining
+                  - created
+                  - hosted_invoice_url
+                  - invoice_pdf
+                additionalProperties: false
+  /v1/platform/plans:
+    get:
+      operationId: platform_plans_get
+      summary: Get the plan catalog with pricing
+      description:
+        "Fetches the platform plan catalog: base and pro plans with pricing (in cents), machine/storage/credit
+        tiers, and packages."
+      tags:
+        - platform
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  plans:
+                    type: array
+                    items:
+                      type: object
+                      propertyNames:
+                        type: string
+                      additionalProperties: {}
+                required:
+                  - plans
+                additionalProperties: false
   /v1/platform/status:
     get:
       operationId: platform_status_get
@@ -22664,6 +22983,91 @@ paths:
                   - organizationId
                   - userId
                 additionalProperties: false
+  /v1/platform/subscription:
+    get:
+      operationId: platform_subscription_get
+      summary: Get the organization's current plan and subscription state
+      description:
+        Fetches the org's plan (base or pro), subscription status, renewal/period-end dates, cancellation state,
+        selected credit tier, package, and plan-gated entitlements from the platform.
+      tags:
+        - platform
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  planId:
+                    type: string
+                    enum:
+                      - base
+                      - pro
+                  status:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  renewalDate:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  currentPeriodEnd:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  cancelAtPeriodEnd:
+                    type: boolean
+                  cancelAt:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  selectedCreditTier:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                  package:
+                    anyOf:
+                      - type: object
+                        properties:
+                          key:
+                            type: string
+                          name:
+                            type: string
+                          version:
+                            type: number
+                          customized:
+                            type: boolean
+                        required:
+                          - key
+                          - name
+                          - version
+                          - customized
+                        additionalProperties: false
+                      - type: "null"
+                  entitlements:
+                    type: object
+                    properties:
+                      managedEmail:
+                        type: boolean
+                      phoneNumber:
+                        type: boolean
+                    required:
+                      - managedEmail
+                      - phoneNumber
+                    additionalProperties: false
+                required:
+                  - planId
+                  - status
+                  - renewalDate
+                  - currentPeriodEnd
+                  - cancelAtPeriodEnd
+                  - cancelAt
+                  - selectedCreditTier
+                  - package
+                  - entitlements
+                additionalProperties: false
   /v1/playground/seed-conversation:
     post:
       operationId: playground_seedconversation_post
@@ -24758,6 +25162,10 @@ paths:
                           anyOf:
                             - type: string
                             - type: "null"
+                        groupId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
                         createdFromConversationId:
                           anyOf:
                             - type: string
@@ -24823,6 +25231,7 @@ paths:
                         - retryBackoffMs
                         - timeoutMs
                         - inferenceProfile
+                        - groupId
                         - createdFromConversationId
                         - createdFromConversationExists
                         - createdFromConversationArchivedAt
@@ -24965,6 +25374,10 @@ paths:
                         anyOf:
                           - type: string
                           - type: "null"
+                      groupId:
+                        anyOf:
+                          - type: string
+                          - type: "null"
                       createdFromConversationId:
                         anyOf:
                           - type: string
@@ -25030,6 +25443,7 @@ paths:
                       - retryBackoffMs
                       - timeoutMs
                       - inferenceProfile
+                      - groupId
                       - createdFromConversationId
                       - createdFromConversationExists
                       - createdFromConversationArchivedAt
@@ -25126,6 +25540,10 @@ paths:
                           anyOf:
                             - type: string
                             - type: "null"
+                        groupId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
                         createdFromConversationId:
                           anyOf:
                             - type: string
@@ -25191,6 +25609,7 @@ paths:
                         - retryBackoffMs
                         - timeoutMs
                         - inferenceProfile
+                        - groupId
                         - createdFromConversationId
                         - createdFromConversationExists
                         - createdFromConversationArchivedAt
@@ -25284,6 +25703,10 @@ paths:
                         anyOf:
                           - type: string
                           - type: "null"
+                      groupId:
+                        anyOf:
+                          - type: string
+                          - type: "null"
                       createdFromConversationId:
                         anyOf:
                           - type: string
@@ -25349,6 +25772,7 @@ paths:
                       - retryBackoffMs
                       - timeoutMs
                       - inferenceProfile
+                      - groupId
                       - createdFromConversationId
                       - createdFromConversationExists
                       - createdFromConversationArchivedAt
@@ -25501,6 +25925,10 @@ paths:
                           anyOf:
                             - type: string
                             - type: "null"
+                        groupId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
                         createdFromConversationId:
                           anyOf:
                             - type: string
@@ -25566,6 +25994,7 @@ paths:
                         - retryBackoffMs
                         - timeoutMs
                         - inferenceProfile
+                        - groupId
                         - createdFromConversationId
                         - createdFromConversationExists
                         - createdFromConversationArchivedAt
@@ -25662,6 +26091,10 @@ paths:
                           anyOf:
                             - type: string
                             - type: "null"
+                        groupId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
                         createdFromConversationId:
                           anyOf:
                             - type: string
@@ -25727,6 +26160,7 @@ paths:
                         - retryBackoffMs
                         - timeoutMs
                         - inferenceProfile
+                        - groupId
                         - createdFromConversationId
                         - createdFromConversationExists
                         - createdFromConversationArchivedAt
@@ -25823,6 +26257,10 @@ paths:
                           anyOf:
                             - type: string
                             - type: "null"
+                        groupId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
                         createdFromConversationId:
                           anyOf:
                             - type: string
@@ -25888,6 +26326,7 @@ paths:
                         - retryBackoffMs
                         - timeoutMs
                         - inferenceProfile
+                        - groupId
                         - createdFromConversationId
                         - createdFromConversationExists
                         - createdFromConversationArchivedAt
@@ -26121,6 +26560,10 @@ paths:
                           anyOf:
                             - type: string
                             - type: "null"
+                        groupId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
                         createdFromConversationId:
                           anyOf:
                             - type: string
@@ -26186,6 +26629,7 @@ paths:
                         - retryBackoffMs
                         - timeoutMs
                         - inferenceProfile
+                        - groupId
                         - createdFromConversationId
                         - createdFromConversationExists
                         - createdFromConversationArchivedAt
@@ -26393,6 +26837,10 @@ paths:
                 properties:
                   query:
                     type: string
+                  queryTokens:
+                    type: array
+                    items:
+                      type: string
                   results:
                     type: object
                     properties:
@@ -26515,6 +26963,7 @@ paths:
                     additionalProperties: false
                 required:
                   - query
+                  - queryTokens
                   - results
                 additionalProperties: false
   /v1/secret:
@@ -29234,6 +29683,11 @@ paths:
                           type: string
                         conversationStreamingMode:
                           type: string
+                        languageSelection:
+                          type: string
+                          enum:
+                            - manual
+                            - auto
                         credentialsGuide:
                           type: string
                       required:
@@ -29346,8 +29800,8 @@ paths:
           schema:
             type: string
           description:
-            The subagent's own conversation ID. Fallback only — when the daemon knows the subagent (live or
-            rehydrated), it resolves the conversation itself and this parameter is ignored.
+            "The subagent's own conversation ID. Fallback only: when the assistant knows the subagent (live,
+            rehydrated, or in its durable records), it resolves the conversation itself and this parameter is ignored."
       responses:
         "200":
           description: Successful response
@@ -29414,6 +29868,8 @@ paths:
                     type: string
                   parentToolUseId:
                     type: string
+                  conversationId:
+                    type: string
                 required:
                   - subagentId
                   - events
@@ -29506,9 +29962,14 @@ paths:
       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,
-        with the identity fields a client needs to rebuild a store entry it never saw spawn (label, the subagent's own
-        conversation id, and the spawning tool-use id). Subagents not in the response are orphaned.
+        "Returns the subagents the assistant knows for a given parent conversation (live, rehydrated, and durably
+        recorded), including recently finished runs whose in-memory metadata the retention sweep has already evicted.
+        Durable records live as long as the conversation, so the snapshot is bounded: every subagent not in a terminal
+        state is always returned, plus the 20 most recently finished ones. Each entry carries enough detail (child
+        conversation id, label, objective, token usage, failure reason) for a client to rebuild its subagent list from
+        scratch, not just refresh statuses. A subagent absent from the response is one the assistant no longer reports,
+        so a client may settle its own stuck-active entries against this snapshot. Only `status` is guaranteed to be
+        present; every other field is optional."
       tags:
         - subagents
       parameters:
@@ -29535,12 +29996,32 @@ paths:
                       properties:
                         status:
                           type: string
+                        conversationId:
+                          type: string
                         label:
                           type: string
-                        conversationId:
+                        objective:
                           type: string
+                        isFork:
+                          type: boolean
                         parentToolUseId:
                           type: string
+                        usage:
+                          type: object
+                          properties:
+                            inputTokens:
+                              type: number
+                            outputTokens:
+                              type: number
+                            estimatedCost:
+                              type: number
+                          required:
+                            - inputTokens
+                            - outputTokens
+                            - estimatedCost
+                          additionalProperties: false
+                        error:
+                          type: string
                       required:
                         - status
                       additionalProperties: false
@@ -33341,6 +33822,12 @@ components:
                     - fireworks
                     - openrouter
                     - vellum
+                    - together
+                    - vercel-ai-gateway
+                    - minimax
+                    - atlascloud
+                    - baseten
+                    - poolside
                 connectionName:
                   type: string
                   minLength: 1
@@ -33712,6 +34199,12 @@ components:
                 - fireworks
                 - openrouter
                 - vellum
+                - together
+                - vercel-ai-gateway
+                - minimax
+                - atlascloud
+                - baseten
+                - poolside
             - type: "null"
         connectionName:
           type: string