@vellumai/assistant 0.10.9-dev.202607161831.8c8f521 → 0.10.9-dev.202607161931.aae7e04

package/openapi.yaml

@@ -29081,13 +29081,13 @@ paths:
   /v1/telemetry/ingest:
     post:
       operationId: telemetry_ingest_post
-      summary: Record a client-reportable telemetry event
+      summary: Record an outbox-backed telemetry event
       description:
-        "Record any client-reportable outbox-backed telemetry event by its wire `type` + `fields`.
-        Client-orchestrated: for events the daemon can't observe on its own (e.g. onboarding_research). The type must be
-        on the daemon's client-reportable allowlist and the payload must pass the platform wire schema. Gated on
-        share_analytics consent like every other outbox-backed event; the platform re-checks the owner's consent
-        server-side at ingest."
+        Record any outbox-backed telemetry event by its wire `type` + `fields`. For events a client observes and
+        the daemon can't detect on its own (e.g. onboarding_research). The type must be an outbox-backed event — the
+        watermark types (turn, llm_usage, tool_executed) have no variant — and the payload must pass the platform wire
+        schema. Gated on share_analytics consent like every other outbox-backed event; the platform re-checks the
+        owner's consent server-side at ingest.
       tags:
         - telemetry
       requestBody:
@@ -29095,29 +29095,403 @@ paths:
         content:
           application/json:
             schema:
+              oneOf:
+                - type: object
+                  properties:
+                    type:
+                      type: string
+                      const: lifecycle
+                    fields:
+                      type: object
+                      properties:
+                        event_name:
+                          type: string
+                          minLength: 1
+                          maxLength: 64
+                      required:
+                        - event_name
+                      description:
+                        Wire event fields, excluding the daemon-stamped base fields (type, daemon_event_id, recorded_at,
+                        assistant_version).
+                    daemon_event_id:
+                      description:
+                        "Optional collapse key: rows sharing an id collapse downstream (e.g. a retried report). Defaults to a fresh
+                        per-row id."
+                      type: string
+                      minLength: 1
+                      maxLength: 128
+                  required:
+                    - type
+                    - fields
+                - type: object
+                  properties:
+                    type:
+                      type: string
+                      const: onboarding
+                    fields:
+                      type: object
+                      properties:
+                        screen:
+                          type: string
+                          minLength: 1
+                          maxLength: 64
+                        tools:
+                          type: array
+                          items:
+                            type: string
+                            minLength: 1
+                            maxLength: 128
+                        tasks:
+                          type: array
+                          items:
+                            type: string
+                            minLength: 1
+                            maxLength: 128
+                        tone:
+                          type: string
+                          minLength: 1
+                          maxLength: 64
+                        google_connected:
+                          type: boolean
+                        google_scopes:
+                          type: array
+                          items:
+                            type: string
+                            minLength: 1
+                            maxLength: 256
+                        ab_variant:
+                          type: string
+                          minLength: 1
+                          maxLength: 64
+                        session_id:
+                          type: string
+                          minLength: 1
+                          maxLength: 128
+                        step_name:
+                          type: string
+                          minLength: 1
+                          maxLength: 128
+                        step_index:
+                          type: integer
+                          minimum: 0
+                          maximum: 9007199254740991
+                        completed_at:
+                          type: string
+                          minLength: 1
+                          maxLength: 64
+                        funnel_version:
+                          type: string
+                          minLength: 1
+                          maxLength: 128
+                        user_id:
+                          anyOf:
+                            - type: string
+                              minLength: 1
+                              maxLength: 64
+                            - type: "null"
+                        outcome:
+                          type: string
+                          minLength: 1
+                          maxLength: 32
+                      description:
+                        Wire event fields, excluding the daemon-stamped base fields (type, daemon_event_id, recorded_at,
+                        assistant_version).
+                    daemon_event_id:
+                      description:
+                        "Optional collapse key: rows sharing an id collapse downstream (e.g. a retried report). Defaults to a fresh
+                        per-row id."
+                      type: string
+                      minLength: 1
+                      maxLength: 128
+                  required:
+                    - type
+                    - fields
+                - type: object
+                  properties:
+                    type:
+                      type: string
+                      const: auth_fallback
+                    fields:
+                      type: object
+                      properties:
+                        guard:
+                          type: string
+                          minLength: 1
+                          maxLength: 64
+                        failure_kind:
+                          type: string
+                          minLength: 1
+                          maxLength: 64
+                        path:
+                          type: string
+                          minLength: 1
+                          maxLength: 2048
+                        count:
+                          type: integer
+                          minimum: 0
+                          maximum: 9007199254740991
+                        window_start:
+                          type: integer
+                          minimum: 0
+                          maximum: 9007199254740991
+                        window_end:
+                          type: integer
+                          minimum: 0
+                          maximum: 9007199254740991
+                      required:
+                        - guard
+                        - failure_kind
+                        - path
+                        - count
+                        - window_start
+                        - window_end
+                      description:
+                        Wire event fields, excluding the daemon-stamped base fields (type, daemon_event_id, recorded_at,
+                        assistant_version).
+                    daemon_event_id:
+                      description:
+                        "Optional collapse key: rows sharing an id collapse downstream (e.g. a retried report). Defaults to a fresh
+                        per-row id."
+                      type: string
+                      minLength: 1
+                      maxLength: 128
+                  required:
+                    - type
+                    - fields
+                - type: object
+                  properties:
+                    type:
+                      type: string
+                      const: skill_loaded
+                    fields:
+                      type: object
+                      properties:
+                        provider:
+                          anyOf:
+                            - type: string
+                              minLength: 1
+                              maxLength: 64
+                            - type: "null"
+                        model:
+                          anyOf:
+                            - type: string
+                              minLength: 1
+                              maxLength: 128
+                            - type: "null"
+                        inference_profile:
+                          anyOf:
+                            - type: string
+                              minLength: 1
+                              maxLength: 255
+                            - type: "null"
+                        inference_profile_source:
+                          anyOf:
+                            - type: string
+                              minLength: 1
+                              maxLength: 255
+                            - type: "null"
+                        skill_name:
+                          type: string
+                          minLength: 1
+                          maxLength: 255
+                        skill_updated_at:
+                          anyOf:
+                            - type: string
+                              minLength: 1
+                              maxLength: 64
+                            - type: "null"
+                        conversation_id:
+                          anyOf:
+                            - type: string
+                              minLength: 1
+                              maxLength: 128
+                            - type: "null"
+                      required:
+                        - skill_name
+                      description:
+                        Wire event fields, excluding the daemon-stamped base fields (type, daemon_event_id, recorded_at,
+                        assistant_version).
+                    daemon_event_id:
+                      description:
+                        "Optional collapse key: rows sharing an id collapse downstream (e.g. a retried report). Defaults to a fresh
+                        per-row id."
+                      type: string
+                      minLength: 1
+                      maxLength: 128
+                  required:
+                    - type
+                    - fields
+                - type: object
+                  properties:
+                    type:
+                      type: string
+                      const: watchdog
+                    fields:
+                      type: object
+                      properties:
+                        check_name:
+                          type: string
+                          minLength: 1
+                          maxLength: 128
+                        value:
+                          anyOf:
+                            - type: number
+                            - type: "null"
+                        detail:
+                          anyOf:
+                            - $ref: "#/components/schemas/TelemetryJsonValue"
+                            - type: "null"
+                      required:
+                        - check_name
+                      description:
+                        Wire event fields, excluding the daemon-stamped base fields (type, daemon_event_id, recorded_at,
+                        assistant_version).
+                    daemon_event_id:
+                      description:
+                        "Optional collapse key: rows sharing an id collapse downstream (e.g. a retried report). Defaults to a fresh
+                        per-row id."
+                      type: string
+                      minLength: 1
+                      maxLength: 128
+                  required:
+                    - type
+                    - fields
+                - type: object
+                  properties:
+                    type:
+                      type: string
+                      const: config_setting
+                    fields:
+                      type: object
+                      properties:
+                        config_key:
+                          type: string
+                          minLength: 1
+                          maxLength: 128
+                        config_value:
+                          type: string
+                          minLength: 1
+                          maxLength: 256
+                      required:
+                        - config_key
+                        - config_value
+                      description:
+                        Wire event fields, excluding the daemon-stamped base fields (type, daemon_event_id, recorded_at,
+                        assistant_version).
+                    daemon_event_id:
+                      description:
+                        "Optional collapse key: rows sharing an id collapse downstream (e.g. a retried report). Defaults to a fresh
+                        per-row id."
+                      type: string
+                      minLength: 1
+                      maxLength: 128
+                  required:
+                    - type
+                    - fields
+                - type: object
+                  properties:
+                    type:
+                      type: string
+                      const: onboarding_research
+                    fields:
+                      type: object
+                      properties:
+                        conversation_id:
+                          anyOf:
+                            - type: string
+                              minLength: 1
+                              maxLength: 64
+                            - type: "null"
+                        status:
+                          type: string
+                          minLength: 1
+                          maxLength: 32
+                        self_reported_occupation:
+                          anyOf:
+                            - type: string
+                              maxLength: 256
+                            - type: "null"
+                        self_reported_hobbies:
+                          maxItems: 32
+                          type: array
+                          items:
+                            type: string
+                            minLength: 1
+                            maxLength: 128
+                        self_reported_timezone:
+                          anyOf:
+                            - type: string
+                              maxLength: 64
+                            - type: "null"
+                        claims:
+                          maxItems: 20
+                          type: array
+                          items:
+                            $ref: "#/components/schemas/TelemetryJsonValue"
+                        claim_count:
+                          type: integer
+                          minimum: 0
+                          maximum: 9007199254740991
+                        claims_confident:
+                          type: integer
+                          minimum: 0
+                          maximum: 9007199254740991
+                        claims_maybe:
+                          type: integer
+                          minimum: 0
+                          maximum: 9007199254740991
+                        claims_guessing:
+                          type: integer
+                          minimum: 0
+                          maximum: 9007199254740991
+                        suggestions:
+                          maxItems: 20
+                          type: array
+                          items:
+                            $ref: "#/components/schemas/TelemetryJsonValue"
+                        suggestion_count:
+                          type: integer
+                          minimum: 0
+                          maximum: 9007199254740991
+                        plugins:
+                          maxItems: 20
+                          type: array
+                          items:
+                            type: string
+                            minLength: 1
+                            maxLength: 128
+                        installed_plugins:
+                          maxItems: 20
+                          type: array
+                          items:
+                            type: string
+                            minLength: 1
+                            maxLength: 128
+                      required:
+                        - status
+                        - claims
+                        - claim_count
+                        - claims_confident
+                        - claims_maybe
+                        - claims_guessing
+                        - suggestions
+                        - suggestion_count
+                        - plugins
+                        - installed_plugins
+                      description:
+                        Wire event fields, excluding the daemon-stamped base fields (type, daemon_event_id, recorded_at,
+                        assistant_version).
+                    daemon_event_id:
+                      description:
+                        "Optional collapse key: rows sharing an id collapse downstream (e.g. a retried report). Defaults to a fresh
+                        per-row id."
+                      type: string
+                      minLength: 1
+                      maxLength: 128
+                  required:
+                    - type
+                    - fields
               type: object
-              properties:
-                type:
-                  type: string
-                  description: Wire event type; must be a client-reportable telemetry event.
-                fields:
-                  type: object
-                  propertyNames:
-                    type: string
-                  additionalProperties: {}
-                  description:
-                    Wire event fields, excluding the daemon-stamped base fields (type, daemon_event_id, recorded_at,
-                    assistant_version).
-                daemon_event_id:
-                  description:
-                    "Optional collapse key: rows sharing an id collapse downstream (e.g. a retried report). Defaults to a fresh
-                    per-row id."
-                  type: string
-                  minLength: 1
-                  maxLength: 128
-              required:
-                - type
-                - fields
       responses:
         "200":
           description: Successful response
@@ -32039,6 +32413,20 @@ components:
           minLength: 1
       required:
         - id
+    TelemetryJsonValue:
+      anyOf:
+        - type: string
+        - type: number
+        - type: boolean
+        - type: "null"
+        - type: array
+          items:
+            $ref: "#/components/schemas/TelemetryJsonValue"
+        - type: object
+          propertyNames:
+            type: string
+          additionalProperties:
+            $ref: "#/components/schemas/TelemetryJsonValue"
     ConfigGetResponse:
       type: object
       properties:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/assistant",
-  "version": "0.10.9-dev.202607161831.8c8f521",
+  "version": "0.10.9-dev.202607161931.aae7e04",
   "license": "MIT",
   "type": "module",
   "exports": {

package/scripts/generate-openapi.ts

@@ -30,6 +30,14 @@ import type {
 } from "zod-openapi";
 import { createDocument } from "zod-openapi";
 
+import { jsonValueSchema } from "../src/telemetry/telemetry-wire.generated.js";
+
+// The recursive wire JSON-value schema (`claims`/`suggestions` item type) must
+// be hoisted into a named component so it can `$ref` itself; without a
+// registered id zod-openapi falls back to an anonymous `__schema0`. Name it
+// explicitly so the spec + generated SDK read as `TelemetryJsonValue`.
+z.globalRegistry.add(jsonValueSchema, { id: "TelemetryJsonValue" });
+
 const ROOT = resolve(import.meta.dir, "..");
 const ROUTES_DIR = join(ROOT, "src/runtime/routes");
 const PLUGIN_DEFAULTS_DIR = join(ROOT, "src/plugins/defaults");

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

@@ -113,16 +113,34 @@ describe("telemetry-routes: ingest", () => {
     expect(pendingPayloads().length).toBe(1);
   });
 
-  test("rejects a type not on the client-reportable allowlist", () => {
-    // `turn` is a real wire type but daemon-authoritative — a client must never
-    // be able to inject it.
+  test("rejects a non-outbox (watermark) or unknown type", () => {
+    // `turn` is a real wire type but watermark-flushed, not outbox-backed, so it
+    // has no ingest variant and a client can't inject it.
     expect(() => call({ type: "turn", fields: {} })).toThrow(RouteError);
     // An unknown type is rejected the same way.
     expect(() => call({ type: "not_a_type", fields: {} })).toThrow(RouteError);
     expect(pendingPayloads().length).toBe(0);
   });
 
-  test("rejects a payload that fails the wire schema without persisting", () => {
+  test("accepts any outbox-backed type, e.g. config_setting", () => {
+    const result = call({
+      type: "config_setting",
+      fields: { config_key: "voice.provider", config_value: "elevenlabs" },
+    });
+    expect(result).toEqual({ id: expect.any(String) });
+
+    const payloads = pendingOutboxPayloads<{ config_key: string }>(
+      "config_setting",
+    );
+    expect(payloads.length).toBe(1);
+    expect(payloads[0]).toMatchObject({
+      type: "config_setting",
+      config_key: "voice.provider",
+      config_value: "elevenlabs",
+    });
+  });
+
+  test("rejects malformed fields (missing or mistyped) without persisting", () => {
     // Missing the required derived counts.
     const { claim_count: _c, suggestion_count: _s, ...missingCounts } =
       VALID_FIELDS;
@@ -146,4 +164,14 @@ describe("telemetry-routes: ingest", () => {
     expect(() => call({ fields: VALID_FIELDS })).toThrow(RouteError);
     expect(pendingPayloads().length).toBe(0);
   });
+
+  test("strips unknown fields keys (typed schema, not a passthrough record)", () => {
+    call({
+      type: "onboarding_research",
+      fields: { ...VALID_FIELDS, bogus_extra: "nope" },
+    });
+    const payloads = pendingPayloads();
+    expect(payloads.length).toBe(1);
+    expect(payloads[0]).not.toHaveProperty("bogus_extra");
+  });
 });

package/src/calls/voice-session-bridge.ts

@@ -94,7 +94,7 @@ const pendingTurnTeardowns = new Map<string, Promise<void>>();
  * when the signal aborts mid-wait. Timer and abort listener are removed on
  * every exit path.
  */
-async function waitForPriorTurnTeardown(
+export async function waitForPriorTurnTeardown(
   teardown: Promise<void>,
   timeoutMs: number,
   signal?: AbortSignal,
@@ -127,6 +127,24 @@ async function waitForPriorTurnTeardown(
   });
 }
 
+/**
+ * The pending teardown promise for a conversation's most recent turn, or
+ * `undefined` when no turn is currently tearing down. The live-voice barge-in
+ * path reads this synchronously at interrupt time — before the next utterance's
+ * `startVoiceTurn` overwrites the per-conversation entry — to capture the
+ * interrupted turn's teardown, then awaits it before forking a background
+ * continuation. That guarantees the fork snapshots history only after the
+ * interrupted turn's completed tool calls have settled into it, so a
+ * side-effecting continuation cannot repeat a call the interrupted turn already
+ * ran. It is turn-scoped: it resolves once THIS turn's teardown finishes, and
+ * does not block on any later turn's work.
+ */
+export function getConversationTurnTeardown(
+  conversationId: string,
+): Promise<void> | undefined {
+  return pendingTurnTeardowns.get(conversationId);
+}
+
 // ---------------------------------------------------------------------------
 // Types
 // ---------------------------------------------------------------------------

package/src/cli/commands/__tests__/notifications.test.ts

@@ -29,9 +29,15 @@ let ipcResponse: {
 };
 
 const exitCodeFromIpcResult = (r: { statusCode?: number }): number => {
-  if (r.statusCode === undefined) return 10;
-  if (r.statusCode >= 500) return 3;
-  if (r.statusCode >= 400) return 2;
+  if (r.statusCode === undefined) {
+    return 10;
+  }
+  if (r.statusCode >= 500) {
+    return 3;
+  }
+  if (r.statusCode >= 400) {
+    return 2;
+  }
   return 1;
 };
 
@@ -518,6 +524,21 @@ describe("notifications list", () => {
     expect(ipcCalls[0].method).toBe("list_home_feed");
   });
 
+  test("list help disambiguates Vellum notifications from email inboxes", async () => {
+    const { stdout, exitCode } = await runRawCommand([
+      "notifications",
+      "list",
+      "--help",
+    ]);
+
+    expect(exitCode).toBe(0);
+    const normalizedHelp = stdout.replace(/\s+/g, " ");
+    expect(normalizedHelp).toContain("Vellum Home feed");
+    expect(normalizedHelp).toContain("does not read email inboxes");
+    expect(normalizedHelp).toContain("Gmail");
+    expect(normalizedHelp).toContain("Outlook");
+  });
+
   test("list returns items from IPC", async () => {
     ipcResponse = {
       ok: true,

package/src/cli/commands/notifications.help.ts

@@ -48,9 +48,9 @@ source channel, event name, and attention hints. The decision engine evaluates
 whether and where to deliver the notification based on connected channels,
 urgency, and user preferences.
 
-Minimal usage: only --message is required. Add --urgent for a push + visual
-flag in the inbox. Source channel/event name fall back to assistant_tool /
-assistant.share when omitted.
+Minimal usage: only --message is required. Add --urgent for a push +
+visual flag in the Vellum Home feed. Source channel/event name fall back
+to assistant_tool / assistant.share when omitted.
 
 Examples:
   $ assistant notifications send --message "Build finished"
@@ -71,7 +71,7 @@ Examples:
         {
           flags: "--urgent",
           description:
-            "Mark this notification as urgent (fires push + visual flag in inbox)",
+            "Mark this notification as urgent (fires push + visual flag in Vellum Home)",
           defaultValue: false,
         },
         {
@@ -176,7 +176,7 @@ Examples:
     {
       name: "list",
       description:
-        "List notifications surfaced to the user via the home feed. Excludes dismissed items by default.",
+        "List Vellum Home feed notifications surfaced by the assistant. Excludes dismissed items by default.",
       options: [
         {
           flags: "--all",
@@ -231,11 +231,11 @@ Examples:
         },
       ],
       helpText: `
-Reads the home feed at $VELLUM_WORKSPACE_DIR/data/home-feed.json — the
-user's notification inbox. Items are ordered by priority then recency,
-matching what the user sees in the macOS Home page. The home feed covers
-background/async notifications mirrored from the unified pipeline;
-real-time chat pushes that did not mirror to the feed will not appear.
+Reads Vellum's Home feed at $VELLUM_WORKSPACE_DIR/data/home-feed.json.
+Items are ordered by priority then recency, matching what the user sees
+in the macOS Home page. This is only the assistant's Vellum notification
+feed; it does not read email inboxes, Gmail, Outlook, or other external
+message providers. Use OAuth/provider-specific commands for external mail.
 
 Examples:
   $ assistant notifications list