@livx.cc/agentx 0.99.95 → 0.99.96

package/dist/cli.js

@@ -13445,6 +13445,11 @@ function bindSecondChannel(v, sc, live) {
     sc.onBargeIn();
     onBargeIn(phase);
   };
+  const speakDelta = v.speakDelta.bind(v);
+  v.speakDelta = ((t, ...rest) => {
+    if (live()) sc.noteReply(t);
+    return speakDelta(t, ...rest);
+  });
   Object.assign(sc.options, {
     aec: v.usingAec,
     speak: (text, kind) => {
@@ -13657,6 +13662,9 @@ var JsonlDiagSink = class {
 // src/voice/secondChannel.ts
 init_logging();
 
+// src/voice/backchannelPlan.ts
+init_logging();
+
 // src/voice/channelLang.ts
 init_logging();
 import { mkdir, readFile, writeFile } from "fs/promises";
@@ -13891,8 +13899,79 @@ var ChannelBanks = class {
   }
 };
 
+// src/voice/backchannelPlan.ts
+var log30 = forComponent("BackchannelPlan");
+var TURN_TYPES = ["story", "list", "complaint", "explanation", "short_command", "question", "other"];
+var DENSITIES = ["none", "low", "normal", "high"];
+var silentTurn = (p) => p.density === "none" || p.turn === "short_command" || p.turn === "question";
+var cueWords = (s) => s.toLowerCase().replace(/[^\p{L}\p{N}'\s]+/gu, " ").split(/\s+/).filter(Boolean);
+function parsePlan(raw, lang, maxCues = 8) {
+  const m = raw.match(/\{[\s\S]*\}/);
+  if (!m) return null;
+  let o;
+  try {
+    o = JSON.parse(m[0]);
+  } catch {
+    return null;
+  }
+  const turn = String(o?.turn ?? "").toLowerCase().replace(/[\s-]+/g, "_");
+  const density = String(o?.density ?? "").toLowerCase();
+  if (!TURN_TYPES.includes(turn) || !DENSITIES.includes(density)) return null;
+  const cues = [];
+  for (const c of Array.isArray(o.cues) ? o.cues : []) {
+    const when = (Array.isArray(c?.when) ? c.when : [c?.when]).filter((w) => typeof w === "string").map((w) => cueWords(w).join(" ")).filter((w) => w && w.split(" ").length <= 4);
+    const line = typeof c?.line === "string" ? cleanLine(c.line, lang, 4) : "";
+    if (when.length && line) cues.push({ when: [...new Set(when)], line });
+    if (cues.length >= maxCues) break;
+  }
+  return { turn, density, cues };
+}
+function matchCue(plan, heard, from = 0) {
+  if (!plan || silentTurn(plan)) return null;
+  const w = cueWords(heard);
+  for (let i = Math.max(0, from); i < w.length; i++) {
+    for (const c of plan.cues) {
+      for (const p of c.when) {
+        const pw = p.split(" ");
+        if (i + pw.length <= w.length && pw.every((x, j) => w[i + j] === x)) return c;
+      }
+    }
+  }
+  return null;
+}
+var BackchannelPlannerOptions = class {
+  /** Fast model (Groq gpt-oss / the reflex). */
+  model = "groq/openai/gpt-oss-120b";
+  maxTokens = 900;
+};
+var BackchannelPlanner = class {
+  constructor(ai, options) {
+    this.ai = ai;
+    this.options = options;
+    this.options = { ...new BackchannelPlannerOptions(), ...options };
+  }
+  ai;
+  options;
+  async plan(c, signal) {
+    const o = this.options;
+    const name = languageName(c.lang);
+    const prompt = `You plan a live voice assistant's LISTENER sounds ("mm-hm", "right", "oh no") for the user's ${c.heard ? "CURRENT" : "NEXT"} spoken turn.
+Assistant just said: "${c.agent.slice(-400)}"
+` + (c.user ? `User's previous turn ended: "${c.user.slice(-200)}"
+` : "") + (c.heard ? `User so far in this turn: "${c.heard.slice(-300)}"
+` : "") + `Predict the turn: turn = story | list | complaint | explanation | short_command | question | other; density = none (short request or a question: never interrupt) | low | normal | high (a long story wants frequent cues).
+cues: 3-8 short words/phrases the user is likely to say at a clause boundary where a listener cue fits (list markers like "first", "and then", "also"; narrative markers; emotional words; names/topics from the context), each with ONE fitting listener line of 1-3 words in ${name} that reacts to it (sympathy for bad news, "okay" for a list step) \u2014 never a question, never an answer.
+Reply JSON only: {"turn":"...","density":"...","cues":[{"when":["phrase",...],"line":"..."}]}. Phrases in the user's language.`;
+    const reasoning = /gpt-oss/.test(o.model) ? { providerOptions: { reasoning_effort: "low" } } : {};
+    const r = await this.ai.chat({ model: o.model, messages: [{ role: "user", content: prompt }], stream: false, signal, maxTokens: o.maxTokens, ...reasoning });
+    const p = parsePlan(r.content ?? "", c.lang);
+    if (!p) log30.debug(`unusable plan: ${(r.content ?? "").slice(0, 120)}`);
+    return p;
+  }
+};
+
 // src/voice/secondChannel.ts
-var log30 = forComponent("SecondChannel");
+var log31 = forComponent("SecondChannel");
 var SecondChannelOptions = class {
   /** Refiner (Jev/fast LLM): the choice over CHANNEL_ACTIONS, or null on failure. Absent → the rule alone decides. */
   decide;
@@ -13941,6 +14020,23 @@ var SecondChannelOptions = class {
   fillerPauseMs = 700;
   fillerMinWords = 4;
   bridgeMinWords = 5;
+  /** ANTICIPATE (backchannelPlan.ts): plan the user's next turn off the hot path (after the agent's reply / at turn start,
+   *  revised once at `reviseAtWords`); live, a backchannel fires only on a planned cue, at a `cuePauseMs` breath, with the
+   *  cue's line and no decider call. A silent plan (short command / question / density none) vetoes backchannels. No plan
+   *  yet / failed / late → the reactive path. Off by default (AGENTX_CHANNEL_ANTICIPATE=1). */
+  anticipate = false;
+  plan;
+  planBudgetMs = 4e3;
+  reviseAtWords = 7;
+  /** A predicted moment needs only a short breath (the decision is already made). */
+  cuePauseMs = 200;
+  /** A cue counts only within the last N words (older matches were gated or passed). */
+  cueWindow = 6;
+  /** true: a plan fires on its cues only. false: a non-silent plan with density normal/high also lets the reactive breath
+   *  backchannel through (the plan then only vetoes short commands / questions / low density). */
+  cueOnly = true;
+  onPlan = () => {
+  };
   now = () => performance.now();
   random = Math.random;
 };
@@ -13949,12 +14045,12 @@ function withBudget(p, ms, what) {
   let t;
   const late = new Promise((r) => {
     t = setTimeout(() => {
-      log30.debug(`${what}: over the ${ms}ms budget \u2014 dropped`);
+      log31.debug(`${what}: over the ${ms}ms budget \u2014 dropped`);
       r(null);
     }, ms);
   });
   return Promise.race([p.catch((e) => {
-    log30.warn(`${what} failed \u2014 falling back: ${e?.message ?? e}`);
+    log31.warn(`${what} failed \u2014 falling back: ${e?.message ?? e}`);
     return null;
   }), late]).finally(() => clearTimeout(t));
 }
@@ -13991,6 +14087,18 @@ var SecondChannel = class {
   startedAt;
   lang = null;
   pinned = false;
+  // anticipate: the plan for the user's current/next turn (turnNo bumps per dispatched turn → a late plan is dropped)
+  turnNo = 0;
+  plan = null;
+  planning = false;
+  planTries = 0;
+  // per turn: the reply-end plan + one turn-start retry, never a call per interim
+  revised = false;
+  cueFrom = 0;
+  // word index after the last planned backchannel
+  reply = "";
+  // channel-1's text this turn (the plan's context)
+  lastUser = "";
   /** The language lines are spoken in (detected from the user's words, or set by the host). */
   get language() {
     return this.lang;
@@ -14002,7 +14110,7 @@ var SecondChannel = class {
     if (host) this.pinned = true;
     const lang = primaryLang(tag);
     if (!lang || lang === this.lang) return;
-    log30.debug(`language ${this.lang} \u2192 ${lang}`);
+    log31.debug(`language ${this.lang} \u2192 ${lang}`);
     this.lang = lang;
     this.recent = [];
     this.picks.clear();
@@ -14034,11 +14142,21 @@ var SecondChannel = class {
       this.pauseTimer = null;
       this.onPause(this.o.fillerPauseMs);
     }, this.o.fillerPauseMs);
+    let cue = null;
+    if (this.o.anticipate) {
+      const n = words2(t).length;
+      if (!this.plan && !this.planning && this.planTries < 2) this.requestPlan();
+      else if (this.plan && !this.revised && n >= this.o.reviseAtWords) {
+        this.revised = true;
+        this.requestPlan(t);
+      }
+      cue = matchCue(this.plan, t, Math.max(this.cueFrom, n - this.o.cueWindow));
+    }
     if (this.bcTimer) clearTimeout(this.bcTimer);
     this.bcTimer = this.o.aec ? setTimeout(() => {
       this.bcTimer = null;
-      if (this.userSpeaking && this.heard === t) void this.consider("interim", 0, true);
-    }, this.o.backchannelPauseMs) : null;
+      if (this.userSpeaking && this.heard === t) void this.consider("interim", 0, true, cue);
+    }, cue ? this.o.cuePauseMs : this.o.backchannelPauseMs) : null;
     if (words2(t).length - this.decidedAt >= this.o.decideEveryWords) void this.consider("interim");
   }
   /** The user went quiet for `ms` (host VAD/STT pause, or the internal interim timer). */
@@ -14067,9 +14185,17 @@ var SecondChannel = class {
       this.heard = "";
       this.decidedAt = 0;
       this.bridged = false;
+      this.cueFrom = 0;
+      if (this.o.anticipate && this.reply.trim() && !this.plan && !this.planning) this.requestPlan();
       return;
     }
     if (s === "queued") {
+      this.turnNo++;
+      this.plan = null;
+      this.planning = false;
+      this.planTries = 0;
+      this.revised = false;
+      this.reply = "";
       this.gen++;
       this.userSpeaking = false;
       this.bridged = false;
@@ -14088,14 +14214,20 @@ var SecondChannel = class {
   /** The user's final line was dispatched to the main agent (its words are the bridge's micro-context). */
   onUserTurn(text) {
     this.heard = text.trim();
+    this.lastUser = this.heard;
     this.detect(this.heard);
     this.main = "idle";
     this.onAgentState("queued");
   }
   /** The main answer's streamed text (before its audio): channel-1 is responding — no bridge from here on. */
   onMainTokens(text) {
+    this.noteReply(text);
     if (text.trim() && (this.main === "queued" || this.main === "thinking")) this.onAgentState("streaming_text");
   }
+  /** Channel-1's reply text (a delta) — only the plan's context; no state change (hosts without onMainTokens). */
+  noteReply(text) {
+    this.reply += text;
+  }
   /** The user barged in: cut the in-flight line now and drop every pending decision. */
   onBargeIn() {
     this.gen++;
@@ -14105,7 +14237,7 @@ var SecondChannel = class {
       try {
         this.o.cancel();
       } catch (e) {
-        log30.warn(`cancel threw: ${e.message}`);
+        log31.warn(`cancel threw: ${e.message}`);
       }
     }
   }
@@ -14134,13 +14266,31 @@ var SecondChannel = class {
     return (this.main === "queued" || this.main === "thinking") && !this.bridged;
   }
   /** 0ms rule: the candidate line for this trigger, or silence. */
-  rule(trigger, pauseMs = 0, breath = false) {
+  rule(trigger, pauseMs = 0, breath = false, cue = null) {
     const w = words2(this.heard);
     if (!this.lang) return "silence";
     if (w.length <= 3 || w.length <= 6 && isPhatic(this.heard, this.bank)) return "silence";
-    const k = trigger === "interim" ? this.backchannelMoment(w.length, breath) ? "backchannel" : null : trigger === "pause" ? pauseMs >= this.o.fillerPauseMs && w.length >= this.o.fillerMinWords ? "filler" : null : w.length >= this.o.bridgeMinWords ? "bridge" : null;
+    const k = trigger === "interim" ? this.backchannelMoment(w.length, breath) && (!this.o.anticipate || !this.plan || !silentTurn(this.plan) && (!!cue || !this.o.cueOnly && this.plan.density !== "low")) ? "backchannel" : null : trigger === "pause" ? pauseMs >= this.o.fillerPauseMs && w.length >= this.o.fillerMinWords ? "filler" : null : w.length >= this.o.bridgeMinWords ? "bridge" : null;
     return k && this.allowed(k) ? k : "silence";
   }
+  /** Plan (or, with `heard`, revise) the backchannels of the user's turn — async, never on the hot path. */
+  requestPlan(heard) {
+    if (!this.o.plan || !this.lang) return;
+    const turn = this.turnNo, t0 = this.o.now(), ac = new AbortController();
+    if (!heard) {
+      this.planning = true;
+      this.planTries++;
+    }
+    const ctx = { agent: this.reply.trim(), user: words2(this.lastUser).slice(-30).join(" "), recent: [...this.recent], lang: this.lang, heard };
+    void withBudget(this.o.plan(ctx, ac.signal), this.o.planBudgetMs, heard ? "plan revision" : "plan").then((p) => {
+      if (p === null) ac.abort();
+      if (turn !== this.turnNo) return;
+      if (!heard) this.planning = false;
+      if (!p) return;
+      this.plan = p;
+      this.o.onPlan(p, !!heard, Math.round(this.o.now() - t0));
+    });
+  }
   /** A clause boundary mid-floor: a breath or a comma-like close. Not a question (it wants the answer, not "mm-hm"), and a
    *  sentence end only deep into a story — a short request's end is the end of their turn (replay: "mm-hm" right after
    *  "Check hacker news for recent news.", just before the final). */
@@ -14149,33 +14299,36 @@ var SecondChannel = class {
     if (/[.!]$/.test(this.heard)) return n >= 2 * this.o.backchannelMinWords;
     return breath || /[,;:…]$/.test(this.heard);
   }
-  async consider(trigger, pauseMs, breath = false) {
+  async consider(trigger, pauseMs, breath = false, cue = null) {
     if (this.busy) return;
     const n0 = words2(this.heard).length;
     this.decidedAt = n0;
-    const rule = this.rule(trigger, pauseMs, breath);
+    if (!(this.o.anticipate && this.plan && trigger === "interim")) cue = null;
+    const rule = this.rule(trigger, pauseMs, breath, cue);
     if (rule === "silence") return;
     this.busy = true;
     const gen = this.gen, t0 = this.o.now();
-    const ev = (e) => this.o.onEvent({ trigger, rule, ms: Math.round(this.o.now() - t0), ...e });
+    const ev = (e) => this.o.onEvent({ trigger, rule, ms: Math.round(this.o.now() - t0), ...cue ? { cue: cue.line } : {}, ...e });
     const stale = () => gen !== this.gen || words2(this.heard).length - n0 >= this.o.staleWords;
     try {
       let kind = rule;
       let choice;
-      if (this.o.decide) {
+      if (this.o.decide && !cue) {
         const d = await withBudget(this.o.decide(this.tail(), this.state(pauseMs)), this.o.decisionBudgetMs, "channel decision");
         choice = d?.choice;
         if (choice && choice in CHANNEL_ACTIONS && (choice === "silence" || this.allowed(choice))) kind = choice;
-        else if (choice && choice in CHANNEL_ACTIONS) log30.debug(`decider chose ${choice} for a ${rule} moment \u2014 the rule stands`);
+        else if (choice && choice in CHANNEL_ACTIONS) log31.debug(`decider chose ${choice} for a ${rule} moment \u2014 the rule stands`);
       }
       if (kind === "silence") return ev({ choice, acted: "silence" });
       if (stale()) return ev({ choice, kind, acted: "stale" });
       if (!this.allowed(kind)) return ev({ choice, kind, acted: "gated" });
-      const text = await this.line(kind);
+      const text = cue && !this.recent.some((r) => norm2(r) === norm2(cue.line)) ? cue.line : await this.line(kind);
       if (!text) return ev({ choice, kind, acted: "no_bank" });
       if (stale()) return ev({ choice, kind, text, acted: "stale" });
       if (!this.allowed(kind)) return ev({ choice, kind, text, acted: "gated" });
-      ev({ choice, kind, text, acted: this.say(kind, text) ? "spoken" : "skipped" });
+      const said = this.say(kind, text);
+      if (said && cue) this.cueFrom = words2(this.heard).length;
+      ev({ choice, kind, text, acted: said ? "spoken" : "skipped" });
     } finally {
       this.busy = false;
     }
@@ -14199,7 +14352,7 @@ var SecondChannel = class {
       if (raw === null) ac.abort();
       const text = cleanLine(raw ?? "", this.lang);
       if (text && !this.recent.some((r) => norm2(r) === norm2(text))) return text;
-      if (text) log30.debug(`generated "${text}" repeats a recent line \u2014 canned`);
+      if (text) log31.debug(`generated "${text}" repeats a recent line \u2014 canned`);
     }
     return this.pick(kind);
   }
@@ -14221,7 +14374,7 @@ var SecondChannel = class {
     try {
       r = this.o.speak(text, kind);
     } catch (e) {
-      log30.warn(`speak threw \u2014 line dropped: ${e.message}`);
+      log31.warn(`speak threw \u2014 line dropped: ${e.message}`);
       return false;
     }
     if (r === false) return false;
@@ -14233,7 +14386,7 @@ var SecondChannel = class {
     this.o.show(text, kind);
     const p = Promise.resolve(r).then(() => {
     }, (e) => {
-      log30.warn(`channel line playback failed: ${e?.message ?? e}`);
+      log31.warn(`channel line playback failed: ${e?.message ?? e}`);
     }).finally(() => {
       if (this.inflight === p) this.inflight = null;
     });
@@ -14405,7 +14558,7 @@ function applyOverlay(cfg, file) {
 // cli/hooks-config.ts
 import { spawnSync as spawnSync4 } from "child_process";
 init_platform();
-var log31 = forComponent("hooks");
+var log32 = forComponent("hooks");
 var escapeRegex = (s) => s.replace(/[.+^${}()|[\]\\]/g, "\\$&");
 function ruleMatches(rule, toolName) {
   if (!rule.tool || rule.tool === "*") return true;
@@ -14424,7 +14577,7 @@ function runCmd(rule, env) {
     });
     return { code: r.status ?? 1, out: ((r.stdout ?? "") + (r.stderr ?? "")).trim() };
   } catch (e) {
-    log31.debug(`hook command failed: ${rule.command}`, e);
+    log32.debug(`hook command failed: ${rule.command}`, e);
     return { code: 1, out: String(e?.message ?? e) };
   }
 }
@@ -14532,7 +14685,7 @@ import { existsSync as existsSync6, mkdirSync as mkdirSync8, readFileSync as rea
 import { homedir as homedir6 } from "os";
 import { join as join11 } from "path";
 init_platform();
-var log32 = forComponent("session");
+var log33 = forComponent("session");
 var globalDir = () => join11(homedir6(), ".agent", "sessions");
 function indexLink(target, link2) {
   try {
@@ -14595,7 +14748,7 @@ var SessionStore = class {
   }
   load(id) {
     if (!this.safeId(id)) {
-      log32.debug(`rejecting unsafe session id: ${id}`);
+      log33.debug(`rejecting unsafe session id: ${id}`);
       return void 0;
     }
     const path = join11(this.dir, `${id}.json`);
@@ -14603,7 +14756,7 @@ var SessionStore = class {
     try {
       return JSON.parse(readFileSync8(path, "utf8"));
     } catch (e) {
-      log32.debug(`unreadable session ${id} \u2014 ignoring`, e);
+      log33.debug(`unreadable session ${id} \u2014 ignoring`, e);
       return void 0;
     }
   }
@@ -14616,7 +14769,7 @@ var SessionStore = class {
       try {
         metas.push(JSON.parse(readFileSync8(join11(this.dir, f), "utf8")).meta);
       } catch (e) {
-        log32.debug(`skipping unreadable session file ${f}`, e);
+        log33.debug(`skipping unreadable session file ${f}`, e);
       }
     }
     return metas.sort((a, b) => b.updated - a.updated);
@@ -14855,7 +15008,7 @@ import { promisify } from "util";
 import { writeFileSync as writeFileSync6, mkdirSync as mkdirSync9 } from "fs";
 import { homedir as homedir7 } from "os";
 import { join as join12, resolve as resolve4, sep as sep3, parse as parsePath } from "path";
-var log33 = forComponent("checkpoints");
+var log34 = forComponent("checkpoints");
 var exec = promisify(execFile4);
 var DEFAULT_EXCLUDE = [".agent/", ".git/", "node_modules/", "dist/", "build/", ".next/", "target/", ".venv/", "__pycache__/", "*.log"];
 function isBroadRoot(p) {
@@ -14901,7 +15054,7 @@ var ShadowRepo = class {
       writeFileSync6(join12(this.gitDir, "info", "exclude"), this.exclude.join("\n") + "\n");
       this.ready = true;
     } catch (e) {
-      log33.debug(`git checkpoints unavailable for ${this.workTree}`, e);
+      log34.debug(`git checkpoints unavailable for ${this.workTree}`, e);
       this.ready = false;
     }
     return this.ready;
@@ -14912,7 +15065,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) => log33.debug(`force-add failed: ${p}`, e));
+    for (const p of forced) await this.run("add", "-f", "--", p).catch((e) => log34.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.
@@ -14920,8 +15073,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) => log33.debug(`force-capture failed: ${p}`, e));
-    await this.run("commit", "--amend", "--no-edit", "-q", "--allow-empty").catch((e) => log33.debug("amend failed", e));
+    for (const p of paths) await this.run("add", "-f", "--", p).catch((e) => log34.debug(`force-capture failed: ${p}`, e));
+    await this.run("commit", "--amend", "--no-edit", "-q", "--allow-empty").catch((e) => log34.debug("amend failed", e));
   }
   /** Commits on `ref`, oldest-first (canonical index space). */
   async log(ref) {
@@ -14981,7 +15134,7 @@ var ShadowRepo = class {
       await this.run("gc", "--auto", "-q").catch(() => {
       });
     } catch (e) {
-      log33.debug("checkpoint prune failed", e);
+      log34.debug("checkpoint prune failed", e);
     }
   }
 };
@@ -15049,7 +15202,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) => log33.debug("re-point failed", e));
+    if (this.started) for (const r of this.repos) void r.point(this.ref()).catch((e) => log34.debug("re-point failed", e));
   }
   async begin(label) {
     if (!await this.start()) return;
@@ -15069,7 +15222,7 @@ var GitCheckpoints = class {
           process.stderr.write(`\x1B[2m  checkpoints: '${this.repos[i].root}' too large to snapshot in ${Math.round(this.options.opTimeoutMs / 1e3)}s \u2014 file rewind disabled here\x1B[0m
 `);
         } else {
-          log33.debug("checkpoint commit failed", e);
+          log34.debug("checkpoint commit failed", e);
           survivors.push(this.repos[i]);
           survivorCaches.push(this.caches[i] ?? []);
         }
@@ -15104,7 +15257,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) => log33.debug("amendForced failed", e));
+          if (i >= 0) await this.repos[i].amendForced([abs]).catch((e) => log34.debug("amendForced failed", e));
         }
       }
     };
@@ -16889,7 +17042,7 @@ import { spawnSync as spawnSync6 } from "child_process";
 import { writeFileSync as writeFileSync8, mkdirSync as mkdirSync10, readdirSync as readdirSync2, unlinkSync as unlinkSync3, chmodSync, existsSync as existsSync7 } from "fs";
 import { homedir as homedir8 } from "os";
 import { join as join14 } from "path";
-var log34 = forComponent("os-sched");
+var log35 = forComponent("os-sched");
 var OsScheduler = class {
   options;
   constructor(options) {
@@ -16951,7 +17104,7 @@ var OsScheduler = class {
         }
       }
     } catch (e) {
-      log34.debug(`cancel ${id}`, e);
+      log35.debug(`cancel ${id}`, e);
     }
     for (const f of [`${id}.json`, `${id}.sh`]) {
       try {
@@ -17069,7 +17222,7 @@ import { existsSync as existsSync8, mkdirSync as mkdirSync11, unlinkSync as unli
 import { homedir as homedir9 } from "os";
 import { join as join15 } from "path";
 init_platform();
-var log35 = forComponent("remote-trigger");
+var log36 = forComponent("remote-trigger");
 var TRIGGER_DIR = () => join15(homedir9(), ".agent", "triggers");
 var sockPath = (sessionId, dir = TRIGGER_DIR()) => join15(dir, `${sessionId}.sock`);
 var TriggerServer = class {
@@ -17107,13 +17260,13 @@ var TriggerServer = class {
             conn.end(JSON.stringify({ ok: false, error: String(e) }) + "\n");
           }
         });
-        conn.on("error", (e) => log35.debug("trigger conn error", e));
+        conn.on("error", (e) => log36.debug("trigger conn error", e));
       });
-      this.server.on("error", (e) => log35.debug("trigger server error", e));
+      this.server.on("error", (e) => log36.debug("trigger server error", e));
       this.server.listen(p);
       this.path = p;
     } catch (e) {
-      log35.debug("trigger server unavailable", e);
+      log36.debug("trigger server unavailable", e);
     }
   }
   /** Re-bind on /resume (the session id changed). */
@@ -17245,7 +17398,7 @@ var strike = C("9");
 var link = (text, url) => useColor ? `\x1B]8;;${url}\x1B\\${cyan(text)}\x1B]8;;\x1B\\` : `${text} (${url})`;
 var mdPalette = { bold, dim, cyan, italic, strike, green, link };
 var err = (s) => process.stderr.write(s);
-var log36 = forComponent("cli");
+var log37 = forComponent("cli");
 var VERSION = (() => {
   try {
     return JSON.parse(readFileSync10(new URL("../package.json", import.meta.url), "utf8")).version ?? "?";
@@ -18088,7 +18241,7 @@ function turnCost(model, usage) {
   const priced = model.startsWith("claude-code/") ? `anthropic/${resolveModelAlias(model.slice("claude-code/".length))}` : model;
   return costOf(getModelInfo(priced)?.pricing, usage?.promptTokens ?? 0, usage?.completionTokens ?? 0, usage?.cacheCreationTokens ?? 0, usage?.cacheReadTokens ?? 0, priced);
 }
-async function evaluateGoal(ai, condition, transcript, log37) {
+async function evaluateGoal(ai, condition, transcript, log38) {
   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);
@@ -18108,7 +18261,7 @@ ${recent}` }
     const match = r.content.match(/\{[\s\S]*\}/);
     if (match) return JSON.parse(match[0]);
   } catch (e) {
-    log37(dim(`  (goal evaluator error: ${e?.message ?? e})
+    log38(dim(`  (goal evaluator error: ${e?.message ?? e})
 `));
   }
   return { met: false, reason: "evaluation unclear" };
@@ -18334,7 +18487,7 @@ function mcpAgentTools(mounted, opts) {
   return tools;
 }
 async function closeMcp(mounted) {
-  await Promise.all(mounted.map((m) => m.client.close().catch((e) => log36.debug("mcp close failed", e))));
+  await Promise.all(mounted.map((m) => m.client.close().catch((e) => log37.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) {
@@ -18393,7 +18546,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) => {
-        log36.debug("mcp mention resolve failed", e);
+        log37.debug("mcp mention resolve failed", e);
         return null;
       });
       if (body != null) {
@@ -18484,7 +18637,7 @@ async function runTurn(agent, store, session, task, cp, cwd = process.cwd(), sen
       try {
         store.save(session);
       } catch (ex) {
-        log36.debug("mid-turn session flush failed", ex);
+        log37.debug("mid-turn session flush failed", ex);
       }
     }
     return origNotify(e);
@@ -18648,14 +18801,14 @@ var isCancelTeardown = (e) => {
 function installCancelGuards(mounted) {
   process.on("unhandledRejection", (e) => {
     if (isCancelTeardown(e)) {
-      log36.debug("suppressed unhandledRejection (cursor stream cancel)", e);
+      log37.debug("suppressed unhandledRejection (cursor stream cancel)", e);
       return;
     }
-    log36.error("unhandledRejection", e);
+    log37.error("unhandledRejection", e);
   });
   process.on("uncaughtException", (e) => {
     if (isCancelTeardown(e)) {
-      log36.debug("suppressed uncaughtException (cursor stream cancel)", e);
+      log37.debug("suppressed uncaughtException (cursor stream cancel)", e);
       return;
     }
     console.error(e);
@@ -19082,7 +19235,7 @@ async function repl(args, ai, cfg, cwd) {
     try {
       mkdirSync12(dir, { recursive: true });
     } catch (e) {
-      log36.debug("paste image dir create failed", e);
+      log37.debug("paste image dir create failed", e);
     }
     const img = grabClipboardImage(dir, String(Date.now()));
     return img ? { display: "Image", ref: "@" + img.path, path: img.path } : null;
@@ -19195,7 +19348,7 @@ Added entries are loadable now via the Skill/SlashCommand tools; removed ones ar
       mkdirSync12(join16(cwd, ".agent"), { recursive: true });
       appendFileSync(histPath, line + "\n");
     } catch (e) {
-      log36.debug("history write failed", e);
+      log37.debug("history write failed", e);
     }
   };
   const ago = (t) => {
@@ -19267,7 +19420,7 @@ Added entries are loadable now via the Skill/SlashCommand tools; removed ones ar
       try {
         store.save(session);
       } catch (e) {
-        log36.debug("session save after rewind failed", e);
+        log37.debug("session save after rewind failed", e);
       }
       err(green("  \u27F2 jumped back") + dim(` \u2014 ${face.transcript.length} message(s) kept; edit + resend
 `));
@@ -19302,7 +19455,7 @@ ${task}`;
       bangContext.length = 0;
     }
     const delta = await refreshCatalogs().catch((e) => {
-      log36.debug("catalog refresh failed", e);
+      log37.debug("catalog refresh failed", e);
       return "";
     });
     if (delta) {
@@ -19565,7 +19718,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) => {
-          log36.debug("catalog refresh failed", e);
+          log37.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
@@ -20068,7 +20221,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) {
-            log36.debug(`loadAgents(${d}) failed`, e);
+            log37.debug(`loadAgents(${d}) failed`, e);
           }
         }
         if (!seen.size) {
@@ -20156,7 +20309,7 @@ ${task}`;
           }
           if (idx >= 0) {
             const old = mounted.splice(idx, 1)[0];
-            await old.client.close().catch((e) => log36.debug("mcp close failed", e));
+            await old.client.close().catch((e) => log37.debug("mcp close failed", e));
           }
           try {
             const m = await mountMcpServer(name, conf);
@@ -20184,7 +20337,7 @@ ${task}`;
           }
           const m = mounted.splice(idx, 1)[0];
           remountMcpTools();
-          await m.client.close().catch((e) => log36.debug("mcp close failed", e));
+          await m.client.close().catch((e) => log37.debug("mcp close failed", e));
           err(dim(`  removed "${name}"
 `));
           return;
@@ -20387,7 +20540,7 @@ ${task}`;
     try {
       return readdirSync4(join16(cwd, absDir.replace(/^\/+/, "")), { withFileTypes: true }).map((d) => ({ name: d.name, dir: d.isDirectory() }));
     } catch (e) {
-      log36.debug("completion readdir failed", absDir, e);
+      log37.debug("completion readdir failed", absDir, e);
       return null;
     }
   };
@@ -20524,7 +20677,7 @@ ${out}
         return;
       }
       await refreshCatalogs().catch((e) => {
-        log36.debug("catalog refresh failed", e);
+        log37.debug("catalog refresh failed", e);
       });
       const sk = skills.find((x) => x.name === name);
       if (sk) {
@@ -20642,7 +20795,7 @@ ${out}
         if (delivery || cut) dx?.parkCutDelivery(delivery, !!cut, heard);
         const cutReply = cut && cut.full.length - cut.heard.length > 40 ? cut : null;
         const noteP = replaces ? replaces.note : !cutReply ? Promise.resolve("") : (instinct ? instinct.bargeIntent(text).catch((e) => {
-          log36.warn(`barge intent failed \u2014 model decides: ${e.message}`);
+          log37.warn(`barge intent failed \u2014 model decides: ${e.message}`);
           return void 0;
         }) : Promise.resolve(void 0)).then(async (intent) => interruptionNote(cutReply, intent) + ackedNote(await instinct?.ackFor(text)));
         const cutIn = replaces ? replaces.cutIn : interjectNote;
@@ -21004,12 +21157,15 @@ function makeSecondChannel(ai, reflexModel, opts) {
   const decider = leakDecider();
   const instinct = decider ? new Instinct({ decider }) : void 0;
   const model = process.env.AGENTX_CHANNEL_MODEL || reflexModel;
+  const planner = new BackchannelPlanner(ai, { model });
   return new SecondChannel({
     // Banks in the user's language: generated once per language, cached + topped up across sessions (~/.agent/cache).
     banks: new ChannelBanks({ generate: fastBankGenerator(ai, model), cacheDir: join16(homedir10(), ".agent", "cache", "channel-banks") }),
     decide: instinct ? (heard, state) => instinct.channel(heard, state) : void 0,
     generate: fastLineGenerator(ai, model),
-    onEvent: (e) => log36.debug(`channel ${e.trigger}: rule=${e.rule} choice=${e.choice ?? "-"} \u2192 ${e.acted}${e.text ? ` "${e.text}"` : ""} ${e.ms}ms`),
+    // Anticipated backchannels (off until the offline replay proves them — tests/voice-bc-anticipate-eval.ts)
+    ...process.env.AGENTX_CHANNEL_ANTICIPATE === "1" ? { anticipate: true, plan: (c, s) => planner.plan(c, s) } : {},
+    onEvent: (e) => log37.debug(`channel ${e.trigger}: rule=${e.rule} choice=${e.choice ?? "-"} \u2192 ${e.acted}${e.text ? ` "${e.text}"` : ""}${e.cue ? " (planned cue)" : ""} ${e.ms}ms`),
     ...opts
   });
 }
@@ -21071,7 +21227,7 @@ async function duplexServe(args, ai, cfg, cwd) {
     try {
       store.save(session);
     } catch (e) {
-      log36.warn("duplex session save failed", e);
+      log37.warn("duplex session save failed", e);
     }
   };
   out({ type: "ready", sessionId: session.meta.id, reflexModel: dx.options.reflexModel, actModel: dx.options.actModel, ...notes.length ? { notes } : {} });
@@ -21109,7 +21265,7 @@ async function duplexServe(args, ai, cfg, cwd) {
           done2();
           out({ type: "turn_done", id, finishReason: res?.finishReason ?? "error", ...why ? { error: why } : {} });
         }).catch((e) => {
-          log36.error("duplex turn failed", e);
+          log37.error("duplex turn failed", e);
           done2();
           out({ type: "turn_done", id, finishReason: "error", error: String(e?.message ?? e) });
         });