@livx.cc/agentx 0.97.9 → 0.98.2

package/dist/cli.js

@@ -1755,7 +1755,7 @@ function makeRealShellTool(options) {
           proc.stderr?.on("data", collect);
           proc.on("error", (err2) => {
             if (err2?.name === "AbortError" || ctl.signal.aborted) return finish(reasonFor(timedOut, timeoutMs, clean(out)));
-            log13.debug("shell spawn error", err2);
+            log14.debug("shell spawn error", err2);
             finish(`[exit 1] ${err2?.message ?? err2}${out ? "\n" + clean(out) : ""}`);
           });
           proc.on("close", (code) => {
@@ -1817,7 +1817,7 @@ ${clean(out) || "(no output yet)"}`;
     }
   ];
 }
-var log13, clean, DETACHED, SECRET_ENV_RE, _spawn, ShellJobRegistry, NO_JOB2;
+var log14, clean, DETACHED, SECRET_ENV_RE, _spawn, ShellJobRegistry, NO_JOB2;
 var init_tools_shell = __esm({
   "src/tools.shell.ts"() {
     "use strict";
@@ -1825,7 +1825,7 @@ var init_tools_shell = __esm({
     init_redact();
     init_logging();
     init_shell_sandbox();
-    log13 = forComponent("shell");
+    log14 = forComponent("shell");
     clean = (s) => truncateOutput(redactSecrets(s.replace(/\n+$/, "")));
     DETACHED = { stdio: ["ignore", "pipe", "pipe"], detached: true };
     SECRET_ENV_RE = /(_API_KEY|_TOKEN|_SECRET|_PASSWORD|_PRIVATE_KEY|^AWS_|^GITHUB_TOKEN$|^OPENAI_|^ANTHROPIC_|^GOOGLE_|^GEMINI_|^GROQ_|^NPM_TOKEN$)/i;
@@ -4582,6 +4582,188 @@ function digestRun(messages, maxChars) {
 import { MemFilesystem as MemFilesystem2 } from "@livx.cc/wcli/core";
 init_logging();
 
+// src/voice/emotion.ts
+init_logging();
+var log8 = forComponent("Emotion");
+var EMOTIONS = [
+  // primary (best results)
+  "neutral",
+  "angry",
+  "excited",
+  "content",
+  "sad",
+  "scared",
+  // extended
+  "happy",
+  "enthusiastic",
+  "elated",
+  "triumphant",
+  "amazed",
+  "surprised",
+  "flirtatious",
+  "curious",
+  "calm",
+  "grateful",
+  "affectionate",
+  "sympathetic",
+  "mysterious",
+  "frustrated",
+  "disgusted",
+  "sarcastic",
+  "disappointed",
+  "hurt",
+  "guilty",
+  "bored",
+  "tired",
+  "nostalgic",
+  "apologetic",
+  "hesitant",
+  "confused",
+  "anxious",
+  "panicked",
+  "proud",
+  "confident",
+  "skeptical",
+  "contemplative",
+  "determined"
+];
+var VALID = new Set(EMOTIONS);
+var ALIASES = {
+  cheerful: "happy",
+  joyful: "happy",
+  joy: "happy",
+  glad: "happy",
+  pleased: "happy",
+  warm: "affectionate",
+  thrilled: "excited",
+  eager: "enthusiastic",
+  ecstatic: "elated",
+  euphoric: "elated",
+  mad: "angry",
+  furious: "angry",
+  annoyed: "frustrated",
+  irritated: "frustrated",
+  agitated: "frustrated",
+  shocked: "surprised",
+  astonished: "amazed",
+  wonder: "amazed",
+  worried: "anxious",
+  nervous: "anxious",
+  afraid: "scared",
+  alarmed: "panicked",
+  unsure: "hesitant",
+  uncertain: "hesitant",
+  doubtful: "skeptical",
+  suspicious: "skeptical",
+  thoughtful: "contemplative",
+  focused: "determined",
+  serious: "determined",
+  playful: "flirtatious",
+  teasing: "flirtatious",
+  ironic: "sarcastic",
+  cheeky: "sarcastic",
+  thankful: "grateful",
+  sorry: "apologetic",
+  down: "sad",
+  melancholic: "sad",
+  gloomy: "sad",
+  peaceful: "calm",
+  serene: "calm",
+  relaxed: "calm",
+  sleepy: "tired"
+};
+var NONVERBAL = { laughter: "laughter", laughs: "laughter", laugh: "laughter", laughing: "laughter" };
+function normalizeEmotion(raw) {
+  const k = raw.trim().toLowerCase();
+  if (VALID.has(k)) return k;
+  return ALIASES[k] ?? null;
+}
+function resolveTag(raw) {
+  const k = raw.trim().toLowerCase();
+  if (NONVERBAL[k]) return { kind: "nonverbal", value: NONVERBAL[k] };
+  const e = normalizeEmotion(k);
+  return e ? { kind: "emotion", value: e } : null;
+}
+var TAG_RE = /\[([a-zA-Z][a-zA-Z ]{0,24})\]/g;
+var PARTIAL_RE = /\[[a-zA-Z ]*$/;
+var cartesiaTag = (t) => t.kind === "nonverbal" ? `[${t.value}]` : `<emotion value="${t.value}"/>`;
+function renderEmotions(text, opts = { show: true }) {
+  let speech = "", display = "", prose = "", last = 0;
+  TAG_RE.lastIndex = 0;
+  for (let m = TAG_RE.exec(text); m; m = TAG_RE.exec(text)) {
+    const before = text.slice(last, m.index);
+    speech += before;
+    display += before;
+    prose += before;
+    const tag = resolveTag(m[1]);
+    if (tag) {
+      speech += cartesiaTag(tag);
+      if (opts.show) display += m[0];
+    } else {
+      log8.debug(`dropping unknown emotion tag ${m[0]}`);
+    }
+    last = m.index + m[0].length;
+  }
+  const tail = text.slice(last);
+  return { speech: speech + tail, display: display + tail, prose: prose + tail };
+}
+var EmotionStream = class {
+  constructor(show = true) {
+    this.show = show;
+  }
+  show;
+  buf = "";
+  pending = null;
+  feed(delta) {
+    this.buf += delta;
+    return this.drain(false);
+  }
+  flush() {
+    return this.drain(true);
+  }
+  drain(final) {
+    let body = this.buf;
+    if (!final) {
+      const p = body.match(PARTIAL_RE);
+      if (p) {
+        this.buf = p[0];
+        body = body.slice(0, body.length - p[0].length);
+      } else this.buf = "";
+    } else this.buf = "";
+    let speech = "", display = "", prose = "", last = 0;
+    TAG_RE.lastIndex = 0;
+    for (let m = TAG_RE.exec(body); m; m = TAG_RE.exec(body)) {
+      this.emit(body.slice(last, m.index), (s, d, p) => {
+        speech += s;
+        display += d;
+        prose += p;
+      });
+      const tag = resolveTag(m[1]);
+      if (tag) {
+        this.pending = tag;
+        if (this.show) display += m[0];
+      } else log8.debug(`dropping unknown emotion tag ${m[0]}`);
+      last = m.index + m[0].length;
+    }
+    this.emit(body.slice(last), (s, d, p) => {
+      speech += s;
+      display += d;
+      prose += p;
+    });
+    return { speech, display, prose };
+  }
+  /** Emit a prose span, flushing any pending tag onto its FRONT (only once real words appear). */
+  emit(text, sink) {
+    if (!text) return;
+    let speech = text;
+    if (this.pending && /[\p{L}\p{N}]/u.test(text)) {
+      speech = cartesiaTag(this.pending) + text;
+      this.pending = null;
+    }
+    sink(speech, text, text);
+  }
+};
+
 // src/voice/spokenSplitter.ts
 var OPEN = "<spoken>";
 var CLOSE = "</spoken>";
@@ -4655,7 +4837,7 @@ var SpokenSplitter = class {
 };
 
 // src/duplex.ts
-var log8 = forComponent("DuplexAgent");
+var log9 = forComponent("DuplexAgent");
 function describeCall(call) {
   const v = call.args && Object.values(call.args).find((x) => typeof x === "string" && x.trim());
   const hint = v ? ` (${String(v).replace(/\s+/g, " ").trim().slice(0, 48)})` : "";
@@ -4694,6 +4876,9 @@ var DuplexAgentOptions = class {
   /** Voice register: 'neutral' = clean spoken style; 'conversational' = human-like — fillers,
    *  backchannels, impulsive first reactions before content (mimics real duplex conversation). */
   voiceStyle = "neutral";
+  /** Teach the model to emit inline `[emotion]` tags for Cartesia emotion control. Only set when the
+   *  TTS actually speaks them — text-duplex (no TTS) would otherwise print literal tags. */
+  emotionTags = false;
   /** Awaited BEFORE a worker spawns — open a per-task checkpoint frame, audit, etc.
    *  (post-spawn would race the worker's first edits). */
   onTaskStart;
@@ -4726,6 +4911,7 @@ var VOICE_SYSTEM_PROMPT = 'You are a spoken voice assistant \u2014 the user HEAR
 var THINK_GUIDANCE = "\u2022 `Think` \u2014 your brain. A premium reasoning model, FAR more expensive than Act. Reserve it for open-ended architecture/design questions, or a problem Act already FAILED at. ALL implementation work \u2014 coding, refactoring, debugging, edge cases, tests \u2014 goes to Act; Act is highly capable. Never send the same work to both.";
 var THINK_DISABLED_GUIDANCE = "(Think tier is not available \u2014 use Act for all escalations.)";
 var VOICE_STYLE_CONVERSATIONAL = `Speak like a person in a live conversation, not an assistant reading a script. React first, then deliver: a quick impulsive beat ("oh nice", "hmm, hold on", "ah, got it") before the substance. Use contractions always. Vary sentence length \u2014 some very short. Light fillers and backchannels are fine ("mm-hm", "right", "let's see") but at most one per reply \u2014 never stack them. When you escalate to Act or Think, say it like a human would ("hang on, let me actually dig into that \u2014 gimme a minute") instead of announcing a task. When a result comes back, react to it like you just found out ("okay so \u2014 turns out\u2026"). Match the user's energy: a quick question gets a quick answer \u2014 a few words is a perfectly good turn. Prefer a short answer plus an offer ("want the details?") over covering everything. Never narrate your own mechanics (no "I will now act", no task ids out loud).`;
+var EMOTION_TAGS_GUIDANCE = `EMOTION: your voice is synthesized with emotion control. Prefix a sentence with an inline [emotion] tag, placed directly before the sentence it colors, to shape how it is spoken. Use it ONLY when the emotion genuinely fits the words (it amplifies real feeling, it cannot fake it) \u2014 do not tag every sentence; reserve it for moments that carry feeling, and vary which one you use. You may also drop [laughter] for a natural laugh. Available emotions: ${EMOTIONS.join(", ")}.`;
 var DuplexAgent = class _DuplexAgent {
   options;
   voice;
@@ -4751,6 +4937,8 @@ var DuplexAgent = class _DuplexAgent {
   // briefs dispatched this turn (detect identical re-dispatch)
   spokeThisTurn = false;
   // any non-empty text_delta streamed this turn
+  heldThisTurn = false;
+  // Hold called this turn → turn is INTENTIONALLY silent (suppress reflex text + no dead-air ack)
   nudging = false;
   // re-ack pass in flight: block ALL tools, prevent recursion
   reflexBuf = "";
@@ -4795,7 +4983,7 @@ var DuplexAgent = class _DuplexAgent {
       ...new Set(workerToolNames.filter((n) => n.startsWith("mcp__")).map((n) => n.slice(5).split("__")[0]))
     ];
     const workerMcp = mcpNames.length ? `, and it can use these MCP servers: ${[...new Set(mcpNames)].join(", ")}` + (mcpNames.some((n) => /browser/i.test(n)) ? ' \u2014 including driving a REAL browser (open tabs, navigate, click, screenshot), so answer "yes" if asked whether you can control/drive a browser and route an actual browse to Act' : "") : "";
-    const prompt = VOICE_SYSTEM_PROMPT.replace("{{MEMORY_SLOT}}", memSlot).replace("{{THINK_SLOT}}", thinkSlot).replace("{{WORKER_WEB}}", workerWeb + workerMcp) + (o.voiceStyle === "conversational" ? "\n" + VOICE_STYLE_CONVERSATIONAL : "") + `
+    const prompt = VOICE_SYSTEM_PROMPT.replace("{{MEMORY_SLOT}}", memSlot).replace("{{THINK_SLOT}}", thinkSlot).replace("{{WORKER_WEB}}", workerWeb + workerMcp) + (o.voiceStyle === "conversational" ? "\n" + VOICE_STYLE_CONVERSATIONAL : "") + (o.emotionTags ? "\n" + EMOTION_TAGS_GUIDANCE : "") + `
 Today's date: ${(/* @__PURE__ */ new Date()).toDateString()}.`;
     const tools = [
       ...o.reflexOptions?.tools ?? [],
@@ -4813,13 +5001,14 @@ Today's date: ${(/* @__PURE__ */ new Date()).toDateString()}.`;
       confirm: host.confirm ? (p, m) => host.confirm(p, m) : void 0,
       notify: (ev) => {
         if (ev?.kind === "text_delta" && typeof ev.message === "string") {
+          if (this.heldThisTurn) return;
           if (this.fabricationCut) return;
           const msg = ev.message;
           this.reflexBuf += msg;
           const m = this.reflexBuf.match(RESERVED_EVENT_MARKER) ?? this.reflexBuf.match(RESERVED_EVENT_OPENER);
           if (m) {
             this.fabricationCut = true;
-            log8.warn(`reflex fabricated a [task \u2026] event in its spoken stream \u2014 cutting it (kept ${m.index} chars)`);
+            log9.warn(`reflex fabricated a [task \u2026] event in its spoken stream \u2014 cutting it (kept ${m.index} chars)`);
             const safe = this.reflexBuf.slice(this.reflexForwarded, m.index);
             if (!safe) return;
             if (safe.trim()) this.spokeThisTurn = true;
@@ -4882,6 +5071,7 @@ Today's date: ${(/* @__PURE__ */ new Date()).toDateString()}.`;
     this.turnDispatched = false;
     this.turnBriefs.clear();
     this.spokeThisTurn = false;
+    this.heldThisTurn = false;
     this.reflexBuf = "";
     this.reflexForwarded = 0;
     this.fabricationCut = false;
@@ -4910,7 +5100,7 @@ Today's date: ${(/* @__PURE__ */ new Date()).toDateString()}.`;
    *  voice) and emits an empty `final`, so no text_delta ever streams. Both ship silence; both repair.
    *  Requires a host: without one there's no stream to detect speech on (and no one to speak to). */
   get silentTurn() {
-    return !!this.options.host && !this.spokeThisTurn;
+    return !!this.options.host && !this.spokeThisTurn && !this.heldThisTurn;
   }
   /** A turn that voiced nothing is dead air. Re-prompt the reflex ONCE so the LLM itself voices a short
    *  line (no template). If it STILL says nothing, fall back to a minimal line so silence never ships.
@@ -4921,7 +5111,7 @@ Today's date: ${(/* @__PURE__ */ new Date()).toDateString()}.`;
     try {
       await this.voice.send(fallback ? "[reminder] You said nothing to the user this turn. Tell them, in ONE short spoken sentence, what just happened \u2014 no tools." : dispatched ? "[reminder] You dispatched a task but said nothing to the user. Say ONE short spoken acknowledgement now \u2014 no tools." : "[reminder] You said nothing to the user this turn. Give your ONE short spoken reply now \u2014 no tools.");
     } catch (e) {
-      log8.warn(`ack nudge failed: ${e instanceof Error ? e.message : e}`);
+      log9.warn(`ack nudge failed: ${e instanceof Error ? e.message : e}`);
     } finally {
       this.nudging = false;
     }
@@ -5013,7 +5203,7 @@ Today's date: ${(/* @__PURE__ */ new Date()).toDateString()}.`;
   buildBrief(brief, tier = "act", deliver = true) {
     const recent = this.voice.transcript.filter((m) => (m.role === "user" || m.role === "assistant") && contentText(m.content).trim()).slice(-this.options.excerptTurns).map((m) => `${m.role}: ${contentText(m.content)}`).join("\n");
     const verify = tier === "act" ? "\n\nBefore reporting done: re-read what you changed and check it against EVERY requirement above \u2014 fix any gap first. Your report is trusted without review." : "";
-    const deliverContract = deliver ? "\n\n## DELIVER (spoken delivery)\nYou are reporting back to a user who is LISTENING. Stream your work normally \u2014 your prose is the written work record and detail, and is NOT spoken. Wrap anything the user should HEAR in <spoken>\u2026</spoken> tags. LEAD WITH the actual content they asked for: if they asked for a specific piece of content \u2014 a value, a name, the actual lines, the writing itself \u2014 that content goes INSIDE the <spoken> tags, not a remark about it. Your FIRST <spoken> segment is substantive \u2014 never a greeting or an acknowledgement (the front-end has already acked; do not double-ack). Keep spoken text concise and natural for the ear: short sentences, no markdown." : "";
+    const deliverContract = deliver ? "\n\n## DELIVER (spoken delivery)\nYou are reporting back to a user who is LISTENING. Stream your work normally \u2014 your prose is the written work record and detail, and is NOT spoken. Wrap anything the user should HEAR in <spoken>\u2026</spoken> tags. LEAD WITH the actual content they asked for: if they asked for a specific piece of content \u2014 a value, a name, the actual lines, the writing itself \u2014 that content goes INSIDE the <spoken> tags, not a remark about it. Your FIRST <spoken> segment is substantive \u2014 never a greeting or an acknowledgement (the front-end has already acked; do not double-ack). Keep spoken text concise and natural for the ear: short sentences, no markdown." + (this.options.emotionTags ? " Inside <spoken>, you may prefix a sentence with an inline [emotion] tag (e.g. [excited], [curious]) to color how it is voiced \u2014 only when it genuinely fits, and vary it; [laughter] gives a natural laugh." : "") : "";
     return (recent ? `${brief}
 
 ## Recent conversation (for context)
@@ -5129,7 +5319,7 @@ Another agent just implemented the above. Independently check the CURRENT state
     this.notify("task_verify", `task ${id}: verifying`, { id });
     const cres = await new Agent(checkerOpts).run(checkBrief);
     if (cres.finishReason !== "stop") {
-      log8.warn(`task ${id}: verify inconclusive (${cres.finishReason})`);
+      log9.warn(`task ${id}: verify inconclusive (${cres.finishReason})`);
       this.notify("task_verify", `task ${id}: verify inconclusive (${cres.finishReason})`, { id, finishReason: cres.finishReason });
     }
     const sum = (a = 0, b = 0) => a + b;
@@ -5265,7 +5455,7 @@ Another agent just implemented the above. Independently check the CURRENT state
     rec.status = "done";
     rec.result = res.text;
     const incomplete = res.finishReason !== "stop";
-    log8.verbose(`task ${id} done (${res.steps} steps${incomplete ? `, INCOMPLETE: ${res.finishReason}` : ""})`);
+    log9.verbose(`task ${id} done (${res.steps} steps${incomplete ? `, INCOMPLETE: ${res.finishReason}` : ""})`);
     this.notify("task_done", `task ${id} (${rec.label}) completed`, {
       id,
       text: res.text,
@@ -5291,7 +5481,7 @@ Another agent just implemented the above. Independently check the CURRENT state
     this.dropAsk(rec.id);
     rec.status = "error";
     rec.result = msg;
-    log8.warn(`task ${rec.id} failed: ${msg}`);
+    log9.warn(`task ${rec.id} failed: ${msg}`);
     this.notify("task_error", `task ${rec.id} (${rec.label}) failed: ${msg}`);
     this.queueRevoice(this.integrationPrompt(rec, "error", msg, "error"), true);
   }
@@ -5471,6 +5661,7 @@ Another agent just implemented the above. Independently check the CURRENT state
         }
       },
       run: async ({ filler }) => {
+        this.heldThisTurn = true;
         if (filler) this.notify("hold_filler", String(filler));
         return "Holding \u2014 listening for the rest of the user's thought. Do not respond further this turn.";
       }
@@ -5596,7 +5787,7 @@ init_logging();
 
 // src/voice/engine.ts
 init_logging();
-var log9 = forComponent("VoiceEngine");
+var log10 = forComponent("VoiceEngine");
 var now = () => performance.now();
 var forSpeech = (t) => t.replace(/[*_`#]+/g, "").replace(/^[ \t]*[-•]\s+/gm, "").replace(/\s*[\u2013\u2014]\s*/g, ", ").replace(/[\u2010\u2011]/g, "-").replace(/\s*\|\s*/g, ", ").replace(/(\d)\s+%/g, "$1%").replace(/\.{3,}/g, ".");
 var VoiceEngineOptions = class {
@@ -5664,6 +5855,11 @@ var VoiceEngineOptions = class {
    *  speech at all, an audible hiccup. Default OFF: the genuine-gated STT partial is the
    *  mechanism-correct pause trigger; enable only if barge-in onset feels sluggish in a clean-AEC room. */
   overlapEnergyHold = false;
+  /** Map inline `[emotion]` tags (emitted by the model, prompt-taught) into Cartesia inline emotion
+   *  tags in the spoken transcript (sonic-3 stitches the prosody). false = strip them silently. */
+  emotions = true;
+  /** Show the `[emotion]` tags in the on-screen echo (debug). false = hide (spoken-only). */
+  showEmotions = false;
 };
 var VoiceEngine = class _VoiceEngine {
   options;
@@ -5709,6 +5905,9 @@ var VoiceEngine = class _VoiceEngine {
   // Central speech queue (above the TTS context): complete worker utterances serialize into ONE
   // playback stream, one-at-a-time, never splicing into the live reflex's open utterance.
   uttQueue = [];
+  // Per-turn emotion-tag parser (reset on beginSpeech) — converts `[emotion]` → Cartesia inline tags
+  // for TTS, tracks tag-free prose for echo discrimination, and surfaces display text for the screen.
+  emo = null;
   constructor(options) {
     this.options = { ...new VoiceEngineOptions(), ...options };
     const o = this.options;
@@ -5726,7 +5925,7 @@ var VoiceEngine = class _VoiceEngine {
     this.stt.onLevel = (rms) => this.handleLevel(rms);
     await Promise.all([this.tts.connect(), this.stt.start()]);
     this.setState("listening");
-    log9.debug(`voice I/O up (${this.stt.usingAec ? "AEC" : "heuristic echo"} capture)`);
+    log10.debug(`voice I/O up (${this.stt.usingAec ? "AEC" : "heuristic echo"} capture)`);
   }
   get usingAec() {
     return this.stt.usingAec;
@@ -5735,6 +5934,10 @@ var VoiceEngine = class _VoiceEngine {
   setBargeIn(on) {
     this.options.bargeIn = on;
   }
+  /** Show/hide the `[emotion]` debug tags in the echo (next turn's stream picks it up). */
+  setShowEmotions(on) {
+    this.options.showEmotions = on;
+  }
   idleWaiters = [];
   setState(s) {
     if (this.state === s) return;
@@ -5766,6 +5969,7 @@ var VoiceEngine = class _VoiceEngine {
     this.ctxOpen = true;
     this.spokeDeltas = false;
     this.reply = "";
+    this.emo = this.options.emotions ? new EmotionStream(this.options.showEmotions) : null;
     this.echoWords = new Set(this.words(this.prevReply));
     this.tts.newContext();
     if (ack && this.options.ackPhrase) {
@@ -5776,21 +5980,31 @@ var VoiceEngine = class _VoiceEngine {
     if (!this.turnStartAt) this.turnStartAt = now();
     this.setState("thinking");
   }
+  /** Feed a spoken delta. Returns the on-screen echo text (emotion tags shown/hidden per config) so the
+   *  host renders the SAME stream that was parsed for TTS — no second, state-doubling parse. */
   speakDelta(text) {
-    if (this.interrupted) return;
+    if (this.interrupted) return "";
     if (!this.speaking || !this.ctxOpen) this.beginSpeech();
-    this.reply += text;
+    const { speech, display, prose } = this.emo ? this.emo.feed(text) : { speech: text, display: text, prose: text };
+    this.reply += prose;
     for (const w of this.words(this.reply)) this.echoWords.add(w);
-    this.tts.speak(forSpeech(text), true);
-    if (!this.spokeDeltas && this.turnStartAt) log9.debug(`ttft: ${Math.round(now() - this.turnStartAt)}ms`);
+    this.tts.speak(forSpeech(speech), true);
+    if (!this.spokeDeltas && this.turnStartAt) log10.debug(`ttft: ${Math.round(now() - this.turnStartAt)}ms`);
     this.spokeDeltas = true;
     this.setState("speaking");
+    return display;
   }
   /** close the spoken turn (idempotent); stays audible until ALL audio arrived AND playback drains */
   endSpeech() {
     this.interrupted = false;
     if (!this.speaking) return;
     this.ctxOpen = false;
+    if (this.emo) {
+      const t = this.emo.flush();
+      this.emo = null;
+      if (t.prose) this.reply += t.prose;
+      if (t.speech) this.tts.speak(forSpeech(t.speech), true);
+    }
     if (this.reply) this.prevReply = this.reply;
     const settle = () => {
       if (this.ctxOpen) {
@@ -5803,7 +6017,7 @@ var VoiceEngine = class _VoiceEngine {
       }
       this.drainTimer = null;
       this.speaking = false;
-      if (this.turnStartAt) log9.debug(`turn: ${Math.round(now() - this.turnStartAt)}ms (incl. playback)`);
+      if (this.turnStartAt) log10.debug(`turn: ${Math.round(now() - this.turnStartAt)}ms (incl. playback)`);
       this.echoUntil = now() + 2500;
       if (!this.usingAec) this.stt.reset();
       this.setState("listening");
@@ -5995,7 +6209,7 @@ var VoiceEngine = class _VoiceEngine {
     this.pendingUtt = this.mergeUtterance(this.pendingUtt, text);
     if (this.pendingTimer) clearTimeout(this.pendingTimer);
     if (this.options.incompleteMergeMs && this.looksIncomplete(this.pendingUtt)) {
-      log9.verbose(`hold: incomplete utterance "${this.pendingUtt.slice(-40)}"`);
+      log10.verbose(`hold: incomplete utterance "${this.pendingUtt.slice(-40)}"`);
       this.options.onHold();
       if (this.options.holdFiller && !this.speaking) {
         this.beginSpeech();
@@ -6094,7 +6308,7 @@ async function resolveAuth(auth) {
 }
 
 // src/voice/soniox.ts
-var log10 = forComponent("SonioxSTT");
+var log11 = forComponent("SonioxSTT");
 var now2 = () => performance.now();
 var SonioxSTTOptions = class {
   auth = "";
@@ -6163,9 +6377,9 @@ var SonioxSTT = class {
     this.ws.onmessage = (ev) => this.handle(JSON.parse(String(ev.data)));
     this.ws.onclose = (ev) => {
       if (this.stopped) return;
-      log10.warn(`soniox ws closed (${ev.code} ${ev.reason || ""}) \u2014 reconnecting`);
+      log11.warn(`soniox ws closed (${ev.code} ${ev.reason || ""}) \u2014 reconnecting`);
       this.reset();
-      this.connectWs().catch((e) => log10.error(`soniox reconnect failed: ${e.message}`));
+      this.connectWs().catch((e) => log11.error(`soniox reconnect failed: ${e.message}`));
     };
   }
   async start() {
@@ -6175,7 +6389,7 @@ var SonioxSTT = class {
     this.endpointTimer = setInterval(() => {
       const combined = (this.finalText + this.partialText).trim();
       if (!combined || now2() - this.lastChangeAt < this.options.silenceEndpointMs) return;
-      if (this.firstTokenAt) log10.debug(`stt: ${Math.round(now2() - this.firstTokenAt)}ms first-token\u2192silence-endpoint, "${combined.slice(0, 60)}"`);
+      if (this.firstTokenAt) log11.debug(`stt: ${Math.round(now2() - this.firstTokenAt)}ms first-token\u2192silence-endpoint, "${combined.slice(0, 60)}"`);
       this.reset();
       this.onUtterance(combined, now2());
     }, 120);
@@ -6187,7 +6401,7 @@ var SonioxSTT = class {
         if (this.stopped) return;
         const ref = this.lastChunkAt || this.startedChunksAt;
         if (now2() - ref > noAudioMs) {
-          log10.error(`stt: no mic audio for >${Math.round(noAudioMs / 1e3)}s \u2014 capture device stopped delivering`);
+          log11.error(`stt: no mic audio for >${Math.round(noAudioMs / 1e3)}s \u2014 capture device stopped delivering`);
           this.onFatal("microphone stopped delivering audio (try a different input device, e.g. AirPods, or check System Settings \u2192 Sound \u2192 Input)");
           this.stop();
         }
@@ -6207,7 +6421,7 @@ var SonioxSTT = class {
     });
   }
   handle(m) {
-    if (m.error_message) return log10.error(`soniox: ${m.error_message}`);
+    if (m.error_message) return log11.error(`soniox: ${m.error_message}`);
     let endpoint = false;
     for (const t of m.tokens ?? []) {
       if (t.text === "<end>") endpoint = true;
@@ -6223,7 +6437,7 @@ var SonioxSTT = class {
     this.onPartial(combined);
     if (endpoint && this.finalText.trim()) {
       const utterance = this.finalText.trim();
-      if (this.firstTokenAt) log10.debug(`stt: ${Math.round(now2() - this.firstTokenAt)}ms first-token\u2192endpoint, "${utterance.slice(0, 60)}"`);
+      if (this.firstTokenAt) log11.debug(`stt: ${Math.round(now2() - this.firstTokenAt)}ms first-token\u2192endpoint, "${utterance.slice(0, 60)}"`);
       this.reset();
       this.onUtterance(utterance, now2());
     }
@@ -6246,7 +6460,7 @@ var SonioxSTT = class {
 
 // src/voice/cartesia.ts
 init_logging();
-var log11 = forComponent("CartesiaTTS");
+var log12 = forComponent("CartesiaTTS");
 var now3 = () => performance.now();
 var CartesiaTTSOptions = class {
   auth = "";
@@ -6296,9 +6510,9 @@ var CartesiaTTS = class _CartesiaTTS {
       this.ws.onerror = (e) => rej(new Error(`cartesia ws: ${e.message || "connect failed"}`));
     });
     this.ws.onclose = (ev) => {
-      log11.warn(`cartesia ws closed (${ev.code} ${ev.reason || ""})`);
+      log12.warn(`cartesia ws closed (${ev.code} ${ev.reason || ""})`);
       if (!this.closed) {
-        this.connecting = this.doConnect().catch((e) => log11.error(`cartesia reconnect failed: ${e.message}`));
+        this.connecting = this.doConnect().catch((e) => log12.error(`cartesia reconnect failed: ${e.message}`));
       }
     };
     this.ws.onmessage = (ev) => {
@@ -6320,11 +6534,11 @@ var CartesiaTTS = class _CartesiaTTS {
           this.down = true;
           this.downAt = now3();
           this.consecutiveOk = 0;
-          log11.warn(`TTS circuit breaker open \u2014 ${this.consecutiveErrors} consecutive errors, switching to text-only`);
+          log12.warn(`TTS circuit breaker open \u2014 ${this.consecutiveErrors} consecutive errors, switching to text-only`);
           this.onDone();
           this.startProbe();
         } else if (!this.down) {
-          log11.warn(`cartesia: ${JSON.stringify(m)}`);
+          log12.warn(`cartesia: ${JSON.stringify(m)}`);
         }
       }
     };
@@ -6338,7 +6552,7 @@ var CartesiaTTS = class _CartesiaTTS {
     this.consecutiveOk = 0;
     this.stopProbe();
     const downMs = this.downAt ? now3() - this.downAt : 0;
-    (downMs < 2e3 ? log11.debug : log11.info)(`TTS recovered${downMs ? ` (down ${downMs}ms)` : ""}`);
+    (downMs < 2e3 ? log12.debug : log12.info)(`TTS recovered${downMs ? ` (down ${downMs}ms)` : ""}`);
   }
   /** Ensure the WS is open before sending — reconnects if idle-closed. */
   async ensureConnected() {
@@ -6418,7 +6632,7 @@ import { MemFilesystem as MemFilesystem3, IndexedDbFilesystem, CommandExecutor a
 init_logging();
 import { spawn } from "child_process";
 import { createHash } from "crypto";
-var log12 = forComponent("mcp");
+var log13 = forComponent("mcp");
 var PROTOCOL_VERSION = "2025-06-18";
 var DEFAULT_TIMEOUT_MS = 3e4;
 var StdioTransport = class {
@@ -6437,7 +6651,7 @@ var StdioTransport = class {
     proc.stdout.setEncoding("utf8");
     proc.stdout.on("data", (chunk) => this.onData(chunk));
     proc.stderr.setEncoding("utf8");
-    proc.stderr.on("data", (chunk) => log12.debug(`[${command}] stderr:`, chunk.trimEnd()));
+    proc.stderr.on("data", (chunk) => log13.debug(`[${command}] stderr:`, chunk.trimEnd()));
     proc.on("exit", (code) => this.failAll(new Error(`MCP server "${command}" exited (code ${code})`)));
     proc.on("error", (e) => this.failAll(e instanceof Error ? e : new Error(String(e))));
   }
@@ -6451,7 +6665,7 @@ var StdioTransport = class {
       try {
         this.dispatch(JSON.parse(line));
       } catch (e) {
-        log12.debug("dropping non-JSON line from MCP server:", line, e);
+        log13.debug("dropping non-JSON line from MCP server:", line, e);
       }
     }
   }
@@ -6500,7 +6714,7 @@ var StdioTransport = class {
     try {
       this.proc?.stdin?.end();
     } catch (e) {
-      log12.debug("stdin end failed", e);
+      log13.debug("stdin end failed", e);
     }
     this.proc?.kill();
   }
@@ -6569,7 +6783,7 @@ function parseSseResponse(body) {
       const obj = JSON.parse(trimmed.slice(5).trim());
       if (obj && (obj.result !== void 0 || obj.error !== void 0)) return obj;
     } catch (e) {
-      log12.debug("skipping unparseable SSE data line", e);
+      log13.debug("skipping unparseable SSE data line", e);
     }
   }
   return {};
@@ -6637,7 +6851,7 @@ async function mountWithDeadline(name, cfg, mountTimeoutMs) {
       return { name, client, tools, specs, serverInfo: init?.serverInfo, config: cfg };
     })(), mountTimeoutMs, name);
   } catch (e) {
-    await client.close().catch((err2) => log12.debug(`close after failed mount of "${name}": ${err2}`));
+    await client.close().catch((err2) => log13.debug(`close after failed mount of "${name}": ${err2}`));
     throw e;
   }
 }
@@ -6648,15 +6862,15 @@ function validEntries(servers) {
   return Object.entries(servers).filter(([name, cfg]) => {
     if (!cfg || cfg.disabled) return false;
     if (!cfg.command && !cfg.url) {
-      log12.warn(`MCP server "${name}" needs a command (stdio) or url (http) \u2014 skipping`);
+      log13.warn(`MCP server "${name}" needs a command (stdio) or url (http) \u2014 skipping`);
       return false;
     }
     return true;
   });
 }
 function logMountFailure(name, e) {
-  if (e instanceof McpAuthError) log12.warn(`MCP "${name}" needs-auth: HTTP ${e.status} \u2014 set bearerToken or headers in its config; skipping`);
-  else log12.error(`MCP server "${name}" failed to mount: ${e?.message ?? e}`);
+  if (e instanceof McpAuthError) log13.warn(`MCP "${name}" needs-auth: HTTP ${e.status} \u2014 set bearerToken or headers in its config; skipping`);
+  else log13.error(`MCP server "${name}" failed to mount: ${e?.message ?? e}`);
 }
 async function mountMcpServers(servers = {}, opts = {}) {
   const entries = validEntries(servers);
@@ -6666,7 +6880,7 @@ async function mountMcpServers(servers = {}, opts = {}) {
     const name = entries[i][0];
     if (r.status === "fulfilled") {
       out.push(r.value);
-      log12.debug(`MCP "${name}" mounted \u2014 ${r.value.tools.length} tool(s)${r.value.serverInfo?.name ? ` from ${r.value.serverInfo.name}` : ""}`);
+      log13.debug(`MCP "${name}" mounted \u2014 ${r.value.tools.length} tool(s)${r.value.serverInfo?.name ? ` from ${r.value.serverInfo.name}` : ""}`);
     } else logMountFailure(name, r.reason);
   });
   return out;
@@ -6706,7 +6920,7 @@ var McpPool = class {
     const prev = this.warm.get(key);
     if (prev) {
       clearTimeout(prev.timer);
-      if (prev.client !== client) void prev.client.close().catch((err2) => log12.debug(`warm-pool replace close failed: ${err2}`));
+      if (prev.client !== client) void prev.client.close().catch((err2) => log13.debug(`warm-pool replace close failed: ${err2}`));
     }
     const e = { client, timer: void 0 };
     this.warm.set(key, e);
@@ -6723,7 +6937,7 @@ var McpPool = class {
     const e = this.warm.get(key);
     if (!e) return;
     this.warm.delete(key);
-    await e.client.close().catch((err2) => log12.debug(`warm-pool evict close failed: ${err2}`));
+    await e.client.close().catch((err2) => log13.debug(`warm-pool evict close failed: ${err2}`));
   }
   async closeAll() {
     for (const e of this.warm.values()) {
@@ -6941,7 +7155,7 @@ init_tools_shell();
 // src/tools.notify.ts
 init_logging();
 import { execFile } from "child_process";
-var log14 = forComponent("notify");
+var log15 = forComponent("notify");
 function makeNotifyTool(opts = {}) {
   const platform2 = opts.platform ?? process.platform;
   const run = opts.exec ?? execFile;
@@ -6965,7 +7179,7 @@ function makeNotifyTool(opts = {}) {
       return new Promise((resolve4) => {
         run(argv[0], argv[1], { timeout: 5e3 }, (e) => {
           if (e) {
-            log14.debug("notification failed", e);
+            log15.debug("notification failed", e);
             resolve4(`Notification failed: ${e.message}`);
           } else resolve4("Notification shown.");
         });
@@ -6981,7 +7195,7 @@ import { BodDB as BodDB2 } from "@bod.ee/db";
 init_logging();
 import { existsSync as existsSync2, readFileSync as readFileSync3 } from "fs";
 import { homedir } from "os";
-var log15 = forComponent("cli-util");
+var log16 = forComponent("cli-util");
 function dotDirs(base, sub, opts = {}) {
   const home = opts.home ?? homedir();
   const dirs = [`${base}/.agent/${sub}`, `${base}/.claude/${sub}`, `${home}/.agent/${sub}`, `${home}/.claude/${sub}`];
@@ -6998,7 +7212,7 @@ function parseJson(text, fallback, what = "json") {
   try {
     return JSON.parse(text);
   } catch (e) {
-    log15.debug(`parseJson(${what}) failed: ${e.message}`);
+    log16.debug(`parseJson(${what}) failed: ${e.message}`);
     return fallback;
   }
 }
@@ -7008,7 +7222,7 @@ function readJsonFile(path, fallback) {
   try {
     text = readFileSync3(path, "utf8");
   } catch (e) {
-    log15.debug(`readJsonFile(${path}) unreadable: ${e.message}`);
+    log16.debug(`readJsonFile(${path}) unreadable: ${e.message}`);
     return fallback;
   }
   return parseJson(text, fallback, path);
@@ -7261,7 +7475,7 @@ import { existsSync as existsSync4, mkdirSync as mkdirSync5, readFileSync as rea
 import { homedir as homedir3 } from "os";
 import { dirname as dirname3, join as join6 } from "path";
 import { fileURLToPath } from "url";
-var log16 = forComponent("VoiceIO");
+var log17 = forComponent("VoiceIO");
 var now4 = () => performance.now();
 var Player = class {
   proc = null;
@@ -7275,7 +7489,7 @@ var Player = class {
       ["-loglevel", "quiet", "-nodisp", "-fflags", "nobuffer", "-flags", "low_delay", "-probesize", "32", "-f", "s16le", "-ar", String(TTS_SAMPLE_RATE), "-ch_layout", "mono", "-i", "-"],
       { stdio: ["pipe", "ignore", "ignore"] }
     );
-    this.proc.on("error", (e) => log16.warn(`ffplay error: ${e.message}`));
+    this.proc.on("error", (e) => log17.warn(`ffplay error: ${e.message}`));
     this.proc.stdin.on("error", () => {
     });
     this.bytesWritten = 0;
@@ -7313,7 +7527,7 @@ function detectFfmpegMic() {
   const devices = [...audio.matchAll(/\[(\d+)\] (.+)/g)].map(([, idx, name]) => ({ idx, name: name.trim() }));
   const mic = devices.find((d) => /microphone|built-in/i.test(d.name) && !/teams|blackhole|loopback/i.test(d.name)) ?? devices[0];
   if (!mic) throw new Error("no audio input device found");
-  log16.debug(`ffmpeg mic: [${mic.idx}] ${mic.name}`);
+  log17.debug(`ffmpeg mic: [${mic.idx}] ${mic.name}`);
   return `:${mic.idx}`;
 }
 function detectedInputDevice() {
@@ -7349,15 +7563,15 @@ function resolveAecBinary() {
   if (existsSync4(bin) && statSync3(bin).mtimeMs >= statSync3(src).mtimeMs) return bin;
   if (spawnSync2("which", ["swiftc"]).status !== 0) return null;
   mkdirSync5(cacheDir, { recursive: true });
-  log16.info("compiling AEC mic helper (first run)\u2026");
+  log17.info("compiling AEC mic helper (first run)\u2026");
   const build = spawnSync2("swiftc", ["-O", "-o", bin, src, "-Xlinker", "-sectcreate", "-Xlinker", "__TEXT", "-Xlinker", "__info_plist", "-Xlinker", plist], { encoding: "utf8" });
   if (build.status !== 0) {
-    log16.warn(`AEC build failed: ${build.stderr?.slice(0, 400)}`);
+    log17.warn(`AEC build failed: ${build.stderr?.slice(0, 400)}`);
     return null;
   }
   const sign = spawnSync2("codesign", ["-fs", "-", bin], { encoding: "utf8" });
   if (sign.status !== 0) {
-    log16.warn(`codesign failed: ${sign.stderr?.slice(0, 200)}`);
+    log17.warn(`codesign failed: ${sign.stderr?.slice(0, 200)}`);
     return null;
   }
   return bin;
@@ -7399,16 +7613,16 @@ var NodeMicSource = class {
       this.proc = spawn2(this.bin, [], { stdio: ["ignore", "pipe", "ignore"] });
     } else {
       if (spawnSync2("which", ["ffmpeg"]).status !== 0) throw new Error("voice I/O unavailable: no AEC helper and no ffmpeg on PATH");
-      log16.info("mic: raw capture (no AEC) \u2014 echo handled heuristically; headphones recommended");
+      log17.info("mic: raw capture (no AEC) \u2014 echo handled heuristically; headphones recommended");
       this.proc = spawn2(
         "ffmpeg",
         ["-loglevel", "error", "-f", "avfoundation", "-i", detectFfmpegMic(), "-ar", String(STT_SAMPLE_RATE), "-ac", "1", "-f", "s16le", "-"],
         { stdio: ["ignore", "pipe", "pipe"] }
       );
-      this.proc.stderr.on("data", (d) => log16.warn(`ffmpeg: ${String(d).trim()}`));
+      this.proc.stderr.on("data", (d) => log17.warn(`ffmpeg: ${String(d).trim()}`));
     }
     this.proc.on("exit", (c) => {
-      if (c && !this.stopped) log16.error(`mic capture exited (${c}) \u2014 check mic permission / MIC_DEVICE / MIC_AEC=0`);
+      if (c && !this.stopped) log17.error(`mic capture exited (${c}) \u2014 check mic permission / MIC_DEVICE / MIC_AEC=0`);
     });
     this.proc.stdout.on("data", (chunk) => onChunk(chunk));
   }
@@ -7474,7 +7688,7 @@ var AecDuplexAudio = class {
     this.proc.stdin.on("error", () => {
     });
     this.proc.on("exit", (c) => {
-      if (c && !this.stopped) log16.error(`aec duplex audio exited (${c}) \u2014 check mic permission / MIC_AEC=0`);
+      if (c && !this.stopped) log17.error(`aec duplex audio exited (${c}) \u2014 check mic permission / MIC_AEC=0`);
     });
     this.proc.stdout.on("data", (chunk) => {
       this.gotChunk = true;
@@ -7490,7 +7704,7 @@ var AecDuplexAudio = class {
             openMicSettings();
             this.onFatal?.("microphone permission denied \u2014 enable it in System Settings \u2192 Privacy & Security \u2192 Microphone for your terminal, then restart it");
           }
-        } else log16.debug(`mic-aec: ${s}`);
+        } else log17.debug(`mic-aec: ${s}`);
       }
     });
     if (!this.noVpio && !this.triedFallback) {
@@ -7499,7 +7713,7 @@ var AecDuplexAudio = class {
         this.triedFallback = true;
         this.noVpio = true;
         this._aec = false;
-        log16.warn("mic-aec: VPIO delivered no audio in 2.5s \u2014 falling back to non-VPIO capture (no AEC \u2192 half-duplex, no barge-in)");
+        log17.warn("mic-aec: VPIO delivered no audio in 2.5s \u2014 falling back to non-VPIO capture (no AEC \u2192 half-duplex, no barge-in)");
         this.onDegrade?.();
         this.killProc();
         this.spawnHelper();
@@ -7607,6 +7821,10 @@ var VoiceIOOptions = class extends VoiceEngineOptions {
   sonioxApiKey = process.env.SONIOX_API_KEY ?? "";
   cartesiaApiKey = process.env.CARTESIA_API_KEY ?? "";
   cartesiaVoiceId = process.env.CARTESIA_VOICE_ID ?? "";
+  emotions = process.env.VOICE_EMOTIONS !== "0";
+  // Cartesia inline emotion tags (sonic-3)
+  showEmotions = process.env.VOICE_SHOW_EMOTIONS === "1";
+  // surface the tags in the on-screen echo (debug; opt-in)
 };
 var VoiceIO = class extends VoiceEngine {
   duplexSource;
@@ -7750,7 +7968,7 @@ async function loadConfig(cwd) {
 
 // cli/hooks-config.ts
 import { spawnSync as spawnSync3 } from "child_process";
-var log17 = forComponent("hooks");
+var log18 = forComponent("hooks");
 var escapeRegex = (s) => s.replace(/[.+^${}()|[\]\\]/g, "\\$&");
 function ruleMatches(rule, toolName) {
   if (!rule.tool || rule.tool === "*") return true;
@@ -7767,7 +7985,7 @@ function runCmd(rule, env) {
     });
     return { code: r.status ?? 1, out: ((r.stdout ?? "") + (r.stderr ?? "")).trim() };
   } catch (e) {
-    log17.debug(`hook command failed: ${rule.command}`, e);
+    log18.debug(`hook command failed: ${rule.command}`, e);
     return { code: 1, out: String(e?.message ?? e) };
   }
 }
@@ -7874,7 +8092,7 @@ function formatDiff(ops, opts = {}) {
 import { existsSync as existsSync6, mkdirSync as mkdirSync6, readFileSync as readFileSync6, writeFileSync as writeFileSync4, readdirSync, renameSync, symlinkSync as symlinkSync2, unlinkSync, readlinkSync } from "fs";
 import { homedir as homedir5 } from "os";
 import { join as join8 } from "path";
-var log18 = forComponent("session");
+var log19 = forComponent("session");
 var globalDir = () => join8(homedir5(), ".agent", "sessions");
 var SessionStore = class {
   dir;
@@ -7919,7 +8137,7 @@ var SessionStore = class {
   }
   load(id) {
     if (!this.safeId(id)) {
-      log18.debug(`rejecting unsafe session id: ${id}`);
+      log19.debug(`rejecting unsafe session id: ${id}`);
       return void 0;
     }
     const path = join8(this.dir, `${id}.json`);
@@ -7927,7 +8145,7 @@ var SessionStore = class {
     try {
       return JSON.parse(readFileSync6(path, "utf8"));
     } catch (e) {
-      log18.debug(`unreadable session ${id} \u2014 ignoring`, e);
+      log19.debug(`unreadable session ${id} \u2014 ignoring`, e);
       return void 0;
     }
   }
@@ -7940,7 +8158,7 @@ var SessionStore = class {
       try {
         metas.push(JSON.parse(readFileSync6(join8(this.dir, f), "utf8")).meta);
       } catch (e) {
-        log18.debug(`skipping unreadable session file ${f}`, e);
+        log19.debug(`skipping unreadable session file ${f}`, e);
       }
     }
     return metas.sort((a, b) => b.updated - a.updated);
@@ -8108,7 +8326,7 @@ import { execFile as execFile3 } from "child_process";
 import { promisify } from "util";
 import { writeFileSync as writeFileSync5, mkdirSync as mkdirSync7 } from "fs";
 import { join as join9, resolve as resolve2, sep as sep2 } from "path";
-var log19 = forComponent("checkpoints");
+var log20 = forComponent("checkpoints");
 var exec = promisify(execFile3);
 var DEFAULT_EXCLUDE = [".agent/", ".git/", "node_modules/", "dist/", "build/", ".next/", "target/", ".venv/", "__pycache__/", "*.log"];
 var ShadowRepo = class {
@@ -8146,7 +8364,7 @@ var ShadowRepo = class {
       writeFileSync5(join9(this.gitDir, "info", "exclude"), this.exclude.join("\n") + "\n");
       this.ready = true;
     } catch (e) {
-      log19.debug(`git checkpoints unavailable for ${this.workTree}`, e);
+      log20.debug(`git checkpoints unavailable for ${this.workTree}`, e);
       this.ready = false;
     }
     return this.ready;
@@ -8157,7 +8375,7 @@ var ShadowRepo = class {
   }
   async commit(label, forced = []) {
     await this.run("add", "-A");
-    for (const p of forced) await this.run("add", "-f", "--", p).catch((e) => log19.debug(`force-add failed: ${p}`, e));
+    for (const p of forced) await this.run("add", "-f", "--", p).catch((e) => log20.debug(`force-add failed: ${p}`, e));
     await this.run("commit", "--allow-empty", "-q", "-m", label);
   }
   /** Inject the CURRENT (pre-edit) content of `paths` into the turn-open restore point by amending it.
@@ -8165,8 +8383,8 @@ var ShadowRepo = class {
    *  turn-boundary `add -A` would never have captured it. Amend (vs a new commit) keeps one restore
    *  point per turn, so the REPL's turn↔frame mapping stays intact. */
   async amendForced(paths) {
-    for (const p of paths) await this.run("add", "-f", "--", p).catch((e) => log19.debug(`force-capture failed: ${p}`, e));
-    await this.run("commit", "--amend", "--no-edit", "-q", "--allow-empty").catch((e) => log19.debug("amend failed", e));
+    for (const p of paths) await this.run("add", "-f", "--", p).catch((e) => log20.debug(`force-capture failed: ${p}`, e));
+    await this.run("commit", "--amend", "--no-edit", "-q", "--allow-empty").catch((e) => log20.debug("amend failed", e));
   }
   /** Commits on `ref`, oldest-first (canonical index space). */
   async log(ref) {
@@ -8226,7 +8444,7 @@ var ShadowRepo = class {
       await this.run("gc", "--auto", "-q").catch(() => {
       });
     } catch (e) {
-      log19.debug("checkpoint prune failed", e);
+      log20.debug("checkpoint prune failed", e);
     }
   }
 };
@@ -8285,7 +8503,7 @@ var GitCheckpoints = class {
   use(sessionId) {
     if (sessionId === this.session) return;
     this.session = sessionId;
-    if (this.started) for (const r of this.repos) void r.point(this.ref()).catch((e) => log19.debug("re-point failed", e));
+    if (this.started) for (const r of this.repos) void r.point(this.ref()).catch((e) => log20.debug("re-point failed", e));
   }
   async begin(label) {
     if (!await this.start()) return;
@@ -8297,7 +8515,7 @@ var GitCheckpoints = class {
       try {
         await this.repos[i].commit(msg, forced);
       } catch (e) {
-        log19.debug("checkpoint commit failed", e);
+        log20.debug("checkpoint commit failed", e);
       }
     }
     if (slow) clearTimeout(slow);
@@ -8327,7 +8545,7 @@ var GitCheckpoints = class {
           if (this.forced.has(abs)) continue;
           this.forced.add(abs);
           const i = this.repoIndexFor(abs);
-          if (i >= 0) await this.repos[i].amendForced([abs]).catch((e) => log19.debug("amendForced failed", e));
+          if (i >= 0) await this.repos[i].amendForced([abs]).catch((e) => log20.debug("amendForced failed", e));
         }
       }
     };
@@ -10033,7 +10251,7 @@ import { spawnSync as spawnSync5 } from "child_process";
 import { writeFileSync as writeFileSync8, mkdirSync as mkdirSync9, readdirSync as readdirSync2, unlinkSync as unlinkSync3, chmodSync, existsSync as existsSync7 } from "fs";
 import { homedir as homedir7 } from "os";
 import { join as join12 } from "path";
-var log20 = forComponent("os-sched");
+var log21 = forComponent("os-sched");
 var OsScheduler = class {
   options;
   constructor(options) {
@@ -10095,7 +10313,7 @@ var OsScheduler = class {
         }
       }
     } catch (e) {
-      log20.debug(`cancel ${id}`, e);
+      log21.debug(`cancel ${id}`, e);
     }
     for (const f of [`${id}.json`, `${id}.sh`]) {
       try {
@@ -10212,7 +10430,7 @@ import { spawn as spawn3 } from "child_process";
 import { existsSync as existsSync8, mkdirSync as mkdirSync10, unlinkSync as unlinkSync4, readdirSync as readdirSync3 } from "fs";
 import { homedir as homedir8 } from "os";
 import { join as join13 } from "path";
-var log21 = forComponent("remote-trigger");
+var log22 = forComponent("remote-trigger");
 var TRIGGER_DIR = () => join13(homedir8(), ".agent", "triggers");
 var sockPath = (sessionId, dir = TRIGGER_DIR()) => join13(dir, `${sessionId}.sock`);
 var TriggerServer = class {
@@ -10250,13 +10468,13 @@ var TriggerServer = class {
             conn.end(JSON.stringify({ ok: false, error: String(e) }) + "\n");
           }
         });
-        conn.on("error", (e) => log21.debug("trigger conn error", e));
+        conn.on("error", (e) => log22.debug("trigger conn error", e));
       });
-      this.server.on("error", (e) => log21.debug("trigger server error", e));
+      this.server.on("error", (e) => log22.debug("trigger server error", e));
       this.server.listen(p);
       this.path = p;
     } catch (e) {
-      log21.debug("trigger server unavailable", e);
+      log22.debug("trigger server unavailable", e);
     }
   }
   /** Re-bind on /resume (the session id changed). */
@@ -10377,7 +10595,7 @@ var italic = C("3");
 var strike = C("9");
 var link = (text, url) => useColor ? `\x1B]8;;${url}\x1B\\${cyan(text)}\x1B]8;;\x1B\\` : `${text} (${url})`;
 var err = (s) => process.stderr.write(s);
-var log22 = forComponent("cli");
+var log23 = forComponent("cli");
 var VERSION = (() => {
   try {
     return JSON.parse(readFileSync8(new URL("../package.json", import.meta.url), "utf8")).version ?? "?";
@@ -11016,7 +11234,7 @@ function costOf(pricing, promptTokens = 0, completionTokens = 0, cacheCreationTo
 function turnCost(model, usage) {
   return costOf(getModelInfo(model)?.pricing, usage?.promptTokens ?? 0, usage?.completionTokens ?? 0, usage?.cacheCreationTokens ?? 0, usage?.cacheReadTokens ?? 0, model);
 }
-async function evaluateGoal(ai, condition, transcript, log23) {
+async function evaluateGoal(ai, condition, transcript, log24) {
   const recent = transcript.filter((m) => m.role === "assistant").slice(-8).map((m) => {
     const text = typeof m.content === "string" ? m.content : m.content.filter((p) => p.type === "text").map((p) => p.text).join(" ");
     return text.slice(0, 600);
@@ -11036,7 +11254,7 @@ ${recent}` }
     const match = r.content.match(/\{[\s\S]*\}/);
     if (match) return JSON.parse(match[0]);
   } catch (e) {
-    log23(dim(`  (goal evaluator error: ${e?.message ?? e})
+    log24(dim(`  (goal evaluator error: ${e?.message ?? e})
 `));
   }
   return { met: false, reason: "evaluation unclear" };
@@ -11248,7 +11466,7 @@ function mcpAgentTools(mounted, opts) {
   return tools;
 }
 async function closeMcp(mounted) {
-  await Promise.all(mounted.map((m) => m.client.close().catch((e) => log22.debug("mcp close failed", e))));
+  await Promise.all(mounted.map((m) => m.client.close().catch((e) => log23.debug("mcp close failed", e))));
 }
 var IMG_EXT = { ".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".gif": "image/gif", ".webp": "image/webp" };
 function mentionRefs(line) {
@@ -11298,7 +11516,7 @@ async function expandMentions(fs, line) {
     if (loaded.includes(ref) || missing.includes(ref)) continue;
     if (ref.includes(":") && mcpMentionResolver) {
       const body = await mcpMentionResolver(ref).catch((e) => {
-        log22.debug("mcp mention resolve failed", e);
+        log23.debug("mcp mention resolve failed", e);
         return null;
       });
       if (body != null) {
@@ -11381,7 +11599,7 @@ async function runTurn(agent, store, session, task, cp, cwd = process.cwd(), sen
       try {
         store.save(session);
       } catch (ex) {
-        log22.debug("mid-turn session flush failed", ex);
+        log23.debug("mid-turn session flush failed", ex);
       }
     }
     return origNotify(e);
@@ -11528,14 +11746,14 @@ var isCancelTeardown = (e) => {
 function installCancelGuards(mounted) {
   process.on("unhandledRejection", (e) => {
     if (isCancelTeardown(e)) {
-      log22.debug("suppressed unhandledRejection (cursor stream cancel)", e);
+      log23.debug("suppressed unhandledRejection (cursor stream cancel)", e);
       return;
     }
-    log22.error("unhandledRejection", e);
+    log23.error("unhandledRejection", e);
   });
   process.on("uncaughtException", (e) => {
     if (isCancelTeardown(e)) {
-      log22.debug("suppressed uncaughtException (cursor stream cancel)", e);
+      log23.debug("suppressed uncaughtException (cursor stream cancel)", e);
       return;
     }
     console.error(e);
@@ -11595,6 +11813,8 @@ async function repl(args, ai, cfg, cwd) {
   let dx;
   let voiceIO;
   let voiceLineOpen = false;
+  const emotionsOn = process.env.VOICE_EMOTIONS !== "0";
+  let showEmotions = process.env.VOICE_SHOW_EMOTIONS === "1";
   const voiceEcho = (text) => {
     const s = forSpeech(text);
     if (!s) return;
@@ -11669,7 +11889,7 @@ async function repl(args, ai, cfg, cwd) {
             spinner.stop();
             voiceIO.enqueueUtterance(e.message);
             editorRef?.suspend();
-            voiceEcho(e.message);
+            voiceEcho(emotionsOn ? renderEmotions(e.message, { show: showEmotions }).display : e.message);
             voiceEchoEnd();
             editorRef?.resume();
             editorRef?.redrawNow();
@@ -11683,9 +11903,9 @@ async function repl(args, ai, cfg, cwd) {
         }
         if (e.kind === "text_delta" && voiceIO) {
           spinner.stop();
-          voiceIO.speakDelta(e.message);
+          const echo = voiceIO.speakDelta(e.message);
           editorRef?.suspend();
-          voiceEcho(e.message);
+          voiceEcho(echo);
           return;
         } else if (e.kind === "text_delta" && stashText()) {
           process.stdout.write("\r\x1B[K");
@@ -11759,8 +11979,8 @@ async function repl(args, ai, cfg, cwd) {
       providerOptionsFor: (m) => cursorProviderOptions(m, cwd, cfg.mcpServers),
       ...(args.thinkModel ?? cfg.thinkModel) !== void 0 ? { thinkModel: (args.thinkModel ?? cfg.thinkModel) === false ? false : resolveModelOrNewest(String(args.thinkModel ?? cfg.thinkModel)) } : {},
       host,
-      ...args.voice ? { voiceStyle: "conversational", progressUpdates: true, askRelay: true } : {},
-      // voice: progress asides + worker questions relayed through the conversation
+      ...args.voice ? { voiceStyle: "conversational", progressUpdates: true, askRelay: true, emotionTags: emotionsOn } : {},
+      // voice: progress asides + worker questions relayed through the conversation; emotion tags taught only with a TTS that speaks them
       // Per-TASK checkpoint frames (the natural undo unit in duplex = one delegation): opened BEFORE
       // the worker spawns (post-spawn would race its first edits). `checkpoints` is bound below.
       onTaskStart: async (_id, label) => {
@@ -12012,7 +12232,7 @@ Added entries are loadable now via the Skill/SlashCommand tools; removed ones ar
       mkdirSync11(join14(cwd, ".agent"), { recursive: true });
       appendFileSync(histPath, line + "\n");
     } catch (e) {
-      log22.debug("history write failed", e);
+      log23.debug("history write failed", e);
     }
   };
   const ago = (t) => {
@@ -12083,7 +12303,7 @@ Added entries are loadable now via the Skill/SlashCommand tools; removed ones ar
       try {
         store.save(session);
       } catch (e) {
-        log22.debug("session save after rewind failed", e);
+        log23.debug("session save after rewind failed", e);
       }
       err(green("  \u27F2 jumped back") + dim(` \u2014 ${face.transcript.length} message(s) kept; edit + resend
 `));
@@ -12117,7 +12337,7 @@ ${task}`;
       bangContext.length = 0;
     }
     const delta = await refreshCatalogs().catch((e) => {
-      log22.debug("catalog refresh failed", e);
+      log23.debug("catalog refresh failed", e);
       return "";
     });
     if (delta) {
@@ -12380,7 +12600,7 @@ ${task}`;
       desc: "rescan skills/commands dirs and rebuild the system prompt (one cache miss) \u2014 picks up entries created mid-session",
       run: async () => {
         await refreshCatalogs().catch((e) => {
-          log22.debug("catalog refresh failed", e);
+          log23.debug("catalog refresh failed", e);
         });
         face.reprepare();
         err(green(`  \u2713 reloaded \u2014 ${skills.length} skill(s), ${cmds.length} command(s); system prompt rebuilds on next message
@@ -12450,6 +12670,24 @@ ${task}`;
         }
         await toggleVoice();
       }
+    }, "voice-emotions": {
+      desc: "show/hide the [emotion] debug tags in the echo \u2014 /voice-emotions <on|off> (TTS emotion control stays on regardless)",
+      run: async (a) => {
+        if (!emotionsOn) {
+          err(dim("  (emotion control is off \u2014 VOICE_EMOTIONS=0)\n"));
+          return;
+        }
+        const v = a[0]?.toLowerCase();
+        if (v === "on" || v === "off") {
+          showEmotions = v === "on";
+          voiceIO?.setShowEmotions(showEmotions);
+          err(green(`  \u2713 emotion tags ${showEmotions ? "shown" : "hidden"} in echo
+`));
+          return;
+        }
+        err(dim(`  emotion tags in echo: ${showEmotions ? "shown" : "hidden"} (use /voice-emotions on|off)
+`));
+      }
     }, "voice-model": {
       desc: "switch the reflex (voice) model \u2014 /voice-model <id>, or alone for a picker",
       run: async (a) => {
@@ -12842,7 +13080,7 @@ ${task}`;
           try {
             for (const def of (await loadAgents(fs2, d)).agents) if (!seen.has(def.name)) seen.set(def.name, { def, from: d });
           } catch (e) {
-            log22.debug(`loadAgents(${d}) failed`, e);
+            log23.debug(`loadAgents(${d}) failed`, e);
           }
         }
         if (!seen.size) {
@@ -12930,7 +13168,7 @@ ${task}`;
           }
           if (idx >= 0) {
             const old = mounted.splice(idx, 1)[0];
-            await old.client.close().catch((e) => log22.debug("mcp close failed", e));
+            await old.client.close().catch((e) => log23.debug("mcp close failed", e));
           }
           try {
             const m = await mountMcpServer(name, conf);
@@ -12958,7 +13196,7 @@ ${task}`;
           }
           const m = mounted.splice(idx, 1)[0];
           remountMcpTools();
-          await m.client.close().catch((e) => log22.debug("mcp close failed", e));
+          await m.client.close().catch((e) => log23.debug("mcp close failed", e));
           err(dim(`  removed "${name}"
 `));
           return;
@@ -13178,7 +13416,7 @@ ${task}`;
     try {
       return readdirSync4(join14(cwd, absDir.replace(/^\/+/, "")), { withFileTypes: true }).map((d) => ({ name: d.name, dir: d.isDirectory() }));
     } catch (e) {
-      log22.debug("completion readdir failed", absDir, e);
+      log23.debug("completion readdir failed", absDir, e);
       return null;
     }
   };
@@ -13305,7 +13543,7 @@ ${out}
         return;
       }
       await refreshCatalogs().catch((e) => {
-        log22.debug("catalog refresh failed", e);
+        log23.debug("catalog refresh failed", e);
       });
       const sk = skills.find((x) => x.name === name);
       if (sk) {
@@ -13348,6 +13586,9 @@ ${out}
     const fakeVoice = process.env.AGENTX_VOICE_FAKE ? fakeVoiceParts(process.env.AGENTX_VOICE_FAKE) : null;
     voiceIO = new VoiceIO({
       ...fakeVoice ?? {},
+      emotions: emotionsOn,
+      showEmotions,
+      // local is authoritative (a /voice-emotions before mic-on still applies)
       // No ack phrase by default: a fixed "Mm-hm," every turn reads robotic, Haiku's TTFT doesn't
       // need masking (~0.7-1.2s full turns), and the conversational register already opens with a
       // natural reaction. The mechanism (+ echo-leak guard) stays for slower voice models.