@vellumai/assistant 0.11.7 → 0.11.8-staging.1

package/openapi.yaml

@@ -3,7 +3,7 @@
 openapi: 3.1.0
 info:
   title: Vellum Assistant API
-  version: 0.11.7
+  version: 0.11.8
   description: Auto-generated OpenAPI specification for the Vellum Assistant runtime HTTP server.
 servers:
   - url: http://127.0.0.1:7821
@@ -467,6 +467,8 @@ paths:
                           type: string
                         parentToolUseId:
                           type: string
+                        authErrorCode:
+                          type: string
                         usedTokens:
                           type: number
                         contextSize:
@@ -4198,6 +4200,22 @@ paths:
                     - delete
                     - reaction
                     - button
+                reaction:
+                  type: object
+                  properties:
+                    op:
+                      type: string
+                      enum:
+                        - added
+                        - removed
+                    emoji:
+                      type: string
+                    targetMessageId:
+                      type: string
+                  required:
+                    - op
+                    - emoji
+                    - targetMessageId
                 isEdit:
                   type: boolean
                 callbackQueryId:
@@ -4366,6 +4384,8 @@ paths:
                       required:
                         - trustClass
                         - canonicalSenderId
+                    actorUnattributed:
+                      type: boolean
                     emailProvider:
                       type: string
                     emailSubject:
@@ -5539,6 +5559,49 @@ paths:
                   - runs
                   - nextCursor
                 additionalProperties: false
+  /v1/contact_prompt_claim:
+    post:
+      operationId: contact_prompt_claim_post
+      summary: Claim a pending contact form for one submission
+      description:
+        Marks a pending form as answered so a second client submitting the same form writes nothing. Returns
+        claimed=false with reason 'already_claimed' when somebody got there first, or 'unknown' when no such form is
+        pending. A granted claim carries the window its write has to report back in.
+      tags:
+        - contacts
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                requestId:
+                  type: string
+                  description: The pending contact_request id.
+              required:
+                - requestId
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  claimed:
+                    type: boolean
+                  reason:
+                    type: string
+                    enum:
+                      - already_claimed
+                      - unknown
+                  settleMs:
+                    description: How long a granted claim has to report its write back before the waiting call gives up.
+                    type: number
+                required:
+                  - claimed
+                additionalProperties: false
   /v1/contact_prompt_flags:
     post:
       operationId: contact_prompt_flags_post
@@ -6462,7 +6525,7 @@ paths:
       summary: Prompt user to register a contact channel
       description:
         Broadcasts a contact_request to connected clients, waits for the user to submit an address via the gateway.
-        The gateway owns the contact write and notifies the daemon via resolve_contact_prompt IPC.
+        The gateway owns the contact write and reports it back via resolve_contact_prompt.
       tags:
         - contacts
       requestBody:
@@ -6496,8 +6559,17 @@ paths:
                     - trusted-contact
                     - unknown
                 verify:
-                  description: When true, submitting the address also marks the channel verified. Same attest as Contacts Verify me.
+                  description:
+                    Pre-check the form's 'mark verified' box. The guardian's answer on submit decides the attest, so an
+                    unchecked box leaves the channel unverified.
                   type: boolean
+                timeoutMs:
+                  description:
+                    How long to hold the form open (ms). The caller waits slightly longer than this, so the form closing is
+                    what ends the wait. Defaults to 300000.
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 3600000
       responses:
         "200":
           description: Successful response
@@ -6518,6 +6590,106 @@ paths:
                     type: string
                   address:
                     type: string
+                  verified:
+                    type: boolean
+                required:
+                  - ok
+                additionalProperties: false
+  /v1/contacts/record-prompt:
+    post:
+      operationId: contacts_recordprompt_post
+      summary: Ask the guardian to confirm a contact record write
+      description:
+        Broadcasts a contact_record_request to connected clients and waits for the guardian to submit the form. The
+        gateway owns the write and reports it back via resolve_contact_prompt. Nothing is written if nobody answers.
+      tags:
+        - contacts
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                operation:
+                  type: string
+                  enum:
+                    - create
+                    - update
+                    - delete
+                  description: Which record write the guardian is being asked to confirm.
+                contactId:
+                  description: Target contact. Required for update and delete.
+                  type: string
+                currentDisplayName:
+                  description:
+                    The target's current name, resolved by the caller, so the form can show what is changing. Gateway-owned
+                    facts are not read here.
+                  type: string
+                currentNotes:
+                  description:
+                    The target's current notes, resolved by the caller. The form submits a field only when it differs from what
+                    is stored.
+                  type: string
+                channels:
+                  description:
+                    The target's channels, resolved by the caller, so a delete confirmation can identify the contact and show
+                    what access is about to be lost.
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      type:
+                        type: string
+                      address:
+                        type: string
+                    required:
+                      - type
+                      - address
+                displayName:
+                  description: Proposed name, prefilled into the form. The guardian can edit it.
+                  type: string
+                notes:
+                  description: Proposed notes, prefilled into the form. The guardian can edit them.
+                  type: string
+                notesProposed:
+                  description:
+                    Whether the caller asked for these notes explicitly, so the form submits them even when they match what is
+                    stored.
+                  type: boolean
+                label:
+                  description: Display label shown in the form.
+                  type: string
+                description:
+                  description: Longer description shown in the form.
+                  type: string
+                timeoutMs:
+                  description:
+                    How long to hold the form open (ms). The caller waits slightly longer than this, so the form closing is
+                    what ends the wait. Defaults to 300000.
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 3600000
+              required:
+                - operation
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                  error:
+                    type: string
+                  contactId:
+                    type: string
+                  notesSaved:
+                    type: boolean
+                  nothingWritten:
+                    type: boolean
                 required:
                   - ok
                 additionalProperties: false
@@ -12634,6 +12806,56 @@ paths:
                 additionalProperties: false
         "403":
           description: Cannot reorder system groups
+  /v1/guardian_form_claim:
+    post:
+      operationId: guardian_form_claim_post
+      summary: Claim a pending guardian form for one submission
+      description:
+        Marks a pending form as answered so a second client submitting the same form writes nothing. Returns
+        claimed=false with reason 'already_claimed' when somebody got there first, 'unknown' when no such form is
+        pending, or 'wrong_kind' when the id belongs to a different form than the caller named. A granted claim carries
+        the window its write has to report back in.
+      tags:
+        - guardian-forms
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                requestId:
+                  type: string
+                  description: The pending form's id.
+                kind:
+                  description:
+                    The form the caller believes it is writing for. Rejected when it is not what the id is holding. Omitted by
+                    callers that predate the check.
+                  type: string
+              required:
+                - requestId
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  claimed:
+                    type: boolean
+                  reason:
+                    type: string
+                    enum:
+                      - already_claimed
+                      - unknown
+                      - wrong_kind
+                  settleMs:
+                    description: How long a granted claim has to report its write back before the waiting call gives up.
+                    type: number
+                required:
+                  - claimed
+                additionalProperties: false
   /v1/guardian-actions/decision:
     post:
       operationId: guardianactions_decision_post
@@ -13540,6 +13762,54 @@ paths:
                           required:
                             - kind
                           additionalProperties: false
+                        guardianRequest:
+                          type: object
+                          properties:
+                            requestId:
+                              type: string
+                            kind:
+                              type: string
+                            intent:
+                              type: string
+                              enum:
+                                - approval
+                                - question
+                            status:
+                              type: string
+                              enum:
+                                - pending
+                                - approved
+                                - denied
+                                - expired
+                                - cancelled
+                            requesterLabel:
+                              type: string
+                            toolName:
+                              type: string
+                            sourceChannel:
+                              type: string
+                            sourceContextLabel:
+                              type: string
+                            sourceUrl:
+                              type: string
+                            slackCardUrl:
+                              type: string
+                            slackCardAppUrl:
+                              type: string
+                            decidedAction:
+                              type: string
+                            decidedByLabel:
+                              type: string
+                            decidedAt:
+                              type: string
+                            terminalReason:
+                              type: string
+                          required:
+                            - requestId
+                            - kind
+                            - intent
+                            - status
+                          additionalProperties: false
                         category:
                           type: string
                           enum:
@@ -13733,6 +14003,54 @@ paths:
                     required:
                       - kind
                     additionalProperties: false
+                  guardianRequest:
+                    type: object
+                    properties:
+                      requestId:
+                        type: string
+                      kind:
+                        type: string
+                      intent:
+                        type: string
+                        enum:
+                          - approval
+                          - question
+                      status:
+                        type: string
+                        enum:
+                          - pending
+                          - approved
+                          - denied
+                          - expired
+                          - cancelled
+                      requesterLabel:
+                        type: string
+                      toolName:
+                        type: string
+                      sourceChannel:
+                        type: string
+                      sourceContextLabel:
+                        type: string
+                      sourceUrl:
+                        type: string
+                      slackCardUrl:
+                        type: string
+                      slackCardAppUrl:
+                        type: string
+                      decidedAction:
+                        type: string
+                      decidedByLabel:
+                        type: string
+                      decidedAt:
+                        type: string
+                      terminalReason:
+                        type: string
+                    required:
+                      - requestId
+                      - kind
+                      - intent
+                      - status
+                    additionalProperties: false
                   category:
                     type: string
                     enum:
@@ -14020,6 +14338,54 @@ paths:
                           required:
                             - kind
                           additionalProperties: false
+                        guardianRequest:
+                          type: object
+                          properties:
+                            requestId:
+                              type: string
+                            kind:
+                              type: string
+                            intent:
+                              type: string
+                              enum:
+                                - approval
+                                - question
+                            status:
+                              type: string
+                              enum:
+                                - pending
+                                - approved
+                                - denied
+                                - expired
+                                - cancelled
+                            requesterLabel:
+                              type: string
+                            toolName:
+                              type: string
+                            sourceChannel:
+                              type: string
+                            sourceContextLabel:
+                              type: string
+                            sourceUrl:
+                              type: string
+                            slackCardUrl:
+                              type: string
+                            slackCardAppUrl:
+                              type: string
+                            decidedAction:
+                              type: string
+                            decidedByLabel:
+                              type: string
+                            decidedAt:
+                              type: string
+                            terminalReason:
+                              type: string
+                          required:
+                            - requestId
+                            - kind
+                            - intent
+                            - status
+                          additionalProperties: false
                         category:
                           type: string
                           enum:
@@ -16233,14 +16599,14 @@ paths:
               type: object
               properties:
                 botToken:
-                  type: string
                   description: Slack bot token
-                appToken:
                   type: string
+                appToken:
                   description: Slack app-level token
-              required:
-                - botToken
-                - appToken
+                  type: string
+                userToken:
+                  description: Slack user token, for reading channels the bot is not in
+                  type: string
       responses:
         "200":
           description: Successful response
@@ -20608,6 +20974,29 @@ paths:
                           additionalProperties: false
                         systemCard:
                           type: boolean
+                        noResponse:
+                          type: boolean
+                        reaction:
+                          type: object
+                          properties:
+                            emoji:
+                              type: string
+                            op:
+                              type: string
+                              enum:
+                                - added
+                                - removed
+                            targetMessageId:
+                              type: string
+                            actorDisplayName:
+                              type: string
+                            selfAuthored:
+                              type: boolean
+                          required:
+                            - emoji
+                            - op
+                            - targetMessageId
+                          additionalProperties: false
                         providerError:
                           type: object
                           properties:
@@ -22586,6 +22975,54 @@ paths:
                         required:
                           - kind
                         additionalProperties: false
+                      guardianRequest:
+                        type: object
+                        properties:
+                          requestId:
+                            type: string
+                          kind:
+                            type: string
+                          intent:
+                            type: string
+                            enum:
+                              - approval
+                              - question
+                          status:
+                            type: string
+                            enum:
+                              - pending
+                              - approved
+                              - denied
+                              - expired
+                              - cancelled
+                          requesterLabel:
+                            type: string
+                          toolName:
+                            type: string
+                          sourceChannel:
+                            type: string
+                          sourceContextLabel:
+                            type: string
+                          sourceUrl:
+                            type: string
+                          slackCardUrl:
+                            type: string
+                          slackCardAppUrl:
+                            type: string
+                          decidedAction:
+                            type: string
+                          decidedByLabel:
+                            type: string
+                          decidedAt:
+                            type: string
+                          terminalReason:
+                            type: string
+                        required:
+                          - requestId
+                          - kind
+                          - intent
+                          - status
+                        additionalProperties: false
                       category:
                         type: string
                         enum:
@@ -26006,12 +26443,47 @@ paths:
     post:
       operationId: resolve_contact_prompt_post
       summary: "Gateway callback: resolve a pending contact prompt"
-      description: Called by the gateway after it writes the contact and channel. Unblocks the waiting contacts/prompt IPC call.
+      description: Called by the gateway after it writes the contact and channel. Unblocks the waiting contacts/prompt call.
       tags:
         - contacts
       responses:
         "200":
           description: Successful response
+  /v1/resolve_guardian_form:
+    post:
+      operationId: resolve_guardian_form_post
+      summary: Report a guardian form's outcome back to the waiting command
+      description:
+        Called by the writer once it has committed (or failed). Fields other than requestId and error are passed
+        through to the parked caller untouched; an error makes the outcome a failure.
+      tags:
+        - guardian-forms
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                requestId:
+                  type: string
+                  description: The pending form's id.
+              required:
+                - requestId
+              additionalProperties: {}
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  resolved:
+                    type: boolean
+                required:
+                  - resolved
+                additionalProperties: false
   /v1/resource-pressure/status:
     get:
       operationId: resourcepressure_status_get

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/assistant",
-  "version": "0.11.7",
+  "version": "0.11.8-staging.1",
   "license": "MIT",
   "type": "module",
   "exports": {
@@ -43,6 +43,7 @@
     "@qdrant/js-client-rest": "1.17.0",
     "@resvg/resvg-js": "2.6.2",
     "@slack/types": "2.22.0",
+    "@vellumai/avatar-catalog": "file:../packages/avatar-catalog",
     "@vellumai/avatar-manifest": "file:../packages/avatar-manifest",
     "@vellumai/ces-client": "file:../packages/ces-client",
     "@vellumai/credential-storage": "file:../packages/credential-storage",
@@ -87,6 +88,7 @@
     "node": ">=20.12.0"
   },
   "bundledDependencies": [
+    "@vellumai/avatar-catalog",
     "@vellumai/avatar-manifest",
     "@vellumai/ces-client",
     "@vellumai/credential-storage",

package/scripts/sync-llm-catalog.ts

@@ -74,6 +74,9 @@ function projectModel(model: CatalogModel): Record<string, unknown> {
   if (model.adaptiveThinkingOnly !== undefined) {
     projected.adaptiveThinkingOnly = model.adaptiveThinkingOnly;
   }
+  if (model.thinkingFloor !== undefined) {
+    projected.thinkingFloor = model.thinkingFloor;
+  }
   if (model.supportsCaching !== undefined) {
     projected.supportsCaching = model.supportsCaching;
   }

package/src/__tests__/agent-loop-callsite-precedence.test.ts

@@ -175,6 +175,22 @@ describe("AgentLoop — call-site precedence", () => {
 
   test("call-site thinking wins over conversation default when callSite is set", async () => {
     setLlmConfig({
+      // Pinned to a model that can actually be told not to think. Without an
+      // active profile the call site resolves the shipped Balanced body, and
+      // the disabled shape asserted below only exists for models whose
+      // reasoning can be turned off: the normalizer drops a disabled thinking
+      // config for adaptive-thinking-only models (they always reason and 4xx
+      // the opt-out), so this test would assert the Balanced pin's capabilities
+      // rather than call-site precedence.
+      profiles: {
+        "test-anthropic": {
+          source: "user",
+          provider: "anthropic",
+          model: "claude-sonnet-5",
+        },
+      },
+      profileOrder: ["test-anthropic"],
+      activeProfile: "test-anthropic",
       default: {
         provider: "anthropic",
         model: "claude-default",