@vellumai/assistant 0.6.5 → 0.6.6

package/openapi.yaml

@@ -3,7 +3,7 @@
 openapi: 3.0.0
 info:
   title: Vellum Assistant API
-  version: 0.6.5
+  version: 0.6.6
   description: Auto-generated OpenAPI specification for the Vellum Assistant runtime HTTP server.
 servers:
   - url: http://127.0.0.1:7821
@@ -1894,72 +1894,6 @@ paths:
       responses:
         "200":
           description: Successful response
-  /v1/computer-use/watch:
-    post:
-      operationId: computeruse_watch_post
-      summary: Submit watch observation
-      description: Send a screen observation from ambient watch mode.
-      tags:
-        - computer-use
-      responses:
-        "200":
-          description: Successful response
-          content:
-            application/json:
-              schema:
-                type: object
-                properties:
-                  ok:
-                    type: boolean
-                required:
-                  - ok
-                additionalProperties: false
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              type: object
-              properties:
-                watchId:
-                  type: string
-                  description: Watch session ID
-                conversationId:
-                  type: string
-                  description: Conversation to associate with
-                ocrText:
-                  type: string
-                  description: OCR text from screen capture
-                appName:
-                  type: string
-                  description: Active application name
-                windowTitle:
-                  type: string
-                  description: Active window title
-                bundleIdentifier:
-                  type: string
-                  description: Application bundle identifier
-                timestamp:
-                  type: number
-                  description: Capture timestamp (epoch ms)
-                captureIndex:
-                  type: integer
-                  minimum: -9007199254740991
-                  maximum: 9007199254740991
-                  description: Index of this capture in the batch
-                totalExpected:
-                  type: integer
-                  minimum: -9007199254740991
-                  maximum: 9007199254740991
-                  description: Total captures expected in the batch
-              required:
-                - watchId
-                - conversationId
-                - ocrText
-                - timestamp
-                - captureIndex
-                - totalExpected
-              additionalProperties: false
   /v1/config:
     get:
       operationId: config_get
@@ -2880,6 +2814,82 @@ paths:
               required:
                 - name
               additionalProperties: false
+  /v1/conversations/{id}/playground/compact:
+    post:
+      operationId: conversations_by_id_playground_compact_post
+      summary: Force compaction on a conversation (dev-only playground)
+      tags:
+        - playground
+      responses:
+        "200":
+          description: Successful response
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+  /v1/conversations/{id}/playground/compaction-state:
+    get:
+      operationId: conversations_by_id_playground_compactionstate_get
+      summary: Read current compaction state for a conversation
+      tags:
+        - playground
+      responses:
+        "200":
+          description: Successful response
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+  /v1/conversations/{id}/playground/inject-compaction-failures:
+    post:
+      operationId: conversations_by_id_playground_injectcompactionfailures_post
+      summary: Directly mutate compaction circuit-breaker state (dev-only playground)
+      tags:
+        - playground
+      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:
+                consecutiveFailures:
+                  type: integer
+                  minimum: 0
+                  maximum: 10
+                circuitOpenForMs:
+                  type: integer
+                  minimum: 0
+                  maximum: 86400000
+              additionalProperties: false
+  /v1/conversations/{id}/playground/reset-compaction-circuit:
+    post:
+      operationId: conversations_by_id_playground_resetcompactioncircuit_post
+      summary: Clear compaction circuit-breaker state (dev-only playground)
+      tags:
+        - playground
+      responses:
+        "200":
+          description: Successful response
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
   /v1/conversations/{id}/regenerate:
     post:
       operationId: conversations_by_id_regenerate_post
@@ -4234,6 +4244,7 @@ paths:
                             - slack
                             - calendar
                             - assistant
+                            - telegram
                         timestamp:
                           type: string
                         status:
@@ -4273,6 +4284,23 @@ paths:
                             - medium
                             - high
                             - critical
+                        conversationId:
+                          type: string
+                        detailPanel:
+                          type: object
+                          properties:
+                            kind:
+                              type: string
+                              enum:
+                                - emailDraft
+                                - documentPreview
+                                - permissionChat
+                                - paymentAuth
+                                - toolPermission
+                                - updatesList
+                          required:
+                            - kind
+                          additionalProperties: false
                         author:
                           type: string
                           enum:
@@ -4405,6 +4433,7 @@ paths:
                       - slack
                       - calendar
                       - assistant
+                      - telegram
                   timestamp:
                     type: string
                   status:
@@ -4444,6 +4473,23 @@ paths:
                       - medium
                       - high
                       - critical
+                  conversationId:
+                    type: string
+                  detailPanel:
+                    type: object
+                    properties:
+                      kind:
+                        type: string
+                        enum:
+                          - emailDraft
+                          - documentPreview
+                          - permissionChat
+                          - paymentAuth
+                          - toolPermission
+                          - updatesList
+                    required:
+                      - kind
+                    additionalProperties: false
                   author:
                     type: string
                     enum:
@@ -6056,6 +6102,70 @@ paths:
           schema:
             type: string
           description: Conversation ID
+  /v1/playground/seed-conversation:
+    post:
+      operationId: playground_seedconversation_post
+      summary: Create a synthetic seeded conversation for compaction testing
+      tags:
+        - playground
+      responses:
+        "200":
+          description: Successful response
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                turns:
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 500
+                avgTokensPerTurn:
+                  default: 500
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 5000
+                title:
+                  type: string
+                  maxLength: 120
+              required:
+                - turns
+                - avgTokensPerTurn
+              additionalProperties: false
+  /v1/playground/seeded-conversations:
+    delete:
+      operationId: playground_seededconversations_delete
+      summary: Delete every seeded playground conversation (prefix-gated)
+      tags:
+        - playground
+      responses:
+        "200":
+          description: Successful response
+    get:
+      operationId: playground_seededconversations_get
+      summary: List conversations created by the seed-conversation endpoint
+      tags:
+        - playground
+      responses:
+        "200":
+          description: Successful response
+  /v1/playground/seeded-conversations/{id}:
+    delete:
+      operationId: playground_seededconversations_by_id_delete
+      summary: Delete a single seeded conversation (prefix-gated)
+      tags:
+        - playground
+      responses:
+        "200":
+          description: Successful response
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
   /v1/profiler/runs:
     get:
       operationId: profiler_runs_get
@@ -6532,9 +6642,14 @@ paths:
                   type: string
                 message:
                   type: string
+                script:
+                  anyOf:
+                    - type: string
+                    - type: "null"
+                  description: Shell command for script mode
                 mode:
                   type: string
-                  description: notify or execute
+                  description: notify, execute, or script
                 routingIntent:
                   type: string
                   description: single_channel, multi_channel, or all_channels
@@ -6547,6 +6662,7 @@ paths:
                 - expression
                 - timezone
                 - message
+                - script
                 - mode
                 - routingIntent
                 - quiet
@@ -6608,6 +6724,34 @@ paths:
           required: true
           schema:
             type: string
+  /v1/schedules/{id}/runs:
+    get:
+      operationId: schedules_by_id_runs_get
+      summary: List schedule runs
+      description: Return recent invocation history for a schedule.
+      tags:
+        - schedules
+      responses:
+        "200":
+          description: Successful response
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  runs:
+                    type: array
+                    items: {}
+                    description: Schedule run objects
+                required:
+                  - runs
+                additionalProperties: false
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
   /v1/schedules/{id}/toggle:
     post:
       operationId: schedules_by_id_toggle_post

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/assistant",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "license": "MIT",
   "type": "module",
   "exports": {

package/src/__tests__/app-compiler.test.ts

@@ -355,6 +355,63 @@ console.log("styled");`,
     const r2 = await compileApp(appDir2);
     expect(r2.ok).toBe(true);
   }, 30_000);
+
+  test("concurrent callers during an in-flight compile coalesce to at most one follow-up", async () => {
+    const appDir = await scaffold("concurrent-dedup", {
+      "main.tsx": `console.log("hello");`,
+      "index.html": MINIMAL_HTML,
+    });
+
+    // Kick off three concurrent compiles. Serialisation guarantees the
+    // first runs to completion alone; callers 2 and 3 coalesce into a
+    // single follow-up compile that begins after the first settles.
+    const [r1, r2, r3] = await Promise.all([
+      compileApp(appDir),
+      compileApp(appDir),
+      compileApp(appDir),
+    ]);
+
+    expect(r1.ok).toBe(true);
+    expect(r2.ok).toBe(true);
+    expect(r3.ok).toBe(true);
+
+    // Callers 2 and 3 share the coalesced follow-up promise.
+    expect(r2).toBe(r3);
+    // Caller 1 ran a distinct compile from the coalesced follow-up.
+    expect(r1).not.toBe(r2);
+
+    // Final dist/ output must be intact regardless of how many compiles
+    // ran: main.js non-empty and index.html has the injected script tag.
+    const js = await readFile(join(appDir, "dist", "main.js"), "utf-8");
+    expect(js.length).toBeGreaterThan(0);
+    const html = await readFile(join(appDir, "dist", "index.html"), "utf-8");
+    expect(html).toContain('src="main.js"');
+  });
+
+  test("source edit during an in-flight compile is picked up by the follow-up", async () => {
+    const appDir = await scaffold("mid-build-edit", {
+      "main.tsx": `console.log("original");`,
+      "index.html": MINIMAL_HTML,
+    });
+
+    // Start the first compile but do not await it yet.
+    const first = compileApp(appDir);
+
+    // Mutate the source while the first compile is still running, then
+    // request another compile. The follow-up must read the updated source
+    // rather than silently reusing the first compile's (now stale) output.
+    await writeFile(join(appDir, "src", "main.tsx"), `console.log("updated");`);
+    const second = compileApp(appDir);
+
+    const [r1, r2] = await Promise.all([first, second]);
+    expect(r1.ok).toBe(true);
+    expect(r2.ok).toBe(true);
+    expect(r1).not.toBe(r2);
+
+    const js = await readFile(join(appDir, "dist", "main.js"), "utf-8");
+    expect(js).toContain("updated");
+    expect(js).not.toContain("original");
+  });
 });
 
 // ---------------------------------------------------------------------------

package/src/__tests__/approval-cascade.test.ts

@@ -56,7 +56,7 @@ mock.module("../providers/registry.js", () => ({
 
 mock.module("../config/loader.js", () => ({
   getConfig: () => ({
-    ui: {},    
+    ui: {},
     llm: {
       default: {
         provider: "mock-provider",
@@ -205,6 +205,9 @@ mock.module("../agent/loop.js", () => ({
     getToolTokenBudget() {
       return 0;
     }
+    getResolvedTools() {
+      return [];
+    }
     getActiveModel() {
       return undefined;
     }
@@ -213,7 +216,9 @@ mock.module("../agent/loop.js", () => ({
       _onEvent: (event: AgentEvent) => void,
       _signal?: AbortSignal,
       _requestId?: string,
-      _onCheckpoint?: (checkpoint: CheckpointInfo) => CheckpointDecision,
+      _onCheckpoint?: (
+        checkpoint: CheckpointInfo,
+      ) => CheckpointDecision | Promise<CheckpointDecision>,
     ): Promise<Message[]> {
       return [];
     }

package/src/__tests__/auto-analysis-end-to-end.test.ts

@@ -50,6 +50,7 @@ mock.module("../memory/qdrant-client.js", () => ({
     deletePoints: async () => {},
   }),
   initQdrantClient: () => {},
+  resolveQdrantUrl: () => "http://127.0.0.1:6333",
 }));
 
 // ── Test config ────────────────────────────────────────────────────

package/src/__tests__/avatar-generator.test.ts

@@ -96,8 +96,10 @@ describe("generateAndSaveAvatar", () => {
     expect(result.content).toContain("No image data returned");
   });
 
-  test("generic error returns mapped message", async () => {
-    mockRouterError = new Error("Network timeout");
+  test("router-mapped error message is surfaced verbatim", async () => {
+    // avatar-router now maps provider errors before throwing, so the
+    // generator just surfaces error.message directly.
+    mockRouterError = new Error("Image generation failed: Network timeout");
 
     const result = await executeAvatar("a cat");
 

package/src/__tests__/bundled-asset.test.ts

@@ -101,18 +101,18 @@ describe("resolveBundledDir", () => {
       const macosDir = join(tempDir, "Contents", "MacOS");
       const resourcesDir = join(tempDir, "Contents", "Resources");
       mkdirSync(macosDir, { recursive: true });
-      mkdirSync(join(resourcesDir, "hook-templates"), { recursive: true });
+      mkdirSync(join(resourcesDir, "compact-prompts"), { recursive: true });
       // Also create at execDir level
-      mkdirSync(join(macosDir, "hook-templates"), { recursive: true });
+      mkdirSync(join(macosDir, "compact-prompts"), { recursive: true });
 
       process.execPath = join(macosDir, "vellum-daemon");
 
       const result = resolveBundledDir(
-        "/$bunfs/root/src/hooks",
-        "../../hook-templates",
-        "hook-templates",
+        "/$bunfs/root/src/context/prompts",
+        "..",
+        "compact-prompts",
       );
-      expect(result).toBe(join(resourcesDir, "hook-templates"));
+      expect(result).toBe(join(resourcesDir, "compact-prompts"));
     });
 
     test("works with different bundleName values", () => {

package/src/__tests__/catalog-cache.test.ts

@@ -184,4 +184,73 @@ describe("getCatalog", () => {
     expect(readLocalCatalogCallCount).toBe(1);
     expect(fetchCatalogCallCount).toBe(1); // attempted remote fetch
   });
+
+  test("preserves merged cache when later remote fetch fails", async () => {
+    mockRepoSkillsDir = "/mock/repo/skills";
+    mockLocalCatalog = [
+      { id: "web-search", name: "Local Web Search", description: "Local" },
+    ];
+    mockFetchCatalogResult = [
+      { id: "web-search", name: "Remote Web Search", description: "Remote" },
+      { id: "remote-only", name: "Remote Only", description: "Remote only" },
+    ];
+
+    // Prime the cache with a successful merged fetch.
+    const merged = await getCatalog();
+    expect(merged).toEqual([
+      { id: "web-search", name: "Local Web Search", description: "Local" },
+      { id: "remote-only", name: "Remote Only", description: "Remote only" },
+    ]);
+
+    // Expire TTL and make remote fetch fail.
+    const originalNow = Date.now;
+    Date.now = () => originalNow() + 5 * 60 * 1000 + 1;
+    try {
+      mockFetchCatalogError = new Error("Network timeout");
+      const fallback = await getCatalog();
+      // Must retain remote-only skills rather than regressing to bare local.
+      expect(fallback).toEqual(merged);
+    } finally {
+      Date.now = originalNow;
+    }
+  });
+
+  test("resets TTL on stale-cache fallback so subsequent calls hit cache", async () => {
+    mockFetchCatalogResult = sampleCatalog;
+
+    // Prime cache.
+    await getCatalog();
+    expect(fetchCatalogCallCount).toBe(1);
+
+    // Expire TTL, trigger fallback once.
+    const originalNow = Date.now;
+    let clock = originalNow() + 5 * 60 * 1000 + 1;
+    Date.now = () => clock;
+    try {
+      mockFetchCatalogError = new Error("Network timeout");
+      const first = await getCatalog();
+      expect(first).toEqual(sampleCatalog);
+      expect(fetchCatalogCallCount).toBe(2);
+
+      // Advance clock by less than the TTL — subsequent calls must be served
+      // from the refreshed cache window without re-entering fetchCatalog().
+      clock += 60 * 1000;
+      const second = await getCatalog();
+      expect(second).toEqual(sampleCatalog);
+      expect(fetchCatalogCallCount).toBe(2);
+
+      clock += 2 * 60 * 1000;
+      const third = await getCatalog();
+      expect(third).toEqual(sampleCatalog);
+      expect(fetchCatalogCallCount).toBe(2);
+
+      // Once the refreshed TTL elapses, the next call retries the remote.
+      clock += 5 * 60 * 1000 + 1;
+      const fourth = await getCatalog();
+      expect(fourth).toEqual(sampleCatalog);
+      expect(fetchCatalogCallCount).toBe(3);
+    } finally {
+      Date.now = originalNow;
+    }
+  });
 });