@morphllm/morphsdk 0.2.55 → 0.2.57

package/dist/tools/warp_grep/harness.cjs

@@ -0,0 +1,859 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// tools/warp_grep/harness.ts
+var harness_exports = {};
+__export(harness_exports, {
+  DEFAULT_EXCLUDES: () => DEFAULT_EXCLUDES,
+  LocalRipgrepProvider: () => LocalRipgrepProvider,
+  MAX_TURNS: () => MAX_TURNS,
+  SYSTEM_PROMPT: () => SYSTEM_PROMPT,
+  TIMEOUT_MS: () => TIMEOUT_MS,
+  formatAnalyseTree: () => formatAnalyseTree,
+  formatToolResult: () => formatToolResult,
+  formatTurnMessage: () => formatTurnMessage,
+  parseToolCalls: () => parseToolCalls,
+  resolveFinishFiles: () => resolveFinishFiles
+});
+module.exports = __toCommonJS(harness_exports);
+
+// tools/warp_grep/agent/parser.ts
+var VALID_COMMANDS = ["analyse", "grep", "read", "finish"];
+function preprocessText(text) {
+  let processed = text.replace(/<think>[\s\S]*?<\/think>/gi, "");
+  const openingTagRegex = /<tool_call>|<tool>/gi;
+  const closingTagRegex = /<\/tool_call>|<\/tool>/gi;
+  const openingMatches = processed.match(openingTagRegex) || [];
+  const closingMatches = processed.match(closingTagRegex) || [];
+  if (openingMatches.length > closingMatches.length) {
+    const lastClosingMatch = /<\/tool_call>|<\/tool>/gi;
+    let lastClosingIndex = -1;
+    let match;
+    while ((match = lastClosingMatch.exec(processed)) !== null) {
+      lastClosingIndex = match.index + match[0].length;
+    }
+    if (lastClosingIndex > 0) {
+      processed = processed.slice(0, lastClosingIndex);
+    }
+  }
+  const toolCallLines = [];
+  const toolTagRegex = /<tool_call>([\s\S]*?)<\/tool_call>|<tool>([\s\S]*?)<\/tool>/gi;
+  let tagMatch;
+  while ((tagMatch = toolTagRegex.exec(processed)) !== null) {
+    const content = (tagMatch[1] || tagMatch[2] || "").trim();
+    if (content) {
+      const lines = content.split(/\r?\n/).map((l) => l.trim()).filter((l) => l);
+      toolCallLines.push(...lines);
+    }
+  }
+  const allLines = processed.split(/\r?\n/).map((l) => l.trim());
+  for (const line of allLines) {
+    if (!line) continue;
+    if (line.startsWith("<")) continue;
+    const firstWord = line.split(/\s/)[0];
+    if (VALID_COMMANDS.includes(firstWord)) {
+      if (!toolCallLines.includes(line)) {
+        toolCallLines.push(line);
+      }
+    }
+  }
+  return toolCallLines;
+}
+var LLMResponseParser = class {
+  finishSpecSplitRe = /,(?=[^,\s]+:)/;
+  parse(text) {
+    if (typeof text !== "string") {
+      throw new TypeError("Command text must be a string.");
+    }
+    const lines = preprocessText(text);
+    const commands = [];
+    let finishAccumulator = null;
+    lines.forEach((line) => {
+      if (!line || line.startsWith("#")) return;
+      const parts = this.splitLine(line);
+      if (parts.length === 0) return;
+      const cmd = parts[0];
+      switch (cmd) {
+        case "analyse":
+          this.handleAnalyse(parts, line, commands);
+          break;
+        case "grep":
+          this.handleGrep(parts, line, commands);
+          break;
+        case "read":
+          this.handleRead(parts, line, commands);
+          break;
+        case "finish":
+          finishAccumulator = this.handleFinish(parts, line, commands, finishAccumulator);
+          break;
+        default:
+          break;
+      }
+    });
+    if (finishAccumulator) {
+      const map = finishAccumulator;
+      const entries = [...map.entries()];
+      const filesPayload = entries.map(([path3, ranges]) => ({
+        path: path3,
+        lines: [...ranges].sort((a, b) => a[0] - b[0])
+      }));
+      commands.push({ name: "finish", arguments: { files: filesPayload } });
+    }
+    return commands;
+  }
+  splitLine(line) {
+    const parts = [];
+    let current = "";
+    let inSingle = false;
+    for (let i = 0; i < line.length; i++) {
+      const ch = line[i];
+      if (ch === "'" && line[i - 1] !== "\\") {
+        inSingle = !inSingle;
+        current += ch;
+      } else if (!inSingle && /\s/.test(ch)) {
+        if (current) {
+          parts.push(current);
+          current = "";
+        }
+      } else {
+        current += ch;
+      }
+    }
+    if (current) parts.push(current);
+    return parts;
+  }
+  /** Helper to create a _skip tool call with an error message */
+  skip(message) {
+    return { name: "_skip", arguments: { message } };
+  }
+  handleAnalyse(parts, rawLine, commands) {
+    if (parts.length < 2) {
+      commands.push(this.skip(
+        `[SKIPPED] Your command "${rawLine}" is missing a path. Correct format: analyse <path> [pattern]. Example: analyse src/`
+      ));
+      return;
+    }
+    const path3 = parts[1];
+    const pattern = parts[2]?.replace(/^"|"$/g, "") ?? null;
+    commands.push({ name: "analyse", arguments: { path: path3, pattern } });
+  }
+  // no glob tool in MCP
+  handleGrep(parts, rawLine, commands) {
+    if (parts.length < 3) {
+      commands.push(this.skip(
+        `[SKIPPED] Your command "${rawLine}" is missing arguments. Correct format: grep '<pattern>' <path>. Example: grep 'TODO' src/`
+      ));
+      return;
+    }
+    let pat = parts[1];
+    if (pat.startsWith("'") && pat.endsWith("'")) {
+      pat = pat.slice(1, -1);
+    }
+    if (!pat) {
+      commands.push(this.skip(
+        `[SKIPPED] Your command "${rawLine}" has an empty pattern. Provide a non-empty search pattern. Example: grep 'function' src/`
+      ));
+      return;
+    }
+    commands.push({ name: "grep", arguments: { pattern: pat, path: parts[2] } });
+  }
+  handleRead(parts, rawLine, commands) {
+    if (parts.length < 2) {
+      commands.push(this.skip(
+        `[SKIPPED] Your command "${rawLine}" is missing a path. Correct format: read <path> or read <path>:<start>-<end>. Example: read src/index.ts:1-50`
+      ));
+      return;
+    }
+    const spec = parts[1];
+    const rangeIdx = spec.indexOf(":");
+    if (rangeIdx === -1) {
+      commands.push({ name: "read", arguments: { path: spec } });
+      return;
+    }
+    const filePath = spec.slice(0, rangeIdx);
+    const range = spec.slice(rangeIdx + 1);
+    const [s, e] = range.split("-").map((v) => parseInt(v, 10));
+    if (!Number.isFinite(s) || !Number.isFinite(e)) {
+      commands.push({ name: "read", arguments: { path: filePath } });
+      return;
+    }
+    commands.push({ name: "read", arguments: { path: filePath, start: s, end: e } });
+  }
+  handleFinish(parts, rawLine, commands, acc) {
+    const map = acc ?? /* @__PURE__ */ new Map();
+    const args = parts.slice(1);
+    for (const token of args) {
+      const [filePath, rangesText] = token.split(":", 2);
+      if (!filePath || !rangesText) {
+        commands.push(this.skip(
+          `[SKIPPED] Invalid finish token "${token}". Correct format: finish <path>:<start>-<end>. Example: finish src/index.ts:1-50`
+        ));
+        continue;
+      }
+      const rangeSpecs = rangesText.split(",").filter(Boolean);
+      for (const spec of rangeSpecs) {
+        const [s, e] = spec.split("-").map((v) => parseInt(v, 10));
+        if (!Number.isFinite(s) || !Number.isFinite(e) || e < s) {
+          commands.push(this.skip(
+            `[SKIPPED] Invalid range "${spec}" in "${token}". Ranges must be <start>-<end> where start <= end. Example: 1-50`
+          ));
+          continue;
+        }
+        const arr = map.get(filePath) ?? [];
+        arr.push([s, e]);
+        map.set(filePath, arr);
+      }
+    }
+    return map;
+  }
+};
+
+// tools/warp_grep/agent/formatter.ts
+var ToolOutputFormatter = class {
+  format(toolName, args, output, options = {}) {
+    const name = (toolName ?? "").trim();
+    if (!name) {
+      return "";
+    }
+    const payload = output?.toString?.()?.trim?.() ?? "";
+    const isError = Boolean(options.isError);
+    const safeArgs = args ?? {};
+    if (!payload && !isError) {
+      return "";
+    }
+    switch (name) {
+      case "read":
+        return this.formatRead(safeArgs, payload, isError);
+      case "analyse":
+        return this.formatAnalyse(safeArgs, payload, isError);
+      case "grep":
+        return this.formatGrep(safeArgs, payload, isError);
+      default:
+        return payload ? `<tool_output>
+${payload}
+</tool_output>` : "";
+    }
+  }
+  formatRead(args, payload, isError) {
+    if (isError) {
+      return payload;
+    }
+    const path3 = this.asString(args.path) || "...";
+    return `<file path="${path3}">
+${payload}
+</file>`;
+  }
+  formatAnalyse(args, payload, isError) {
+    const path3 = this.asString(args.path) || ".";
+    if (isError) {
+      return `<analyse_results path="${path3}" status="error">
+${payload}
+</analyse_results>`;
+    }
+    return `<analyse_results path="${path3}">
+${payload}
+</analyse_results>`;
+  }
+  formatGrep(args, payload, isError) {
+    const pattern = this.asString(args.pattern);
+    const path3 = this.asString(args.path);
+    const attributes = [];
+    if (pattern !== void 0) {
+      attributes.push(`pattern="${pattern}"`);
+    }
+    if (path3 !== void 0) {
+      attributes.push(`path="${path3}"`);
+    }
+    if (isError) {
+      attributes.push('status="error"');
+    }
+    const attrText = attributes.length ? ` ${attributes.join(" ")}` : "";
+    return `<grep_output${attrText}>
+${payload}
+</grep_output>`;
+  }
+  asString(value) {
+    if (value === null || value === void 0) {
+      return void 0;
+    }
+    return String(value);
+  }
+};
+var sharedFormatter = new ToolOutputFormatter();
+function formatAgentToolOutput(toolName, args, output, options = {}) {
+  return sharedFormatter.format(toolName, args, output, options);
+}
+
+// tools/warp_grep/agent/prompt.ts
+var SYSTEM_PROMPT = `You are a code search agent. Your task is to find all relevant code for a given query.
+
+<workflow>
+You have exactly 4 turns. The 4th turn MUST be a \`finish\` call. Each turn allows up to 8 parallel tool calls.
+
+- Turn 1: Map the territory OR dive deep (based on query specificity)
+- Turn 2-3: Refine based on findings
+- Turn 4: MUST call \`finish\` with all relevant code locations
+- You MAY call \`finish\` early if confident\u2014but never before at least 1 search turn.
+
+Remember, if the task feels easy to you, it is strongly desirable to call \`finish\` early using fewer turns, but quality over speed.
+</workflow>
+
+<tools>
+### \`analyse <path> [pattern]\`
+Directory tree or file search. Shows structure of a path, optionally filtered by regex pattern.
+- \`path\`: Required. Directory or file path (use \`.\` for repo root)
+- \`pattern\`: Optional regex to filter results
+
+Examples:
+\`\`\`
+analyse .
+analyse src/api
+analyse . ".*\\.ts$"
+analyse src "test.*"
+\`\`\`
+
+### \`read <path>[:start-end]\`
+Read file contents. Line range is 1-based, inclusive.
+- Returns numbered lines for easy reference
+- Omit range to read entire file
+
+Examples:
+\`\`\`
+read src/main.py
+read src/db/conn.py:10-50
+read package.json:1-20
+\`\`\`
+
+### \`grep '<pattern>' <path>\`
+Ripgrep search. Finds pattern matches across files.
+- \`'<pattern>'\`: Required. Regex pattern wrapped in single quotes
+- \`<path>\`: Required. Directory or file to search (use \`.\` for repo root)
+
+Examples:
+\`\`\`
+grep 'class.*Service' src/
+grep 'def authenticate' .
+grep 'import.*from' src/components/
+grep 'TODO' .
+\`\`\`
+
+### \`finish <file1:ranges> [file2:ranges ...]\`
+Submit final answer with all relevant code locations.
+- Include generous line ranges\u2014don't be stingy with context
+- Ranges are comma-separated: \`file.py:10-30,50-60\`
+- ALWAYS include import statements at the top of files (usually lines 1-20)
+- If code spans multiple files, include ALL of them
+- Small files can be returned in full
+
+Examples:
+\`\`\`
+finish src/auth.py:1-15,25-50,75-80 src/models/user.py:1-10,20-45
+finish src/index.ts:1-100
+\`\`\`
+</tools>
+
+<strategy>
+**Before your first tool call, classify the query:**
+
+| Query Type | Turn 1 Strategy | Early Finish? |
+|------------|-----------------|---------------|
+| **Specific** (function name, error string, unique identifier) | 8 parallel greps on likely paths | Often by turn 2 |
+| **Conceptual** (how does X work, where is Y handled) | analyse + 2-3 broad greps | Rarely early |
+| **Exploratory** (find all tests, list API endpoints) | analyse at multiple depths | Usually needs 3 turns |
+
+**Parallel call patterns:**
+- **Shotgun grep**: Same pattern, 8 different directories\u2014fast coverage
+- **Variant grep**: 8 pattern variations (synonyms, naming conventions)\u2014catches inconsistent codebases
+- **Funnel**: 1 analyse + 7 greps\u2014orient and search simultaneously
+- **Deep read**: 8 reads on files you already identified\u2014gather full context fast
+</strategy>
+
+<output_format>
+EVERY response MUST follow this exact format:
+
+1. First, wrap your reasoning in \`<think>...</think>\` tags containing:
+   - Query classification (specific/conceptual/exploratory)
+   - Confidence estimate (can I finish in 1-2 turns?)
+   - This turn's parallel strategy
+   - What signals would let me finish early?
+
+2. Then, output tool calls wrapped in \`<tool_call>...</tool_call>\` tags, one per line.
+
+Example:
+\`\`\`
+<think>
+This is a specific query about authentication. I'll grep for auth-related patterns.
+High confidence I can finish in 2 turns if I find the auth module.
+Strategy: Shotgun grep across likely directories.
+</think>
+<tool_call>grep 'authenticate' src/</tool_call>
+<tool_call>grep 'login' src/</tool_call>
+<tool_call>analyse src/auth</tool_call>
+\`\`\`
+
+No commentary outside \`<think>\`. No explanations after tool calls.
+</output_format>
+
+<finishing_requirements>
+When calling \`finish\`:
+- Include the import section (typically lines 1-20) of each file
+- Include all function/class definitions that are relevant
+- Include any type definitions, interfaces, or constants used
+- Better to over-include than leave the user missing context
+- If unsure about boundaries, include more rather than less
+</finishing_requirements>
+
+Begin your exploration now to find code relevant to the query.`;
+
+// tools/warp_grep/agent/config.ts
+var AGENT_CONFIG = {
+  // Give the model freedom; failsafe cap to prevent infinite loops
+  MAX_ROUNDS: 10,
+  TIMEOUT_MS: 3e4
+};
+var BUILTIN_EXCLUDES = [
+  // Version control
+  ".git",
+  ".svn",
+  ".hg",
+  ".bzr",
+  // Dependencies
+  "node_modules",
+  "bower_components",
+  ".pnpm",
+  ".yarn",
+  "vendor",
+  "packages",
+  "Pods",
+  ".bundle",
+  // Python
+  "__pycache__",
+  ".pytest_cache",
+  ".mypy_cache",
+  ".ruff_cache",
+  ".venv",
+  "venv",
+  ".tox",
+  ".nox",
+  ".eggs",
+  "*.egg-info",
+  // Build outputs
+  "dist",
+  "build",
+  "out",
+  "output",
+  "target",
+  "_build",
+  ".next",
+  ".nuxt",
+  ".output",
+  ".vercel",
+  ".netlify",
+  // Cache directories
+  ".cache",
+  ".parcel-cache",
+  ".turbo",
+  ".nx",
+  ".gradle",
+  // IDE/Editor
+  ".idea",
+  ".vscode",
+  ".vs",
+  // Coverage
+  "coverage",
+  ".coverage",
+  "htmlcov",
+  ".nyc_output",
+  // Temporary
+  "tmp",
+  "temp",
+  ".tmp",
+  ".temp",
+  // Lock files
+  "package-lock.json",
+  "yarn.lock",
+  "pnpm-lock.yaml",
+  "bun.lockb",
+  "Cargo.lock",
+  "Gemfile.lock",
+  "poetry.lock",
+  // Binary/minified
+  "*.min.js",
+  "*.min.css",
+  "*.bundle.js",
+  "*.wasm",
+  "*.so",
+  "*.dll",
+  "*.pyc",
+  "*.map",
+  "*.js.map",
+  // Hidden directories catch-all
+  ".*"
+];
+var DEFAULT_EXCLUDES = (process.env.MORPH_WARP_GREP_EXCLUDE || "").split(",").map((s) => s.trim()).filter(Boolean).concat(BUILTIN_EXCLUDES);
+
+// tools/warp_grep/tools/finish.ts
+async function readFinishFiles(repoRoot, files, reader) {
+  const out = [];
+  for (const f of files) {
+    const ranges = mergeRanges(f.lines);
+    const chunks = [];
+    for (const [s, e] of ranges) {
+      const lines = await reader(f.path, s, e);
+      chunks.push(lines.join("\n"));
+    }
+    out.push({ path: f.path, ranges, content: chunks.join("\n") });
+  }
+  return out;
+}
+function mergeRanges(ranges) {
+  if (!ranges.length) return [];
+  const sorted = [...ranges].sort((a, b) => a[0] - b[0]);
+  const merged = [];
+  let [cs, ce] = sorted[0];
+  for (let i = 1; i < sorted.length; i++) {
+    const [s, e] = sorted[i];
+    if (s <= ce + 1) {
+      ce = Math.max(ce, e);
+    } else {
+      merged.push([cs, ce]);
+      cs = s;
+      ce = e;
+    }
+  }
+  merged.push([cs, ce]);
+  return merged;
+}
+
+// tools/warp_grep/providers/local.ts
+var import_promises2 = __toESM(require("fs/promises"), 1);
+var import_path2 = __toESM(require("path"), 1);
+
+// tools/warp_grep/utils/ripgrep.ts
+var import_child_process = require("child_process");
+var import_ripgrep = require("@vscode/ripgrep");
+var resolvedRgPath = null;
+var rgPathChecked = false;
+function spawnRg(rgBinary, args, opts) {
+  return new Promise((resolve) => {
+    const child = (0, import_child_process.spawn)(rgBinary, args, {
+      cwd: opts?.cwd,
+      env: { ...process.env, ...opts?.env || {} },
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.on("data", (d) => stdout += d.toString());
+    child.stderr.on("data", (d) => stderr += d.toString());
+    child.on("close", (code) => {
+      resolve({ stdout, stderr, exitCode: typeof code === "number" ? code : -1 });
+    });
+    child.on("error", () => {
+      resolve({ stdout: "", stderr: "Failed to spawn ripgrep.", exitCode: -1 });
+    });
+  });
+}
+function isBinaryFailure(result) {
+  if (result.exitCode === -1) return true;
+  if (result.stderr.includes("jemalloc") || result.stderr.includes("Unsupported system page size")) return true;
+  if (result.exitCode === 134) return true;
+  return false;
+}
+async function runRipgrep(args, opts) {
+  if (rgPathChecked && resolvedRgPath) {
+    return spawnRg(resolvedRgPath, args, opts);
+  }
+  if (!rgPathChecked) {
+    const result = await spawnRg(import_ripgrep.rgPath, args, opts);
+    if (!isBinaryFailure(result)) {
+      resolvedRgPath = import_ripgrep.rgPath;
+      rgPathChecked = true;
+      return result;
+    }
+    const fallbackResult = await spawnRg("rg", args, opts);
+    if (!isBinaryFailure(fallbackResult)) {
+      resolvedRgPath = "rg";
+      rgPathChecked = true;
+      return fallbackResult;
+    }
+    rgPathChecked = true;
+    return {
+      stdout: "",
+      stderr: "Failed to spawn ripgrep. Neither bundled nor system rg is available.",
+      exitCode: -1
+    };
+  }
+  return {
+    stdout: "",
+    stderr: "Failed to spawn ripgrep. Neither bundled nor system rg is available.",
+    exitCode: -1
+  };
+}
+
+// tools/warp_grep/utils/paths.ts
+var import_fs = __toESM(require("fs"), 1);
+var import_path = __toESM(require("path"), 1);
+function resolveUnderRepo(repoRoot, targetPath) {
+  const absRoot = import_path.default.resolve(repoRoot);
+  const resolved = import_path.default.resolve(absRoot, targetPath);
+  ensureWithinRepo(absRoot, resolved);
+  return resolved;
+}
+function ensureWithinRepo(repoRoot, absTarget) {
+  const rel = import_path.default.relative(import_path.default.resolve(repoRoot), import_path.default.resolve(absTarget));
+  if (rel.startsWith("..") || import_path.default.isAbsolute(rel)) {
+    throw new Error(`Path outside repository root: ${absTarget}`);
+  }
+}
+function toRepoRelative(repoRoot, absPath) {
+  return import_path.default.relative(import_path.default.resolve(repoRoot), import_path.default.resolve(absPath));
+}
+function isSymlink(p) {
+  try {
+    const st = import_fs.default.lstatSync(p);
+    return st.isSymbolicLink();
+  } catch {
+    return false;
+  }
+}
+function isTextualFile(filePath, maxBytes = 2e6) {
+  try {
+    const st = import_fs.default.statSync(filePath);
+    if (!st.isFile()) return false;
+    if (st.size > maxBytes) return false;
+    const fd = import_fs.default.openSync(filePath, "r");
+    const buf = Buffer.alloc(512);
+    const read = import_fs.default.readSync(fd, buf, 0, buf.length, 0);
+    import_fs.default.closeSync(fd);
+    for (let i = 0; i < read; i++) {
+      const c = buf[i];
+      if (c === 0) return false;
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// tools/warp_grep/utils/files.ts
+var import_promises = __toESM(require("fs/promises"), 1);
+async function readAllLines(filePath) {
+  const content = await import_promises.default.readFile(filePath, "utf8");
+  return content.split(/\r?\n/);
+}
+
+// tools/warp_grep/providers/local.ts
+var LocalRipgrepProvider = class {
+  constructor(repoRoot, excludes = DEFAULT_EXCLUDES) {
+    this.repoRoot = repoRoot;
+    this.excludes = excludes;
+  }
+  async grep(params) {
+    const abs = resolveUnderRepo(this.repoRoot, params.path);
+    const stat = await import_promises2.default.stat(abs).catch(() => null);
+    if (!stat) return { lines: [] };
+    const targetArg = abs === import_path2.default.resolve(this.repoRoot) ? "." : toRepoRelative(this.repoRoot, abs);
+    const args = [
+      "--no-config",
+      "--no-heading",
+      "--with-filename",
+      "--line-number",
+      "--color=never",
+      "--trim",
+      "--max-columns=400",
+      ...this.excludes.flatMap((e) => ["-g", `!${e}`]),
+      params.pattern,
+      targetArg || "."
+    ];
+    const res = await runRipgrep(args, { cwd: this.repoRoot });
+    if (res.exitCode === -1) {
+      return {
+        lines: [],
+        error: `[RIPGREP NOT AVAILABLE] ripgrep (rg) is required but failed to execute. Please install it:
+  \u2022 macOS: brew install ripgrep
+  \u2022 Ubuntu/Debian: apt install ripgrep
+  \u2022 Windows: choco install ripgrep
+  \u2022 Or visit: https://github.com/BurntSushi/ripgrep#installation
+Exit code: ${res.exitCode}${res.stderr ? `
+Details: ${res.stderr}` : ""}`
+      };
+    }
+    if (res.exitCode !== 0 && res.exitCode !== 1) {
+      return {
+        lines: [],
+        error: `[RIPGREP ERROR] grep failed with exit code ${res.exitCode}${res.stderr ? `: ${res.stderr}` : ""}`
+      };
+    }
+    const lines = (res.stdout || "").trim().split(/\r?\n/).filter((l) => l.length > 0);
+    return { lines };
+  }
+  async glob(params) {
+    const abs = resolveUnderRepo(this.repoRoot, params.path);
+    const targetArg = abs === import_path2.default.resolve(this.repoRoot) ? "." : toRepoRelative(this.repoRoot, abs);
+    const args = [
+      "--no-config",
+      "--files",
+      "-g",
+      params.pattern,
+      ...this.excludes.flatMap((e) => ["-g", `!${e}`]),
+      targetArg || "."
+    ];
+    const res = await runRipgrep(args, { cwd: this.repoRoot });
+    if (res.exitCode === -1) {
+      console.warn(`[warp_grep] ripgrep not available for glob: ${res.stderr || "execution failed"}`);
+      return { files: [] };
+    }
+    const files = (res.stdout || "").trim().split(/\r?\n/).filter((l) => l.length > 0);
+    return { files };
+  }
+  async read(params) {
+    const abs = resolveUnderRepo(this.repoRoot, params.path);
+    const stat = await import_promises2.default.stat(abs).catch(() => null);
+    if (!stat || !stat.isFile()) {
+      return {
+        lines: [],
+        error: `[FILE NOT FOUND] You tried to read "${params.path}" but there is no file at this path. Double-check the path exists and is spelled correctly.`
+      };
+    }
+    if (isSymlink(abs)) {
+      return {
+        lines: [],
+        error: `[SYMLINK] You tried to read "${params.path}" but this is a symlink. Try reading the actual file it points to instead.`
+      };
+    }
+    if (!isTextualFile(abs)) {
+      return {
+        lines: [],
+        error: `[UNREADABLE FILE] You tried to read "${params.path}" but this file is either too large or not a text file, so it cannot be read. Try a different file.`
+      };
+    }
+    const lines = await readAllLines(abs);
+    const total = lines.length;
+    let s = params.start ?? 1;
+    let e = Math.min(params.end ?? total, total);
+    if (s > total && total > 0) {
+      s = 1;
+      e = total;
+    }
+    const out = [];
+    for (let i = s; i <= e; i += 1) {
+      const content = lines[i - 1] ?? "";
+      out.push(`${i}|${content}`);
+    }
+    return { lines: out };
+  }
+  async analyse(params) {
+    const abs = resolveUnderRepo(this.repoRoot, params.path);
+    const stat = await import_promises2.default.stat(abs).catch(() => null);
+    if (!stat || !stat.isDirectory()) {
+      return [];
+    }
+    const maxResults = params.maxResults ?? 100;
+    const maxDepth = params.maxDepth ?? 2;
+    const regex = params.pattern ? new RegExp(params.pattern) : null;
+    const results = [];
+    async function walk(dir, depth) {
+      if (depth > maxDepth || results.length >= maxResults) return;
+      const entries = await import_promises2.default.readdir(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        const full = import_path2.default.join(dir, entry.name);
+        const rel = toRepoRelative(abs, full).replace(/^[.][/\\]?/, "");
+        if (DEFAULT_EXCLUDES.some((ex) => rel.split(import_path2.default.sep).includes(ex))) continue;
+        if (regex && !regex.test(entry.name)) continue;
+        if (results.length >= maxResults) break;
+        results.push({
+          name: entry.name,
+          path: toRepoRelative(import_path2.default.resolve(""), full),
+          // relative display
+          type: entry.isDirectory() ? "dir" : "file",
+          depth
+        });
+        if (entry.isDirectory()) {
+          await walk(full, depth + 1);
+        }
+      }
+    }
+    await walk(abs, 0);
+    return results;
+  }
+};
+
+// tools/warp_grep/harness.ts
+var parser = new LLMResponseParser();
+function parseToolCalls(text) {
+  return parser.parse(text);
+}
+function formatToolResult(name, args, output, options) {
+  return formatAgentToolOutput(name, args, output, options ?? {});
+}
+function formatTurnMessage(turn, maxTurns = 4) {
+  const remaining = maxTurns - turn;
+  if (remaining === 0) {
+    return `
+
+[Turn ${turn}/${maxTurns}] This is your LAST turn. You MUST call finish now.`;
+  }
+  if (remaining === 1) {
+    return `
+
+[Turn ${turn}/${maxTurns}] You have 1 turn remaining.`;
+  }
+  return `
+
+[Turn ${turn}/${maxTurns}] You have ${remaining} turns remaining.`;
+}
+function formatAnalyseTree(entries) {
+  if (!entries.length) return "empty";
+  return entries.map((e) => `${"  ".repeat(e.depth)}- ${e.type === "dir" ? "[D]" : "[F]"} ${e.name}`).join("\n");
+}
+async function resolveFinishFiles(provider, files) {
+  return readFinishFiles("", files, async (p, s, e) => {
+    const r = await provider.read({ path: p, start: s, end: e });
+    return r.lines.map((l) => {
+      const idx = l.indexOf("|");
+      return idx >= 0 ? l.slice(idx + 1) : l;
+    });
+  });
+}
+var MAX_TURNS = 4;
+var TIMEOUT_MS = AGENT_CONFIG.TIMEOUT_MS;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_EXCLUDES,
+  LocalRipgrepProvider,
+  MAX_TURNS,
+  SYSTEM_PROMPT,
+  TIMEOUT_MS,
+  formatAnalyseTree,
+  formatToolResult,
+  formatTurnMessage,
+  parseToolCalls,
+  resolveFinishFiles
+});
+//# sourceMappingURL=harness.cjs.map