reasonix 0.34.1 → 0.36.0

package/dist/cli/{chunk-LNTORE5K.js → chunk-QRUQ2BFT.js}

@@ -2,7 +2,7 @@
 import {
   MemoryStore,
   sanitizeMemoryName
-} from "./chunk-6TMHAK5D.js";
+} from "./chunk-ZU45XW3P.js";
 import {
   countTokens,
   estimateConversationTokens,
@@ -13,16 +13,16 @@ import {
 } from "./chunk-KMWKGPFZ.js";
 import {
   pauseGate
-} from "./chunk-SX6L4HZZ.js";
+} from "./chunk-QPNZWUZF.js";
 import {
   ESCALATION_CONTRACT,
   NEGATIVE_CLAIM_RULE,
   TUI_FORMATTING_RULES
-} from "./chunk-U3V2ZQ5J.js";
+} from "./chunk-KJQIA4US.js";
 import {
   formatHookOutcomeMessage,
   runHooks
-} from "./chunk-OERAGRJX.js";
+} from "./chunk-IPCPEZWQ.js";
 import {
   ignoredByLayers,
   loadGitignoreAt,
@@ -36,12 +36,12 @@ import {
 } from "./chunk-DFP4YSVM.js";
 import {
   t
-} from "./chunk-Q36KBLSU.js";
+} from "./chunk-MLXUGPJE.js";
 import {
   DEFAULT_INDEX_EXCLUDES,
   webSearchEndpoint,
   webSearchEngine
-} from "./chunk-5JXXEPDM.js";
+} from "./chunk-BHLHOS5Y.js";
 import {
   DEEPSEEK_CONTEXT_TOKENS,
   DEFAULT_CONTEXT_TOKENS,
@@ -286,6 +286,7 @@ var ToolRegistry = class {
   _planMode = false;
   _interceptor = null;
   _auditListener = null;
+  _resultAugmenter = null;
   constructor(opts = {}) {
     this._autoFlatten = opts.autoFlatten !== false;
   }
@@ -304,6 +305,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 };
@@ -379,6 +384,7 @@ var ToolRegistry = class {
         });
       }
     }
+    let finalResult;
     try {
       try {
         this._auditListener?.({ name, args });
@@ -396,19 +402,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}` });
       }
-      return JSON.stringify({
-        error: `${e.name}: ${e.message}`
-      });
     }
+    if (this._resultAugmenter) {
+      try {
+        return this._resultAugmenter(name, args, finalResult);
+      } catch {
+      }
+    }
+    return finalResult;
   }
 };
 function isReadOnlyCall(tool, args) {
@@ -2374,11 +2387,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");
@@ -2390,6 +2406,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]`);
@@ -2400,6 +2419,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 pct = Math.round(totalBytes / ctx.maxListBytes * 100);
+      pushLine(
+        `[switching to summary mode \u2014 byte budget at ${pct}%; remaining files will report match counts only]`
+      );
+      summaryNoticeEmitted = true;
+    }
+  };
   const walk2 = async (dir) => {
     if (truncated) return;
     throwIfAborted(args.signal);
@@ -2458,33 +2489,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);
@@ -2500,6 +2546,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) {
@@ -2552,7 +2635,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: {
@@ -2620,14 +2703,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({
@@ -2760,7 +2848,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",
@@ -2788,6 +2876,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"]
@@ -3254,9 +3346,14 @@ function registerSubmitPlan(registry, opts) {
         kind: "plan_proposed",
         payload: { plan, steps, summary }
       });
-      if (verdict.type === "approve") return "plan approved";
-      if (verdict.type === "refine") throw new Error("user requested refinement");
-      throw new Error("plan cancelled");
+      const fb = verdict.feedback?.trim();
+      if (verdict.type === "approve") {
+        return fb ? `plan approved. user's additional instructions: ${fb}` : "plan approved";
+      }
+      if (verdict.type === "refine") {
+        throw new Error(fb ? `user requested refinement: ${fb}` : "user requested refinement");
+      }
+      throw new Error(fb ? `plan cancelled: ${fb}` : "plan cancelled");
     }
   });
 }
@@ -4447,6 +4544,10 @@ ${ESCALATION_CONTRACT}
 ${TUI_FORMATTING_RULES}`;
 var DEFAULT_MAX_RESULT_CHARS2 = 8e3;
 var DEFAULT_MAX_ITERS = 16;
+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";
@@ -4505,8 +4606,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({
@@ -4890,4 +5009,4 @@ export {
   snapshotBeforeEdits,
   restoreSnapshots
 };
-//# sourceMappingURL=chunk-LNTORE5K.js.map
+//# sourceMappingURL=chunk-QRUQ2BFT.js.map