@vellumai/assistant 0.10.8-dev.202607142125.4cfef21 → 0.10.8-dev.202607142322.265489c

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/assistant",
-  "version": "0.10.8-dev.202607142125.4cfef21",
+  "version": "0.10.8-dev.202607142322.265489c",
   "license": "MIT",
   "type": "module",
   "exports": {

package/src/__tests__/config-schema.test.ts

@@ -896,11 +896,12 @@ describe("AssistantConfigSchema", () => {
       mode: "open-mic",
       vad: {
         speechEnergyThreshold: 800,
-        silenceThresholdMs: 800,
+        silenceThresholdMs: 1200,
         maxTurnDurationMs: 30000,
-        bargeInMinSpeechMs: 60,
+        bargeInMinSpeechMs: 250,
       },
       maxSessionDurationSeconds: 1800,
+      archiveAudio: false,
     });
   });
 

package/src/calls/media-turn-detector.ts

@@ -75,7 +75,7 @@ export interface TurnDetectorCallbacks {
 // ---------------------------------------------------------------------------
 
 export class MediaTurnDetector {
-  private readonly silenceThresholdMs: number;
+  private silenceThresholdMs: number;
   private readonly maxTurnDurationMs: number;
   private readonly callbacks: TurnDetectorCallbacks;
 
@@ -116,6 +116,16 @@ export class MediaTurnDetector {
     return this.active;
   }
 
+  /**
+   * Update the trailing-silence threshold mid-session (the "pause before
+   * reply" live-tuning path). Applies from the next silence-timer arm — a
+   * countdown already in flight keeps its current duration until it resets on
+   * the next speech chunk — so the change takes effect on the next utterance.
+   */
+  setSilenceThresholdMs(silenceThresholdMs: number): void {
+    this.silenceThresholdMs = silenceThresholdMs;
+  }
+
   /**
    * Feed an inbound audio chunk to the detector with speech activity info.
    *

package/src/cli/lib/bundled-marketplace.json

@@ -15,20 +15,22 @@
       "description": "Proactive chief-of-staff: a morning digest, propose-then-confirm inbox triage, calendar prep, and a weekly competitor brief.",
       "category": "productivity",
       "homepage": "https://github.com/vellum-ai/admin-copilot",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "🧑‍💼"
     },
     {
       "name": "agent-wrapped",
       "source": {
         "source": "github",
         "repo": "vellum-ai/agent-wrapped",
-        "ref": "1bfa2b9c0735662e4c493955a414b6b62136a380"
+        "ref": "be38bd9cd57aaac6bf06b22d82885c09219320bf"
       },
       "description": "Your agent's year in review: conversations, days together, memories formed, swear count, top topics, and the receipt (total tokens + LLM calls). Works with Vellum agents and Claude Code. Ships a stats collector tool, a CLI, a Claude Code plugin, and a skill for the shareable cards experience.",
       "category": "creative",
       "license": "MIT",
       "submittedBy": "marina",
-      "homepage": "https://agent-wrapped.com"
+      "homepage": "https://agent-wrapped.com",
+      "icon": "🎁"
     },
     {
       "name": "ai-hero-engineer-kit",
@@ -37,10 +39,11 @@
         "repo": "marinatrajk/ai-hero-engineer-kit",
         "ref": "18d33c62b15a3e2cc22dc070723fe3077749dcec"
       },
-      "description": "Five engineering skills adapted from Matt Pocock's '5 Agent Skills I Use Every Day' \u2014 plans, PRDs, vertical-slice issues, TDD loop, and codebase deepening in one install.",
+      "description": "Five engineering skills adapted from Matt Pocock's '5 Agent Skills I Use Every Day' — plans, PRDs, vertical-slice issues, TDD loop, and codebase deepening in one install.",
       "category": "developer",
       "homepage": "https://github.com/marinatrajk/ai-hero-engineer-kit",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "🧰"
     },
     {
       "name": "amex-perk-reminder",
@@ -52,7 +55,8 @@
       "description": "Track every credit on the Amex cards you hold (Platinum, Gold, Business Platinum, Delta Gold/Platinum/Reserve) with status-aware reminders before any window closes.",
       "category": "lifestyle",
       "homepage": "https://github.com/AnitaKirkovska/amex-perk-reminder",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "💳"
     },
     {
       "name": "astrology-horoscope",
@@ -64,7 +68,8 @@
       "description": "Western tropical natal chart and transit computation. Local ephemeris (astronomy-engine, no API keys) for planet positions, ascendant/midheaven, whole-sign houses, and aspects, plus a natal-reading skill that interprets the raw chart into a readable report.",
       "category": "hobby",
       "homepage": "https://github.com/vellum-ai/astrology-horoscope",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "🔮"
     },
     {
       "name": "caveman",
@@ -77,7 +82,7 @@
       "category": "productivity",
       "homepage": "https://github.com/JuliusBrussee/caveman",
       "license": "MIT",
-      "icon": "\ud83e\uddb4"
+      "icon": "🦴"
     },
     {
       "name": "coffee-aficionado",
@@ -89,8 +94,7 @@
       "description": "Find great coffee beans and machines matched to your taste profile, budget, and kitchen. Persistent memory learns your preferences over time.",
       "category": "lifestyle",
       "homepage": "https://github.com/vellum-ai/coffee-aficionado",
-      "license": "MIT",
-      "icon": "\u2615"
+      "license": "MIT"
     },
     {
       "name": "cofounder",
@@ -102,7 +106,8 @@
       "description": "AI co-founder that remembers your company context, challenges your thinking, and tracks your decisions.",
       "category": "productivity",
       "homepage": "https://github.com/vellum-ai/cofounder",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "🤝"
     },
     {
       "name": "cognee",
@@ -114,7 +119,8 @@
       },
       "description": "Cognee knowledge graph memory for Vellum Assistant: session-aware storage, auto-routing recall, and persistent learning across sessions. Supports local mode and Cognee Cloud.",
       "category": "memory",
-      "homepage": "https://github.com/topoteretes/cognee-integrations/tree/main/integrations/vellum-assistant"
+      "homepage": "https://github.com/topoteretes/cognee-integrations/tree/main/integrations/vellum-assistant",
+      "icon": "🕸️"
     },
     {
       "name": "dynamic-notch",
@@ -126,7 +132,8 @@
       "description": "Put your Vellum assistant inside your MacBook's notch: click to chat, hold Ctrl+Option to talk, and get a floating task bulb while it works, with live-streamed replies and per-sentence voice.",
       "category": "interface",
       "homepage": "https://github.com/AnitaKirkovska/dynamic-notch",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "💻"
     },
     {
       "name": "family-briefing",
@@ -138,7 +145,8 @@
       "description": "Daily morning briefing for parents: merges family calendars, triages school emails, and detects scheduling conflicts.",
       "category": "productivity",
       "homepage": "https://github.com/AnitaKirkovska/family-briefing",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "👨‍👩‍👧‍👦"
     },
     {
       "name": "fitness-companion",
@@ -150,7 +158,8 @@
       "description": "Fitness and nutrition companion. Logs meals, workouts, and weight; looks up nutrition data from OpenFoodFacts; calculates macro targets; and injects daily fitness context into every conversation.",
       "category": "health",
       "homepage": "https://github.com/vellum-ai/fitness-companion",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "💪"
     },
     {
       "name": "git-workflow",
@@ -162,7 +171,8 @@
       "description": "Git workflow tools and multi-perspective code review: branch management, push, stash, PR creation/review/merge/checkout, diffs, logs, changelog generation, and parallel subagent code review with confidence scoring.",
       "category": "developer",
       "homepage": "https://github.com/vellum-ai/git-workflow",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "🔀"
     },
     {
       "name": "google-drive-search",
@@ -174,7 +184,8 @@
       "description": "Local full-text search across your Google Drive. Indexes file metadata and document content into SQLite FTS5 for instant, private search.",
       "category": "productivity",
       "homepage": "https://github.com/ZeebBoyBlue/google-drive-search",
-      "license": "Apache-2.0"
+      "license": "Apache-2.0",
+      "icon": "🔍"
     },
     {
       "name": "influencer-marketing",
@@ -186,7 +197,8 @@
       "description": "Find and research influencers on Instagram, TikTok, and X/Twitter. Includes a strategy builder that walks from campaign brief to research criteria, a research skill that discovers real profiles via browser automation, scores candidates, and exports ranked shortlists, and a dashboard skill that turns the shortlist into an interactive outreach tracker.",
       "category": "marketing",
       "homepage": "https://github.com/ZeebBoyBlue/influencer",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "📣"
     },
     {
       "name": "kitchen-companion",
@@ -198,7 +210,8 @@
       "description": "Full kitchen companion. Scan your fridge with a photo to stock a pantry inventory and get 3 makeable-now recipes, get alerts before food expires, clip recipes from any URL into a clean format, and generate meal plans with grocery lists from what you actually have.",
       "category": "lifestyle",
       "homepage": "https://github.com/vellum-ai/kitchen-companion",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "🍳"
     },
     {
       "name": "level-up",
@@ -210,7 +223,8 @@
       "description": "Surfaces a first-class \"Level Up\" diff card whenever the assistant edits its own skills or plugins, so you can see how it improved itself after the fact.",
       "category": "developer",
       "homepage": "https://github.com/vellum-ai/level-up",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "🆙"
     },
     {
       "name": "marketing-expert",
@@ -222,7 +236,8 @@
       "description": "Acts as a full-stack marketing expert for any business (B2B or B2C): an on-demand persona plus playbook skills (positioning, demand planning, launches, content & copywriting, brand voice, email sequences, SEO & GEO, competitive teardown, board reporting) and deterministic funnel/positioning/GTM/competitive tools.",
       "category": "marketing",
       "homepage": "https://github.com/vellum-ai/marketing-expert",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "📈"
     },
     {
       "name": "model-router",
@@ -234,7 +249,8 @@
       "description": "Routes each user-facing message to one of your workspace's inference profiles, so model selection can vary per call instead of staying pinned to a single profile.",
       "category": "productivity",
       "homepage": "https://github.com/AnitaKirkovska/model-router",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "🚦"
     },
     {
       "name": "motion-design",
@@ -246,7 +262,8 @@
       "description": "Teaches the assistant to build polished UI animations with Motion (motion.dev) for React: animated product mockups, chat replays, typing effects, and staggered reveals, with a complete animated chat example included.",
       "category": "creative",
       "homepage": "https://github.com/vellum-ai/motion-design",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "🎬"
     },
     {
       "name": "originkit",
@@ -258,7 +275,8 @@
       "description": "Browse and import animated UI components from Originkit, a free library of 50 animated components. Browse by category or search term without an API key; fetch component source code (React, Next.js, Vite, Framer) with a free key from originkit.dev.",
       "category": "productivity",
       "homepage": "https://github.com/vellum-ai/originkit",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "🧱"
     },
     {
       "name": "personal-finance",
@@ -270,7 +288,8 @@
       "description": "Track expenses, income, recurring bills, and savings funds from your assistant. Multi-currency, receipt OCR, Plaid bank sync, and financial summaries. All data stored locally in SQLite.",
       "category": "productivity",
       "homepage": "https://github.com/AnitaKirkovska/personal-finance",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "💰"
     },
     {
       "name": "plant-doctor",
@@ -282,7 +301,8 @@
       "description": "Diagnose plants from photos. Identifies the species, assesses health with visible evidence, and returns a care plan. Named plants get a persistent checkup history so you can track whether they are improving.",
       "category": "lifestyle",
       "homepage": "https://github.com/vellum-ai/plant-doctor",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "🪴"
     },
     {
       "name": "polyglot",
@@ -294,7 +314,8 @@
       "description": "Ambient language acquisition through your assistant. Three graduated modes (practice, ambient, immersive) weave a target language into your real conversations, with SM-2 spaced repetition, error-pattern tracking, and CEFR level history.",
       "category": "education",
       "homepage": "https://github.com/vellum-ai/polyglot",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "🗣️"
     },
     {
       "name": "proactive-slacks",
@@ -306,7 +327,8 @@
       "description": "Let your assistant reach you on Slack on purpose. Route notifications by topic to the right channel at the right volume, with heartbeat-based change detection so it only pings when something actually changed.",
       "category": "productivity",
       "homepage": "https://github.com/AnitaKirkovska/proactive-slacks",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "💬"
     },
     {
       "name": "reading-pal",
@@ -318,7 +340,8 @@
       "description": "Your reading life in one plugin. Track your TBR pile, get guilt-tripped about your backlog, find your next read, and sync from Goodreads.",
       "category": "hobby",
       "homepage": "https://github.com/vellum-ai/reading-pal",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "📚"
     },
     {
       "name": "simple-memory",
@@ -330,7 +353,8 @@
       "description": "Reference memory plugin that exercises the full plugin API with low-cost variants of Vellum's memory defaults.",
       "category": "memory",
       "homepage": "https://github.com/vellum-ai/simple-memory",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "🧠"
     },
     {
       "name": "smb-inbox-brief",
@@ -342,7 +366,8 @@
       "description": "Find urgent replies, overdue invoices, quotes, and customer follow-ups before they slip. Scans email, logs business items, delivers urgency-ranked daily briefs.",
       "category": "productivity",
       "homepage": "https://github.com/AnitaKirkovska/smb-inbox-brief",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "📧"
     },
     {
       "name": "tennis-companion",
@@ -354,7 +379,8 @@
       "description": "Tennis journal, drill sessions, court finder, and progress tracking. Log matches with opponent tendencies, generate 30-minute practice sessions with progressions, find nearby courts via OpenStreetMap, and track win rate by surface and conditions.",
       "category": "health",
       "homepage": "https://github.com/vellum-ai/tennis-companion",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "🎾"
     },
     {
       "name": "travel-planner",
@@ -366,7 +392,8 @@
       "description": "A travel EA for your assistant. Remembers how you travel (carrier, miles, hotel budget, card benefits), keeps per-trip records, watches Gmail for booking changes, syncs your calendar, and emails an EA-style trip brief 48 hours before departure.",
       "category": "lifestyle",
       "homepage": "https://github.com/AnitaKirkovska/travel-planner",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "✈️"
     },
     {
       "name": "vellum-client-qa",
@@ -378,7 +405,8 @@
       "description": "Cross-platform QA rig for vellum-assistant clients: mock the platform backend, boot the real chat UI, and verify feature branches in headless Chromium (web), an iOS simulator, or Electron with screenshot and video proof.",
       "category": "developer",
       "homepage": "https://github.com/vellum-ai/vellum-client-qa",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "🧪"
     },
     {
       "name": "writing-coach",
@@ -390,7 +418,8 @@
       "description": "A writing coach in your pocket. Daily prompts that escalate with your streak, savage-but-constructive draft roasts, query letter critiques, and a word count enforcer that guilt-trips you when you skip.",
       "category": "hobby",
       "homepage": "https://github.com/vellum-ai/writing-coach",
-      "license": "MIT"
+      "license": "MIT",
+      "icon": "✍️"
     }
   ]
 }

package/src/config/schemas/__tests__/live-voice.test.ts

@@ -11,9 +11,9 @@ describe("LiveVoiceVadConfigSchema", () => {
     const parsed = LiveVoiceVadConfigSchema.parse({});
     expect(parsed).toEqual({
       speechEnergyThreshold: 800,
-      silenceThresholdMs: 800,
+      silenceThresholdMs: 1200,
       maxTurnDurationMs: 30_000,
-      bargeInMinSpeechMs: 60,
+      bargeInMinSpeechMs: 250,
     });
   });
 
@@ -64,22 +64,40 @@ describe("LiveVoiceConfigSchema", () => {
       mode: "open-mic",
       vad: {
         speechEnergyThreshold: 800,
-        silenceThresholdMs: 800,
+        silenceThresholdMs: 1200,
         maxTurnDurationMs: 30_000,
-        bargeInMinSpeechMs: 60,
+        bargeInMinSpeechMs: 250,
       },
       maxSessionDurationSeconds: 1800,
+      // Off by default: voice turns carry only their transcript, no audio
+      // artifacts on the conversation messages (JARVIS-1283).
+      archiveAudio: false,
     });
   });
 
+  test("archiveAudio can be enabled", () => {
+    expect(
+      LiveVoiceConfigSchema.parse({ archiveAudio: true }).archiveAudio,
+    ).toBe(true);
+  });
+
+  test("rejects a non-boolean archiveAudio", () => {
+    const result = LiveVoiceConfigSchema.safeParse({ archiveAudio: "yes" });
+    expect(result.success).toBe(false);
+    if (!result.success) {
+      const msgs = result.error.issues.map((i) => i.message);
+      expect(msgs.some((m) => m.includes("liveVoice.archiveAudio"))).toBe(true);
+    }
+  });
+
   test("accepts overrides", () => {
     const parsed = LiveVoiceConfigSchema.parse({
       mode: "ptt",
-      vad: { silenceThresholdMs: 1200 },
+      vad: { silenceThresholdMs: 900 },
       maxSessionDurationSeconds: 600,
     });
     expect(parsed.mode).toBe("ptt");
-    expect(parsed.vad.silenceThresholdMs).toBe(1200);
+    expect(parsed.vad.silenceThresholdMs).toBe(900);
     // Unspecified vad fields still get defaults
     expect(parsed.vad.speechEnergyThreshold).toBe(800);
     expect(parsed.vad.maxTurnDurationMs).toBe(30_000);

package/src/config/schemas/live-voice.ts

@@ -20,9 +20,9 @@ export const LiveVoiceVadConfigSchema = z
       .number({ error: "liveVoice.vad.silenceThresholdMs must be a number" })
       .int("liveVoice.vad.silenceThresholdMs must be an integer")
       .positive("liveVoice.vad.silenceThresholdMs must be a positive integer")
-      .default(800)
+      .default(1200)
       .describe(
-        "Trailing silence duration (ms) after speech that ends the user's turn",
+        "Trailing silence duration (ms) after speech that ends the user's turn — the default 'pause before reply'. Clients may override it per-session via the start frame.",
       ),
     maxTurnDurationMs: z
       .number({ error: "liveVoice.vad.maxTurnDurationMs must be a number" })
@@ -38,9 +38,9 @@ export const LiveVoiceVadConfigSchema = z
       .nonnegative(
         "liveVoice.vad.bargeInMinSpeechMs must be a nonnegative integer",
       )
-      .default(60)
+      .default(250)
       .describe(
-        "Sustained speech (ms) required before speech during assistant playback interrupts it; 0 disables the guard",
+        "Sustained speech (ms) required before speech during assistant playback interrupts it — the default 'interrupt sensitivity' (higher = harder to interrupt). 0 disables the guard. Clients may override it per-session via the start frame. Raised from 60 so brief TTS bleed through imperfect echo cancellation no longer self-interrupts the assistant.",
       ),
   })
   .describe(
@@ -68,6 +68,12 @@ export const LiveVoiceConfigSchema = z
       )
       .default(1800)
       .describe("Maximum duration of a single live voice session in seconds"),
+    archiveAudio: z
+      .boolean({ error: "liveVoice.archiveAudio must be a boolean" })
+      .default(false)
+      .describe(
+        "Persist the recorded user + assistant audio of each voice turn as attachments on the conversation messages. Off by default: voice turns carry only their transcribed text, so no audio-file artifacts land in the conversation history. Enable for playback/debugging.",
+      ),
   })
   .describe(
     "Live voice (in-app duplex audio) configuration — mic mode, VAD tuning, and session limits",

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

@@ -57,6 +57,14 @@ export const MemoryRetrospectiveConfigSchema = z
       .describe(
         "When true, fork-based retrospectives run under the source conversation's inference profile (which forkConversation copies onto the fork) instead of the call site's default. Provider prompt caches are byte-exact prefix matches scoped per model, and a thinking enable/disable mismatch invalidates the messages cache tier — so reusing the source's cached prefix requires the retrospective to resolve the SAME model/thinking/effort as the conversation's own turns. Falls back to the call site's default when the conversation has no profile or the referenced profile no longer exists.",
       ),
+
+    promptPath: z
+      .string({ error: "memory.retrospective.promptPath must be a string" })
+      .nullable()
+      .default(null)
+      .describe(
+        "Optional path to a file whose contents replace the bundled retrospective fork-instruction prompt. Absolute paths are used as-is, a leading `~/` is expanded to the home directory, otherwise the path is resolved under the workspace root. The loaded contents may include `{{AVAILABLE_TOOLS_LINE}}`, `{{WINDOW_ANCHOR}}`, `{{ALREADY_REMEMBERED}}`, and `{{SKILL_AUTHORING_SECTION}}`, which are substituted at runtime. If the file is missing, unreadable, or empty, the bundled prompt is used and a warning is logged.",
+      ),
   })
   .describe(
     "Controls the memory-retrospective background pass. Model selection lives under llm.callSites.memoryRetrospective.",

package/src/live-voice/__tests__/live-voice-integration.test.ts

@@ -1,14 +1,16 @@
-import { describe, expect, mock, test } from "bun:test";
+import { describe, expect, mock, spyOn, test } from "bun:test";
 
 import type {
   VoiceTurnCallbacks,
   VoiceTurnOptions,
 } from "../../calls/voice-session-bridge.js";
+import { loadRawConfig, saveRawConfig } from "../../config/loader.js";
 import type {
   StreamingTranscriber,
   SttStreamServerEvent,
 } from "../../stt/types.js";
 import type { LiveVoiceAudioArchiveResult } from "../live-voice-archive.js";
+import * as liveVoiceArchive from "../live-voice-archive.js";
 import {
   createLiveVoiceSession,
   type LiveVoiceSessionArchiveAudioInput,
@@ -217,7 +219,9 @@ async function waitFor(
   message = "Timed out waiting for live voice integration condition",
 ): Promise<void> {
   for (let attempt = 0; attempt < 80; attempt += 1) {
-    if (predicate()) return;
+    if (predicate()) {
+      return;
+    }
     await new Promise((resolve) => setTimeout(resolve, 5));
   }
   throw new Error(message);
@@ -672,3 +676,113 @@ describe("LiveVoiceSession integration smoke harness", () => {
     ]);
   });
 });
+
+// ---------------------------------------------------------------------------
+// Audio archiving is config-gated and OFF by default (JARVIS-1283): a voice
+// turn persists only its transcribed text, so no audio-file artifact lands on
+// the conversation messages unless `liveVoice.archiveAudio` is enabled. These
+// exercise the production factory's config resolution (no injected archiver).
+// ---------------------------------------------------------------------------
+
+describe("live-voice audio archiving default (JARVIS-1283)", () => {
+  function makeSingleTurnLegs() {
+    const startVoiceTurn = mock(async (options: VoiceTurnOptions) => {
+      options.callbacks?.persisted_user_message_id?.("user-message-123");
+      options.callbacks?.assistant_text_delta?.(
+        makeTextDelta("Hello from the assistant."),
+      );
+      options.callbacks?.message_complete?.(makeMessageComplete());
+      return { turnId: "bridge-turn-1", abort: mock() };
+    });
+    const streamTtsAudio = mock(async (options: LiveVoiceTtsOptions) => {
+      options.onAudioChunk(makeTtsChunk(`audio:${options.text}`));
+      return makeTtsResult(options.text);
+    });
+    return { startVoiceTurn, streamTtsAudio };
+  }
+
+  async function driveOneTurn(
+    session: ReturnType<typeof createLiveVoiceSession>,
+    frames: LiveVoiceServerFrame[],
+  ) {
+    await session.start();
+    await session.handleBinaryAudio(new Uint8Array([1, 2, 3, 4]));
+    await session.handleClientFrame({ type: "ptt_release" });
+    await waitFor(() => frames.some((frame) => frame.type === "tts_done"));
+  }
+
+  test("with no injected archiver and default config, nothing is archived", async () => {
+    const { startVoiceTurn, streamTtsAudio } = makeSingleTurnLegs();
+    const { context, frames } = createContext();
+    // No `archiveAudio` option → the factory consults config, which defaults
+    // off in the test workspace.
+    const session = createLiveVoiceSession(context, {
+      resolveCredentialReadiness: null,
+      resolveTranscriber: mock(async () => new FakeStreamingTranscriber()),
+      startVoiceTurn,
+      streamTtsAudio,
+      metricsClock: createClock(),
+      createTurnId: () => "live-turn-1",
+    });
+
+    await driveOneTurn(session, frames);
+
+    // The turn completed, but no `archived` frame was emitted — no audio
+    // attachment was written to either message.
+    expect(startVoiceTurn).toHaveBeenCalledTimes(1);
+    expect(frames.some((frame) => frame.type === "archived")).toBe(false);
+    expect(frameTypes(frames)).not.toContain("archived");
+  });
+
+  test("liveVoice.archiveAudio=true wires the default archiver through the factory", async () => {
+    // The real linkers write to the DB; these are role-less inputs, so stub
+    // them (synchronously — the linkers are sync) with a valid archived result
+    // per role. The point under test is the config→default-archiver wiring, not
+    // the DB write, which the injected-archiver tests above already cover.
+    const audioInput = {
+      sessionId: "session-123",
+      turnId: "live-turn-1",
+      mimeType: "audio/pcm",
+      audio: {
+        type: "base64" as const,
+        dataBase64: Buffer.from([1, 2, 3, 4]).toString("base64"),
+      },
+    };
+    const userSpy = spyOn(
+      liveVoiceArchive,
+      "linkLiveVoiceUserUtteranceAudioToMessage",
+    ).mockReturnValue(makeArchiveResult({ ...audioInput, role: "user" }));
+    const assistantSpy = spyOn(
+      liveVoiceArchive,
+      "linkLiveVoiceAssistantResponseAudioToMessage",
+    ).mockReturnValue(makeArchiveResult({ ...audioInput, role: "assistant" }));
+    const originalRaw = loadRawConfig();
+    saveRawConfig({ ...originalRaw, liveVoice: { archiveAudio: true } });
+
+    try {
+      const { startVoiceTurn, streamTtsAudio } = makeSingleTurnLegs();
+      const { context, frames } = createContext();
+      // Still no injected `archiveAudio` — the config default must supply it.
+      const session = createLiveVoiceSession(context, {
+        resolveCredentialReadiness: null,
+        resolveTranscriber: mock(async () => new FakeStreamingTranscriber()),
+        startVoiceTurn,
+        streamTtsAudio,
+        metricsClock: createClock(),
+        createTurnId: () => "live-turn-1",
+      });
+
+      await driveOneTurn(session, frames);
+
+      expect(userSpy).toHaveBeenCalledTimes(1);
+      expect(assistantSpy).toHaveBeenCalledTimes(1);
+      expect(frames.filter((frame) => frame.type === "archived")).toHaveLength(
+        2,
+      );
+    } finally {
+      saveRawConfig(originalRaw);
+      userSpy.mockRestore();
+      assistantSpy.mockRestore();
+    }
+  });
+});