@vellumai/assistant 0.8.10-dev.202606110544.2aed335 → 0.8.10-dev.202606110941.6cb149d

package/openapi.yaml

@@ -4539,55 +4539,6 @@ paths:
                   - lastRunAt
                   - success
                 additionalProperties: false
-    put:
-      operationId: consolidation_config_put
-      summary: Update consolidation config
-      description: Update the 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
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                enabled:
-                  description: Enable or disable automatic consolidation
-                  type: boolean
-              additionalProperties: false
   /v1/consolidation/run-now:
     post:
       operationId: consolidation_runnow_post
@@ -6020,6 +5971,8 @@ paths:
                           additionalProperties: false
                         archivedAt:
                           type: number
+                        surfacedAt:
+                          type: number
                         inferenceProfile:
                           type: string
                         isProcessing:
@@ -6381,6 +6334,8 @@ paths:
                         additionalProperties: false
                       archivedAt:
                         type: number
+                      surfacedAt:
+                        type: number
                       inferenceProfile:
                         type: string
                       isProcessing:
@@ -6579,6 +6534,8 @@ paths:
                         additionalProperties: false
                       archivedAt:
                         type: number
+                      surfacedAt:
+                        type: number
                       inferenceProfile:
                         type: string
                       isProcessing:
@@ -6987,6 +6944,56 @@ paths:
           required: true
           schema:
             type: string
+  /v1/conversations/{id}/surface:
+    post:
+      operationId: conversations_by_id_surface_post
+      summary: Surface a conversation into Recents
+      description:
+        Explicitly promote a background or scheduled conversation into the default conversation listing (the
+        Recents sidebar grouping), or demote it with surfaced=false. Conversations are never surfaced automatically.
+      tags:
+        - conversations
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  ok:
+                    type: boolean
+                  conversationId:
+                    type: string
+                  surfacedAt:
+                    anyOf:
+                      - type: number
+                      - type: "null"
+                    description: Epoch-ms timestamp of the promotion, or null when cleared.
+                required:
+                  - ok
+                  - conversationId
+                  - surfacedAt
+                additionalProperties: false
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                surfaced:
+                  type: boolean
+                  description: true to surface the conversation into Recents, false to clear the promotion.
+              required:
+                - surfaced
+              additionalProperties: false
   /v1/conversations/{id}/unarchive:
     post:
       operationId: conversations_by_id_unarchive_post
@@ -7542,6 +7549,8 @@ paths:
                         additionalProperties: false
                       archivedAt:
                         type: number
+                      surfacedAt:
+                        type: number
                       inferenceProfile:
                         type: string
                       isProcessing:
@@ -11182,6 +11191,14 @@ paths:
                     required:
                       - connected
                     additionalProperties: false
+                  capabilities:
+                    type: object
+                    properties:
+                      memoryOptOut:
+                        type: boolean
+                    required:
+                      - memoryOptOut
+                    additionalProperties: false
                   profiler:
                     type: object
                     properties:
@@ -11266,6 +11283,7 @@ paths:
                   - cpu
                   - migrations
                   - ces
+                  - capabilities
                 additionalProperties: false
   /v1/healthz:
     get:
@@ -11350,6 +11368,14 @@ paths:
                     required:
                       - connected
                     additionalProperties: false
+                  capabilities:
+                    type: object
+                    properties:
+                      memoryOptOut:
+                        type: boolean
+                    required:
+                      - memoryOptOut
+                    additionalProperties: false
                   profiler:
                     type: object
                     properties:
@@ -11434,6 +11460,7 @@ paths:
                   - cpu
                   - migrations
                   - ces
+                  - capabilities
                 additionalProperties: false
   /v1/heartbeat/checklist:
     get:
@@ -20298,9 +20325,9 @@ paths:
                             - type: number
                             - type: "null"
                         description:
-                          anyOf:
-                            - type: string
-                            - type: "null"
+                          type: string
+                        cadenceDescription:
+                          type: string
                         mode:
                           type: string
                           enum:
@@ -20350,6 +20377,7 @@ paths:
                         - createdFromConversationExists
                         - createdFromConversationArchivedAt
                         - description
+                        - cadenceDescription
                         - mode
                         - status
                         - routingIntent
@@ -20447,9 +20475,9 @@ paths:
                             - type: number
                             - type: "null"
                         description:
-                          anyOf:
-                            - type: string
-                            - type: "null"
+                          type: string
+                        cadenceDescription:
+                          type: string
                         mode:
                           type: string
                           enum:
@@ -20499,6 +20527,7 @@ paths:
                         - createdFromConversationExists
                         - createdFromConversationArchivedAt
                         - description
+                        - cadenceDescription
                         - mode
                         - status
                         - routingIntent
@@ -20520,6 +20549,9 @@ paths:
                 name:
                   type: string
                   description: Display name
+                description:
+                  type: string
+                  description: Authored schedule description. Defaults to the schedule name when omitted for backward compatibility.
                 expression:
                   type: string
                   description: Cron or RRULE expression
@@ -20622,9 +20654,9 @@ paths:
                             - type: number
                             - type: "null"
                         description:
-                          anyOf:
-                            - type: string
-                            - type: "null"
+                          type: string
+                        cadenceDescription:
+                          type: string
                         mode:
                           type: string
                           enum:
@@ -20674,6 +20706,7 @@ paths:
                         - createdFromConversationExists
                         - createdFromConversationArchivedAt
                         - description
+                        - cadenceDescription
                         - mode
                         - status
                         - routingIntent
@@ -20770,9 +20803,9 @@ paths:
                             - type: number
                             - type: "null"
                         description:
-                          anyOf:
-                            - type: string
-                            - type: "null"
+                          type: string
+                        cadenceDescription:
+                          type: string
                         mode:
                           type: string
                           enum:
@@ -20822,6 +20855,7 @@ paths:
                         - createdFromConversationExists
                         - createdFromConversationArchivedAt
                         - description
+                        - cadenceDescription
                         - mode
                         - status
                         - routingIntent
@@ -20848,6 +20882,8 @@ paths:
               properties:
                 name:
                   type: string
+                description:
+                  type: string
                 expression:
                   type: string
                 timezone:
@@ -20961,9 +20997,9 @@ paths:
                             - type: number
                             - type: "null"
                         description:
-                          anyOf:
-                            - type: string
-                            - type: "null"
+                          type: string
+                        cadenceDescription:
+                          type: string
                         mode:
                           type: string
                           enum:
@@ -21013,6 +21049,7 @@ paths:
                         - createdFromConversationExists
                         - createdFromConversationArchivedAt
                         - description
+                        - cadenceDescription
                         - mode
                         - status
                         - routingIntent
@@ -21110,9 +21147,9 @@ paths:
                             - type: number
                             - type: "null"
                         description:
-                          anyOf:
-                            - type: string
-                            - type: "null"
+                          type: string
+                        cadenceDescription:
+                          type: string
                         mode:
                           type: string
                           enum:
@@ -21162,6 +21199,7 @@ paths:
                         - createdFromConversationExists
                         - createdFromConversationArchivedAt
                         - description
+                        - cadenceDescription
                         - mode
                         - status
                         - routingIntent
@@ -21348,9 +21386,9 @@ paths:
                             - type: number
                             - type: "null"
                         description:
-                          anyOf:
-                            - type: string
-                            - type: "null"
+                          type: string
+                        cadenceDescription:
+                          type: string
                         mode:
                           type: string
                           enum:
@@ -21400,6 +21438,7 @@ paths:
                         - createdFromConversationExists
                         - createdFromConversationArchivedAt
                         - description
+                        - cadenceDescription
                         - mode
                         - status
                         - routingIntent

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/assistant",
-  "version": "0.8.10-dev.202606110544.2aed335",
+  "version": "0.8.10-dev.202606110941.6cb149d",
   "license": "MIT",
   "type": "module",
   "exports": {

package/src/__tests__/background-workers-disk-pressure.test.ts

@@ -167,7 +167,6 @@ const mockFailStalledJobs = mock(() => 0);
 const mockClaimMemoryJobs = mock(() => []);
 mock.module("../memory/jobs-store.js", () => ({
   claimMemoryJobs: mockClaimMemoryJobs,
-  cancelPendingAutomaticConsolidationJobs: mock(() => 0),
   completeMemoryJob: mock(() => {}),
   deferMemoryJob: mock(() => "deferred"),
   EMBED_JOB_TYPES: [],
@@ -179,7 +178,6 @@ mock.module("../memory/jobs-store.js", () => ({
   failStalledJobs: mockFailStalledJobs,
   getMemoryJobCounts: mock(() => ({})),
   hasActiveJobOfType: mock(() => false),
-  isAutomaticConsolidationJob: mock(() => true),
   isMemoryEnabled: () => true,
   MEMORY_V2_CONSOLIDATION_JOB_TRIGGERS: {
     automatic: "automatic",

package/src/__tests__/db-schedule-syntax-migration.test.ts

@@ -4,6 +4,7 @@ import { describe, expect, test } from "bun:test";
 import { eq } from "drizzle-orm";
 import { drizzle } from "drizzle-orm/bun-sqlite";
 
+import { migrateScheduleDescription } from "../memory/migrations/270-schedule-description.js";
 import { migrateScheduleSourceConversation } from "../memory/migrations/270-schedule-source-conversation.js";
 import * as schema from "../memory/schema.js";
 import { scheduleJobs } from "../memory/schema.js";
@@ -50,6 +51,7 @@ describe("schedule_syntax column migration", () => {
         script TEXT,
         wake_conversation_id TEXT,
         timeout_ms INTEGER,
+        description TEXT NOT NULL DEFAULT '',
         created_at INTEGER NOT NULL,
         updated_at INTEGER NOT NULL
       )
@@ -137,6 +139,7 @@ describe("schedule_syntax column migration", () => {
       /* already exists */
     }
     migrateScheduleSourceConversation(db);
+    migrateScheduleDescription(db);
 
     const row = db
       .select()
@@ -202,6 +205,8 @@ describe("schedule_syntax column migration", () => {
     }
     migrateScheduleSourceConversation(db);
     migrateScheduleSourceConversation(db);
+    migrateScheduleDescription(db);
+    migrateScheduleDescription(db);
 
     const now = Date.now();
     raw.exec(
@@ -214,4 +219,79 @@ describe("schedule_syntax column migration", () => {
       .get();
     expect(row!.scheduleSyntax).toBe("cron");
   });
+
+  test("schedule description migration backfills non-defer rows once", () => {
+    const db = createTestDb();
+    const raw = getRawSqlite(db);
+
+    raw.exec(/*sql*/ `
+      CREATE TABLE IF NOT EXISTS cron_jobs (
+        id TEXT PRIMARY KEY,
+        name TEXT NOT NULL,
+        enabled INTEGER NOT NULL DEFAULT 1,
+        cron_expression TEXT,
+        schedule_syntax TEXT NOT NULL DEFAULT 'cron',
+        timezone TEXT,
+        message TEXT NOT NULL,
+        next_run_at INTEGER NOT NULL,
+        retry_count INTEGER NOT NULL DEFAULT 0,
+        created_by TEXT NOT NULL,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      )
+    `);
+
+    const now = Date.now();
+    raw
+      .query(
+        `INSERT INTO cron_jobs (id, name, cron_expression, message, next_run_at, created_by, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+      )
+      .run(
+        "legacy-schedule",
+        "Legacy report",
+        "0 9 * * *",
+        "compile report",
+        now + 60_000,
+        "agent",
+        now,
+        now,
+      );
+    raw
+      .query(
+        `INSERT INTO cron_jobs (id, name, cron_expression, message, next_run_at, created_by, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+      )
+      .run(
+        "legacy-defer",
+        "Deferred wake",
+        null,
+        "resume later",
+        now + 60_000,
+        "defer",
+        now,
+        now,
+      );
+
+    migrateScheduleDescription(db);
+
+    const rows = raw
+      .query("SELECT id, description FROM cron_jobs ORDER BY id")
+      .all() as Array<{ id: string; description: string }>;
+    expect(rows).toEqual([
+      { id: "legacy-defer", description: "" },
+      { id: "legacy-schedule", description: "Legacy report" },
+    ]);
+
+    raw
+      .query("UPDATE cron_jobs SET description = ? WHERE id = ?")
+      .run("", "legacy-schedule");
+
+    migrateScheduleDescription(db);
+
+    const description = raw
+      .query("SELECT description FROM cron_jobs WHERE id = ?")
+      .get("legacy-schedule") as { description: string };
+    expect(description.description).toBe("");
+  });
 });

package/src/__tests__/identity-routes.test.ts

@@ -237,6 +237,7 @@ describe("identity routes — health endpoint", () => {
       expect(body.memory).toBeDefined();
       expect(body.cpu).toBeDefined();
       expect(body.migrations).toBeDefined();
+      expect(body.capabilities).toEqual({ memoryOptOut: true });
 
       // Profiler should either be absent or show enabled: false
       if ("profiler" in body) {

package/src/__tests__/intent-routing.test.ts

@@ -83,6 +83,13 @@ describe("schedule_create tool description", () => {
     expect(scheduleCreateDef.description).toContain("cron");
   });
 
+  test("requires an authored description", () => {
+    expect(scheduleCreateDef.input_schema.required).toContain("description");
+    expect(
+      scheduleCreateDef.input_schema.properties.description.description,
+    ).toContain("what it does and why");
+  });
+
   test('warns against using for "add to my tasks" requests', () => {
     expect(scheduleCreateDef.description).toContain(
       'Do NOT use this for "add to my tasks"',

package/src/__tests__/require-fresh-approval.test.ts

@@ -125,6 +125,9 @@ mock.module("../tools/registry.js", () => ({
 
 mock.module("../permissions/gateway-threshold-reader.js", () => ({
   getAutoApproveThreshold: async () => "medium",
+  // Refresh failure ("null") keeps the original decision — these tests
+  // exercise the cached-threshold paths only.
+  refreshAutoApproveThreshold: async () => null,
   _clearGlobalCacheForTesting: () => {},
 }));