agent.libx.js 0.93.11 → 0.93.12

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { a as AgentOptions, H as Hooks, h as RunResult, A as Agent } from './Agent-Di1u5nH0.js';
-export { C as ChatFragment, D as DEFAULT_MUTATING, b as Decision, P as PermissionOptions, c as PermissionPolicy, d as PermissionRule, e as PreToolUseDecision, R as ReasoningEffort, f as RecordingHooks, g as RecordingLifecycle, T as ToolUse, i as ToolUseMeta, j as composeHooks, p as planMode, r as reasoningToChatFragment } from './Agent-Di1u5nH0.js';
+import { a as AgentOptions, H as Hooks, h as RunResult, A as Agent } from './Agent-kWrJvtZM.js';
+export { C as ChatFragment, D as DEFAULT_MUTATING, b as Decision, P as PermissionOptions, c as PermissionPolicy, d as PermissionRule, e as PreToolUseDecision, R as ReasoningEffort, f as RecordingHooks, g as RecordingLifecycle, T as ToolUse, i as ToolUseMeta, j as composeHooks, p as planMode, r as reasoningToChatFragment } from './Agent-kWrJvtZM.js';
 import { IFilesystem, FileMetadata } from '@livx.cc/wcli/core';
 export { CommandExecutor, FileMetadata, IFilesystem, IndexedDbFilesystem, MemFilesystem, registerHeadlessCommands } from '@livx.cc/wcli/core';
 import { BodDB } from '@bod.ee/db';
@@ -610,6 +610,11 @@ declare class DuplexAgentOptions {
     reflexOptions?: Partial<AgentOptions>;
     actOptions?: Partial<AgentOptions>;
     thinkOptions?: Partial<AgentOptions>;
+    /** Fresh-context check on each successful Act task: a NEW agent (no self-confirmation bias) re-reads
+     *  the file state against the brief and fixes any gap before the result is re-voiced. Bounded to one
+     *  pass; ~2x Act cost so default OFF. The self-verify FOOTER (same context) was measured ineffective —
+     *  this is the structural fix (see mind/10). Think tasks are pure reasoning, never checked. */
+    verifyActTasks: boolean;
     /** Receives the voice text_delta stream + task lifecycle events. */
     host?: HostBridge;
     /** How many recent transcript messages are rendered into a worker's brief. */
@@ -681,6 +686,12 @@ declare class DuplexAgent {
     private buildBrief;
     /** Spawn a detached worker for task `id`; its settlement notifies + enqueues the re-voice turn. */
     private spawnWorker;
+    /** Fresh-context check of a successful Act task: a NEW agent (same model/fs/tools, but NO shared
+     *  conversation context) re-reads the file state against the brief and fixes any gap. The fix lands
+     *  on the shared fs automatically (workers write fs directly, no overlay), so grading sees the
+     *  corrected state. Bounded to ONE pass. Off unless `verifyActTasks`; never runs for think/failed/
+     *  cancelled tasks. Usage is merged so /cost reflects the real (worker + checker) spend. */
+    private maybeVerify;
     /** Throttled per-task progress: worker tool calls → at most one progress re-voice per interval.
      *  Two sources, one throttle: completed steps (post) and a heartbeat for a SINGLE long tool call
      *  (pre records the in-flight call; a self-cleaning timer narrates "still inside Bash — 70s").

package/dist/index.js

@@ -2657,6 +2657,9 @@ var AgentOptions = class {
   instructionFiles = true;
   /** Host interaction channel (human-in-the-loop). If set: adds the `AskUserQuestion` tool. */
   host;
+  /** Add the `AskUserQuestion` tool when a host is present (default true). Set false for an agent that
+   *  must never block a turn on a structured question — e.g. a voice reflex that confirms inline. */
+  askUserQuestion = true;
   /** Deterministic interception points around tool execution (pre/post/stop). */
   hooks;
   /** If true: add the `Task` tool so the agent can spawn depth-limited child agents over the VFS. */
@@ -2793,7 +2796,7 @@ var Agent = class _Agent {
       if (catalog) systemPrompt += "\n\n" + catalog;
       if (tool) tools = [...tools, tool];
     }
-    if (o.host) tools = [...tools, askUserQuestionTool];
+    if (o.host && o.askUserQuestion) tools = [...tools, askUserQuestionTool];
     if (o.subagents) {
       let agents;
       if (o.agentsDir) {
@@ -3625,6 +3628,11 @@ var DuplexAgentOptions = class {
   reflexOptions;
   actOptions;
   thinkOptions;
+  /** Fresh-context check on each successful Act task: a NEW agent (no self-confirmation bias) re-reads
+   *  the file state against the brief and fixes any gap before the result is re-voiced. Bounded to one
+   *  pass; ~2x Act cost so default OFF. The self-verify FOOTER (same context) was measured ineffective —
+   *  this is the structural fix (see mind/10). Think tasks are pure reasoning, never checked. */
+  verifyActTasks = false;
   /** Receives the voice text_delta stream + task lifecycle events. */
   host;
   /** How many recent transcript messages are rendered into a worker's brief. */
@@ -3655,7 +3663,7 @@ var DuplexAgentOptions = class {
   /** User-scope memory dir for global facts (type=user/feedback). Forwarded to Remember's routing. */
   memoryUserDir;
 };
-var VOICE_SYSTEM_PROMPT = 'You are a spoken voice assistant \u2014 the user HEARS everything you say. Use short sentences. One idea per sentence. No markdown, no bullet lists, no code blocks, no headings, no emoji.\nKeep turns SHORT \u2014 one to three sentences, then stop. Never lecture, enumerate cases, or add caveats unprompted. Conversation is a fast exchange: give the one thing asked, and let the user pull more if they want it.\nYou have three cognitive tiers \u2014 like a human brain:\n\u2022 YOU (reflex) \u2014 instant, lightweight. Handle greetings, simple questions, status checks, QuickLook.\n\u2022 `Act` \u2014 your hands. A standard background worker with FULL access to the user\'s environment (files, shell, web). Use for reading, editing, searching, running tasks, building \u2014 any real work.\n{{THINK_SLOT}}\nYou can find out or do ANYTHING by calling `Act` with a clear, self-contained brief \u2014 so NEVER tell the user you can\'t see, access, or do something. Act and find out. When the user mentions their project, folder, files, or environment ("this project", "the current folder", "my code"), call `Act` IMMEDIATELY \u2014 do not ask for paths or details the worker can discover itself. Never pretend to have done the work or invent results \u2014 the worker\'s report is your only source.\nAfter calling Act or Think, tell the user you are on it in one short sentence, then end your turn. Do not wait for the result.\nResults arrive later as events like "[task t1 completed] \u2026" or "[task t1 failed] \u2026". When one arrives, summarize it for the ear in one or two short sentences. "[task t1 progress] \u2026" events are interim status, NOT results \u2014 give at most a half-sentence aside ("still on it \u2014 running tests now") and end your turn. Never present progress as a finished result.\nNever read raw file paths, diffs, or code aloud verbatim.\n"[task t1 asks] \u2026" events are QUESTIONS from a background task \u2014 relay to the user in your own words, short, then end your turn. When the user answers, call `AnswerTask` with that id and their answer. NEVER answer on the user\'s behalf for permissions or risky operations; if their reply is ambiguous, confirm first.\nIf the user\'s message sounds INCOMPLETE \u2014 trailing off mid-sentence, a fragment that needs more context ("and then we", "but the problem is"), hesitation fillers ("uh", "um") \u2014 call `Hold` instead of answering. This keeps listening for the rest of their thought. Only respond with substance when you have a complete question or request.\nDispatch discipline: send ONE self-contained task per request \u2014 a single worker with the full brief beats several workers with fragments (each worker starts fresh and re-discovers context). NEVER dispatch a worker just to read files or gather information \u2014 workers explore and discover context themselves; pass on what you already know and let one worker do the whole job. Split into parallel tasks only when the user asks for genuinely independent things. When a task completes, report its result and stop \u2014 do NOT dispatch follow-up work (verification, polish, extras) the user did not ask for, unless the report itself signals failure or doubt.\nDo not fire a second Act/Think for work already in flight \u2014 check `TaskStatus` first. Use `CancelTask` when the user asks to stop something.\nPRIORITY: when the user says goodbye or wants to end/finish/wrap up the session ("ok bye", "that\'s all", "let\'s finish", "let\'s end", "goodnight", "exit", "wrap up"), call `ExitSession` IMMEDIATELY \u2014 do not act, do not check status, just exit.\nFor TRIVIAL instant lookups only \u2014 current time, git branch, listing a folder, peeking at a small file \u2014 use `QuickLook` (instant, no task). Anything requiring searching, reasoning, running commands, or editing goes through `Act`.\n{{MEMORY_SLOT}}\nUser messages may arrive via speech-to-text and can carry transcription artifacts \u2014 odd words, cut-offs, homophones ("for you" vs "folder"). Read for INTENT, not surface text. If a message seems garbled or surprising, briefly confirm what they meant ("did you mean\u2026?") instead of answering the literal words.';
+var VOICE_SYSTEM_PROMPT = 'You are a spoken voice assistant \u2014 the user HEARS everything you say. Use short sentences. One idea per sentence. No markdown, no bullet lists, no code blocks, no headings, no emoji.\nKeep turns SHORT \u2014 one to three sentences, then stop. Never lecture, enumerate cases, or add caveats unprompted. Conversation is a fast exchange: give the one thing asked, and let the user pull more if they want it.\nYou have three cognitive tiers \u2014 like a human brain:\n\u2022 YOU (reflex) \u2014 instant, lightweight. Handle greetings, simple questions, status checks, QuickLook.\n\u2022 `Act` \u2014 your hands. A standard background worker with FULL access to the user\'s environment (files, shell, web). Use for reading, editing, searching, running tasks, building \u2014 any real work.\n{{THINK_SLOT}}\nYou can find out or do ANYTHING by calling `Act` with a clear, self-contained brief \u2014 so NEVER tell the user you can\'t see, access, or do something. Act and find out. When the user mentions their project, folder, files, or environment ("this project", "the current folder", "my code"), call `Act` IMMEDIATELY \u2014 do not ask for paths or details the worker can discover itself. Never pretend to have done the work or invent results \u2014 the worker\'s report is your only source.\nAfter calling Act or Think, tell the user you are on it in one short sentence, then end your turn. Do not wait for the result.\nResults arrive later as events like "[task t1 completed] \u2026" or "[task t1 failed] \u2026". When one arrives, summarize it for the ear in one or two short sentences. "[task t1 progress] \u2026" events are interim status, NOT results \u2014 give at most a half-sentence aside ("still on it \u2014 running tests now") and end your turn. Never present progress as a finished result.\nCRITICAL: while a task is still running you have NO answer yet \u2014 never state a specific result of any kind (a number, size, count, name, path, or value). The real answer arrives ONLY in the "[task \u2026 completed]" event; inventing one meanwhile (a made-up disk size, commit count, etc.) is a serious error. Until then, only acknowledge and wait.\nNever read raw file paths, diffs, or code aloud verbatim.\n"[task t1 asks] \u2026" events are QUESTIONS from a background task \u2014 relay to the user in your own words, short, then end your turn. When the user answers, call `AnswerTask` with that id and their answer. NEVER answer on the user\'s behalf for permissions or risky operations; if their reply is ambiguous, confirm first.\nIf the user\'s message sounds INCOMPLETE \u2014 trailing off mid-sentence, a fragment that needs more context ("and then we", "but the problem is"), hesitation fillers ("uh", "um") \u2014 call `Hold` instead of answering. This keeps listening for the rest of their thought. Only respond with substance when you have a complete question or request.\nDispatch discipline: send ONE self-contained task per request \u2014 a single worker with the full brief beats several workers with fragments (each worker starts fresh and re-discovers context). NEVER dispatch a worker just to read files or gather information \u2014 workers explore and discover context themselves; pass on what you already know and let one worker do the whole job. Split into parallel tasks only when the user asks for genuinely independent things. When a task completes, report its result and stop \u2014 do NOT dispatch follow-up work (verification, polish, extras) the user did not ask for, unless the report itself signals failure or doubt.\nDo not fire a second Act/Think for work already in flight, and NEVER spawn a second task to re-count, cross-check, or verify a result a worker already gave you \u2014 trust its answer; a single question gets ONE task. Call `TaskStatus` at most ONCE per turn; if a task is still running, just say "still on it" and end the turn \u2014 never poll it again and again in a loop. Use `CancelTask` when the user asks to stop something.\nPRIORITY: when the user says goodbye or wants to end/finish/wrap up the session ("ok bye", "that\'s all", "let\'s finish", "let\'s end", "goodnight", "exit", "wrap up"), call `ExitSession` IMMEDIATELY \u2014 do not act, do not check status, just exit.\nFor TRIVIAL instant lookups only \u2014 current time, git branch, listing a folder, peeking at a small file \u2014 use `QuickLook` (instant, no task). Anything requiring searching, reasoning, running commands, or editing goes through `Act`.\n{{MEMORY_SLOT}}\nUser messages may arrive via speech-to-text and can carry transcription artifacts \u2014 odd words, cut-offs, homophones ("for you" vs "folder"). Read for INTENT, not surface text. If a message seems garbled or surprising, briefly confirm what they meant ("did you mean\u2026?") instead of answering the literal words.';
 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).`;
@@ -3697,6 +3705,10 @@ Today's date: ${(/* @__PURE__ */ new Date()).toDateString()}.`;
       model: o.reflexModel,
       stream: true,
       host: o.host,
+      // The reflex IS the conversational channel — it confirms ambiguity inline ("did you mean…?"),
+      // never via the blocking AskUserQuestion tool (Agent auto-adds it whenever a host is set). Left in,
+      // it stalls a voice turn until the kill-switch. Worker questions still reach the user via parkQuestion.
+      askUserQuestion: false,
       systemPrompt: prompt,
       instructionFiles: false,
       maxSteps: 8,
@@ -3796,7 +3808,7 @@ ${recent}` : brief) + verify;
       return a || "(no answer from the user \u2014 use your best judgment and note the assumption)";
     };
     const workerHost = o.askRelay ? { ask: relayAsk } : o.host?.ask ? { ask: (q) => o.host.ask(q) } : void 0;
-    const worker = new Agent({
+    const agentOpts = {
       ai: o.ai,
       fs: o.fs,
       model: tierModel,
@@ -3805,10 +3817,46 @@ ${recent}` : brief) + verify;
       ...workerHost ? { host: workerHost } : {},
       ...hooks ? { hooks } : {},
       signal: controller.signal
-    });
-    const promise = worker.run(briefText).then((res) => this.onWorkerSettled(id, res)).catch((err) => this.onWorkerFailed(id, err));
+      // shared with the checker so a cancel tears down both
+    };
+    const promise = new Agent(agentOpts).run(briefText).then((res) => this.maybeVerify(id, briefText, res, tier, agentOpts)).then((res) => this.onWorkerSettled(id, res)).catch((err) => this.onWorkerFailed(id, err));
     this.tasks.set(id, { id, label, status: "running", controller, promise });
   }
+  /** Fresh-context check of a successful Act task: a NEW agent (same model/fs/tools, but NO shared
+   *  conversation context) re-reads the file state against the brief and fixes any gap. The fix lands
+   *  on the shared fs automatically (workers write fs directly, no overlay), so grading sees the
+   *  corrected state. Bounded to ONE pass. Off unless `verifyActTasks`; never runs for think/failed/
+   *  cancelled tasks. Usage is merged so /cost reflects the real (worker + checker) spend. */
+  async maybeVerify(id, briefText, res, tier, agentOpts) {
+    if (!this.options.verifyActTasks || tier !== "act" || res.finishReason !== "stop") return res;
+    if (this.tasks.get(id)?.status === "cancelled") return res;
+    const checkBrief = `${briefText}
+
+## VERIFY MODE
+Another agent just implemented the above. Independently check the CURRENT state of the files against EVERY requirement. Fix any gap you find. If everything is already correct, make NO changes \u2014 do not refactor or improve \u2014 and report "verified".`;
+    this.notify("task_verify", `task ${id}: verifying`, { id });
+    const cres = await new Agent(agentOpts).run(checkBrief);
+    if (cres.finishReason !== "stop") {
+      log7.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;
+    return {
+      ...res,
+      steps: res.steps + cres.steps,
+      // Merge the checker's messages so downstream tool-call/step accounting includes BOTH agents
+      // (else a verified task's toolCalls would undercount vs its steps/usage).
+      messages: [...res.messages, ...cres.messages],
+      usageEstimated: res.usageEstimated || cres.usageEstimated,
+      usage: res.usage && cres.usage ? {
+        promptTokens: sum(res.usage.promptTokens, cres.usage.promptTokens),
+        completionTokens: sum(res.usage.completionTokens, cres.usage.completionTokens),
+        totalTokens: sum(res.usage.totalTokens, cres.usage.totalTokens),
+        cacheCreationTokens: sum(res.usage.cacheCreationTokens, cres.usage.cacheCreationTokens),
+        cacheReadTokens: sum(res.usage.cacheReadTokens, cres.usage.cacheReadTokens)
+      } : res.usage ?? cres.usage
+    };
+  }
   /** Throttled per-task progress: worker tool calls → at most one progress re-voice per interval.
    *  Two sources, one throttle: completed steps (post) and a heartbeat for a SINGLE long tool call
    *  (pre records the in-flight call; a self-cleaning timer narrates "still inside Bash — 70s").