@vellumai/assistant 0.7.0 → 0.7.1

package/openapi.yaml

@@ -3,7 +3,7 @@
 openapi: 3.0.0
 info:
   title: Vellum Assistant API
-  version: 0.7.0
+  version: 0.7.1
   description: Auto-generated OpenAPI specification for the Vellum Assistant runtime HTTP server.
 servers:
   - url: http://127.0.0.1:7821
@@ -465,6 +465,13 @@ paths:
                 required:
                   - apps
                 additionalProperties: false
+      parameters:
+        - name: conversationId
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Filter apps by conversation ID
   /v1/apps/{appId}/dist/{filename}:
     get:
       operationId: apps_by_appId_dist_by_filename_get
@@ -2439,6 +2446,40 @@ paths:
           schema:
             type: string
           description: Filter clients by a specific capability.
+  /v1/clients/disconnect:
+    post:
+      operationId: clients_disconnect_post
+      summary: Force-disconnect a client
+      description: Dispose all hub subscribers for the given clientId, forcibly closing their SSE streams.
+      tags:
+        - clients
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  disconnected:
+                    type: number
+                    description: Number of disposed subscribers.
+                required:
+                  - disconnected
+                additionalProperties: false
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                clientId:
+                  type: string
+                  description: The client UUID to disconnect.
+              required:
+                - clientId
+              additionalProperties: false
   /v1/config:
     get:
       operationId: config_get
@@ -2491,6 +2532,18 @@ paths:
               required:
                 - provider
               additionalProperties: false
+  /v1/config/llm/call-sites:
+    get:
+      operationId: config_llm_callsites_get
+      summary: List LLM call sites
+      description:
+        Returns the full catalog of LLM call sites with display names, descriptions, and domain groupings. Used by
+        clients to render the per-call-site override settings UI.
+      tags:
+        - config
+      responses:
+        "200":
+          description: Successful response
   /v1/config/llm/profiles/{name}:
     put:
       operationId: config_llm_profiles_by_name_put
@@ -2594,6 +2647,76 @@ paths:
                 - requestId
                 - decision
               additionalProperties: false
+  /v1/consolidation/config:
+    get:
+      operationId: consolidation_config_get
+      summary: Get consolidation config
+      description: Return the current memory v2 consolidation schedule configuration.
+      tags:
+        - consolidation
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  available:
+                    type: boolean
+                  enabled:
+                    type: boolean
+                  intervalMs:
+                    type: number
+                  nextRunAt:
+                    anyOf:
+                      - type: number
+                      - type: "null"
+                  lastRunAt:
+                    anyOf:
+                      - type: number
+                      - type: "null"
+                  success:
+                    type: boolean
+                required:
+                  - available
+                  - enabled
+                  - intervalMs
+                  - nextRunAt
+                  - lastRunAt
+                  - success
+                additionalProperties: false
+  /v1/consolidation/run-now:
+    post:
+      operationId: consolidation_runnow_post
+      summary: Run consolidation now
+      description:
+        Enqueue an immediate memory v2 consolidation job. Returns once the job is queued; the job itself runs
+        through the memory jobs worker.
+      tags:
+        - consolidation
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  success:
+                    type: boolean
+                  ran:
+                    type: boolean
+                    description: Whether a job was enqueued
+                  jobId:
+                    anyOf:
+                      - type: string
+                      - type: "null"
+                required:
+                  - success
+                  - ran
+                  - jobId
+                additionalProperties: false
   /v1/contact-channels/{contactChannelId}:
     patch:
       operationId: contactchannels_by_contactChannelId_patch
@@ -3216,6 +3339,10 @@ paths:
           description: Successful response
     get:
       operationId: conversations_get
+      summary: List conversations
+      description: Paginated list of conversations with attention state and display metadata.
+      tags:
+        - conversations
       responses:
         "200":
           description: Successful response
@@ -3282,6 +3409,10 @@ paths:
             type: string
     get:
       operationId: conversations_by_id_get
+      summary: Get conversation detail
+      description: Retrieve a single conversation with full metadata.
+      tags:
+        - conversations
       responses:
         "200":
           description: Successful response
@@ -3770,6 +3901,10 @@ paths:
   /v1/conversations/seen:
     post:
       operationId: conversations_seen_post
+      summary: Record a seen signal
+      description: Mark a conversation as seen, advancing the attention cursor.
+      tags:
+        - conversations
       responses:
         "200":
           description: Successful response
@@ -3819,6 +3954,10 @@ paths:
   /v1/conversations/unread:
     post:
       operationId: conversations_unread_post
+      summary: Mark conversation unread
+      description: Reset the seen cursor so the conversation appears unread.
+      tags:
+        - conversations
       responses:
         "200":
           description: Successful response
@@ -4450,6 +4589,8 @@ paths:
               schema:
                 type: object
                 properties:
+                  available:
+                    type: boolean
                   enabled:
                     type: boolean
                   intervalMs:
@@ -4473,6 +4614,7 @@ paths:
                   success:
                     type: boolean
                 required:
+                  - available
                   - enabled
                   - intervalMs
                   - activeHoursStart
@@ -6053,16 +6195,6 @@ paths:
       responses:
         "200":
           description: Successful response
-  /v1/integrations/slack/channel/oauth-install:
-    post:
-      operationId: integrations_slack_channel_oauthinstall_post
-      summary: Run Slack OAuth install
-      description: Run an OAuth2 loopback flow to install the Slack app and capture bot + user tokens.
-      tags:
-        - integrations
-      responses:
-        "200":
-          description: Successful response
   /v1/integrations/telegram/commands:
     post:
       operationId: integrations_telegram_commands_post
@@ -6211,6 +6343,9 @@ paths:
   /v1/interfaces/{path}:
     get:
       operationId: interfaces_by_path_get
+      summary: Serve an interface definition file
+      tags:
+        - interfaces
       responses:
         "200":
           description: Successful response
@@ -6223,24 +6358,58 @@ paths:
   /v1/internal/oauth/callback:
     post:
       operationId: internal_oauth_callback_post
+      summary: Internal OAuth callback
+      description:
+        Receives forwarded OAuth callback results (code or error) from the gateway and resolves the pending
+        callback in the runtime.
+      tags:
+        - internal
       responses:
         "200":
           description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                state:
+                  type: string
+                code:
+                  type: string
+                error:
+                  type: string
+              required:
+                - state
+              additionalProperties: false
   /v1/internal/twilio/connect-action:
     post:
       operationId: internal_twilio_connectaction_post
+      summary: Internal Twilio connect-action
+      description: Gateway-to-runtime forwarding for ConversationRelay connect-action callback.
+      tags:
+        - internal
       responses:
         "200":
           description: Successful response
   /v1/internal/twilio/status:
     post:
       operationId: internal_twilio_status_post
+      summary: Internal Twilio status callback
+      description: Gateway-to-runtime forwarding for Twilio call status updates. Accepts pre-parsed form params as JSON.
+      tags:
+        - internal
       responses:
         "200":
           description: Successful response
   /v1/internal/twilio/voice-webhook:
     post:
       operationId: internal_twilio_voicewebhook_post
+      summary: Internal Twilio voice webhook
+      description: Gateway-to-runtime forwarding for Twilio voice webhook. Accepts pre-parsed form params as JSON.
+      tags:
+        - internal
       responses:
         "200":
           description: Successful response
@@ -6541,7 +6710,6 @@ paths:
                   type: string
                   enum:
                     - migrate
-                    - rebuild-edges
                     - reembed
                     - activation-recompute
                 force:
@@ -6710,13 +6878,22 @@ paths:
                     type: array
                     items: {}
                   memoryRecall:
-                    type: object
-                    properties: {}
-                    additionalProperties: {}
+                    anyOf:
+                      - type: object
+                        properties: {}
+                        additionalProperties: {}
+                      - type: "null"
+                  memoryV2Activation:
+                    anyOf:
+                      - type: object
+                        properties: {}
+                        additionalProperties: {}
+                      - type: "null"
                 required:
                   - messageId
                   - logs
                   - memoryRecall
+                  - memoryV2Activation
                 additionalProperties: false
       parameters:
         - name: id
@@ -7512,23 +7689,13 @@ paths:
           required: true
           schema:
             type: string
-  /v1/pairing/request:
-    post:
-      operationId: pairing_request_post
-      responses:
-        "200":
-          description: Successful response
-  /v1/pairing/status:
-    get:
-      operationId: pairing_status_get
-      responses:
-        "200":
-          description: Successful response
   /v1/pending-interactions:
     get:
       operationId: pendinginteractions_get
       summary: List pending interactions
-      description: Return pending confirmations and secrets for a conversation.
+      description:
+        Return pending interactions. When conversationKey or conversationId is provided, returns details for that
+        conversation. When neither is provided, returns all pending interactions.
       tags:
         - approvals
       responses:
@@ -7549,9 +7716,27 @@ paths:
                     properties: {}
                     additionalProperties: {}
                     description: Pending secret request or null
-                required:
-                  - pendingConfirmation
-                  - pendingSecret
+                  interactions:
+                    type: array
+                    items:
+                      type: object
+                      properties:
+                        requestId:
+                          type: string
+                        conversationId:
+                          type: string
+                        kind:
+                          type: string
+                        toolName:
+                          type: string
+                        riskLevel:
+                          type: string
+                      required:
+                        - requestId
+                        - conversationId
+                        - kind
+                      additionalProperties: false
+                    description: All pending interactions (returned when no filters given)
                 additionalProperties: false
       parameters:
         - name: conversationKey
@@ -7559,13 +7744,13 @@ paths:
           required: false
           schema:
             type: string
-          description: Conversation key
+          description: Conversation key (optional)
         - name: conversationId
           in: query
           required: false
           schema:
             type: string
-          description: Conversation ID
+          description: Conversation ID (optional)
   /v1/playground/seed-conversation:
     post:
       operationId: playground_seedconversation_post
@@ -10720,78 +10905,6 @@ paths:
           schema:
             type: string
           description: Include unmodified defaults
-    post:
-      operationId: trustrules_post
-      summary: Create a trust rule
-      description: Create a new trust rule with tool, pattern, risk level, and optional description.
-      tags:
-        - trust-rules
-      responses:
-        "200":
-          description: Successful response
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                tool:
-                  type: string
-                pattern:
-                  type: string
-                risk:
-                  type: string
-                description:
-                  type: string
-              required:
-                - tool
-                - pattern
-                - risk
-              additionalProperties: false
-  /v1/trust-rules/{id}:
-    delete:
-      operationId: trustrules_by_id_delete
-      summary: Remove a trust rule
-      description: Delete a trust rule by ID.
-      tags:
-        - trust-rules
-      responses:
-        "200":
-          description: Successful response
-      parameters:
-        - name: id
-          in: path
-          required: true
-          schema:
-            type: string
-    patch:
-      operationId: trustrules_by_id_patch
-      summary: Update a trust rule
-      description: Update the risk level or description of an existing trust rule.
-      tags:
-        - trust-rules
-      responses:
-        "200":
-          description: Successful response
-      parameters:
-        - name: id
-          in: path
-          required: true
-          schema:
-            type: string
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                risk:
-                  type: string
-                description:
-                  type: string
-              additionalProperties: false
   /v1/trust-rules/suggest:
     post:
       operationId: trustrules_suggest_post
@@ -10907,6 +11020,20 @@ paths:
                   enum:
                     - auto_approve
                     - escalate
+                existingRule:
+                  type: object
+                  properties:
+                    id:
+                      type: string
+                    pattern:
+                      type: string
+                    risk:
+                      type: string
+                  required:
+                    - id
+                    - pattern
+                    - risk
+                  additionalProperties: false
               required:
                 - tool
                 - command
@@ -11010,7 +11137,9 @@ paths:
     get:
       operationId: usage_breakdown_get
       summary: Get usage breakdown
-      description: Return grouped usage breakdown (by actor, provider, model, or conversation).
+      description:
+        Return grouped usage breakdown. Prefer call_site for user-facing task breakdowns; actor is a
+        legacy/internal dimension.
       tags:
         - usage
       responses:
@@ -11046,7 +11175,7 @@ paths:
           required: false
           schema:
             type: string
-          description: "Group by: actor, provider, model, or conversation (required)"
+          description: "Group by: actor, provider, model, conversation, call_site, inference_profile (required)"
   /v1/usage/daily:
     get:
       operationId: usage_daily_get
@@ -11099,6 +11228,64 @@ paths:
           description:
             IANA timezone identifier (e.g. "America/Los_Angeles"). Bucket boundaries and display labels are computed in
             this timezone. Defaults to "UTC" for backwards compatibility.
+  /v1/usage/series:
+    get:
+      operationId: usage_series_get
+      summary: Get grouped usage series
+      description: Return usage buckets with per-group values for stacked charts. Prefer call_site for user-facing task stacks.
+      tags:
+        - usage
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  buckets:
+                    type: array
+                    items: {}
+                    description: Grouped usage bucket objects
+                required:
+                  - buckets
+                additionalProperties: false
+      parameters:
+        - name: from
+          in: query
+          required: false
+          schema:
+            type: integer
+          description: Start epoch millis (required)
+        - name: to
+          in: query
+          required: false
+          schema:
+            type: integer
+          description: End epoch millis (required)
+        - name: granularity
+          in: query
+          required: false
+          schema:
+            type: string
+            enum:
+              - daily
+              - hourly
+          description: 'Bucket granularity: "daily" (default) or "hourly"'
+        - name: groupBy
+          in: query
+          required: false
+          schema:
+            type: string
+          description: "Group by: actor, provider, model, call_site, inference_profile (required)"
+        - name: tz
+          in: query
+          required: false
+          schema:
+            type: string
+          description:
+            IANA timezone identifier (e.g. "America/Los_Angeles"). Bucket boundaries and display labels are computed in
+            this timezone. Defaults to "UTC".
   /v1/usage/totals:
     get:
       operationId: usage_totals_get

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/assistant",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "license": "MIT",
   "type": "module",
   "exports": {
@@ -46,6 +46,7 @@
     "@vellumai/egress-proxy": "file:../packages/egress-proxy",
     "@vellumai/gateway-client": "file:../packages/gateway-client",
     "@vellumai/skill-host-contracts": "file:../packages/skill-host-contracts",
+    "@vellumai/slack-text": "file:../packages/slack-text",
     "archiver": "7.0.1",
     "commander": "13.1.0",
     "croner": "10.0.1",
@@ -75,7 +76,8 @@
     "@vellumai/service-contracts",
     "@vellumai/egress-proxy",
     "@vellumai/gateway-client",
-    "@vellumai/skill-host-contracts"
+    "@vellumai/skill-host-contracts",
+    "@vellumai/slack-text"
   ],
   "overrides": {
     "lodash": "4.18.1",