@vellumai/assistant 0.11.5 → 0.11.6-staging.1

package/openapi.yaml

@@ -3,7 +3,7 @@
 openapi: 3.1.0
 info:
   title: Vellum Assistant API
-  version: 0.11.5
+  version: 0.11.6
   description: Auto-generated OpenAPI specification for the Vellum Assistant runtime HTTP server.
 servers:
   - url: http://127.0.0.1:7821
@@ -790,6 +790,13 @@ paths:
                           type: string
                         origin:
                           type: string
+                          description: '"workspace" or "plugin:<name>": where the app comes from'
+                        pinSortPosition:
+                          description: Sidebar order, ascending. Absent when the app is not pinned
+                          type: number
+                        pinColor:
+                          description: Pin colour id; absent when no colour is set
+                          type: string
                       required:
                         - id
                         - name
@@ -1025,6 +1032,62 @@ paths:
                   - html
                   - origin
                 additionalProperties: false
+  /v1/apps/{id}/pin:
+    post:
+      operationId: apps_by_id_pin_post
+      summary: Pin or unpin an app
+      description:
+        Pin an app to the sidebar, unpin it, or set the colour it is tinted with. Pin state is read back from the
+        app list as `pinSortPosition` and `pinColor`.
+      tags:
+        - apps
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                pinned:
+                  description: Pin (true) or unpin (false). Omit to leave unchanged.
+                  type: boolean
+                color:
+                  description: Colour id, or null to clear. Omit to leave unchanged.
+                  anyOf:
+                    - type: string
+                    - type: "null"
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  appId:
+                    type: string
+                  pinSortPosition:
+                    anyOf:
+                      - type: number
+                      - type: "null"
+                  pinColor:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                required:
+                  - success
+                  - appId
+                  - pinSortPosition
+                  - pinColor
+                additionalProperties: false
   /v1/apps/{id}/preview:
     get:
       operationId: apps_by_id_preview_get
@@ -4148,6 +4211,12 @@ paths:
                       type: string
                     chatType:
                       type: string
+                    conversationType:
+                      type: string
+                      enum:
+                        - dm
+                        - private
+                        - public
                     threadId:
                       type: string
                     channelName:
@@ -4360,7 +4429,17 @@ paths:
                         setupStatus:
                           anyOf:
                             - type: string
+                              enum:
+                                - not_configured
+                                - incomplete
+                                - ready
                             - type: "null"
+                        health:
+                          type: string
+                          enum:
+                            - ok
+                            - failing
+                            - unknown
                         checkedAt:
                           anyOf:
                             - type: number
@@ -4370,7 +4449,16 @@ paths:
                         reasons:
                           type: array
                           items:
-                            type: string
+                            type: object
+                            properties:
+                              code:
+                                type: string
+                              text:
+                                type: string
+                            required:
+                              - code
+                              - text
+                            additionalProperties: false
                         localChecks:
                           type: array
                           items:
@@ -4384,6 +4472,13 @@ paths:
                                 anyOf:
                                   - type: string
                                   - type: "null"
+                              indeterminate:
+                                type: boolean
+                              kind:
+                                type: string
+                                enum:
+                                  - configuration
+                                  - operational
                             required:
                               - name
                               - passed
@@ -4401,6 +4496,13 @@ paths:
                                 anyOf:
                                   - type: string
                                   - type: "null"
+                              indeterminate:
+                                type: boolean
+                              kind:
+                                type: string
+                                enum:
+                                  - configuration
+                                  - operational
                             required:
                               - name
                               - passed
@@ -4482,7 +4584,17 @@ paths:
                         setupStatus:
                           anyOf:
                             - type: string
+                              enum:
+                                - not_configured
+                                - incomplete
+                                - ready
                             - type: "null"
+                        health:
+                          type: string
+                          enum:
+                            - ok
+                            - failing
+                            - unknown
                         checkedAt:
                           anyOf:
                             - type: number
@@ -4492,7 +4604,16 @@ paths:
                         reasons:
                           type: array
                           items:
-                            type: string
+                            type: object
+                            properties:
+                              code:
+                                type: string
+                              text:
+                                type: string
+                            required:
+                              - code
+                              - text
+                            additionalProperties: false
                         localChecks:
                           type: array
                           items:
@@ -4506,6 +4627,13 @@ paths:
                                 anyOf:
                                   - type: string
                                   - type: "null"
+                              indeterminate:
+                                type: boolean
+                              kind:
+                                type: string
+                                enum:
+                                  - configuration
+                                  - operational
                             required:
                               - name
                               - passed
@@ -4523,6 +4651,13 @@ paths:
                                 anyOf:
                                   - type: string
                                   - type: "null"
+                              indeterminate:
+                                type: boolean
+                              kind:
+                                type: string
+                                enum:
+                                  - configuration
+                                  - operational
                             required:
                               - name
                               - passed
@@ -5067,6 +5202,8 @@ paths:
                 provider_connection:
                   type: string
                   minLength: 1
+                allowUnlisted:
+                  type: boolean
                 status:
                   anyOf:
                     - $ref: "#/components/schemas/ProfileStatus"
@@ -12572,9 +12709,12 @@ paths:
                         type: boolean
                       retryLastTurn:
                         type: boolean
+                      appPins:
+                        type: boolean
                     required:
                       - memoryOptOut
                       - retryLastTurn
+                      - appPins
                     additionalProperties: false
                   profiler:
                     type: object
@@ -12774,9 +12914,12 @@ paths:
                         type: boolean
                       retryLastTurn:
                         type: boolean
+                      appPins:
+                        type: boolean
                     required:
                       - memoryOptOut
                       - retryLastTurn
+                      - appPins
                     additionalProperties: false
                   profiler:
                     type: object
@@ -14929,6 +15072,38 @@ paths:
           description: Invalid fields, a profile that cannot serve requests, or attempt to edit a managed profile
         "404":
           description: Profile not found
+  /v1/inference/profiles/{name}/validate:
+    post:
+      operationId: inference_profiles_by_name_validate_post
+      summary: Probe a saved profile with one minimal request
+      description:
+        "Dispatch one minimal test request through the named profile's resolved model and connection, and classify
+        any failure by which object the user should fix (the profile vs its provider connection). Advisory: the probe
+        never mutates the profile. Returns a null check when there is no verdict to give (missing, disabled, managed, or
+        routing-identity profiles, or a probe timeout). The probe spends one tiny request on the profile's own key."
+      tags:
+        - inference
+      parameters:
+        - name: name
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  check:
+                    anyOf:
+                      - $ref: "#/components/schemas/InferenceProfileCheck"
+                      - type: "null"
+                required:
+                  - check
+                additionalProperties: false
   /v1/inference/provider-connections:
     get:
       operationId: inference_providerconnections_get
@@ -15010,7 +15185,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ProviderConnection"
+                $ref: "#/components/schemas/SavedProviderConnection"
         "400":
           description: Invalid provider or auth schema
         "409":
@@ -15121,7 +15296,7 @@ paths:
           content:
             application/json:
               schema:
-                $ref: "#/components/schemas/ProviderConnection"
+                $ref: "#/components/schemas/SavedProviderConnection"
         "400":
           description: Invalid auth schema, or attempt to change auth on a managed connection
         "404":
@@ -15468,6 +15643,67 @@ paths:
                   - localGatewayTarget
                   - success
                 additionalProperties: false
+  /v1/integrations/ingress/status:
+    get:
+      operationId: integrations_ingress_status_get
+      summary: Get ingress tunnel status
+      description:
+        Probe the configured public ingress URL and report whether a tunnel is serving this assistant.
+        `unconfigured` means no tunnel has ever been recorded (or the ingress is managed for this assistant, as it is
+        when platform-hosted or fronted by a Velay tunnel), `stopped` means a tunnel ran before and is not running now
+        (callback ingress is explicitly switched off, or its URL is gone), `healthy` means the URL answers and fronts
+        this assistant's web app, `unpairable` means it answers but does not serve that app, so a pairing link minted
+        against it would not open, `unreachable` means it does not answer, and `foreign` means it answers for a
+        different assistant. `lastTunnel` names the tunnel to restart, on the states where a recorded one applies to the
+        configured URL.
+      tags:
+        - config
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  state:
+                    type: string
+                    enum:
+                      - unconfigured
+                      - stopped
+                      - healthy
+                      - unpairable
+                      - unreachable
+                      - foreign
+                  publicBaseUrl:
+                    description: The probed URL. Set for healthy, unpairable, unreachable, and foreign.
+                    type: string
+                  lastTunnel:
+                    description:
+                      The tunnel to restart. Set on stopped whenever one is recorded, and on unpairable, unreachable and foreign
+                      when the recorded tunnel fronted the configured URL.
+                    type: object
+                    properties:
+                      provider:
+                        type: string
+                      publicBaseUrl:
+                        type: string
+                    required:
+                      - provider
+                      - publicBaseUrl
+                    additionalProperties: false
+                  servingAssistantName:
+                    description: Name the edge serves under. Set for foreign when it reports one.
+                    type: string
+                  detail:
+                    description: Short failure reason, free of the URL. Set for unreachable, and for unpairable when the edge gave one.
+                    type: string
+                  checkedAt:
+                    description: ISO-8601 instant the probe finished. Set whenever one ran.
+                    type: string
+                required:
+                  - state
+                additionalProperties: false
   /v1/integrations/oauth/start:
     post:
       operationId: integrations_oauth_start_post
@@ -17021,6 +17257,34 @@ paths:
                 required:
                   - status
                 additionalProperties: false
+  /v1/live-voice/session/end:
+    post:
+      operationId: livevoice_session_end_post
+      summary: End the active live voice session
+      description:
+        Release the assistant's single live-voice session slot, whichever client holds it. Reports whether a
+        session was actually ended; a slot already tearing down reports false, since that teardown releases it on its
+        own.
+      tags:
+        - live-voice
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ended:
+                    type: boolean
+                  sessionId:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                required:
+                  - ended
+                  - sessionId
+                additionalProperties: false
   /v1/llm-request-logs/{id}/context:
     get:
       operationId: llmrequestlogs_by_id_context_get
@@ -19054,6 +19318,7 @@ paths:
                                           - tavily
                                           - keenable
                                           - firecrawl
+                                          - fastcrw
                                       resultCount:
                                         type: number
                                       durationMs:
@@ -19106,6 +19371,7 @@ paths:
                                         enum:
                                           - default
                                           - firecrawl
+                                          - fastcrw
                                       status:
                                         type: number
                                       contentType:
@@ -19563,6 +19829,7 @@ paths:
                                                   - tavily
                                                   - keenable
                                                   - firecrawl
+                                                  - fastcrw
                                               resultCount:
                                                 type: number
                                               durationMs:
@@ -19615,6 +19882,7 @@ paths:
                                                 enum:
                                                   - default
                                                   - firecrawl
+                                                  - fastcrw
                                               status:
                                                 type: number
                                               contentType:
@@ -21083,8 +21351,9 @@ paths:
       summary: Import a .vbundle archive
       description:
         Commit a .vbundle archive import to disk — destructive. Accepts the bundle as raw bytes
-        (application/octet-stream), multipart/form-data, or a JSON body with `{ url }` carrying a signed URL the daemon
-        fetches.
+        (application/octet-stream), multipart/form-data, a JSON body with `{ url }` carrying a signed URL the daemon
+        fetches, or a JSON body with `{ path }` pointing at a file staged under the workspace `.restore-staging`
+        directory.
       tags:
         - migrations
       requestBody:
@@ -21095,11 +21364,13 @@ paths:
               type: object
               properties:
                 url:
+                  description: A signed GCS URL pointing to the .vbundle archive (JSON body path only).
                   type: string
                   format: uri
-                  description: A signed GCS URL pointing to the .vbundle archive (JSON body path only).
-              required:
-                - url
+                path:
+                  description: Workspace-relative or absolute path to a staged .vbundle under .restore-staging (JSON body path only).
+                  type: string
+                  minLength: 1
       responses:
         "200":
           description: Successful response
@@ -21182,9 +21453,23 @@ paths:
     post:
       operationId: migrations_importpreflight_post
       summary: Dry-run import analysis
-      description: Validate a .vbundle archive and return a report of what would change on import without modifying data.
+      description:
+        Validate a .vbundle archive and return a report of what would change on import without modifying data.
+        Accepts raw bytes, multipart form data, or JSON `{ path }` pointing at a file staged under the workspace
+        `.restore-staging` directory.
       tags:
         - migrations
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                path:
+                  description: Workspace-relative or absolute path to a staged .vbundle under .restore-staging (JSON body path only).
+                  type: string
+                  minLength: 1
       responses:
         "200":
           description: Successful response
@@ -24097,10 +24382,11 @@ paths:
       summary: Disable a plugin
       description:
         Disable a plugin in this workspace by dropping a `.disabled` sentinel, mirroring the CLI's `assistant
-        plugins disable <name>`. The change is honored live at read time by every tool / injector / hook gate — no
-        restart required. Broadcasts a `sync_changed` invalidation carrying the `plugins:list` tag so other clients
-        refetch `GET /v1/plugins`. An already-disabled plugin returns 409; a user plugin with no directory returns 404
-        (default plugins are stubbed on demand via the `default-` prefix); a malformed name returns 400.
+        plugins disable <name>`. Awaits the same source reconcile enable uses so the plugin's shutdown hook runs. Tools,
+        injectors, and hook gates also honor the sentinel at read time. Broadcasts a `sync_changed` invalidation
+        carrying the `plugins:list` tag so other clients refetch `GET /v1/plugins`. An already-disabled plugin returns
+        409; a user plugin with no directory returns 404 (default plugins are stubbed on demand via the `default-`
+        prefix); a malformed name returns 400.
       tags:
         - plugins
       parameters:
@@ -34445,6 +34731,10 @@ components:
             - type: string
               minLength: 1
             - type: "null"
+        allowUnlisted:
+          anyOf:
+            - type: boolean
+            - type: "null"
         status:
           anyOf:
             - anyOf:
@@ -35217,6 +35507,8 @@ components:
         provider_connection:
           type: string
           minLength: 1
+        allowUnlisted:
+          type: boolean
         status:
           anyOf:
             - $ref: "#/components/schemas/ProfileStatus"
@@ -35493,6 +35785,8 @@ components:
           anyOf:
             - $ref: "#/components/schemas/ProfileConnectionAvailability"
             - type: "null"
+        config_issue:
+          $ref: "#/components/schemas/InferenceProfileConfigIssue"
       required:
         - name
         - label
@@ -35521,6 +35815,21 @@ components:
       required:
         - status
       additionalProperties: false
+    InferenceProfileConfigIssue:
+      type: object
+      properties:
+        code:
+          type: string
+          enum:
+            - model_unknown
+            - over_output_cap
+            - no_input_room
+        message:
+          type: string
+      required:
+        - code
+        - message
+      additionalProperties: false
     InferenceProfileWriteResult:
       type: object
       properties:
@@ -35561,11 +35870,36 @@ components:
           anyOf:
             - $ref: "#/components/schemas/ProfileConnectionAvailability"
             - type: "null"
+        config_issue:
+          $ref: "#/components/schemas/InferenceProfileConfigIssue"
       required:
         - name
         - entry
         - availability
       additionalProperties: false
+    InferenceProfileCheck:
+      type: object
+      properties:
+        ok:
+          type: boolean
+        blame:
+          type: string
+          enum:
+            - profile
+            - provider
+            - transient
+            - unknown
+        reason:
+          type: string
+        detail:
+          type: string
+        connection:
+          type: string
+        message:
+          type: string
+      required:
+        - ok
+      additionalProperties: false
     ProviderConnection:
       type: object
       properties:
@@ -35613,6 +35947,78 @@ components:
         - updatedAt
         - isManaged
       additionalProperties: false
+    SavedProviderConnection:
+      type: object
+      properties:
+        name:
+          type: string
+          minLength: 1
+        provider:
+          $ref: "#/components/schemas/ConnectionProvider"
+        auth:
+          $ref: "#/components/schemas/AuthOutput"
+        label:
+          anyOf:
+            - type: string
+              minLength: 1
+            - type: "null"
+        baseUrl:
+          anyOf:
+            - type: string
+              format: uri
+            - type: "null"
+        models:
+          anyOf:
+            - type: array
+              items:
+                $ref: "#/components/schemas/ConnectionModelOutput"
+            - type: "null"
+        createdAt:
+          type: integer
+          minimum: -9007199254740991
+          maximum: 9007199254740991
+        updatedAt:
+          type: integer
+          minimum: -9007199254740991
+          maximum: 9007199254740991
+        isManaged:
+          type: boolean
+        endpoint_check:
+          $ref: "#/components/schemas/EndpointCheck"
+      required:
+        - name
+        - provider
+        - auth
+        - label
+        - baseUrl
+        - models
+        - createdAt
+        - updatedAt
+        - isManaged
+      additionalProperties: false
+    EndpointCheck:
+      type: object
+      properties:
+        ok:
+          type: boolean
+        status:
+          type: integer
+          minimum: -9007199254740991
+          maximum: 9007199254740991
+        resolved_url:
+          type: string
+        error_class:
+          type: string
+          enum:
+            - http_error
+            - timeout
+            - network
+        hint:
+          type: string
+      required:
+        - ok
+        - resolved_url
+      additionalProperties: false
     ProcessEntry:
       type: object
       properties:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/assistant",
-  "version": "0.11.5",
+  "version": "0.11.6-staging.1",
   "license": "MIT",
   "type": "module",
   "exports": {

package/scripts/sync-web-search-catalog.ts

@@ -67,6 +67,12 @@ function projectProvider(
   if (entry.privacyPolicyUrl !== undefined) {
     projected.privacyPolicyUrl = entry.privacyPolicyUrl;
   }
+  if (entry.supportsApiBase !== undefined) {
+    projected.supportsApiBase = entry.supportsApiBase;
+  }
+  if (entry.defaultApiBase !== undefined) {
+    projected.defaultApiBase = entry.defaultApiBase;
+  }
   return projected;
 }