reasonix 0.34.1 → 0.35.0

package/dist/index.js

@@ -1188,6 +1188,68 @@ var EN = {
     selectFooter: "[\u2191\u2193] navigate \xB7 [Enter] confirm \xB7 [Esc] cancel",
     stepCounter: "Step {step}/{total} \xB7 "
   },
+  planFlow: {
+    approveCardTitle: "Approve plan",
+    approveCardMetaRight: "awaiting",
+    openQuestionsBanner: "\u25B2 the plan flags open questions or risks \u2014 pick {refine} to write concrete answers before the model moves on.",
+    openQuestionsHeader: "Open questions / risks",
+    truncatedBodyMore: "\u2026 {n} more line above in scrollback",
+    truncatedBodyMorePlural: "\u2026 {n} more lines above in scrollback",
+    picker: {
+      accept: "accept",
+      acceptHint: "run it now, in order",
+      refine: "refine",
+      refineHint: "give the agent more guidance, draft a new plan",
+      revise: "revise",
+      reviseHint: "edit the plan inline before running (skip / reorder steps)",
+      reject: "reject",
+      rejectHint: "discard, agent will retry from scratch"
+    },
+    refineFooter: "\u23CE send  \xB7  esc return to picker",
+    refineQuestionsHeading: "Answer these or describe the change you want:",
+    modes: {
+      approve: {
+        title: "approving \u2014 any last instructions?",
+        hint: "Answer questions the plan raised, add constraints, or just press Enter to approve as-is.",
+        blankHint: " (Enter with blank = approve without extra instructions.)"
+      },
+      refine: {
+        title: "refining \u2014 what should the model change?",
+        hint: "Describe what's wrong or missing, or answer questions the plan raised.",
+        blankHint: " (Enter with blank = let the model pick safe defaults for any open questions.)"
+      },
+      reject: {
+        title: "rejecting \u2014 tell the model why (optional)",
+        hint: "Say what the model got wrong about your goal, or what you actually want instead.",
+        blankHint: " (Enter with blank = cancel without explanation; the model will ask what you want.)"
+      },
+      "checkpoint-revise": {
+        title: "revising \u2014 what should change before the next step?",
+        hint: "Scope change, skip steps, alternative approach \u2014 the model adjusts the remaining plan.",
+        blankHint: " (Enter with blank = continue with the current plan.)"
+      },
+      "choice-custom": {
+        title: "custom answer \u2014 type whatever fits",
+        hint: "Free-form reply. The model reads it verbatim and proceeds \u2014 no need to match the listed options.",
+        blankHint: " (Enter with blank = ask the model what you actually want.)"
+      }
+    },
+    checkpoint: {
+      title: "Checkpoint \u2014 step done",
+      continue: "Continue \u2014 run the next step",
+      continueHint: "Model resumes with the next step.",
+      revise: "Revise \u2014 give feedback before the next step",
+      reviseHint: "Stay paused, type guidance; model adjusts the remaining plan.",
+      stop: "Stop \u2014 end the plan here",
+      stopHint: "Model summarizes what was done and ends."
+    },
+    stepList: {
+      counter: "{total} steps",
+      counterSingular: "{total} step",
+      counterDone: "{done}/{total} done ({pct}%) \xB7 {total} steps",
+      counterDoneSingular: "{done}/{total} done ({pct}%) \xB7 {total} step"
+    }
+  },
   app: {
     walkCancelledRemaining: "\u25B8 walk cancelled \u2014 {count} block(s) still pending.",
     walkCancelled: "\u25B8 walk cancelled.",
@@ -1973,6 +2035,68 @@ var zhCN = {
     selectFooter: "[\u2191\u2193] \u79FB\u52A8 \xB7 [Enter] \u786E\u8BA4 \xB7 [Esc] \u53D6\u6D88",
     stepCounter: "\u6B65\u9AA4 {step}/{total} \xB7 "
   },
+  planFlow: {
+    approveCardTitle: "\u786E\u8BA4\u8BA1\u5212",
+    approveCardMetaRight: "\u7B49\u5F85\u4E2D",
+    openQuestionsBanner: "\u25B2 \u8BA1\u5212\u4E2D\u6807\u8BB0\u4E86\u5F85\u786E\u8BA4\u7684\u95EE\u9898\u6216\u98CE\u9669 \u2014\u2014 \u8BF7\u9009 {refine} \u7ED9\u51FA\u660E\u786E\u7B54\u6848\uFF0C\u518D\u8BA9\u6A21\u578B\u7EE7\u7EED\u3002",
+    openQuestionsHeader: "\u5F85\u786E\u8BA4 / \u98CE\u9669",
+    truncatedBodyMore: "\u2026 \u8FD8\u6709 {n} \u884C\u5728\u4E0A\u65B9\u6EDA\u52A8\u5386\u53F2\u4E2D",
+    truncatedBodyMorePlural: "\u2026 \u8FD8\u6709 {n} \u884C\u5728\u4E0A\u65B9\u6EDA\u52A8\u5386\u53F2\u4E2D",
+    picker: {
+      accept: "\u91C7\u7EB3",
+      acceptHint: "\u7ACB\u5373\u6309\u987A\u5E8F\u6267\u884C",
+      refine: "\u7EC6\u5316",
+      refineHint: "\u7ED9\u6A21\u578B\u66F4\u591A\u6307\u5F15\uFF0C\u91CD\u65B0\u51FA\u4E00\u7248\u8BA1\u5212",
+      revise: "\u6539\u5199",
+      reviseHint: "\u5728\u6267\u884C\u524D\u5C31\u5730\u7F16\u8F91\u8BA1\u5212\uFF08\u8DF3\u8FC7 / \u91CD\u6392\u6B65\u9AA4\uFF09",
+      reject: "\u9A73\u56DE",
+      rejectHint: "\u4E22\u5F03\uFF0C\u8BA9\u6A21\u578B\u4ECE\u5934\u518D\u6765"
+    },
+    refineFooter: "\u23CE \u53D1\u9001  \xB7  esc \u8FD4\u56DE\u9009\u9879",
+    refineQuestionsHeading: "\u56DE\u7B54\u4EE5\u4E0B\u95EE\u9898\uFF0C\u6216\u76F4\u63A5\u8BF4\u660E\u4F60\u60F3\u8981\u7684\u4FEE\u6539\uFF1A",
+    modes: {
+      approve: {
+        title: "\u91C7\u7EB3 \u2014\u2014 \u8FD8\u6709\u8865\u5145\u6307\u793A\u5417\uFF1F",
+        hint: "\u56DE\u7B54\u8BA1\u5212\u4E2D\u7684\u95EE\u9898\u3001\u8865\u5145\u7EA6\u675F\uFF0C\u6216\u76F4\u63A5\u56DE\u8F66\u6309\u73B0\u72B6\u91C7\u7EB3\u3002",
+        blankHint: "\uFF08\u7559\u7A7A\u56DE\u8F66 = \u4E0D\u9644\u52A0\u6307\u793A\u76F4\u63A5\u91C7\u7EB3\u3002\uFF09"
+      },
+      refine: {
+        title: "\u7EC6\u5316 \u2014\u2014 \u6A21\u578B\u5E94\u8BE5\u6539\u4EC0\u4E48\uFF1F",
+        hint: "\u8BF4\u660E\u95EE\u9898\u5728\u54EA\u3001\u7F3A\u4EC0\u4E48\uFF0C\u6216\u8005\u56DE\u7B54\u8BA1\u5212\u63D0\u51FA\u7684\u7591\u95EE\u3002",
+        blankHint: "\uFF08\u7559\u7A7A\u56DE\u8F66 = \u8BA9\u6A21\u578B\u5BF9\u6240\u6709\u5F85\u786E\u8BA4\u95EE\u9898\u9009\u7528\u5B89\u5168\u9ED8\u8BA4\u3002\uFF09"
+      },
+      reject: {
+        title: "\u9A73\u56DE \u2014\u2014 \u544A\u8BC9\u6A21\u578B\u539F\u56E0\uFF08\u53EF\u9009\uFF09",
+        hint: "\u8BF4\u660E\u6A21\u578B\u5BF9\u4F60\u7684\u76EE\u6807\u7406\u89E3\u9519\u5728\u54EA\u91CC\uFF0C\u6216\u4F60\u771F\u6B63\u60F3\u8981\u4EC0\u4E48\u3002",
+        blankHint: "\uFF08\u7559\u7A7A\u56DE\u8F66 = \u4E0D\u89E3\u91CA\u76F4\u63A5\u53D6\u6D88\uFF1B\u6A21\u578B\u4F1A\u53CD\u8FC7\u6765\u95EE\u4F60\u60F3\u8981\u4EC0\u4E48\u3002\uFF09"
+      },
+      "checkpoint-revise": {
+        title: "\u6539\u5199 \u2014\u2014 \u4E0B\u4E00\u6B65\u524D\u8981\u8C03\u6574\u4EC0\u4E48\uFF1F",
+        hint: "\u8303\u56F4\u8C03\u6574\u3001\u8DF3\u8FC7\u6B65\u9AA4\u3001\u6362\u4E2A\u601D\u8DEF \u2014\u2014 \u6A21\u578B\u4F1A\u636E\u6B64\u4FEE\u6539\u5269\u4F59\u6B65\u9AA4\u3002",
+        blankHint: "\uFF08\u7559\u7A7A\u56DE\u8F66 = \u6309\u5F53\u524D\u8BA1\u5212\u7EE7\u7EED\u3002\uFF09"
+      },
+      "choice-custom": {
+        title: "\u81EA\u5B9A\u4E49\u56DE\u7B54 \u2014\u2014 \u60F3\u8BF4\u4EC0\u4E48\u90FD\u884C",
+        hint: "\u81EA\u7531\u6587\u672C\u3002\u6A21\u578B\u4F1A\u539F\u6837\u8BFB\u53D6\u5E76\u7EE7\u7EED \u2014\u2014 \u4E0D\u5FC5\u5339\u914D\u5019\u9009\u9879\u3002",
+        blankHint: "\uFF08\u7559\u7A7A\u56DE\u8F66 = \u8BA9\u6A21\u578B\u53CD\u8FC7\u6765\u95EE\u4F60\u60F3\u8981\u4EC0\u4E48\u3002\uFF09"
+      }
+    },
+    checkpoint: {
+      title: "\u68C0\u67E5\u70B9 \u2014\u2014 \u5F53\u524D\u6B65\u9AA4\u5DF2\u5B8C\u6210",
+      continue: "\u7EE7\u7EED \u2014\u2014 \u6267\u884C\u4E0B\u4E00\u6B65",
+      continueHint: "\u6A21\u578B\u4ECE\u4E0B\u4E00\u6B65\u7EE7\u7EED\u3002",
+      revise: "\u8C03\u6574 \u2014\u2014 \u5728\u4E0B\u4E00\u6B65\u524D\u7ED9\u53CD\u9988",
+      reviseHint: "\u5148\u6682\u505C\uFF0C\u8F93\u5165\u6307\u5F15\uFF1B\u6A21\u578B\u4F1A\u8C03\u6574\u5269\u4F59\u8BA1\u5212\u3002",
+      stop: "\u505C\u6B62 \u2014\u2014 \u5728\u6B64\u7ED3\u675F\u8BA1\u5212",
+      stopHint: "\u6A21\u578B\u603B\u7ED3\u5DF2\u5B8C\u6210\u7684\u5DE5\u4F5C\u5E76\u7ED3\u675F\u3002"
+    },
+    stepList: {
+      counter: "{total} \u4E2A\u6B65\u9AA4",
+      counterSingular: "{total} \u4E2A\u6B65\u9AA4",
+      counterDone: "{done}/{total} \u5DF2\u5B8C\u6210\uFF08{pct}%\uFF09 \xB7 \u5171 {total} \u6B65",
+      counterDoneSingular: "{done}/{total} \u5DF2\u5B8C\u6210\uFF08{pct}%\uFF09 \xB7 \u5171 {total} \u6B65"
+    }
+  },
   app: {
     walkCancelledRemaining: "\u25B8 \u6D4F\u89C8\u5DF2\u53D6\u6D88 \u2014 \u8FD8\u6709 {count} \u4E2A\u5F85\u5904\u7406\u7F16\u8F91\u5757\u3002",
     walkCancelled: "\u25B8 \u6D4F\u89C8\u5DF2\u53D6\u6D88\u3002",
@@ -2879,6 +3003,7 @@ var ToolRegistry = class {
   _planMode = false;
   _interceptor = null;
   _auditListener = null;
+  _resultAugmenter = null;
   constructor(opts = {}) {
     this._autoFlatten = opts.autoFlatten !== false;
   }
@@ -2897,6 +3022,10 @@ var ToolRegistry = class {
   setAuditListener(fn) {
     this._auditListener = fn;
   }
+  /** Final-stage post-processor; replaces previous augmenter when called twice. Pass null to clear. */
+  setResultAugmenter(fn) {
+    this._resultAugmenter = fn;
+  }
   register(def) {
     if (!def.name) throw new Error("tool requires a name");
     const internal = { ...def };
@@ -2972,6 +3101,7 @@ var ToolRegistry = class {
         });
       }
     }
+    let finalResult;
     try {
       try {
         this._auditListener?.({ name, args });
@@ -2989,19 +3119,26 @@ var ToolRegistry = class {
       if (opts.maxResultChars !== void 0) {
         clipped = truncateForModel(clipped, opts.maxResultChars);
       }
-      return clipped;
+      finalResult = clipped;
     } catch (err) {
       const e = err;
       if (typeof e.toToolResult === "function") {
         try {
-          return JSON.stringify(e.toToolResult());
+          finalResult = JSON.stringify(e.toToolResult());
         } catch {
+          finalResult = JSON.stringify({ error: `${e.name}: ${e.message}` });
         }
+      } else {
+        finalResult = JSON.stringify({ error: `${e.name}: ${e.message}` });
+      }
+    }
+    if (this._resultAugmenter) {
+      try {
+        return this._resultAugmenter(name, args, finalResult);
+      } catch {
       }
-      return JSON.stringify({
-        error: `${e.name}: ${e.message}`
-      });
     }
+    return finalResult;
   }
 };
 function isReadOnlyCall(tool, args) {
@@ -5762,6 +5899,10 @@ var SkillStore = class {
   }
   /** Scaffold a new skill stub at the chosen scope. Refuses to overwrite. */
   create(name, scope) {
+    return this.createWithContent(name, scope, skillStubBody(name));
+  }
+  /** Like `create` but writes caller-supplied file contents instead of the stub — used by the scaffold tool. */
+  createWithContent(name, scope, content) {
     if (!isValidSkillName(name)) {
       return { error: `invalid skill name: "${name}" \u2014 use letters, digits, _, -, .` };
     }
@@ -5776,7 +5917,7 @@ var SkillStore = class {
     }
     mkdirSync3(dirname4(flat), { recursive: true });
     try {
-      writeFileSync3(flat, skillStubBody(name), { encoding: "utf8", flag: "wx" });
+      writeFileSync3(flat, content, { encoding: "utf8", flag: "wx" });
     } catch (err) {
       if (err.code === "EEXIST") {
         return { error: `skill "${name}" already exists at ${flat}` };
@@ -6643,11 +6784,14 @@ async function searchFiles(ctx, startAbs, args) {
   await walk2(startAbs);
   return matches.length === 0 ? "(no matches)" : matches.join("\n");
 }
+var MAX_HITS_PER_FILE = 30;
+var SUMMARY_MODE_TRIGGER_RATIO = 0.8;
 async function searchContent(ctx, startAbs, args) {
   throwIfAborted(args.signal);
   const caseSensitive = args.case_sensitive === true;
   const includeDeps = args.include_deps === true;
   const ctxLines = Math.max(0, Math.min(20, Math.floor(args.context ?? 0)));
+  const summaryOnly = args.summary_only === true;
   let re = null;
   try {
     re = new RegExp(args.pattern, caseSensitive ? "" : "i");
@@ -6659,6 +6803,9 @@ async function searchContent(ctx, startAbs, args) {
   let totalBytes = 0;
   let scanned = 0;
   let truncated = false;
+  let summaryMode = summaryOnly;
+  let summaryNoticeEmitted = false;
+  const fileHitCounts = /* @__PURE__ */ new Map();
   const pushLine = (out) => {
     if (totalBytes + out.length + 1 > ctx.maxListBytes) {
       matches.push(`[\u2026 truncated at ${ctx.maxListBytes} bytes \u2014 refine pattern or path \u2026]`);
@@ -6669,6 +6816,18 @@ async function searchContent(ctx, startAbs, args) {
     totalBytes += out.length + 1;
     return true;
   };
+  const maybeEnterSummaryMode = () => {
+    if (summaryMode) return;
+    if (totalBytes <= SUMMARY_MODE_TRIGGER_RATIO * ctx.maxListBytes) return;
+    summaryMode = true;
+    if (!summaryNoticeEmitted) {
+      const pct2 = Math.round(totalBytes / ctx.maxListBytes * 100);
+      pushLine(
+        `[switching to summary mode \u2014 byte budget at ${pct2}%; remaining files will report match counts only]`
+      );
+      summaryNoticeEmitted = true;
+    }
+  };
   const walk2 = async (dir) => {
     if (truncated) return;
     throwIfAborted(args.signal);
@@ -6727,33 +6886,48 @@ async function searchContent(ctx, startAbs, args) {
       }
       scanned++;
       if (hits.length === 0) continue;
+      fileHitCounts.set(rel, hits.length);
+      if (summaryMode) {
+        if (!pushLine(`${rel}: ${hits.length} match${hits.length === 1 ? "" : "es"}`)) return;
+        continue;
+      }
+      const printable = Math.min(hits.length, MAX_HITS_PER_FILE);
+      const omittedFromFile = hits.length - printable;
+      const printableHits = hits.slice(0, printable);
       if (ctxLines === 0) {
-        for (const li of hits) {
+        for (const li of printableHits) {
           if (truncated) return;
           const line = lines[li];
           const display = line.length > 200 ? `${line.slice(0, 200)}\u2026` : line;
           if (!pushLine(`${rel}:${li + 1}: ${display}`)) return;
         }
-        continue;
-      }
-      const hitSet = new Set(hits);
-      let prevWindowEnd = -2;
-      for (const li of hits) {
-        if (truncated) return;
-        const winStart = Math.max(0, li - ctxLines);
-        const winEnd = Math.min(lines.length - 1, li + ctxLines);
-        if (winStart > prevWindowEnd + 1 && prevWindowEnd >= 0) {
-          if (!pushLine("--")) return;
-        }
-        const realStart = winStart > prevWindowEnd + 1 ? winStart : prevWindowEnd + 1;
-        for (let i = realStart; i <= winEnd; i++) {
-          const line = lines[i];
-          const display = line.length > 200 ? `${line.slice(0, 200)}\u2026` : line;
-          const sep2 = hitSet.has(i) ? ":" : "-";
-          if (!pushLine(`${rel}:${i + 1}${sep2} ${display}`)) return;
+      } else {
+        const hitSet = new Set(printableHits);
+        let prevWindowEnd = -2;
+        for (const li of printableHits) {
+          if (truncated) return;
+          const winStart = Math.max(0, li - ctxLines);
+          const winEnd = Math.min(lines.length - 1, li + ctxLines);
+          if (winStart > prevWindowEnd + 1 && prevWindowEnd >= 0) {
+            if (!pushLine("--")) return;
+          }
+          const realStart = winStart > prevWindowEnd + 1 ? winStart : prevWindowEnd + 1;
+          for (let i = realStart; i <= winEnd; i++) {
+            const line = lines[i];
+            const display = line.length > 200 ? `${line.slice(0, 200)}\u2026` : line;
+            const sep2 = hitSet.has(i) ? ":" : "-";
+            if (!pushLine(`${rel}:${i + 1}${sep2} ${display}`)) return;
+          }
+          prevWindowEnd = winEnd;
         }
-        prevWindowEnd = winEnd;
       }
+      if (omittedFromFile > 0) {
+        if (!pushLine(
+          `[${rel}: ${omittedFromFile} more match${omittedFromFile === 1 ? "" : "es"} in this file \u2014 re-grep with a tighter pattern or use read_file to see them]`
+        ))
+          return;
+      }
+      maybeEnterSummaryMode();
     }
   };
   await walk2(startAbs);
@@ -6769,6 +6943,43 @@ var DEFAULT_MAX_LIST_BYTES = 256 * 1024;
 var DEFAULT_AUTO_PREVIEW_LINES = 200;
 var AUTO_PREVIEW_HEAD_LINES = 80;
 var AUTO_PREVIEW_TAIL_LINES = 40;
+var OUTLINE_MAX_ENTRIES = 30;
+var OUTLINE_TAIL_KEEP = 5;
+var TS_EXPORT_RE = /^export\s+(?:default\s+)?(?:async\s+)?(function|class|const|let|var|interface|type|enum)\s+\*?\s*(\w+)/;
+function extractTsExportOutline(lines) {
+  const out = [];
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (!line.startsWith("export ")) continue;
+    const m = TS_EXPORT_RE.exec(line);
+    if (!m) continue;
+    out.push({ line: i + 1, kind: m[1], name: m[2] });
+  }
+  return out;
+}
+function formatOutline(entries) {
+  const total = entries.length;
+  if (total === 0) return "";
+  const lastEntry = entries[total - 1];
+  const width = String(lastEntry.line).length;
+  const fmt = (e) => `  L${String(e.line).padStart(width, " ")}  export ${e.kind} ${e.name}`;
+  const header = `[outline: ${total} top-level export${total === 1 ? "" : "s"}]`;
+  if (total <= OUTLINE_MAX_ENTRIES) {
+    return [header, ...entries.map(fmt)].join("\n");
+  }
+  const headCount = OUTLINE_MAX_ENTRIES - OUTLINE_TAIL_KEEP;
+  const headEntries = entries.slice(0, headCount);
+  const tailEntries = entries.slice(-OUTLINE_TAIL_KEEP);
+  const omitted = total - OUTLINE_MAX_ENTRIES;
+  const gapStart = headEntries[headEntries.length - 1].line;
+  const gapEnd = tailEntries[0].line;
+  return [
+    header,
+    ...headEntries.map(fmt),
+    `  [\u2026 ${omitted} more export${omitted === 1 ? "" : "s"} between L${gapStart} and L${gapEnd} \u2026]`,
+    ...tailEntries.map(fmt)
+  ].join("\n");
+}
 var SKIP_DIR_NAMES = new Set(DEFAULT_INDEX_EXCLUDES.dirs);
 var BINARY_EXTENSIONS = new Set(DEFAULT_INDEX_EXCLUDES.exts);
 function displayRel4(rootDir, full) {
@@ -6821,7 +7032,7 @@ function registerFilesystemTools(registry, opts) {
   - head: N  \u2192 first N lines (imports, public API, small configs)
   - tail: N  \u2192 last N lines (recently-added code, log tails)
   - range: "A-B"  \u2192 inclusive line range A..B, 1-indexed (e.g. "120-180" around an edit site)
-When none of these is given AND the file is longer than ${DEFAULT_AUTO_PREVIEW_LINES} lines, the tool auto-returns a head+tail preview with an "N lines omitted" marker rather than dumping everything. If you need the middle, re-call with a range. Prefer search_content to locate a symbol first, then read_file with a range around the hit \u2014 one scoped read beats three full-file reads.`,
+When none of these is given AND the file is longer than ${DEFAULT_AUTO_PREVIEW_LINES} lines, the tool auto-returns a head+tail preview with an "N lines omitted" marker, plus a top-level export outline (function / class / const / interface / type / enum names with line numbers, capped at ${OUTLINE_MAX_ENTRIES}) so you can pick a smart range without a follow-up grep. If you need the middle, re-call with a range. Prefer search_content to locate a symbol first only when the outline doesn't have what you want \u2014 one scoped read beats three full-file reads.`,
     readOnly: true,
     stormExempt: true,
     parameters: {
@@ -6889,14 +7100,19 @@ ${slice.join("\n")}`;
       const head = lines.slice(0, AUTO_PREVIEW_HEAD_LINES).join("\n");
       const tail = lines.slice(totalLines - AUTO_PREVIEW_TAIL_LINES).join("\n");
       const omitted = totalLines - AUTO_PREVIEW_HEAD_LINES - AUTO_PREVIEW_TAIL_LINES;
-      return [
+      const outline = formatOutline(extractTsExportOutline(lines));
+      const parts = [
         `[auto-preview: head ${AUTO_PREVIEW_HEAD_LINES} + tail ${AUTO_PREVIEW_TAIL_LINES} of ${totalLines} lines]`,
-        head,
+        head
+      ];
+      if (outline) parts.push("", outline);
+      parts.push(
         `
 [\u2026 ${omitted} lines omitted \u2014 call read_file again with range:"A-B" (1-indexed) or head / tail to get the middle]
 `,
         tail
-      ].join("\n");
+      );
+      return parts.join("\n");
     }
   });
   registry.register({
@@ -7029,7 +7245,7 @@ Prefer \`list_directory\` for a single-level view, \`search_files\` to find spec
   registry.register({
     name: "search_content",
     parallelSafe: true,
-    description: "Recursively grep file CONTENTS for a substring or regex. This is the right tool for 'find all places that call X', 'where is Y referenced', 'what files contain Z'. Different from search_files (which matches FILE NAMES). Returns one match per line in 'path:line: text' format. Skips dependency / VCS / build directories (node_modules, .git, dist, build, .next, target, .venv) and binary files by default.",
+    description: "Recursively grep file CONTENTS for a substring or regex. This is the right tool for 'find all places that call X', 'where is Y referenced', 'what files contain Z'. Different from search_files (which matches FILE NAMES). Returns one match per line in 'path:line: text' format. Per-file hits are capped at 30 (a footer reports any extras); when the byte budget is mostly spent the remaining files switch to a 'rel: N matches' histogram so distribution stays visible instead of one popular file drowning the rest. Pass `summary_only:true` to skip line content entirely and get just the histogram. Skips dependency / VCS / build directories (node_modules, .git, dist, build, .next, target, .venv) and binary files by default.",
     readOnly: true,
     parameters: {
       type: "object",
@@ -7057,6 +7273,10 @@ Prefer \`list_directory\` for a single-level view, \`search_files\` to find spec
         context: {
           type: "integer",
           description: "Lines of context to show around each match (both before and after). Default 0 (just the matching line). Capped at 20. Output uses ripgrep style: `:` after the line number on the matching line, `-` on context lines, `--` separating non-adjacent windows."
+        },
+        summary_only: {
+          type: "boolean",
+          description: "When true, skip line content and return one 'rel: N matches' line per matching file. Use for 'where does this exist at all' questions before drilling in with a targeted read_file."
         }
       },
       required: ["pattern"]
@@ -7881,6 +8101,10 @@ var DEFAULT_MAX_RESULT_CHARS2 = 8e3;
 var DEFAULT_MAX_ITERS = 16;
 var MIN_MAX_ITERS = 1;
 var MAX_MAX_ITERS = 32;
+var BUDGET_WARN_THRESHOLD = 3;
+function budgetParagraph(maxToolIters) {
+  return `Tool budget: you have ${maxToolIters} tool call${maxToolIters === 1 ? "" : "s"} for this task. The cap is enforced from outside \u2014 the call after #${maxToolIters} is refused. Pace yourself: if you can't fully resolve the task within the budget, stop early and return what you have plus what's missing, rather than burning the budget on one branch.`;
+}
 var DEFAULT_SUBAGENT_MODEL = "deepseek-v4-flash";
 var DEFAULT_SUBAGENT_EFFORT = "high";
 var SUBAGENT_TOOL_NAME = "spawn_subagent";
@@ -7939,8 +8163,26 @@ async function spawnSubagent(opts) {
     new Set(opts.allowedTools),
     NEVER_INHERITED_TOOLS
   ) : forkRegistryExcluding(opts.parentRegistry, NEVER_INHERITED_TOOLS);
+  let dispatchCount = 0;
+  childTools.setResultAugmenter((_name, _args, result) => {
+    dispatchCount++;
+    const remaining = maxToolIters - dispatchCount;
+    if (remaining <= 0) {
+      return `${result}
+
+[budget: 0 of ${maxToolIters} tool calls left \u2014 finalize NOW; the next tool call will be refused]`;
+    }
+    if (remaining <= BUDGET_WARN_THRESHOLD) {
+      return `${result}
+
+[budget: ${remaining} of ${maxToolIters} tool call${remaining === 1 ? "" : "s"} left \u2014 wrap up soon]`;
+    }
+    return result;
+  });
   const childPrefix = new ImmutablePrefix({
-    system: opts.system,
+    system: `${opts.system}
+
+${budgetParagraph(maxToolIters)}`,
     toolSpecs: childTools.specs()
   });
   const childLoop = new CacheFirstLoop({