@vellumai/assistant 0.10.3-dev.202606301742.2b63687 → 0.10.3-dev.202606301940.da6000c

package/openapi.yaml

@@ -4632,6 +4632,162 @@ paths:
           required: true
           schema:
             type: string
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                provider:
+                  $ref: "#/components/schemas/LLMProvider"
+                model:
+                  type: string
+                  minLength: 1
+                maxTokens:
+                  type: integer
+                  exclusiveMinimum: 0
+                  maximum: 9007199254740991
+                effort:
+                  type: string
+                  enum:
+                    - none
+                    - low
+                    - medium
+                    - high
+                    - xhigh
+                    - max
+                speed:
+                  type: string
+                  enum:
+                    - standard
+                    - fast
+                verbosity:
+                  type: string
+                  enum:
+                    - low
+                    - medium
+                    - high
+                temperature:
+                  anyOf:
+                    - type: number
+                      minimum: 0
+                      maximum: 2
+                    - type: "null"
+                topP:
+                  anyOf:
+                    - type: number
+                      minimum: 0
+                      maximum: 1
+                    - type: "null"
+                thinking:
+                  type: object
+                  properties:
+                    enabled:
+                      type: boolean
+                    streamThinking:
+                      type: boolean
+                    level:
+                      type: string
+                      enum:
+                        - minimal
+                        - low
+                        - medium
+                        - high
+                contextWindow:
+                  type: object
+                  properties:
+                    enabled:
+                      type: boolean
+                    maxInputTokens:
+                      type: integer
+                      exclusiveMinimum: 0
+                      maximum: 9007199254740991
+                    targetBudgetRatio:
+                      type: number
+                      exclusiveMinimum: 0
+                      maximum: 1
+                    compactThreshold:
+                      type: number
+                      exclusiveMinimum: 0
+                      maximum: 1
+                    summaryBudgetRatio:
+                      type: number
+                      exclusiveMinimum: 0
+                      maximum: 1
+                    overflowRecovery:
+                      type: object
+                      properties:
+                        enabled:
+                          type: boolean
+                        safetyMarginRatio:
+                          type: number
+                          exclusiveMinimum: 0
+                          exclusiveMaximum: 1
+                        maxAttempts:
+                          type: integer
+                          exclusiveMinimum: 0
+                          maximum: 9007199254740991
+                        interactiveLatestTurnCompression:
+                          type: string
+                          enum:
+                            - truncate
+                            - summarize
+                            - drop
+                        nonInteractiveLatestTurnCompression:
+                          type: string
+                          enum:
+                            - truncate
+                            - summarize
+                            - drop
+                openrouter:
+                  type: object
+                  properties:
+                    only:
+                      type: array
+                      items:
+                        type: string
+                        minLength: 1
+                logitBias:
+                  type: string
+                  enum:
+                    - suppress-cjk
+                disableCache:
+                  type: boolean
+                source:
+                  type: string
+                  enum:
+                    - managed
+                    - user
+                label:
+                  anyOf:
+                    - type: string
+                      minLength: 1
+                    - type: "null"
+                description:
+                  type: string
+                provider_connection:
+                  type: string
+                  minLength: 1
+                status:
+                  anyOf:
+                    - $ref: "#/components/schemas/ProfileStatus"
+                    - type: "null"
+                mix:
+                  minItems: 2
+                  type: array
+                  items:
+                    type: object
+                    properties:
+                      profile:
+                        type: string
+                        minLength: 1
+                      weight:
+                        type: number
+                        exclusiveMinimum: 0
+                    required:
+                      - profile
+                      - weight
       responses:
         "200":
           description: Successful response
@@ -17760,6 +17916,44 @@ paths:
                           additionalProperties: false
                         backgroundToolNotification:
                           type: boolean
+                        backgroundToolCompletion:
+                          type: object
+                          properties:
+                            id:
+                              type: string
+                            toolName:
+                              type: string
+                            conversationId:
+                              type: string
+                            command:
+                              type: string
+                            startedAt:
+                              type: number
+                            status:
+                              type: string
+                              enum:
+                                - completed
+                                - failed
+                                - cancelled
+                            exitCode:
+                              anyOf:
+                                - type: number
+                                - type: "null"
+                            output:
+                              type: string
+                            completedAt:
+                              type: number
+                          required:
+                            - id
+                            - toolName
+                            - conversationId
+                            - command
+                            - startedAt
+                            - status
+                            - exitCode
+                            - output
+                            - completedAt
+                          additionalProperties: false
                         slackMessage:
                           type: object
                           properties:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/assistant",
-  "version": "0.10.3-dev.202606301742.2b63687",
+  "version": "0.10.3-dev.202606301940.da6000c",
   "license": "MIT",
   "type": "module",
   "exports": {

package/src/__tests__/background-shell-bash.test.ts

@@ -189,6 +189,10 @@ describe("bash tool background mode", () => {
     // Command stdout is fenced as untrusted output, not inlined in the hint.
     expect(wakeCall.untrustedOutput?.content).toContain("bg_output_12345");
     expect(wakeCall.untrustedOutput?.source).toBe("tool_result");
+    // Durable completion record stamped onto the persisted wake.
+    expect(wakeCall.backgroundToolCompletion?.id).toBe("bg-test1234");
+    expect(wakeCall.backgroundToolCompletion?.status).toBe("completed");
+    expect(wakeCall.backgroundToolCompletion?.exitCode).toBe(0);
   });
 
   test("failing background process delivers an error hint via wake", async () => {
@@ -210,6 +214,9 @@ describe("bash tool background mode", () => {
     expect(wakeCall.hint).toContain("bg-test1234");
     // The command fails with exit code 1, so the hint should reflect failure
     expect(wakeCall.hint).toContain("exit=1");
+    expect(wakeCall.backgroundToolCompletion?.id).toBe("bg-test1234");
+    expect(wakeCall.backgroundToolCompletion?.status).toBe("failed");
+    expect(wakeCall.backgroundToolCompletion?.exitCode).toBe(1);
   });
 
   test("cancelled background process wakes with the cancellation, not a completed result", async () => {
@@ -234,6 +241,8 @@ describe("bash tool background mode", () => {
     expect(wakeCall.hint).toContain("cancelled");
     expect(wakeCall.hint).not.toContain("completed");
     expect(wakeCall.untrustedOutput?.content).toContain("cancelled");
+    expect(wakeCall.backgroundToolCompletion?.id).toBe("bg-test1234");
+    expect(wakeCall.backgroundToolCompletion?.status).toBe("cancelled");
   });
 
   test("foreground mode still works when background is not set", async () => {

package/src/__tests__/background-shell-host-bash.test.ts

@@ -118,6 +118,7 @@ mock.module("../daemon/host-bash-proxy.js", () => ({
 // Import under test — MUST come after mock.module calls.
 // ---------------------------------------------------------------------------
 
+import type { CompletedBackgroundTool } from "../tools/background-tool-registry.js";
 import { hostShellTool } from "../tools/host-terminal/host-shell.js";
 import type { ToolContext, ToolExecutionResult } from "../tools/types.js";
 
@@ -258,6 +259,11 @@ describe("host_bash background mode — proxy path", () => {
       maxChars: 40_000,
     });
     expect(wakeCall.source).toBe("background-tool");
+    const completion =
+      wakeCall.backgroundToolCompletion as CompletedBackgroundTool;
+    expect(completion.id).toBe("bg-test-0001");
+    expect(completion.status).toBe("completed");
+    expect(completion.exitCode).toBeNull();
   });
 
   test("calls wakeAgentForOpportunity on proxy error result", async () => {
@@ -398,6 +404,11 @@ describe("host_bash background mode — direct execution path", () => {
     expect((wakeCall.untrustedOutput as { content: string }).content).toContain(
       "hello world",
     );
+    const completion =
+      wakeCall.backgroundToolCompletion as CompletedBackgroundTool;
+    expect(completion.id).toBe("bg-test-0001");
+    expect(completion.status).toBe("completed");
+    expect(completion.exitCode).toBe(0);
   });
 
   test("calls wakeAgentForOpportunity with error hint on non-zero exit", async () => {

package/src/__tests__/list-messages-background-tool-completion.test.ts

@@ -0,0 +1,141 @@
+/**
+ * Tests for handleListMessages background-tool completion projection.
+ *
+ * A backgrounded bash/host_bash run posts a `<background_event
+ * source="background-tool">` wake on completion, stamped with
+ * `metadata.backgroundToolCompletion`. The history projection must surface
+ * that structured record (and the `backgroundToolNotification` flag) so the
+ * web can rebuild a terminal inline card after a daemon restart.
+ */
+
+import { beforeEach, describe, expect, mock, test } from "bun:test";
+
+mock.module("../util/logger.js", () => ({
+  getLogger: () =>
+    new Proxy({} as Record<string, unknown>, {
+      get: () => () => {},
+    }),
+}));
+
+mock.module("../config/loader.js", () => ({
+  getConfig: () => ({
+    ui: {},
+    model: "test",
+    provider: "test",
+    memory: { enabled: false },
+    rateLimit: { maxRequestsPerMinute: 0 },
+  }),
+}));
+
+import { ConversationMessageSchema } from "../api/responses/conversation-message.js";
+import {
+  addMessage,
+  createConversation,
+} from "../persistence/conversation-crud.js";
+import { getDb } from "../persistence/db-connection.js";
+import { initializeDb } from "../persistence/db-init.js";
+import { handleListMessages } from "../runtime/routes/conversation-routes.js";
+
+await initializeDb();
+
+function resetTables() {
+  const db = getDb();
+  db.run("DELETE FROM message_attachments");
+  db.run("DELETE FROM attachments");
+  db.run("DELETE FROM messages");
+  db.run("DELETE FROM conversations");
+}
+
+interface ProjectedMessage {
+  role: string;
+  backgroundToolNotification?: boolean;
+  backgroundToolCompletion?: Record<string, unknown>;
+}
+
+describe("handleListMessages background-tool completion projection", () => {
+  beforeEach(resetTables);
+
+  test("projects backgroundToolCompletion from the wake row metadata", async () => {
+    const conv = createConversation();
+    await addMessage(
+      conv.id,
+      "user",
+      JSON.stringify([{ type: "text", text: "run a long command" }]),
+    );
+
+    const completion = {
+      id: "bg-1",
+      toolName: "bash",
+      conversationId: conv.id,
+      command: "sleep 5 && echo done",
+      startedAt: 1000,
+      status: "completed" as const,
+      exitCode: 0,
+      output: "done\n",
+      completedAt: 2000,
+    };
+    // Mirror persistWakeTriggerMessage: a user-role
+    // `<background_event source="background-tool">` row carrying the structured
+    // completion. Not flagged `hidden`; the client suppresses it from the
+    // transcript via `backgroundToolNotification`.
+    await addMessage(
+      conv.id,
+      "user",
+      JSON.stringify([
+        {
+          type: "text",
+          text: '<background_event source="background-tool">Background command completed (id=bg-1, exit=0):</background_event>',
+        },
+      ]),
+      {
+        metadata: {
+          kind: "background-event",
+          backgroundEventSource: "background-tool",
+          automated: true,
+          backgroundToolCompletion: completion,
+        },
+      },
+    );
+
+    const response = handleListMessages({
+      queryParams: { conversationId: conv.id },
+    }) as { messages: ProjectedMessage[] };
+
+    // Every projected message validates against the wire schema.
+    for (const message of response.messages) {
+      expect(() => ConversationMessageSchema.parse(message)).not.toThrow();
+    }
+
+    const wakeRow = response.messages.find(
+      (m) => m.backgroundToolCompletion !== undefined,
+    );
+    expect(wakeRow).toBeDefined();
+    expect(wakeRow?.backgroundToolNotification).toBe(true);
+    expect(wakeRow?.backgroundToolCompletion).toEqual(completion);
+  });
+
+  test("omits backgroundToolCompletion when the row carries no completion metadata", async () => {
+    const conv = createConversation();
+    await addMessage(
+      conv.id,
+      "user",
+      JSON.stringify([{ type: "text", text: "hello" }]),
+    );
+    await addMessage(
+      conv.id,
+      "assistant",
+      JSON.stringify([{ type: "text", text: "hi there" }]),
+    );
+
+    const response = handleListMessages({
+      queryParams: { conversationId: conv.id },
+    }) as { messages: ProjectedMessage[] };
+
+    expect(response.messages).toHaveLength(2);
+    for (const message of response.messages) {
+      expect(message.backgroundToolCompletion).toBeUndefined();
+      expect(message.backgroundToolNotification).toBeUndefined();
+      expect(() => ConversationMessageSchema.parse(message)).not.toThrow();
+    }
+  });
+});

package/src/__tests__/onboarding-template-contract.test.ts

@@ -16,69 +16,53 @@ describe("onboarding template contracts", () => {
       expect(bootstrap).toMatch(/^_ Lines starting with _/);
     });
 
-    test("contains identity section", () => {
+    test("anchors identity in the pre-chat personality and demands staying in character", () => {
       const lower = bootstrap.toLowerCase();
-      expect(lower).toContain("identity");
-      expect(lower).toContain("colleague");
+      expect(lower).toContain("pre-chat");
+      expect(lower).toContain("in character");
     });
 
-    test("gathers user context", () => {
+    test("opens in character with a move drawn from workspace files", () => {
       const lower = bootstrap.toLowerCase();
-      expect(lower).toContain("work role");
-      expect(lower).toContain("goals");
-      expect(lower).toContain("tools");
+      expect(lower).toContain("you start the conversation");
+      expect(lower).toContain("workspace files");
     });
 
-    test("contains cleanup instructions with deletion", () => {
+    test("is engaging, inquisitive, and brief", () => {
       const lower = bootstrap.toLowerCase();
-      expect(lower).toContain("wrap up");
-      expect(lower).toContain("delete");
-      expect(lower).toContain("bootstrap.md");
+      expect(lower).toContain("follow-up question");
+      expect(lower).toContain("short");
     });
 
-    test("handles declined fields", () => {
+    test("does the task then keeps learning about the user", () => {
       const lower = bootstrap.toLowerCase();
-      expect(lower).toContain("declined");
-    });
-
-    test("instructs saving to IDENTITY.md, SOUL.md, and user persona file via file_edit", () => {
-      expect(bootstrap).toContain("IDENTITY.md");
-      expect(bootstrap).toContain("SOUL.md");
-      expect(bootstrap).toContain("{{userSlug}}.md");
-      expect(bootstrap).toContain("file_edit");
-    });
-
-    test("contains core principle", () => {
-      expect(bootstrap).toContain("earns its keep");
+      expect(lower).toContain("just do it");
+      expect(lower).toContain("keep learning about them");
     });
 
-    test("contains opening move with onboarding context", () => {
+    test("contains cleanup instructions with deletion", () => {
       const lower = bootstrap.toLowerCase();
-      expect(lower).toContain("onboarding");
-      expect(lower).toContain("json");
-      expect(lower).toContain("context");
+      expect(lower).toContain("delete");
+      expect(lower).toContain("bootstrap.md");
     });
 
-    test("contains tone matching guidance", () => {
+    test("offers assistant migration from an existing ChatGPT/Claude", () => {
       const lower = bootstrap.toLowerCase();
-      expect(lower).toContain("match");
-      expect(lower).toContain("energy");
+      expect(lower).toContain("chatgpt");
+      expect(lower).toContain("claude");
+      expect(bootstrap).toContain("assistant-migration");
     });
 
-    test("is one-shot", () => {
-      expect(bootstrap).toContain("One-shot");
+    test("does not instruct workspace identity-file writes", () => {
+      expect(bootstrap).not.toContain("file_edit");
+      expect(bootstrap).not.toContain("file_write");
+      expect(bootstrap).not.toMatch(/write .*to SOUL\.md/i);
+      expect(bootstrap).not.toMatch(/\{\{userSlug\}\}\.md/);
     });
 
-    test("offers assistant migration during low-signal first openings", () => {
-      expect(bootstrap).toContain("## Assistant migration");
-      expect(bootstrap).toContain("onboarding self-introduction");
-      expect(bootstrap).toContain("treat it as the real first user turn");
-      expect(bootstrap).toContain(
-        "If the first real user turn is only a greeting",
-      );
-      expect(bootstrap).toContain("that first response is the natural opening");
-      expect(bootstrap).toContain("assistant-migration");
-      expect(bootstrap).toContain("do not load or activate");
+    test("does not split users into conversation-first and task-first paths", () => {
+      expect(bootstrap).not.toMatch(/Path A/);
+      expect(bootstrap).not.toMatch(/Path B/);
     });
 
     test("does not contain personality quiz references", () => {

package/src/__tests__/plugin-import-boundary-guard.test.ts

@@ -161,6 +161,7 @@ const BASELINE: Record<string, readonly string[]> = {
     "../../../config/assistant-feature-flags.js",
     "../../../config/loader.js",
     "../../../config/memory-v3-gate.js",
+    "../../../config/schema.js",
     "../../../config/schemas/memory-v2.js",
     "../../../config/types.js",
     "../../../contacts/guardian-delivery-reader.js",
@@ -169,10 +170,13 @@ const BASELINE: Record<string, readonly string[]> = {
     "../../../context/token-estimator.js",
     "../../../daemon/date-context.js",
     "../../../daemon/disk-pressure-background-gate.js",
+    "../../../daemon/embedding-reconcile.js",
     "../../../daemon/pkb-context-tracker.js",
     "../../../daemon/pkb-reminder-builder.js",
+    "../../../daemon/skill-memory-refresh.js",
     "../../../daemon/tool-setup-types.js",
     "../../../daemon/trust-context.js",
+    "../../../jobs/register-job-handlers.js",
     "../../../permissions/types.js",
     "../../../persistence/checkpoints.js",
     "../../../persistence/conversation-crud.js",
@@ -180,7 +184,10 @@ const BASELINE: Record<string, readonly string[]> = {
     "../../../persistence/embeddings/embedding-backend.js",
     "../../../persistence/embeddings/embedding-runtime-manager.js",
     "../../../persistence/embeddings/embedding-types.js",
+    "../../../persistence/embeddings/qdrant-client.js",
+    "../../../persistence/embeddings/qdrant-manager.js",
     "../../../persistence/jobs-store.js",
+    "../../../persistence/jobs-worker.js",
     "../../../persistence/memory-lifecycle-hooks.js",
     "../../../persistence/message-content.js",
     "../../../persistence/raw-query.js",

package/src/__tests__/system-prompt.test.ts

@@ -457,9 +457,10 @@ describe("buildSystemPrompt", () => {
       expect(result).not.toContain("{{userSlug}}");
     });
 
-    test("substitutes the unmodified bundled BOOTSTRAP.md template", () => {
-      // Copy the real bundled BOOTSTRAP.md into the test workspace so we
-      // verify substitution against the actual template the daemon ships.
+    test("leaves no unresolved placeholders in the bundled BOOTSTRAP.md template", () => {
+      // Render the real bundled BOOTSTRAP.md the daemon ships and verify
+      // substitution leaves no leftover {{userSlug}} placeholder, whether or
+      // not the current template happens to reference it.
       mockPersona.userSlug = "alice";
       const bundled = readFileSync(
         join(import.meta.dirname, "..", "prompts", "templates", "BOOTSTRAP.md"),
@@ -467,7 +468,6 @@ describe("buildSystemPrompt", () => {
       );
       writeFileSync(join(TEST_DIR, "BOOTSTRAP.md"), bundled);
       const result = buildSystemPrompt();
-      expect(result).toContain("users/alice.md");
       expect(result).not.toContain("{{userSlug}}");
     });
   });

package/src/api/index.ts

@@ -404,6 +404,7 @@ export {
   DictationRequestSchema,
 } from "./requests/dictation.js";
 export {
+  type BackgroundToolCompletion,
   type ConversationAttachmentBlock,
   ConversationAttachmentBlockSchema,
   type ConversationContentBlock,

package/src/api/responses/conversation-message.ts

@@ -296,6 +296,29 @@ export type ConversationAcpNotification = z.infer<
   typeof ConversationAcpNotificationSchema
 >;
 
+// ---------------------------------------------------------------------------
+// Background-tool completion
+// ---------------------------------------------------------------------------
+
+/** Structured terminal record of a backgrounded bash/host_bash run, carrying
+ *  everything a web `BackgroundTaskEntry` needs to rebuild a completed inline
+ *  card from history. Mirrors the `background_tool_completed` SSE event plus
+ *  the registry fields (`toolName`, `command`, `startedAt`). */
+export const BackgroundToolCompletionSchema = z.object({
+  id: z.string(),
+  toolName: z.string(),
+  conversationId: z.string(),
+  command: z.string(),
+  startedAt: z.number(),
+  status: z.enum(["completed", "failed", "cancelled"]),
+  exitCode: z.number().nullable(),
+  output: z.string(),
+  completedAt: z.number(),
+});
+export type BackgroundToolCompletion = z.infer<
+  typeof BackgroundToolCompletionSchema
+>;
+
 // ---------------------------------------------------------------------------
 // Slack message envelope
 // ---------------------------------------------------------------------------
@@ -549,6 +572,12 @@ export const ConversationMessageSchema = z.object({
    *  notifications, the row stays in state (the LLM reads it) but is filtered
    *  from the rendered transcript — the inline card carries the status. */
   backgroundToolNotification: z.boolean().optional(),
+  /** Structured completion of a backgrounded bash/host_bash run, stamped on the
+   *  same persisted background-event wake row as `backgroundToolNotification`.
+   *  Lets the web reconstruct a terminal inline card after a daemon restart
+   *  (the in-memory completed ring does not survive restarts). `id` equals the
+   *  spawning tool call's `{backgrounded,id}` id. */
+  backgroundToolCompletion: BackgroundToolCompletionSchema.optional(),
   slackMessage: ConversationSlackMessageSchema.optional(),
   /**
    * Queue state for a user message that is still waiting in the daemon's

package/src/config/schemas/__tests__/memory-v2.test.ts

@@ -22,7 +22,7 @@ describe("MemoryV2ConfigSchema", () => {
       sparse_weight: 0.15,
       bm25_k1: 1.2,
       bm25_b: 0.4,
-      consolidation_interval_hours: 4,
+      consolidation_interval_hours: 8,
       consolidation_max_buffer_lines: 100,
       consolidation_max_entries_per_run: 150,
       max_page_chars: 5000,
@@ -222,7 +222,7 @@ describe("MemoryConfigSchema integration with v2 block", () => {
     expect(parsed.v2.d).toBe(0.3);
     expect(parsed.v2.dense_weight).toBe(0.85);
     expect(parsed.v2.sparse_weight).toBe(0.15);
-    expect(parsed.v2.consolidation_interval_hours).toBe(4);
+    expect(parsed.v2.consolidation_interval_hours).toBe(8);
     expect(parsed.v2.max_page_chars).toBe(5000);
   });
 

package/src/config/schemas/memory-v2.ts

@@ -190,7 +190,7 @@ export const MemoryV2ConfigSchema = z
       .positive(
         "memory.v2.consolidation_interval_hours must be a positive integer",
       )
-      .default(4)
+      .default(8)
       .describe(
         "Hours between scheduled consolidation runs that synthesize buffered memories into concept pages",
       ),