@wrongstack/tools 0.319.1 → 1.0.0

package/dist/{chunk-45JPRMC2.js → chunk-SOR7OCYP.js}

@@ -214,6 +214,7 @@ function unbracket(hostname) {
 function safeBrowserUrl(rawUrl) {
   try {
     const url = new URL(rawUrl);
+    if (url.protocol !== "http:" && url.protocol !== "https:") return "about:blank";
     url.username = "";
     url.password = "";
     url.search = "";
@@ -224,8 +225,11 @@ function safeBrowserUrl(rawUrl) {
   }
 }
 function redactBrowserText(text) {
-  return text.replace(/\bBearer\s+[A-Za-z0-9._~+/-]+=*/gi, "Bearer [REDACTED]").replace(
-    /\b(api[-_ ]?key|access[-_ ]?token|auth[-_ ]?token|token|password|secret)\b\s*[:=]\s*[^\s,;]+/gi,
+  return text.replace(/\bauthorization\b\s*[:=]\s*[^\r\n]+/gi, "Authorization=[REDACTED]").replace(
+    /\bauthorization\b\s*[:=]\s*(?:Basic|Bearer)\s+[^\s,;]+/gi,
+    "Authorization=[REDACTED]"
+  ).replace(/\bBearer\s+[A-Za-z0-9._~+/-]+=*/gi, "Bearer [REDACTED]").replace(
+    /\b(authorization|set[-_ ]?cookie|cookie|api[-_ ]?key|private[-_ ]?key|client[-_ ]?secret|access[-_ ]?token|refresh[-_ ]?token|session[-_ ]?token|auth[-_ ]?token|token|password|secret)\b\s*[:=]\s*[^\s,;]+/gi,
     "$1=[REDACTED]"
   );
 }
@@ -1394,4 +1398,4 @@ export {
   browserTools,
   shutdownBrowserTools
 };
-//# sourceMappingURL=chunk-45JPRMC2.js.map
+//# sourceMappingURL=chunk-SOR7OCYP.js.map

package/dist/{chunk-ATSKPZUK.js → chunk-T3SMFF5Q.js}

@@ -2,7 +2,7 @@ import {
   executeLanguagePlan,
   executePackagePlan,
   planLanguageOperation
-} from "./chunk-TTZOK6IY.js";
+} from "./chunk-7N5U2RAU.js";
 
 // src/languages/legacy-bridge.ts
 import * as fs from "node:fs/promises";
@@ -21,7 +21,11 @@ async function detectNonJsEcosystem(cwd, projectRoot) {
   try {
     let dir = path.resolve(cwd);
     const root = path.resolve(projectRoot);
-    for (let depth = 0; depth <= 4 && dir.startsWith(root); depth++) {
+    const isInsideOrSame = (d, r) => {
+      const rel = path.relative(r, d);
+      return rel === "" || !rel.startsWith("..") && !path.isAbsolute(rel);
+    };
+    for (let depth = 0; depth <= 4 && isInsideOrSame(dir, root); depth++) {
       for (const marker of NON_JS_MARKERS) {
         try {
           const s = await fs.stat(path.join(dir, marker.filename));
@@ -38,8 +42,10 @@ async function detectNonJsEcosystem(cwd, projectRoot) {
         }
       } catch {
       }
-      if (dir === root) break;
-      dir = path.dirname(dir);
+      if (path.relative(root, dir) === "") break;
+      const parent = path.dirname(dir);
+      if (parent === dir) break;
+      dir = parent;
     }
   } catch {
   }
@@ -98,4 +104,4 @@ export {
   tryLegacyCodeOperation,
   tryLegacyPackageOperation
 };
-//# sourceMappingURL=chunk-ATSKPZUK.js.map
+//# sourceMappingURL=chunk-T3SMFF5Q.js.map

package/dist/{chunk-4BHUSMNL.js → chunk-UI3ZJIG3.js}

@@ -101,4 +101,4 @@ ${mode.description}`
 export {
   createModeTool
 };
-//# sourceMappingURL=chunk-4BHUSMNL.js.map
+//# sourceMappingURL=chunk-UI3ZJIG3.js.map

package/dist/{chunk-WXJY3BKV.js → chunk-VBF2YXUW.js}

@@ -80,7 +80,7 @@ var batchToolUseTool = {
     if (input.calls.length > MAX_BATCH_CALLS) {
       throw new Error(`batch_tool_use: calls must contain at most ${MAX_BATCH_CALLS} items`);
     }
-    const governedExecute = ctx.meta[GOVERNED_TOOL_EXECUTOR_META_KEY];
+    const governedExecute = ctx.meta?.[GOVERNED_TOOL_EXECUTOR_META_KEY];
     if (typeof governedExecute !== "function") {
       return {
         results: input.calls.map((call) => ({
@@ -200,4 +200,4 @@ async function executeSingle(call, ctx, governedExecute) {
 export {
   batchToolUseTool
 };
-//# sourceMappingURL=chunk-WXJY3BKV.js.map
+//# sourceMappingURL=chunk-VBF2YXUW.js.map

package/dist/{chunk-FQNXYA6W.js → chunk-VU3QBYL4.js}

@@ -1,6 +1,6 @@
 import {
   compileUserRegex
-} from "./chunk-Q5JPPCZC.js";
+} from "./chunk-YJTXRH5Y.js";
 import {
   safeResolveReal
 } from "./chunk-ZUFHAHTE.js";
@@ -8,8 +8,9 @@ import {
 // src/logs.ts
 import { spawn } from "node:child_process";
 import { StringDecoder } from "node:string_decoder";
-import { buildChildEnv } from "@wrongstack/core/utils";
-import { ToolValidationError } from "@wrongstack/core/types";
+import * as fs from "node:fs/promises";
+import { buildChildEnv, toErrorMessage } from "@wrongstack/core/utils";
+import { FsError, ToolValidationError } from "@wrongstack/core/types";
 var logsTool = {
   name: "logs",
   category: "Logs",
@@ -86,7 +87,37 @@ var logsTool = {
       return await dockerLogs(input.service, lines, filterRe, cwd, signal, input.since);
     }
     if (input.path) {
-      return await fileLogs(await safeResolveReal(input.path, ctx), lines, filterRe);
+      const resolved = await safeResolveReal(input.path, ctx);
+      let stat2;
+      try {
+        stat2 = await fs.stat(resolved);
+      } catch (err) {
+        const code = err.code;
+        if (code === "ENOENT") {
+          throw new FsError({
+            message: `logs: file not found "${input.path}"`,
+            code: "FS_READ_FAILED",
+            path: resolved,
+            context: { errno: "ENOENT" }
+          });
+        }
+        throw new FsError({
+          message: `logs: failed to stat "${input.path}": ${toErrorMessage(err)}`,
+          code: "FS_READ_FAILED",
+          path: resolved,
+          context: { errno: code },
+          cause: err
+        });
+      }
+      if (!stat2.isFile()) {
+        throw new FsError({
+          message: `logs: "${input.path}" is not a regular file`,
+          code: "FS_READ_FAILED",
+          path: resolved,
+          context: { reason: "not-a-regular-file" }
+        });
+      }
+      return await fileLogs(resolved, lines, filterRe);
     }
     return {
       source: "none",
@@ -268,4 +299,4 @@ function parseLine(line) {
 export {
   logsTool
 };
-//# sourceMappingURL=chunk-FQNXYA6W.js.map
+//# sourceMappingURL=chunk-VU3QBYL4.js.map

package/dist/{chunk-IIF5HIVF.js → chunk-VVZPQPTY.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-UCYQTZ7F.js";
 import {
   resolveWin32Command
-} from "./chunk-V43EQ6VR.js";
+} from "./chunk-KE7A76VC.js";
 
 // src/codebase-index/py-parser.ts
 import { spawn } from "node:child_process";
@@ -382,4 +382,4 @@ export {
   parseSymbols,
   resolvePythonBinary
 };
-//# sourceMappingURL=chunk-IIF5HIVF.js.map
+//# sourceMappingURL=chunk-VVZPQPTY.js.map

package/dist/{chunk-VD2LV5WO.js → chunk-VZGPASGD.js}

@@ -1,7 +1,7 @@
 import {
   capSubject,
   compileUserRegex
-} from "./chunk-Q5JPPCZC.js";
+} from "./chunk-YJTXRH5Y.js";
 import {
   safeResolveReal
 } from "./chunk-ZUFHAHTE.js";
@@ -39,7 +39,7 @@ async function readJsonFileBounded(filePath, ctx) {
 var jsonTool = {
   name: "json",
   category: "Data",
-  description: "Parse, pretty-print, query, validate, transform, and merge JSON/JSON5/YAML. Use `action` to select the operation: parse (default), query, validate, transform, or merge.",
+  description: "Parse, pretty-print, query, validate, transform, and merge JSON/JSON5/YAML (read-only \u2014 does not write files). Use `action` to select the operation: parse (default), query, validate, transform, or merge.",
   usageHint: 'VERY USEFUL FOR DATA INSPECTION:\n\n- `action: "parse"` (default): read/pretty-print/convert JSON, JSON5, or YAML from `file` or `data`.\n- `action: "query"`: JMESPath-like query (`a.b[0].c`, `items[*].name`, filters, functions).\n- `action: "validate"`: validate data against a JSON Schema (`schema` param).\n- `action: "transform"`: chain multiple JMESPath transforms (`transforms` param).\n- `action: "merge"`: deep merge `base` and `patch` objects (`conflictResolution` param).\nPrefer this over raw `read` + manual parsing when dealing with configuration or data files.',
   permission: "auto",
   mutating: false,
@@ -444,20 +444,35 @@ function jmespathSearch(data, query) {
     if (rest === void 0) return val;
     return jmespathSearch(val, rest);
   }
-  const arrMatch = query.match(/^\[(\d+)\](?:\.(.+))?$/);
+  const propIdxMatch = query.match(/^([a-zA-Z_][a-zA-Z0-9_]*)\[(\d+)\](?:\.?(.*))?$/);
+  if (propIdxMatch) {
+    const key = propIdxMatch[1];
+    if (key === "__proto__" || key === "prototype" || key === "constructor") {
+      return void 0;
+    }
+    const idx = Number.parseInt(propIdxMatch[2], 10);
+    const rest = propIdxMatch[3] ? propIdxMatch[3] : void 0;
+    const arr = data?.[key];
+    if (!Array.isArray(arr)) return void 0;
+    const val = arr[idx];
+    if (rest === void 0) return val;
+    return jmespathSearch(val, rest);
+  }
+  const arrMatch = query.match(/^\[(\d+)\](?:\.?(.*))?$/);
   if (arrMatch) {
     const idx = Number.parseInt(arrMatch[1], 10);
-    const rest = arrMatch[2];
+    const rest = arrMatch[2] ? arrMatch[2] : void 0;
     const arr = data;
     const val = arr?.[idx];
     if (rest === void 0) return val;
     return jmespathSearch(val, rest);
   }
-  if (query === "[*]") {
-    if (Array.isArray(data)) {
-      return data;
-    }
-    return data;
+  const wildcardMatch = query.match(/^\[\*\](?:\.(.+))?$/);
+  if (wildcardMatch) {
+    if (!Array.isArray(data)) return [];
+    const rest = wildcardMatch[1];
+    if (rest === void 0) return data;
+    return data.map((item) => jmespathSearch(item, rest));
   }
   const multiMatch = query.match(/^([a-zA-Z_][a-zA-Z0-9_]*)\[\*\](?:\.(.+))?$/);
   if (multiMatch) {
@@ -469,14 +484,24 @@ function jmespathSearch(data, query) {
     return arr.map((item) => jmespathSearch(item, rest));
   }
   const filterMatch = query.match(
-    /^\[\\?([a-zA-Z_][a-zA-Z0-9_]*)(==|!=|<|>|<=|>=)(`[^`]+`|'[^']*')\](?:\.(.+))?$/
+    /^\[\??([a-zA-Z_][a-zA-Z0-9_]*)(==|!=|<|>|<=|>=)(`[^`]+`|'[^']*')\](?:\.(.+))?$/
   );
   if (filterMatch) {
     const field = filterMatch[1];
     const op = filterMatch[2];
     const rawVal = filterMatch[3];
     const rest = filterMatch[4];
-    const cmpVal = JSON.parse(rawVal.slice(1, -1));
+    let cmpVal;
+    if (rawVal.startsWith("'") && rawVal.endsWith("'")) {
+      cmpVal = rawVal.slice(1, -1);
+    } else {
+      const inner = rawVal.slice(1, -1);
+      try {
+        cmpVal = JSON.parse(inner);
+      } catch {
+        cmpVal = inner;
+      }
+    }
     const arr = data;
     if (!Array.isArray(arr)) return [];
     const filtered = arr.filter((item) => {
@@ -676,4 +701,4 @@ ${toYaml(v, indent + 1)}`;
 export {
   jsonTool
 };
-//# sourceMappingURL=chunk-VD2LV5WO.js.map
+//# sourceMappingURL=chunk-VZGPASGD.js.map

package/dist/{chunk-64VIJPFV.js → chunk-WEEVSWQB.js}

@@ -1,9 +1,9 @@
 import {
   tryLegacyPackageOperation
-} from "./chunk-ATSKPZUK.js";
+} from "./chunk-T3SMFF5Q.js";
 import {
   spawnStream
-} from "./chunk-ZHH3BEWU.js";
+} from "./chunk-DRRY6SCM.js";
 import {
   COMMAND_OUTPUT_MAX_BYTES,
   detectPackageManager,
@@ -117,7 +117,8 @@ var auditTool = {
       type: "final",
       output: parseAuditOutput(result.stdout, result.exitCode, {
         level: input.level,
-        spawnTruncated: result.truncated
+        spawnTruncated: result.truncated,
+        rawError: result.stderr || result.error || ""
       })
     };
   }
@@ -129,7 +130,7 @@ function parseAuditOutput(json, exitCode, opts = {}) {
       vulnerabilities: [],
       total: 0,
       summary: exitCode === 0 ? "No vulnerabilities found" : "Audit failed",
-      output: "",
+      output: normalizeCommandOutput(opts.rawError || ""),
       truncated: false
     };
   }
@@ -143,7 +144,17 @@ function parseAuditOutput(json, exitCode, opts = {}) {
       advisories = advisories.filter((a) => (SEVERITY_RANK[a.severity] ?? 0) >= minRank);
     }
     const total = advisories.length;
-    const summary = total === 0 ? "No vulnerabilities found" : `Found ${total} vulnerabilities: ${advisories.filter((a) => a.severity === "critical").length} critical, ${advisories.filter((a) => a.severity === "high").length} high`;
+    let summary;
+    if (total === 0) {
+      if (exitCode !== 0) {
+        const errObj = data.error;
+        summary = typeof errObj?.summary === "string" ? errObj.summary : typeof errObj?.code === "string" ? `Audit failed (${errObj.code})` : "Audit failed";
+      } else {
+        summary = "No vulnerabilities found";
+      }
+    } else {
+      summary = `Found ${total} vulnerabilities: ${advisories.filter((a) => a.severity === "critical").length} critical, ${advisories.filter((a) => a.severity === "high").length} high`;
+    }
     return {
       exit_code: exitCode,
       vulnerabilities: advisories,
@@ -209,4 +220,4 @@ function extractAdvisories(data) {
 export {
   auditTool
 };
-//# sourceMappingURL=chunk-64VIJPFV.js.map
+//# sourceMappingURL=chunk-WEEVSWQB.js.map

package/dist/chunk-XXRMF2BC.js

@@ -0,0 +1,186 @@
+// src/next-steps.ts
+function projectNextStepsToolInput(input) {
+  if (!input || typeof input !== "object" || Array.isArray(input)) return [];
+  const rawSteps = input["steps"];
+  if (!Array.isArray(rawSteps)) return [];
+  const steps = [];
+  for (const candidate of rawSteps) {
+    if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) continue;
+    const text = candidate["text"];
+    if (typeof text !== "string" || !text.trim()) continue;
+    const auto = steps.length === 0 && candidate["auto"] === true;
+    steps.push(
+      auto ? { index: steps.length + 1, text: text.trim(), auto: true } : { index: steps.length + 1, text: text.trim() }
+    );
+    if (steps.length >= MAX_STEPS) break;
+  }
+  return steps;
+}
+function isFinalTurnStopReason(stopReason) {
+  return stopReason !== "tool_use" && stopReason !== "tool_call";
+}
+function fenceSpans(content) {
+  const spans = [];
+  const lines = content.split("\n");
+  let offset = 0;
+  let open = null;
+  for (const line of lines) {
+    const lineStart = offset;
+    offset += line.length + 1;
+    const trimmed = line.trim();
+    const marker = /^(`{3,}|~{3,})/.exec(trimmed)?.[1];
+    if (marker === void 0) continue;
+    if (open === null) {
+      open = { markerChar: marker[0], markerLength: marker.length, start: lineStart };
+      continue;
+    }
+    if (marker[0] === open.markerChar && marker.length >= open.markerLength && trimmed === marker) {
+      spans.push([open.start, offset]);
+      open = null;
+    }
+  }
+  if (open !== null) spans.push([open.start, content.length]);
+  return spans;
+}
+function indexInsideCodeFence(content, index) {
+  return fenceSpans(content).some(([start, end]) => index >= start && index < end);
+}
+function nonFencedIndexOf(content, needle, fromIndex, spans) {
+  let at = fromIndex;
+  for (; ; ) {
+    const found = content.indexOf(needle, at);
+    if (found === -1) return -1;
+    if (!spans.some(([start, end]) => found >= start && found < end)) return found;
+    at = found + 1;
+  }
+}
+var ITEM_RE = /^(?:(\d+)[.)]\s*|[-*•]\s*)(.+?)(\s+auto="true")?$/;
+var MAX_STEPS = 6;
+function parseNextSteps(content, requireHeading = true) {
+  if (requireHeading) {
+    return parseWithHeading(content);
+  }
+  return parseRawNumbered(content);
+}
+function pushStep(steps, index, text, hasAuto) {
+  steps.push(hasAuto ? { index, text, auto: true } : { index, text });
+}
+function parseRawNumbered(content) {
+  const lines = content.split("\n");
+  const steps = [];
+  const seenNumbers = /* @__PURE__ */ new Set();
+  for (const rawLine of lines) {
+    const line = rawLine.trim();
+    if (!line) continue;
+    const m = ITEM_RE.exec(line);
+    if (!m) continue;
+    const numPart = m[1];
+    const text = m[2].trim();
+    let index;
+    if (numPart !== void 0) {
+      index = Number.parseInt(numPart, 10);
+    } else {
+      index = steps.length + 1;
+    }
+    if (seenNumbers.has(index)) continue;
+    seenNumbers.add(index);
+    const hasAuto = !!m[3] && steps.length === 0 && index === 1;
+    pushStep(steps, index, text, hasAuto);
+    if (steps.length >= MAX_STEPS) break;
+  }
+  return {
+    steps,
+    texts: steps.map((s) => s.text),
+    stripped: content,
+    autoTexts: steps.filter((s) => s.auto).map((s) => s.text)
+  };
+}
+function parseWithHeading(content) {
+  const empty = { steps: [], texts: [], stripped: content, autoTexts: [] };
+  const spans = fenceSpans(content);
+  const outsideFences = (index) => !spans.some(([start, end]) => index >= start && index < end);
+  const headingScan = /<nextsteps\b[^>]*>\s*\n+/gi;
+  let heading = null;
+  for (let m = headingScan.exec(content); m !== null; m = headingScan.exec(content)) {
+    if (outsideFences(m.index)) {
+      heading = { index: m.index, length: m[0].length };
+      break;
+    }
+  }
+  if (heading === null) return empty;
+  const headingEnd = heading.index + heading.length;
+  const afterHeading = content.slice(headingEnd);
+  const lines = afterHeading.split("\n");
+  const steps = [];
+  const seenNumbers = /* @__PURE__ */ new Set();
+  for (const rawLine of lines) {
+    const line = rawLine.trim();
+    if (!line) continue;
+    const m = ITEM_RE.exec(line);
+    if (!m) break;
+    const numPart = m[1];
+    const text = m[2].trim();
+    let index;
+    if (numPart !== void 0) {
+      index = Number.parseInt(numPart, 10);
+    } else {
+      index = steps.length + 1;
+    }
+    if (seenNumbers.has(index)) continue;
+    seenNumbers.add(index);
+    const hasAuto = !!m[3] && steps.length === 0 && index === 1;
+    pushStep(steps, index, text, hasAuto);
+    if (steps.length >= MAX_STEPS) break;
+  }
+  if (steps.length === 0) return empty;
+  const closeAbs = nonFencedIndexOf(content, "</nextsteps>", headingEnd, spans);
+  if (closeAbs === -1) return empty;
+  const texts = steps.map((s) => s.text);
+  const autoTexts = steps.filter((s) => s.auto).map((s) => s.text);
+  let blockEndAbs = closeAbs + "</nextsteps>".length;
+  if (content[blockEndAbs] === "\n") blockEndAbs += 1;
+  const stripped = (content.slice(0, heading.index) + content.slice(blockEndAbs)).replace(/\n{3,}/g, "\n\n").trim();
+  return { steps, texts, stripped, autoTexts };
+}
+function stripNextStepsBlock(text) {
+  const spans = fenceSpans(text);
+  const outsideFences = (index) => !spans.some(([start, end]) => index >= start && index < end);
+  let result = "";
+  let cursor = 0;
+  const openTagRe = /<next_?steps\b[^>]*>/gi;
+  for (let match = openTagRe.exec(text); match !== null; match = openTagRe.exec(text)) {
+    if (!outsideFences(match.index)) continue;
+    let removed;
+    if (match[0].endsWith("/>")) {
+      removed = match[0].length;
+    } else {
+      const closeRe = /<\/next_?steps\s*>/gi;
+      closeRe.lastIndex = match.index + match[0].length;
+      removed = -1;
+      for (let close = closeRe.exec(text); close !== null; close = closeRe.exec(text)) {
+        if (!outsideFences(close.index)) continue;
+        removed = close.index + close[0].length - match.index;
+        break;
+      }
+      if (removed === -1) {
+        removed = match[0].length;
+      }
+    }
+    result += text.slice(cursor, match.index);
+    cursor = match.index + removed;
+    openTagRe.lastIndex = cursor;
+  }
+  result += text.slice(cursor);
+  return result.replace(/\n{3,}/g, "\n\n").trim();
+}
+var stripNextSteps = stripNextStepsBlock;
+
+export {
+  projectNextStepsToolInput,
+  isFinalTurnStopReason,
+  indexInsideCodeFence,
+  parseNextSteps,
+  stripNextStepsBlock,
+  stripNextSteps
+};
+//# sourceMappingURL=chunk-XXRMF2BC.js.map

package/dist/{chunk-RTZWBNTY.js → chunk-YEISRT4S.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-XRNN44QY.js";
 import {
   spawnStream
-} from "./chunk-ZHH3BEWU.js";
+} from "./chunk-DRRY6SCM.js";
 import {
   codebaseIndexStats,
   enqueueReindex,
@@ -13,7 +13,7 @@ import {
   outgoingCallsService,
   runStartupIndex,
   searchCodebaseIndex
-} from "./chunk-DP6CXMJZ.js";
+} from "./chunk-ZTCJCYLN.js";
 import {
   IndexTimeoutError,
   SCHEMA_VERSION,
@@ -21,7 +21,7 @@ import {
   indexCircuitBreaker,
   indexStorePool,
   resolveIndexDir
-} from "./chunk-KY4PXYSO.js";
+} from "./chunk-N3K2SFEI.js";
 import {
   EXT_TO_LANG,
   detectLang,
@@ -254,12 +254,6 @@ var PolyglotInvariantEngine = class {
               params,
               returnType
             });
-            functions.set(methodName, {
-              name: methodName,
-              isExported: isExp,
-              params,
-              returnType
-            });
           }
         }
       }
@@ -1643,12 +1637,13 @@ function collapseTsImports(code) {
   let importGroupCount = 0;
   for (let i = 0; i < lines.length; i++) {
     const line = lines[i] ?? "";
-    const trimmed = line.trim();
+    let trimmed = line.trim();
     if (trimmed.startsWith("import ") || trimmed.startsWith("import{")) {
       inImportGroup = true;
       importGroupCount++;
       while (!trimmed.includes(";") && !trimmed.includes("from '") && !trimmed.includes('from "') && i + 1 < lines.length) {
         i++;
+        trimmed = (lines[i] ?? "").trim();
       }
     } else {
       if (inImportGroup) {
@@ -1989,7 +1984,7 @@ var codebaseRepoMapTool = {
   permission: "auto",
   mutating: false,
   capabilities: ["fs.read"],
-  description: "Generate a reference-weighted, token-budgeted Repository Map (Repo Map) of the codebase. Extracts the most architecturally central types, interfaces, classes, and function signatures across the repository into a compact outline (~800-1500 tokens). Use this at the beginning of tasks or when navigating unfamiliar repositories to get a bird-eye view of the architecture.",
+  description: "Generate a reference-weighted, token-budgeted Repository Map of the codebase (~1200 token default). Use it for orientation before a cross-file change. Extracts the most architecturally central types, interfaces, classes, and function signatures across the repository into a compact outline (~800-1500 tokens). Use this at the beginning of tasks or when navigating unfamiliar repositories to get a bird-eye view of the architecture.",
   usageHint: 'USE AT THE START OF COMPLEX OR REPOSITORY-WIDE TASKS:\n\n- Call with default parameters to get a global architecture map within ~1200 tokens.\n- Pass `focusFiles: ["src/auth.ts"]` to ensure candidate files are guaranteed to be mapped alongside related entry-points.\n- Use the returned line numbers (e.g. `/* L32-L45 */`) to navigate or partially read only the functions you need.',
   inputSchema: {
     type: "object",
@@ -2865,4 +2860,4 @@ export {
   deadCodeScanTool,
   runDeadCodeScan
 };
-//# sourceMappingURL=chunk-RTZWBNTY.js.map
+//# sourceMappingURL=chunk-YEISRT4S.js.map

package/dist/{chunk-Q5JPPCZC.js → chunk-YJTXRH5Y.js}

@@ -7,6 +7,7 @@ import {
 
 export {
   capSubject,
-  compileUserRegex
+  compileUserRegex,
+  MAX_SUBJECT_LEN
 };
-//# sourceMappingURL=chunk-Q5JPPCZC.js.map
+//# sourceMappingURL=chunk-YJTXRH5Y.js.map

package/dist/{chunk-GMZYW52L.js → chunk-YULVUTK5.js}

@@ -1,10 +1,10 @@
 import {
   builtinToolsPack
-} from "./chunk-DC4KMPJO.js";
+} from "./chunk-M6UV67BH.js";
 import {
   TIER1_TOOLS,
   TIER2_TOOLS
-} from "./chunk-OTINMOKK.js";
+} from "./chunk-AB2CAUOP.js";
 
 // src/tool-tier.ts
 function toolNameSet(tools) {
@@ -18,6 +18,7 @@ var BUILTIN_TIER_COUNTS = {
   aggressive: TIER1_TOOLS.length
 };
 function selectBuiltinToolsForTier(tier, allTools) {
+  if (!Array.isArray(allTools)) return [];
   switch (tier) {
     case "off":
       return [...allTools];
@@ -35,6 +36,8 @@ function selectBuiltinToolsForTier(tier, allTools) {
       const tier1Names = toolNameSet(TIER1_TOOLS);
       return allTools.filter((tool) => tier1Names.has(tool.name));
     }
+    default:
+      return [...allTools];
   }
 }
 function registerBuiltinToolTier(options) {
@@ -51,4 +54,4 @@ export {
   selectBuiltinToolsForTier,
   registerBuiltinToolTier
 };
-//# sourceMappingURL=chunk-GMZYW52L.js.map
+//# sourceMappingURL=chunk-YULVUTK5.js.map

package/dist/{chunk-NWZ6XGBJ.js → chunk-ZBMANLYH.js}

@@ -1,8 +1,10 @@
 // src/_concurrency.ts
 async function mapWithConcurrency(items, limit, fn) {
-  if (items.length === 0) return [];
+  if (!Array.isArray(items) || items.length === 0) return [];
+  if (typeof fn !== "function") return [];
   if (items.length === 1) return [await fn(items[0])];
-  const effectiveLimit = Math.max(1, Math.min(limit | 0, items.length));
+  const parsedLimit = Number.isFinite(limit) ? Math.floor(limit) : items.length;
+  const effectiveLimit = Math.max(1, Math.min(parsedLimit, items.length));
   const results = new Array(items.length);
   let nextIndex = 0;
   const worker = async () => {
@@ -19,4 +21,4 @@ async function mapWithConcurrency(items, limit, fn) {
 export {
   mapWithConcurrency
 };
-//# sourceMappingURL=chunk-NWZ6XGBJ.js.map
+//# sourceMappingURL=chunk-ZBMANLYH.js.map

package/dist/{chunk-DP6CXMJZ.js → chunk-ZTCJCYLN.js}

@@ -9,7 +9,7 @@ import {
   projectIndexServerBuildId,
   projectIndexServerEndpoint,
   projectIndexServerMetadataPath
-} from "./chunk-UDVKRX5R.js";
+} from "./chunk-GDDXX27P.js";
 import {
   CircuitOpenError,
   IndexTimeoutError,
@@ -24,7 +24,7 @@ import {
   searchService,
   statsService,
   symbolGraphService
-} from "./chunk-KY4PXYSO.js";
+} from "./chunk-N3K2SFEI.js";
 import {
   isIndexablePath
 } from "./chunk-YOHO4DVT.js";
@@ -1269,4 +1269,4 @@ export {
   checkCodebaseIndexServerHealth,
   ensureCodebaseIndexServer
 };
-//# sourceMappingURL=chunk-DP6CXMJZ.js.map
+//# sourceMappingURL=chunk-ZTCJCYLN.js.map

package/dist/circuit-breaker.d.ts

@@ -47,6 +47,7 @@ export interface CircuitBreakerConfig {
      */
     cooldownMs?: number | undefined;
 }
+export type BreakerState = 'closed' | 'open' | 'half-open';
 export interface CircuitBreakerSnapshot {
     state: 'closed' | 'open' | 'half-open';
     consecutiveFailures: number;