@vellumai/assistant 0.10.0 → 0.10.1-staging.1

package/openapi.yaml

@@ -3,7 +3,7 @@
 openapi: 3.1.0
 info:
   title: Vellum Assistant API
-  version: 0.10.0
+  version: 0.10.1
   description: Auto-generated OpenAPI specification for the Vellum Assistant runtime HTTP server.
 servers:
   - url: http://127.0.0.1:7821
@@ -1491,19 +1491,19 @@ paths:
                 properties:
                   id:
                     type: string
-                  original_filename:
+                  filename:
                     type: string
-                  mime_type:
+                  mimeType:
                     type: string
-                  size_bytes:
+                  sizeBytes:
                     type: number
                   kind:
                     type: string
                 required:
                   - id
-                  - original_filename
-                  - mime_type
-                  - size_bytes
+                  - filename
+                  - mimeType
+                  - sizeBytes
                   - kind
                 additionalProperties: false
   /v1/attachments/{id}:
@@ -3959,6 +3959,59 @@ paths:
                         - trusted_contacts
                         - any_contact
                         - strangers
+                    trustVerdict:
+                      type: object
+                      properties:
+                        trustClass:
+                          type: string
+                          enum:
+                            - guardian
+                            - trusted_contact
+                            - unverified_contact
+                            - unknown
+                        canonicalSenderId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        guardianExternalUserId:
+                          type: string
+                        guardianDeliveryChatId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        guardianPrincipalId:
+                          type: string
+                        guardianDisplayName:
+                          type: string
+                        contactId:
+                          type: string
+                        channelId:
+                          type: string
+                        type:
+                          type: string
+                        address:
+                          type: string
+                        externalChatId:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        status:
+                          type: string
+                        policy:
+                          type: string
+                        verifiedAt:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        verifiedVia:
+                          anyOf:
+                            - type: string
+                            - type: "null"
+                        memberDisplayName:
+                          type: string
+                      required:
+                        - trustClass
+                        - canonicalSenderId
                     emailSubject:
                       type: string
                     emailRecipient:
@@ -4800,6 +4853,10 @@ paths:
                           - type: "null"
                       interactionCount:
                         type: number
+                      createdAt:
+                        type: number
+                      updatedAt:
+                        type: number
                       channels:
                         type: array
                         items:
@@ -4871,6 +4928,8 @@ paths:
                       - displayName
                       - role
                       - interactionCount
+                      - createdAt
+                      - updatedAt
                       - channels
                     additionalProperties: false
                 required:
@@ -4955,6 +5014,10 @@ paths:
                             - type: "null"
                         interactionCount:
                           type: number
+                        createdAt:
+                          type: number
+                        updatedAt:
+                          type: number
                         channels:
                           type: array
                           items:
@@ -5026,6 +5089,8 @@ paths:
                         - displayName
                         - role
                         - interactionCount
+                        - createdAt
+                        - updatedAt
                         - channels
                       additionalProperties: false
                     description: Contact objects with channels and metadata
@@ -5079,6 +5144,10 @@ paths:
                           - type: "null"
                       interactionCount:
                         type: number
+                      createdAt:
+                        type: number
+                      updatedAt:
+                        type: number
                       channels:
                         type: array
                         items:
@@ -5150,6 +5219,8 @@ paths:
                       - displayName
                       - role
                       - interactionCount
+                      - createdAt
+                      - updatedAt
                       - channels
                     additionalProperties: false
                   assistantMetadata:
@@ -5241,18 +5312,9 @@ paths:
                 expiresInMs:
                   type: number
                   description: Expiry duration in ms
-                contactName:
-                  type: string
-                  description: Contact display name
                 expectedExternalUserId:
                   type: string
                   description: Expected user ID (E.164 for phone)
-                friendName:
-                  type: string
-                  description: Friend name for the invite
-                guardianName:
-                  type: string
-                  description: Guardian name
               required:
                 - contactId
       responses:
@@ -5270,6 +5332,9 @@ paths:
                     properties: {}
                     additionalProperties: {}
                     description: Created invite
+                  rawToken:
+                    description: One-time raw invite token (returned at creation only)
+                    type: string
                 required:
                   - ok
                   - invite
@@ -5454,6 +5519,10 @@ paths:
                           - type: "null"
                       interactionCount:
                         type: number
+                      createdAt:
+                        type: number
+                      updatedAt:
+                        type: number
                       channels:
                         type: array
                         items:
@@ -5525,6 +5594,8 @@ paths:
                       - displayName
                       - role
                       - interactionCount
+                      - createdAt
+                      - updatedAt
                       - channels
                     additionalProperties: false
                     description: Merged contact
@@ -5643,6 +5714,10 @@ paths:
                         - type: "null"
                     interactionCount:
                       type: number
+                    createdAt:
+                      type: number
+                    updatedAt:
+                      type: number
                     channels:
                       type: array
                       items:
@@ -5714,6 +5789,8 @@ paths:
                     - displayName
                     - role
                     - interactionCount
+                    - createdAt
+                    - updatedAt
                     - channels
                   additionalProperties: false
   /v1/content-source:
@@ -13293,8 +13370,8 @@ paths:
           schema:
             type: string
           description:
-            "Filter by provider. One of: anthropic, openai, gemini, ollama, fireworks, openrouter, openai-compatible,
-            minimax, atlascloud"
+            "Filter by provider. One of: anthropic, openai, gemini, ollama, fireworks, together, openrouter,
+            openai-compatible, minimax, atlascloud"
       responses:
         "200":
           description: Successful response
@@ -15523,6 +15600,14 @@ paths:
                   type: integer
                   minimum: -9007199254740991
                   maximum: 9007199254740991
+                turnIds:
+                  type: array
+                  items:
+                    type: string
+                excludeConversationIds:
+                  type: array
+                  items:
+                    type: string
               required:
                 - stagingDir
                 - snapshotDir
@@ -15537,26 +15622,193 @@ paths:
                 properties:
                   turnsMined:
                     type: number
+                  turnsRequested:
+                    type: number
                   packetsWritten:
                     type: number
                   packetsPath:
                     type: string
                   keyPath:
                     type: string
+                  metaPath:
+                    type: string
                   snapshotPages:
                     type: number
                   stagingPages:
                     type: number
                   dense:
                     type: boolean
+                  seed:
+                    type: number
+                  k:
+                    type: number
+                  embedding:
+                    type: object
+                    properties:
+                      provider:
+                        type: string
+                      model:
+                        type: string
+                      dims:
+                        anyOf:
+                          - type: number
+                          - type: "null"
+                    required:
+                      - provider
+                      - model
+                      - dims
+                    additionalProperties: false
+                  turnIds:
+                    type: array
+                    items:
+                      type: string
                 required:
                   - turnsMined
+                  - turnsRequested
                   - packetsWritten
                   - packetsPath
                   - keyPath
+                  - metaPath
                   - snapshotPages
                   - stagingPages
                   - dense
+                  - seed
+                  - k
+                  - embedding
+                  - turnIds
+                additionalProperties: false
+  /v1/memory/eval/tally:
+    post:
+      operationId: memory_eval_tally_post
+      summary: Unblind + tally blind-judge verdicts against the key with a noise-aware win/tie/loss verdict
+      tags:
+        - memory
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                verdicts:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      turn:
+                        type: string
+                      winner:
+                        type: string
+                      scoreA:
+                        type: number
+                      scoreB:
+                        type: number
+                    required:
+                      - turn
+                      - scoreA
+                      - scoreB
+                key:
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      turn:
+                        type: string
+                      a:
+                        type: string
+                        enum:
+                          - snapshot
+                          - staging
+                      b:
+                        type: string
+                        enum:
+                          - snapshot
+                          - staging
+                    required:
+                      - turn
+                      - a
+                      - b
+                alpha:
+                  type: number
+                  exclusiveMinimum: 0
+              required:
+                - verdicts
+                - key
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  turns:
+                    type: number
+                  verdictsCounted:
+                    type: number
+                  unmatchedVerdicts:
+                    type: number
+                  panel:
+                    type: object
+                    properties:
+                      min:
+                        type: number
+                      max:
+                        type: number
+                      mean:
+                        type: number
+                    required:
+                      - min
+                      - max
+                      - mean
+                    additionalProperties: false
+                  snapshotWins:
+                    type: number
+                  stagingWins:
+                    type: number
+                  ties:
+                    type: number
+                  decided:
+                    type: number
+                  meanSnapshot:
+                    type: number
+                  meanStaging:
+                    type: number
+                  signTestP:
+                    type: number
+                  verdict:
+                    type: string
+                    enum:
+                      - wiki-wins
+                      - tie
+                      - wiki-loses
+                  gate:
+                    type: string
+                    enum:
+                      - pass
+                      - fail
+                  confident:
+                    type: boolean
+                  notes:
+                    type: array
+                    items:
+                      type: string
+                required:
+                  - turns
+                  - verdictsCounted
+                  - unmatchedVerdicts
+                  - panel
+                  - snapshotWins
+                  - stagingWins
+                  - ties
+                  - decided
+                  - meanSnapshot
+                  - meanStaging
+                  - signTestP
+                  - verdict
+                  - gate
+                  - confident
+                  - notes
                 additionalProperties: false
   /v1/memory/v2/backfill:
     post:
@@ -20359,6 +20611,67 @@ paths:
             install-time baseline cannot be reconstructed.
         "503":
           description: The plugin source (GitHub) was temporarily unavailable; the upgrade is retryable.
+  /v1/plugins/{name}/versions:
+    get:
+      operationId: plugins_by_name_versions_get
+      summary: List a plugin's reviewed marketplace pins
+      description:
+        Report the distinct marketplace pins a plugin has been promoted to over time, newest first (the first entry
+        is the current pin), capped at `limit` (default 5). The curated `marketplace.json` stores only the current pin,
+        so this is reconstructed from the manifest's own commit history on the default branch — every entry is therefore
+        a reviewed, known-good revision. Pair with `POST /v1/plugins/install`'s `pin` field to roll a plugin back to an
+        older reviewed version. An unknown name (never in the manifest) returns an empty array, not 404.
+      tags:
+        - plugins
+      parameters:
+        - name: name
+          in: path
+          required: true
+          schema:
+            type: string
+        - name: limit
+          in: query
+          required: false
+          schema:
+            type: string
+          description: Maximum number of pins to return (positive integer; default 5).
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    pin:
+                      type: string
+                      description: Plugin commit SHA pinned at this point in marketplace history.
+                    marketplaceCommit:
+                      type: string
+                      description: Marketplace-manifest commit to install this pin from (the newest commit carrying it).
+                    promotedAt:
+                      anyOf:
+                        - type: string
+                        - type: "null"
+                      description: ISO-8601 committer date (UTC) of the marketplace commit that promoted this pin; null when unreadable.
+                    current:
+                      type: boolean
+                      description: True for the pin currently active on the default branch.
+                  required:
+                    - pin
+                    - marketplaceCommit
+                    - promotedAt
+                    - current
+                  additionalProperties: false
+                description:
+                  Distinct marketplace pins a plugin has been promoted to, newest first; the first entry is the current pin.
+                  Empty when the plugin has no resolvable history.
+        "400":
+          description: The plugin name failed sanitization, or `limit` was not a positive integer.
+        "503":
+          description: The marketplace pin history could not be read from GitHub (rate-limited or upstream error); retryable.
   /v1/plugins/install:
     post:
       operationId: plugins_install_post
@@ -20385,6 +20698,13 @@ paths:
                 force:
                   description: Overwrite an existing install in place. Defaults to false.
                   type: boolean
+                pin:
+                  description:
+                    Install a specific reviewed marketplace pin (full commit SHA) instead of the current one. The pin is
+                    validated against the plugin's marketplace pin history (`GET /v1/plugins/:name/versions`) and
+                    installed from the marketplace revision that introduced it; an unreviewed SHA is rejected. Use this
+                    to roll a plugin back to an older reviewed version.
+                  type: string
               required:
                 - name
       responses:
@@ -27052,6 +27372,10 @@ paths:
                           type: number
                         eventCount:
                           type: number
+                        turnCount:
+                          anyOf:
+                            - type: number
+                            - type: "null"
                       required:
                         - group
                         - groupId
@@ -27061,6 +27385,7 @@ paths:
                         - totalCacheReadTokens
                         - totalEstimatedCostUsd
                         - eventCount
+                        - turnCount
                       additionalProperties: false
                     description: Grouped usage entries
                 required:
@@ -28944,6 +29269,7 @@ components:
         - openai-compatible
         - minimax
         - atlascloud
+        - together
     ProfilePatchEntry:
       type: object
       properties:
@@ -29320,6 +29646,7 @@ components:
         - gemini
         - ollama
         - fireworks
+        - together
         - openrouter
         - openai-compatible
         - minimax

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/assistant",
-  "version": "0.10.0",
+  "version": "0.10.1-staging.1",
   "license": "MIT",
   "type": "module",
   "exports": {
@@ -41,6 +41,7 @@
     "@qdrant/js-client-rest": "1.17.0",
     "@resvg/resvg-js": "2.6.2",
     "@sentry/node": "10.43.0",
+    "@slack/types": "2.21.1",
     "@vellumai/ces-client": "file:../packages/ces-client",
     "@vellumai/credential-storage": "file:../packages/credential-storage",
     "@vellumai/egress-proxy": "file:../packages/egress-proxy",

package/scripts/memory-inspect.ts

@@ -22,10 +22,13 @@ import {
   queryNodes,
 } from "../src/memory/graph/store.js";
 import type { ScoredNode } from "../src/memory/graph/types.js";
-import { initQdrantClient, resolveQdrantUrl } from "../src/memory/qdrant-client.js";
+import {
+  initQdrantClient,
+  resolveQdrantUrl,
+} from "../src/memory/qdrant-client.js";
 
 // Initialize DB and Qdrant before anything else
-initializeDb();
+await initializeDb();
 const config = getConfig();
 try {
   initQdrantClient({
@@ -83,7 +86,7 @@ async function main() {
   } else if (args.includes("--narrative")) {
     await runNarrative();
   } else if (args.includes("--decay")) {
-    runDecay();
+    await runDecay();
   } else {
     console.log(`Memory Graph Inspector
 
@@ -211,7 +214,8 @@ async function showStats() {
 }
 
 async function showContextLoad() {
-  const { loadContextMemory } = await import("../src/memory/graph/retriever.js");
+  const { loadContextMemory } =
+    await import("../src/memory/graph/retriever.js");
 
   console.log("\n  Simulating context load (conversation start)...\n");
 
@@ -227,7 +231,8 @@ async function showContextLoad() {
   console.log(`  Triggered: ${result.triggeredNodes.length} triggers fired`);
 
   // Show assembled context
-  const { assembleContextBlock } = await import("../src/memory/graph/injection.js");
+  const { assembleContextBlock } =
+    await import("../src/memory/graph/injection.js");
   const block = assembleContextBlock(result.nodes, {
     serendipityNodes: result.serendipityNodes,
   });
@@ -245,7 +250,8 @@ async function showContextLoad() {
 
 async function showQuery(query: string) {
   const { embedWithRetry } = await import("../src/memory/embed.js");
-  const { searchGraphNodes } = await import("../src/memory/graph/graph-search.js");
+  const { searchGraphNodes } =
+    await import("../src/memory/graph/graph-search.js");
   const { getNodesByIds } = await import("../src/memory/graph/store.js");
 
   console.log(`\n  Searching: "${query}"\n`);
@@ -369,7 +375,8 @@ function showNode(nodeId: string) {
 async function showTurn(userMessage: string) {
   const { retrieveForTurn } = await import("../src/memory/graph/retriever.js");
   const { InContextTracker } = await import("../src/memory/graph/injection.js");
-  const { assembleInjectionBlock } = await import("../src/memory/graph/injection.js");
+  const { assembleInjectionBlock } =
+    await import("../src/memory/graph/injection.js");
 
   const tracker = new InContextTracker();
 
@@ -440,7 +447,8 @@ async function runBootstrap() {
 }
 
 async function runJournalBootstrap() {
-  const { bootstrapFromJournal } = await import("../src/memory/graph/bootstrap.js");
+  const { bootstrapFromJournal } =
+    await import("../src/memory/graph/bootstrap.js");
 
   console.log("\n  Extracting from journal files...\n");
   const result = await bootstrapFromJournal();
@@ -450,7 +458,8 @@ async function runJournalBootstrap() {
 }
 
 async function runConsolidate() {
-  const { runConsolidation } = await import("../src/memory/graph/consolidation.js");
+  const { runConsolidation } =
+    await import("../src/memory/graph/consolidation.js");
   console.log("\n  Running consolidation...\n");
   const result = await runConsolidation("default", config);
   console.log(
@@ -469,7 +478,8 @@ async function runConsolidate() {
 }
 
 async function runPatterns() {
-  const { runPatternScan } = await import("../src/memory/graph/pattern-scan.js");
+  const { runPatternScan } =
+    await import("../src/memory/graph/pattern-scan.js");
   console.log("\n  Running pattern scan...\n");
   const result = await runPatternScan("default", config);
   console.log(
@@ -481,7 +491,8 @@ async function runPatterns() {
 }
 
 async function runNarrative() {
-  const { runNarrativeRefinement } = await import("../src/memory/graph/narrative.js");
+  const { runNarrativeRefinement } =
+    await import("../src/memory/graph/narrative.js");
   console.log("\n  Running narrative refinement...\n");
   const result = await runNarrativeRefinement("default", config);
   console.log(
@@ -500,9 +511,8 @@ async function runNarrative() {
   console.log();
 }
 
-function runDecay() {
-  // eslint-disable-next-line @typescript-eslint/no-require-imports
-  const { runDecayTick } = require("../src/memory/graph/decay.js") as typeof import("../src/memory/graph/decay.js");
+async function runDecay() {
+  const { runDecayTick } = await import("../src/memory/graph/decay.js");
   console.log("\n  Running decay tick...\n");
   const result = runDecayTick("default");
   console.log(`  Nodes processed: ${result.nodesProcessed}`);