agent.libx.js 0.93.29 → 0.93.31

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-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 { a as AgentOptions, H as Hooks, h as RunResult, A as Agent } from './Agent-uWtu_WFY.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-uWtu_WFY.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';
@@ -314,7 +314,7 @@ declare const grepTool: AgentTool;
  * Compact map of a VFS — code signatures and/or doc outlines. Edge-safe (pure IFilesystem walk).
  * `mode`: "code" (default) = top-level signatures; "docs" = heading outlines; "all" = both.
  */
-declare function repoIndex(fs: IFilesystem, glob?: string, mode?: 'code' | 'docs' | 'all'): Promise<string>;
+declare function repoIndex(fs: IFilesystem, glob?: string, mode?: 'code' | 'docs' | 'all', signal?: AbortSignal): Promise<string>;
 /** Compact map of the codebase or document workspace — orient in ONE call, not many. */
 declare const repoMapTool: AgentTool;
 /** Create or overwrite a file, creating parent directories as needed (mkdir -p). */
@@ -418,6 +418,16 @@ declare class Scratch {
     capture(tool: AgentTool): AgentTool;
     /** Wrap many tools at once. */
     captureAll(tools: AgentTool[]): AgentTool[];
+    /**
+     * Spill an oversized tool result to a scratch file and return PAGE 1 + a recoverable, paginated stub.
+     * Drop-in for `Agent.capToolResult`: the agent sees usable content immediately and knows how to get
+     * the rest (refine the query, Read the file in pages with offset/limit, or Ask to extract specifics).
+     * Lossless — unlike a plain crop, the full output stays available on the scratch FS.
+     */
+    spill(full: string, info: {
+        tool: string;
+        args: any;
+    }, pageBytes?: number): Promise<string>;
 }
 interface AskOptions {
     /** The scratch filesystem to peek into (dedicated VFS holding only scratch files). */
@@ -683,6 +693,11 @@ declare class DuplexAgentOptions {
     actModel: string;
     /** Premium reasoning model. Set to `false` to disable the Think tier entirely. */
     thinkModel: string | false;
+    /** Per-worker providerOptions, derived from the worker's actual model at spawn time (IoC — keeps duplex
+     *  provider-agnostic). Workers override the reflex/main model, so provider-specific options (e.g. cursor's
+     *  cwd/cursorSession) must be recomputed for the worker's model, never inherited from the main template —
+     *  leaking cursor options to an anthropic worker is a hard 400. Returns undefined → no providerOptions. */
+    providerOptionsFor?: (model: string) => Record<string, unknown> | undefined;
     /** Escape hatches merged over the derived per-agent options. */
     reflexOptions?: Partial<AgentOptions>;
     actOptions?: Partial<AgentOptions>;

package/dist/index.js

@@ -25,7 +25,10 @@ var init_redact = __esm({
 });
 
 // src/tools.structured.ts
-async function walkFiles(fs, dir, out = []) {
+function ckAbort(signal) {
+  if (signal?.aborted) throw new Error("aborted");
+}
+async function walkFiles(fs, dir, signal, out = []) {
   let entries;
   try {
     entries = await fs.readDir(dir);
@@ -33,8 +36,9 @@ async function walkFiles(fs, dir, out = []) {
     return out;
   }
   for (const name of entries.sort()) {
+    ckAbort(signal);
     const p = dir === "/" ? `/${name}` : `${dir}/${name}`;
-    if (await fs.isDirectory(p)) await walkFiles(fs, p, out);
+    if (await fs.isDirectory(p)) await walkFiles(fs, p, signal, out);
     else out.push(p);
   }
   return out;
@@ -91,13 +95,14 @@ function signaturesOf(content, cap = 40) {
   }
   return out;
 }
-async function repoIndex(fs, glob, mode = "code") {
+async function repoIndex(fs, glob, mode = "code", signal) {
   const scope = glob ? anchoredGlob(fs, String(glob)) : null;
   const filter = mode === "code" ? isCode : mode === "docs" ? isDoc : (p) => isCode(p) || isDoc(p);
-  const files = (await walkFiles(fs, fsCwd(fs))).filter((p) => scope ? scope.test(p) : filter(p));
+  const files = (await walkFiles(fs, fsCwd(fs), signal)).filter((p) => scope ? scope.test(p) : filter(p));
   const blocks = [];
   let shown = 0;
   for (const path of files) {
+    ckAbort(signal);
     let content;
     try {
       content = await fs.readFile(path);
@@ -217,7 +222,7 @@ var init_tools_structured = __esm({
         const include = pats.filter((p) => !p.startsWith("!")).map((p) => anchoredGlob(ctx.fs, p));
         const exclude = pats.filter((p) => p.startsWith("!")).map((p) => anchoredGlob(ctx.fs, p.slice(1)));
         const includes = include.length ? include : [anchoredGlob(ctx.fs, "**")];
-        const hits = (await walkFiles(ctx.fs, fsCwd(ctx.fs))).filter(
+        const hits = (await walkFiles(ctx.fs, fsCwd(ctx.fs), ctx.signal)).filter(
           (p) => includes.some((re) => re.test(p)) && !exclude.some((re) => re.test(p))
         );
         return hits.length ? hits.join("\n") : "(no matches)";
@@ -244,11 +249,12 @@ var init_tools_structured = __esm({
           throw new Error(`invalid regex: ${String(e)}`);
         }
         const scope = glob ? anchoredGlob(ctx.fs, String(glob)) : null;
-        const files = (await walkFiles(ctx.fs, fsCwd(ctx.fs))).filter((p) => !scope || scope.test(p));
+        const files = (await walkFiles(ctx.fs, fsCwd(ctx.fs), ctx.signal)).filter((p) => !scope || scope.test(p));
         const ctxN = Math.max(0, Number(context ?? 0));
         const out = [];
         const matched = [];
         for (const path of files) {
+          ckAbort(ctx.signal);
           let content;
           try {
             content = await ctx.fs.readFile(path);
@@ -284,7 +290,7 @@ var init_tools_structured = __esm({
           scope: { type: "string", enum: ["code", "docs", "all"], description: 'what to map: "code" (default), "docs", or "all"' }
         }
       },
-      run: ({ glob, scope }, ctx) => repoIndex(ctx.fs, glob, scope || "code")
+      run: ({ glob, scope }, ctx) => repoIndex(ctx.fs, glob, scope || "code", ctx.signal)
     };
     writeTool = {
       name: "Write",
@@ -2682,6 +2688,14 @@ var AgentOptions = class {
   /** Token-aware backstop (~4 chars/token estimate). After note-taking, drop oldest messages from the
    *  sent context until the estimate is under this ceiling (pairing-safe). 0 = off. */
   maxContextTokens = 0;
+  /** Pagination ceiling for a SINGLE tool result (bytes). A result over this is cropped to page 1 with
+   *  a marker telling the model it was cropped (refine the query, or page further). Guards against one
+   *  Grep/Read/MCP call blowing the whole context window. 0 = off. Default 60k (~15k tokens). */
+  maxToolResultBytes = 6e4;
+  /** Hook to handle an oversized tool result instead of the default lossy crop: receives the FULL output
+   *  and returns the (cropped) string to put in context — e.g. spill to scratch and return a recoverable,
+   *  paginated stub. Called only when a result exceeds `maxToolResultBytes`. */
+  capToolResult;
   /** VFS dir(s) of skills (`<dir>/<id>/SKILL.md`). If set: inject a catalog + add the `Skill` tool. Multiple dirs are merged (first wins on name collisions). */
   skillsDir;
   /** VFS dir(s) of slash-command templates (`<dir>/<name>.md`). If set: inject a catalog + add the `SlashCommand` tool. Multiple dirs are merged (first wins). */
@@ -3004,6 +3018,7 @@ var Agent = class _Agent {
       toolCallsTotal += toolCalls.length;
       if (o.maxToolCalls && toolCallsTotal > o.maxToolCalls) return kill("max_tool_calls");
       for (const tc of toolCalls) {
+        if (o.signal?.aborted) return kill("aborted");
         const raw = await this.dispatch(tc);
         let content;
         if (typeof raw === "string") {
@@ -3096,6 +3111,11 @@ var Agent = class _Agent {
       this.ctx.emit = void 0;
     }
     if (!threw) result = await this.maybeAutoTest(tc.function.name, result);
+    const cap = this.options.maxToolResultBytes ?? 0;
+    if (!threw && cap > 0 && result.length > cap) {
+      const info = { tool: tc.function.name, args };
+      result = this.options.capToolResult ? await this.options.capToolResult(result, info) : cropResult(result, cap);
+    }
     await hooks?.postToolUse?.(call, result, meta);
     this.options.host?.notify?.({ kind: "tool_result", id: tc.id ?? "", output: result, isError: threw });
     if (images?.length) {
@@ -3149,6 +3169,15 @@ function estimateTokens(m) {
   for (const x of m) chars += contentText(x.content).length + (x.tool_calls ? JSON.stringify(x.tool_calls).length : 0);
   return Math.ceil(chars / 4);
 }
+function cropResult(result, cap) {
+  const head = result.slice(0, cap);
+  const nl = head.lastIndexOf("\n");
+  const page = nl > cap * 0.5 ? head.slice(0, nl) : head;
+  const omitted = result.length - page.length;
+  return `${page}
+
+[output cropped \u2014 showing ${page.length} of ${result.length} bytes; ${omitted} omitted. This is page 1. Refine your query/command to narrow it, or call the tool again with a tighter scope to see more.]`;
+}
 function stubOldToolResults(messages, keep) {
   const meta = /* @__PURE__ */ new Map();
   for (const msg of messages)
@@ -3626,6 +3655,34 @@ To pull a specific detail, Grep/Read ${path}, or call Ask({ question: "\u2026",
   captureAll(tools) {
     return tools.map((t) => this.capture(t));
   }
+  /**
+   * Spill an oversized tool result to a scratch file and return PAGE 1 + a recoverable, paginated stub.
+   * Drop-in for `Agent.capToolResult`: the agent sees usable content immediately and knows how to get
+   * the rest (refine the query, Read the file in pages with offset/limit, or Ask to extract specifics).
+   * Lossless — unlike a plain crop, the full output stays available on the scratch FS.
+   */
+  async spill(full, info, pageBytes = 8e3) {
+    const { dir } = this.options;
+    const id = "a" + ++this.seq;
+    const path = `${dir}/${id}-${slug(info.tool)}.txt`;
+    const header = `# ${info.tool}(${shortArgs(info.args)}) \u2014 ${full.length} bytes
+`;
+    try {
+      await (this.dirReady ??= mkdirp(this.fs, dir));
+      await this.fs.writeFile(path, header + full);
+    } catch (e) {
+      log5.debug("scratch spill failed; cropping lossy", e);
+      return full.slice(0, pageBytes) + `
+
+[output cropped to ${pageBytes} of ${full.length} bytes; full output unavailable (scratch write failed) \u2014 refine your query]`;
+    }
+    const head = full.slice(0, pageBytes);
+    const nl = head.lastIndexOf("\n");
+    const page = nl > pageBytes * 0.5 ? head.slice(0, nl) : head;
+    return `${page}
+
+[output cropped \u2014 page 1 (${page.length} of ${full.length} bytes). Full output saved to ${path}. To see more: refine your query/command to narrow it, or Read ${path} with offset/limit to page through it, or Ask({ question: "\u2026", over: "${path}" }) to extract specifics.]`;
+  }
 };
 var ASK_PROMPT = "You are a retrieval-extraction step with Read, Grep and Glob over a scratch filesystem holding raw outputs from earlier tools. Find the information that answers the question and return it concisely, quoting values/facts verbatim. Do NOT add analysis or anything not grounded in the files. If the answer is not present, say so plainly.";
 function makeAskTool(o) {
@@ -3759,10 +3816,18 @@ var DuplexAgentOptions = class {
   ai;
   /** The WORKER's filesystem (act + think). If omitted the worker keeps Agent's jailed-disk-at-cwd default. */
   fs;
-  reflexModel = "groq/openai/gpt-oss-20b";
+  // The reflex IS the voice. 120b (not 20b) for channel discipline + instruction-following: the 20b
+  // mislabels gpt-oss harmony channels under load, leaking raw analysis into the spoken `final` channel
+  // (and misfiring Hold). 120b is the same price tier (~$0.15/$0.60) — the quality/cost trade is free.
+  reflexModel = "groq/openai/gpt-oss-120b";
   actModel = "anthropic/claude-sonnet-4-6";
   /** Premium reasoning model. Set to `false` to disable the Think tier entirely. */
   thinkModel = "anthropic/claude-opus-4-8";
+  /** Per-worker providerOptions, derived from the worker's actual model at spawn time (IoC — keeps duplex
+   *  provider-agnostic). Workers override the reflex/main model, so provider-specific options (e.g. cursor's
+   *  cwd/cursorSession) must be recomputed for the worker's model, never inherited from the main template —
+   *  leaking cursor options to an anthropic worker is a hard 400. Returns undefined → no providerOptions. */
+  providerOptionsFor;
   /** Escape hatches merged over the derived per-agent options. */
   reflexOptions;
   actOptions;
@@ -3841,7 +3906,12 @@ var DuplexAgent = class {
     const canSearch = workerToolNames.some((n) => /WebSearch/i.test(n));
     const canFetch = workerToolNames.some((n) => /WebFetch/i.test(n));
     const workerWeb = canSearch ? `, and it CAN search the web and read web pages \u2014 so when the user gives you something specific to look up ("search for X", "find me\u2026", "what's the latest on\u2026"), route it to Act. But a bare capability QUESTION like "can you search the web?" just gets a short spoken "yes, I can" \u2014 do NOT dispatch and NEVER invent a query the user did not give you` : canFetch ? ", and it can fetch a specific web page URL (but cannot search the web)" : "";
-    const prompt = VOICE_SYSTEM_PROMPT.replace("{{MEMORY_SLOT}}", memSlot).replace("{{THINK_SLOT}}", thinkSlot).replace("{{WORKER_WEB}}", workerWeb) + (o.voiceStyle === "conversational" ? "\n" + VOICE_STYLE_CONVERSATIONAL : "") + `
+    const mcpNames = [
+      ...Object.keys(o.actOptions?.providerOptions?.mcpServers ?? {}),
+      ...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 : "") + `
 Today's date: ${(/* @__PURE__ */ new Date()).toDateString()}.`;
     const tools = [
       ...o.reflexOptions?.tools ?? [],
@@ -4025,6 +4095,9 @@ ${recent}` : brief) + verify;
       model: tierModel,
       ...tier === "think" ? { reasoning: tierOpts?.reasoning ?? "high" } : {},
       ...tierOpts,
+      // Recompute providerOptions for THIS worker's model (after tierOpts so it wins over any inherited
+      // main-template value) — prevents cursor-only cwd/cursorSession leaking onto an anthropic worker.
+      providerOptions: o.providerOptionsFor?.(tierModel),
       ...workerHost ? { host: workerHost } : {},
       ...hooks ? { hooks } : {},
       signal: controller.signal
@@ -4273,8 +4346,10 @@ Another agent just implemented the above. Independently check the CURRENT state
             case "capabilities": {
               const actTools = this.options.actOptions?.tools ?? [];
               const names = actTools.map((t) => t.name);
+              const mcpServers = Object.keys(this.options.actOptions?.providerOptions?.mcpServers ?? {});
+              const mcpNote = mcpServers.length ? ` Plus MCP servers your worker can use: ${mcpServers.join(", ")} (e.g. browser-bridge \u2192 drive a real browser: open tabs, navigate, click, screenshot).` : "";
               if (!names.length)
-                return "Your worker uses Act's default local toolset (reading/editing files, running shell commands). No extra tools (e.g. web/internet) are configured; if a request is not a basic file or shell operation, assume you can't do it and say so.";
+                return "Your worker uses Act's default local toolset (reading/editing files, running shell commands). No extra tools (e.g. web/internet) are configured; if a request is not a basic file or shell operation, assume you can't do it and say so." + mcpNote;
               const hasFetch = names.some((n) => /WebFetch/i.test(n));
               const hasBrowser = names.some((n) => /browser.*(navigate|click|page|type)/i.test(n));
               const hasSearch = names.some((n) => /(^|_)WebSearch$|search/i.test(n) && !/WebFetch|browser/i.test(n));
@@ -4283,7 +4358,7 @@ Another agent just implemented the above. Independently check the CURRENT state
               if (hasBrowser) notes.push("The browser tools drive a real browser: you CAN open a site and, if needed, navigate to a search engine and search there \u2014 but it is manual and takes a moment, not an instant lookup.");
               else if (!hasSearch && hasFetch) notes.push('You have no general web-search tool, so for an instant "search the web" you can only fetch a URL they provide.');
               const webNote = notes.length ? " NOTE: " + notes.join(" ") : "";
-              return `Tools your background worker (Act) can actually use: ${names.join(", ")}. Read each name literally and match the request to a SPECIFIC tool; if none fits, you do NOT have that ability \u2014 say so honestly.` + webNote;
+              return `Tools your background worker (Act) can actually use: ${names.join(", ")}. Read each name literally and match the request to a SPECIFIC tool; if none fits, you do NOT have that ability \u2014 say so honestly.` + webNote + mcpNote;
             }
             case "time":
               return (/* @__PURE__ */ new Date()).toString();