@vellumai/assistant 0.10.7-dev.202607100313.fffdfea → 0.10.7-dev.202607100720.fba456e

package/openapi.yaml

@@ -13795,6 +13795,96 @@ paths:
                   - images
                   - resolvedModel
                 additionalProperties: false
+  /v1/inference/active-profile:
+    put:
+      operationId: inference_activeprofile_put
+      summary: Set the active (chat) inference profile
+      description:
+        Set llm.activeProfile after validating the name against the effective profile catalog (provider-aware
+        default expansion included). Unknown or disabled profiles are rejected so the chat-model selection cannot be
+        silently stripped on the next config load.
+      tags:
+        - inference
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                name:
+                  type: string
+                  minLength: 1
+              required:
+                - name
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                    const: true
+                  activeProfile:
+                    type: string
+                required:
+                  - ok
+                  - activeProfile
+                additionalProperties: false
+        "400":
+          description: Unknown or disabled profile name
+  /v1/inference/callsites:
+    get:
+      operationId: inference_callsites_get
+      summary: List call-site resolutions
+      description:
+        "Return the effective resolution for every LLM call site: the winning profile, its source (override /
+        active / call-site pin / shipped default), and the resolved provider/model plus notable tuning."
+      tags:
+        - inference
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  callSites:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/CallSiteResolutionSummary"
+                required:
+                  - callSites
+                additionalProperties: false
+  /v1/inference/callsites/{site}:
+    get:
+      operationId: inference_callsites_by_site_get
+      summary: Get a call-site resolution detail
+      description:
+        "Return the full resolution for one call site: the winner, the resolution chain (rungs considered and
+        skipped), the shipped default fragment, the user's pin fragment, and a preflight-derived resolution error when
+        dispatch would provably fail."
+      tags:
+        - inference
+      parameters:
+        - name: site
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/CallSiteResolutionDetail"
+        "400":
+          description: Unknown call site
   /v1/inference/chatgpt-subscription/auth:
     post:
       operationId: inference_chatgptsubscription_auth_post
@@ -13856,6 +13946,239 @@ paths:
                 required:
                   - ok
                 additionalProperties: false
+  /v1/inference/models:
+    get:
+      operationId: inference_models_get
+      summary: List inference catalog models
+      description:
+        Return every model in the code-owned provider catalog, each tagged with its provider. Optionally filter by
+        provider with ?provider=<id>.
+      tags:
+        - inference
+      parameters:
+        - name: provider
+          in: query
+          required: false
+          schema:
+            type: string
+          description:
+            "Filter by provider id. One of: anthropic, openai, gemini, ollama, fireworks, together, openrouter,
+            vercel-ai-gateway, openai-compatible, minimax, atlascloud"
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  models:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/CatalogModel"
+                required:
+                  - models
+                additionalProperties: false
+        "400":
+          description: Unknown provider filter
+  /v1/inference/profiles:
+    get:
+      operationId: inference_profiles_get
+      summary: List effective inference profiles
+      description:
+        "Return the effective profile catalog: code-defined managed defaults merged with user profiles, each
+        annotated with source and (when it has a connection) availability."
+      tags:
+        - inference
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  profiles:
+                    type: array
+                    items:
+                      $ref: "#/components/schemas/InferenceProfileSummary"
+                required:
+                  - profiles
+                additionalProperties: false
+    post:
+      operationId: inference_profiles_post
+      summary: Create an inference profile
+      description:
+        Create a validated custom profile. The provider must be a known LLM provider, the model must be in the
+        catalog (unless allowUnlisted), and a referenced connection must exist. Managed default names cannot be created.
+      tags:
+        - inference
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                name:
+                  type: string
+                  minLength: 1
+                provider:
+                  type: string
+                  minLength: 1
+                model:
+                  type: string
+                  minLength: 1
+                connection:
+                  type: string
+                  minLength: 1
+                label:
+                  type: string
+                  minLength: 1
+                effort:
+                  type: string
+                maxTokens:
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 9007199254740991
+                temperature:
+                  type: number
+                thinking:
+                  type: boolean
+                description:
+                  type: string
+                allowUnlisted:
+                  type: boolean
+              required:
+                - name
+                - provider
+                - model
+      responses:
+        "201":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/InferenceProfileWriteResult"
+        "400":
+          description: Invalid provider, uncataloged model, or missing connection
+        "409":
+          description: A profile with this name already exists
+  /v1/inference/profiles/{name}:
+    delete:
+      operationId: inference_profiles_by_name_delete
+      summary: Delete an inference profile
+      description: Delete a custom profile. Managed default profiles cannot be deleted (they are re-seeded on boot).
+      tags:
+        - inference
+      parameters:
+        - name: name
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                    const: true
+                  name:
+                    type: string
+                required:
+                  - ok
+                  - name
+                additionalProperties: false
+        "400":
+          description: Attempt to delete a managed profile
+        "404":
+          description: Profile not found
+        "409":
+          description: Profile is still referenced by activeProfile, advisorProfile, a call site, or a mix arm
+    get:
+      operationId: inference_profiles_by_name_get
+      summary: Get an effective inference profile
+      description: Return a single effective profile by name, with availability.
+      tags:
+        - inference
+      parameters:
+        - name: name
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/InferenceProfileDetail"
+        "404":
+          description: Profile not found
+    patch:
+      operationId: inference_profiles_by_name_patch
+      summary: Update an inference profile
+      description:
+        Partial update of a custom profile with the same write-time validation as create. Managed default profiles
+        are read-only.
+      tags:
+        - inference
+      parameters:
+        - name: name
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                provider:
+                  type: string
+                  minLength: 1
+                model:
+                  type: string
+                  minLength: 1
+                connection:
+                  type: string
+                  minLength: 1
+                label:
+                  type: string
+                  minLength: 1
+                effort:
+                  type: string
+                maxTokens:
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 9007199254740991
+                temperature:
+                  type: number
+                thinking:
+                  type: boolean
+                description:
+                  type: string
+                allowUnlisted:
+                  type: boolean
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/InferenceProfileWriteResult"
+        "400":
+          description: Invalid fields, or attempt to edit a managed profile
+        "404":
+          description: Profile not found
   /v1/inference/provider-connections:
     get:
       operationId: inference_providerconnections_get
@@ -16292,20 +16615,166 @@ paths:
                     additionalProperties: {}
                     description: Memory item with graph metadata
                 required:
-                  - item
+                  - item
+                additionalProperties: false
+    patch:
+      operationId: memoryitems_by_id_patch
+      summary: Update a memory item
+      description: Partially update fields on an existing memory graph node.
+      tags:
+        - memory
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                subject:
+                  type: string
+                statement:
+                  type: string
+                kind:
+                  type: string
+                status:
+                  type: string
+                importance:
+                  type: number
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  item:
+                    type: object
+                    properties: {}
+                    additionalProperties: {}
+                    description: Updated memory item
+                required:
+                  - item
+                additionalProperties: false
+        "409":
+          description: Another memory item with this content already exists
+  /v1/memory-nodes:
+    get:
+      operationId: memorynodes_get
+      summary: List memory graph nodes
+      description:
+        Return active memory graph nodes ordered by significance. With `search`, all nodes are scanned so the
+        content filter is exhaustive; without it the query is capped at `limit` rows.
+      tags:
+        - memory
+      parameters:
+        - name: search
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Filter nodes whose content contains the query
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: integer
+          description: Max results (default 50, max 200)
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  message:
+                    type: string
+                  nodes:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        id:
+                          type: string
+                        content:
+                          type: string
+                        type:
+                          type: string
+                        fidelity:
+                          type: string
+                        created:
+                          type: number
+                      required:
+                        - id
+                        - content
+                        - type
+                        - fidelity
+                        - created
+                      additionalProperties: false
+                  total:
+                    type: number
+                required:
+                  - success
+                  - message
+                  - nodes
+                  - total
+                additionalProperties: false
+  /v1/memory-nodes/delete:
+    post:
+      operationId: memorynodes_delete_post
+      summary: Delete a memory graph node by content match
+      description:
+        "Delete the single memory graph node matching `content`: a case-insensitive exact match takes priority;
+        with no exact match, a substring match is tried. Fails as `{ success: false }` when zero or multiple nodes
+        match."
+      tags:
+        - memory
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                content:
+                  type: string
+              required:
+                - content
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  message:
+                    type: string
+                required:
+                  - success
+                  - message
                 additionalProperties: false
-    patch:
-      operationId: memoryitems_by_id_patch
-      summary: Update a memory item
-      description: Partially update fields on an existing memory graph node.
+  /v1/memory-nodes/update:
+    post:
+      operationId: memorynodes_update_post
+      summary: Update a memory graph node by content match
+      description:
+        "Replace the content of the single memory graph node matching `oldContent`: a case-insensitive exact match
+        takes priority; with no exact match, a substring match is tried. Fails as `{ success: false }` when zero or
+        multiple nodes match, or when another active node already has `newContent`."
       tags:
         - memory
-      parameters:
-        - name: id
-          in: path
-          required: true
-          schema:
-            type: string
       requestBody:
         required: true
         content:
@@ -16313,16 +16782,13 @@ paths:
             schema:
               type: object
               properties:
-                subject:
-                  type: string
-                statement:
-                  type: string
-                kind:
+                oldContent:
                   type: string
-                status:
+                newContent:
                   type: string
-                importance:
-                  type: number
+              required:
+                - oldContent
+                - newContent
       responses:
         "200":
           description: Successful response
@@ -16331,16 +16797,14 @@ paths:
               schema:
                 type: object
                 properties:
-                  item:
-                    type: object
-                    properties: {}
-                    additionalProperties: {}
-                    description: Updated memory item
+                  success:
+                    type: boolean
+                  message:
+                    type: string
                 required:
-                  - item
+                  - success
+                  - message
                 additionalProperties: false
-        "409":
-          description: Another memory item with this content already exists
   /v1/memory/eval/run:
     post:
       operationId: memory_eval_run_post
@@ -30982,6 +31446,93 @@ paths:
                   - oldPath
                   - newPath
                 additionalProperties: false
+  /v1/workspace/theme:
+    get:
+      operationId: workspace_theme_get
+      summary: Get workspace theme
+      description:
+        "Return validated design-token overrides from the workspace ui/theme.json. Absent or rejected files yield
+        theme: null with the rejection reasons in issues; clients fall back to built-in theme defaults."
+      tags:
+        - workspace
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  theme:
+                    anyOf:
+                      - type: object
+                        properties:
+                          version:
+                            type: number
+                            const: 1
+                          base:
+                            type: string
+                            enum:
+                              - light
+                              - dark
+                              - velvet
+                              - system
+                          tokens:
+                            type: object
+                            properties:
+                              accent:
+                                type: string
+                                pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
+                              background:
+                                type: string
+                                pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
+                              surface:
+                                type: string
+                                pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
+                              surfaceRaised:
+                                type: string
+                                pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
+                              border:
+                                type: string
+                                pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
+                              text:
+                                type: string
+                                pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
+                              textMuted:
+                                type: string
+                                pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
+                              assistantBubbleBackground:
+                                type: string
+                                pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
+                              assistantBubbleText:
+                                type: string
+                                pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
+                              userBubbleBackground:
+                                type: string
+                                pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
+                              userBubbleText:
+                                type: string
+                                pattern: ^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$
+                            additionalProperties: false
+                        required:
+                          - version
+                        additionalProperties: false
+                      - type: "null"
+                  source:
+                    type: string
+                    enum:
+                      - workspace
+                      - invalid
+                      - none
+                  issues:
+                    type: array
+                    items:
+                      type: string
+                required:
+                  - theme
+                  - source
+                  - issues
+                additionalProperties: false
   /v1/workspace/tree:
     get:
       operationId: workspace_tree_get
@@ -32445,6 +32996,274 @@ components:
         - resolvedConnectionName
         - availability
       additionalProperties: false
+    CallSiteResolutionSummary:
+      type: object
+      properties:
+        callSite:
+          type: string
+        profile:
+          anyOf:
+            - type: string
+            - type: "null"
+        label:
+          anyOf:
+            - type: string
+            - type: "null"
+        source:
+          type: string
+          enum:
+            - override
+            - active
+            - call_site
+            - default
+        provider:
+          type: string
+        model:
+          type: string
+        effort:
+          type: string
+        maxTokens:
+          type: number
+        maxInputTokens:
+          type: number
+      required:
+        - callSite
+        - profile
+        - label
+        - source
+        - provider
+        - model
+        - effort
+        - maxTokens
+      additionalProperties: false
+    CallSiteResolutionDetail:
+      type: object
+      properties:
+        callSite:
+          type: string
+        winner:
+          type: object
+          properties:
+            profile:
+              anyOf:
+                - type: string
+                - type: "null"
+            label:
+              anyOf:
+                - type: string
+                - type: "null"
+            source:
+              type: string
+              enum:
+                - override
+                - active
+                - call_site
+                - default
+          required:
+            - profile
+            - label
+            - source
+          additionalProperties: false
+        resolved:
+          type: object
+          properties:
+            provider:
+              type: string
+            model:
+              type: string
+            maxTokens:
+              type: number
+            effort:
+              type: string
+            temperature:
+              anyOf:
+                - type: number
+                - type: "null"
+            maxInputTokens:
+              type: number
+          required:
+            - provider
+            - model
+            - maxTokens
+            - effort
+            - temperature
+          additionalProperties: false
+        resolutionChain:
+          type: array
+          items:
+            type: object
+            properties:
+              requested:
+                type: string
+              reason:
+                type: string
+                enum:
+                  - missing
+                  - disabled
+                  - incomplete
+            required:
+              - requested
+              - reason
+            additionalProperties: false
+        shippedDefault:
+          type: object
+          propertyNames:
+            type: string
+          additionalProperties: {}
+        userPin:
+          anyOf:
+            - type: object
+              propertyNames:
+                type: string
+              additionalProperties: {}
+            - type: "null"
+        resolutionError:
+          type: object
+          properties:
+            reason:
+              type: string
+            message:
+              type: string
+          required:
+            - reason
+            - message
+          additionalProperties: false
+      required:
+        - callSite
+        - winner
+        - resolved
+        - resolutionChain
+        - shippedDefault
+        - userPin
+      additionalProperties: false
+    CatalogModel:
+      type: object
+      properties:
+        provider:
+          type: string
+        id:
+          type: string
+        displayName:
+          type: string
+        contextWindowTokens:
+          type: number
+        maxOutputTokens:
+          type: number
+        supportsThinking:
+          type: boolean
+        supportsVision:
+          type: boolean
+        supportsToolUse:
+          type: boolean
+        featureFlag:
+          type: string
+      required:
+        - provider
+        - id
+        - displayName
+      additionalProperties: false
+    InferenceProfileSummary:
+      type: object
+      properties:
+        name:
+          type: string
+        label:
+          anyOf:
+            - type: string
+            - type: "null"
+        provider:
+          anyOf:
+            - type: string
+            - type: "null"
+        model:
+          anyOf:
+            - type: string
+            - type: "null"
+        status:
+          type: string
+          enum:
+            - active
+            - disabled
+        source:
+          type: string
+          enum:
+            - managed
+            - user
+        provider_connection:
+          type: string
+        availability:
+          anyOf:
+            - $ref: "#/components/schemas/ProfileConnectionAvailability"
+            - type: "null"
+      required:
+        - name
+        - label
+        - provider
+        - model
+        - status
+        - source
+        - availability
+      additionalProperties: false
+    ProfileConnectionAvailability:
+      type: object
+      properties:
+        status:
+          type: string
+          enum:
+            - ok
+            - missing_connection
+            - missing_credential
+            - provider_mismatch
+            - unsupported_auth
+            - vellum_unauthenticated
+            - unknown
+        message:
+          type: string
+      required:
+        - status
+      additionalProperties: false
+    InferenceProfileWriteResult:
+      type: object
+      properties:
+        ok:
+          type: boolean
+          const: true
+        name:
+          type: string
+        entry:
+          type: object
+          propertyNames:
+            type: string
+          additionalProperties: {}
+        warnings:
+          type: array
+          items:
+            type: string
+      required:
+        - ok
+        - name
+        - entry
+        - warnings
+      additionalProperties: false
+    InferenceProfileDetail:
+      type: object
+      properties:
+        name:
+          type: string
+        entry:
+          type: object
+          propertyNames:
+            type: string
+          additionalProperties: {}
+        availability:
+          anyOf:
+            - $ref: "#/components/schemas/ProfileConnectionAvailability"
+            - type: "null"
+      required:
+        - name
+        - entry
+        - availability
+      additionalProperties: false
     ProviderConnection:
       type: object
       properties: