codebase-cli 2.0.0-pre.0

package/dist/tools/git/status.js

@@ -0,0 +1,97 @@
+import { Type } from "typebox";
+import { requireGitRepo, runGit } from "./git-helpers.js";
+const Params = Type.Object({});
+const DESCRIPTION = `Show the working tree status: current branch, upstream tracking, ahead/behind counts, and the list of staged/unstaged/untracked files.
+
+Output mirrors \`git status --short --branch\`. Two-character prefix per file: first column = staged change (M/A/D/R/?), second = unstaged change. ?? means untracked.`;
+export function createGitStatus(ctx) {
+    return {
+        name: "git_status",
+        label: "Git status",
+        description: DESCRIPTION,
+        parameters: Params,
+        executionMode: "parallel",
+        execute: async (_id, _params, signal) => {
+            await requireGitRepo(ctx.cwd);
+            const r = await runGit(["status", "--short", "--branch"], ctx.cwd, signal);
+            if (r.exitCode !== 0) {
+                throw new Error(r.stderr.trim() || `git status exited ${r.exitCode}`);
+            }
+            const lines = r.stdout.split("\n").filter(Boolean);
+            let branch = null;
+            let upstream = null;
+            let ahead = 0;
+            let behind = 0;
+            const entries = [];
+            for (const line of lines) {
+                if (line.startsWith("##")) {
+                    const parsed = parseBranchLine(line);
+                    branch = parsed.branch;
+                    upstream = parsed.upstream;
+                    ahead = parsed.ahead;
+                    behind = parsed.behind;
+                }
+                else if (line.length >= 3) {
+                    entries.push({
+                        staged: line[0],
+                        unstaged: line[1],
+                        path: line.slice(3).trim(),
+                    });
+                }
+            }
+            const clean = entries.length === 0;
+            const summary = formatSummary(branch, upstream, ahead, behind, entries, clean);
+            return {
+                content: [{ type: "text", text: summary }],
+                details: { branch, upstream, ahead, behind, clean, entries },
+            };
+        },
+    };
+}
+function parseBranchLine(line) {
+    // Examples:
+    //   ## main
+    //   ## main...origin/main
+    //   ## main...origin/main [ahead 2, behind 1]
+    //   ## HEAD (no branch)
+    const body = line.slice(2).trim();
+    if (body.startsWith("HEAD")) {
+        return { branch: null, upstream: null, ahead: 0, behind: 0 };
+    }
+    const bracketIdx = body.indexOf("[");
+    const head = (bracketIdx === -1 ? body : body.slice(0, bracketIdx)).trim();
+    const [branch, upstream = null] = head.split("...");
+    let ahead = 0;
+    let behind = 0;
+    if (bracketIdx !== -1) {
+        const inner = body.slice(bracketIdx + 1, body.lastIndexOf("]"));
+        const aheadMatch = inner.match(/ahead (\d+)/);
+        const behindMatch = inner.match(/behind (\d+)/);
+        if (aheadMatch)
+            ahead = Number.parseInt(aheadMatch[1], 10);
+        if (behindMatch)
+            behind = Number.parseInt(behindMatch[1], 10);
+    }
+    return { branch: branch || null, upstream, ahead, behind };
+}
+function formatSummary(branch, upstream, ahead, behind, entries, clean) {
+    const lines = [];
+    if (branch) {
+        const tracking = upstream ? ` → ${upstream}` : "";
+        const drift = ahead || behind ? ` [ahead ${ahead}, behind ${behind}]` : "";
+        lines.push(`On ${branch}${tracking}${drift}`);
+    }
+    else {
+        lines.push("Detached HEAD");
+    }
+    if (clean) {
+        lines.push("Working tree clean.");
+    }
+    else {
+        for (const e of entries) {
+            lines.push(`  ${e.staged}${e.unstaged} ${e.path}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=status.js.map

package/dist/tools/git/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/tools/git/status.ts"],"names":[],"mappings":"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"}

package/dist/tools/git/worktree.js

@@ -0,0 +1,132 @@
+import { randomBytes } from "node:crypto";
+import { join, resolve } from "node:path";
+import { Type } from "typebox";
+import { requireGitRepo, runGit } from "./git-helpers.js";
+const NAME_PATTERN = /^[a-zA-Z0-9._-]{1,64}$/;
+// ─── enter_worktree ──────────────────────────────────────────
+const EnterParams = Type.Object({
+    name: Type.Optional(Type.String({
+        description: "Worktree name (used as the branch suffix). Letters, digits, ., _, - only; max 64 chars. Auto-generated if omitted.",
+    })),
+});
+const ENTER_DESCRIPTION = `Create an isolated git worktree at .worktrees/<name> on a new branch worktree/<name>.
+
+Use this when you want to work on a separate branch in parallel without disturbing the main checkout (e.g., a long-running refactor while reviews land on main).
+
+The new worktree is a full checkout at the current HEAD with its own working tree. After this call returns, point a new codebase session at the printed path to start working there. The agent's current cwd does not move automatically.`;
+export function createEnterWorktree(ctx) {
+    return {
+        name: "enter_worktree",
+        label: "Enter worktree",
+        description: ENTER_DESCRIPTION,
+        parameters: EnterParams,
+        executionMode: "sequential",
+        execute: async (_id, params, signal) => {
+            await requireGitRepo(ctx.cwd);
+            await assertNotInWorktree(ctx.cwd, signal);
+            const name = params.name?.trim() || `wt-${randomBytes(4).toString("hex")}`;
+            if (!NAME_PATTERN.test(name)) {
+                throw new Error("name must contain only letters, digits, dots, underscores, dashes (max 64 chars).");
+            }
+            const root = await readGitRoot(ctx.cwd, signal);
+            const worktreePath = join(root, ".worktrees", name);
+            const branch = `worktree/${name}`;
+            const r = await runGit(["worktree", "add", "-b", branch, worktreePath], root, signal);
+            if (r.exitCode !== 0) {
+                throw new Error(r.stderr.trim() || `git worktree add exited ${r.exitCode}`);
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Created worktree at ${worktreePath} (branch: ${branch}).\n` +
+                            "To use it, run codebase from that directory.",
+                    },
+                ],
+                details: { name, path: resolve(worktreePath), branch },
+            };
+        },
+    };
+}
+async function assertNotInWorktree(cwd, signal) {
+    const common = await runGit(["rev-parse", "--git-common-dir"], cwd, signal);
+    const own = await runGit(["rev-parse", "--git-dir"], cwd, signal);
+    if (common.exitCode !== 0 || own.exitCode !== 0)
+        return;
+    const a = resolveGitDir(common.stdout.trim(), cwd);
+    const b = resolveGitDir(own.stdout.trim(), cwd);
+    if (a !== b) {
+        throw new Error("Already in a worktree. Run exit_worktree first if you want to leave it.");
+    }
+}
+function resolveGitDir(value, cwd) {
+    if (!value)
+        return value;
+    return value.startsWith("/") ? value : resolve(cwd, value);
+}
+async function readGitRoot(cwd, signal) {
+    const r = await runGit(["rev-parse", "--show-toplevel"], cwd, signal);
+    if (r.exitCode !== 0) {
+        throw new Error(r.stderr.trim() || "could not find git root");
+    }
+    return r.stdout.trim();
+}
+// ─── exit_worktree ───────────────────────────────────────────
+const ExitParams = Type.Object({
+    action: Type.Union([Type.Literal("keep"), Type.Literal("remove")], {
+        description: "keep: leave the worktree on disk (just acknowledge). remove: git worktree remove.",
+    }),
+    discard_changes: Type.Optional(Type.Boolean({
+        description: "Force removal even with uncommitted changes. Default false.",
+    })),
+});
+const EXIT_DESCRIPTION = `Exit a worktree created by enter_worktree. Run this from INSIDE the worktree (your codebase session must be cwd'd into it).
+
+action: "keep" leaves the worktree alone — the branch and disk state stay. action: "remove" runs \`git worktree remove\`. If the worktree has uncommitted changes, removal errors unless discard_changes: true.`;
+export function createExitWorktree(ctx) {
+    return {
+        name: "exit_worktree",
+        label: "Exit worktree",
+        description: EXIT_DESCRIPTION,
+        parameters: ExitParams,
+        executionMode: "sequential",
+        execute: async (_id, params, signal) => {
+            await requireGitRepo(ctx.cwd);
+            if (params.action === "keep") {
+                return {
+                    content: [{ type: "text", text: "Worktree kept. Switch back to the main checkout when ready." }],
+                    details: { action: "keep", removed: false, hadUncommittedChanges: false },
+                };
+            }
+            const status = await runGit(["status", "--porcelain"], ctx.cwd, signal);
+            const dirty = status.exitCode === 0 && status.stdout.trim().length > 0;
+            if (dirty && !params.discard_changes) {
+                throw new Error("worktree has uncommitted changes. Set discard_changes: true to force removal, or commit first.");
+            }
+            const path = await readGitRoot(ctx.cwd, signal);
+            const args = ["worktree", "remove"];
+            if (params.discard_changes)
+                args.push("--force");
+            args.push(path);
+            // Run from the parent (main) repo so we can remove the cwd we're in.
+            const main = await readMainRepoDir(ctx.cwd, signal);
+            const r = await runGit(args, main, signal);
+            if (r.exitCode !== 0) {
+                throw new Error(r.stderr.trim() || `git worktree remove exited ${r.exitCode}`);
+            }
+            return {
+                content: [{ type: "text", text: `Removed worktree ${path}.` }],
+                details: { action: "remove", removed: true, hadUncommittedChanges: dirty },
+            };
+        },
+    };
+}
+async function readMainRepoDir(cwd, signal) {
+    const r = await runGit(["rev-parse", "--git-common-dir"], cwd, signal);
+    if (r.exitCode !== 0)
+        return cwd;
+    const commonDir = resolveGitDir(r.stdout.trim(), cwd);
+    // commonDir is the repo's .git dir; the worktree containing it is its parent.
+    return resolve(commonDir, "..");
+}
+//# sourceMappingURL=worktree.js.map

package/dist/tools/git/worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.js","sourceRoot":"","sources":["../../../src/tools/git/worktree.ts"],"names":[],"mappings":"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"}

package/dist/tools/glob.js

@@ -0,0 +1,128 @@
+import { readFileSync } from "node:fs";
+import { join, relative, resolve } from "node:path";
+import { glob } from "glob";
+import ignore from "ignore";
+import { Type } from "typebox";
+import { resolveInsideCwd } from "./file-ops.js";
+const Params = Type.Object({
+    pattern: Type.String({
+        description: 'Glob pattern, e.g. "**/*.ts", "src/**/test/*.test.tsx", "package.json". Standard globstar (** = any depth) and brace expansion ({a,b}) supported.',
+    }),
+    path: Type.Optional(Type.String({
+        description: "Search root, relative to the project root. Defaults to the project root.",
+    })),
+    max_results: Type.Optional(Type.Integer({
+        minimum: 1,
+        maximum: 5000,
+        description: "Cap on matches returned. Default 500.",
+    })),
+    respect_gitignore: Type.Optional(Type.Boolean({
+        description: "Honor .gitignore at the search root and the project root. Default true.",
+    })),
+});
+const DEFAULT_LIMIT = 500;
+const HARDCODED_IGNORES = [
+    "**/node_modules/**",
+    "**/.git/**",
+    "**/.hg/**",
+    "**/.svn/**",
+    "**/dist/**",
+    "**/build/**",
+    "**/out/**",
+    "**/.next/**",
+    "**/.nuxt/**",
+    "**/.cache/**",
+    "**/.turbo/**",
+    "**/__pycache__/**",
+    "**/.pytest_cache/**",
+    "**/target/**",
+    "**/vendor/**",
+];
+const DESCRIPTION = `Find files matching a glob pattern.
+
+Behavior:
+- Standard glob: ** = any directory depth, * = any chars in a segment, {a,b} = alternation, [abc] = char class.
+- Search starts from the project root unless path is given (must remain inside the project root).
+- Build/VCS metadata directories (node_modules, .git, dist, target, etc.) are excluded by default.
+- .gitignore at the search root and project root is honored unless respect_gitignore: false.
+- Results are sorted by modification time, newest first, so recently-changed files surface first.
+- Results capped at 500 by default; truncation is reported in details.
+
+Use this when you know what kind of file you're looking for. For directory orientation use list_files; for content search use grep.`;
+export function createGlob(ctx) {
+    return {
+        name: "glob",
+        label: "Glob",
+        description: DESCRIPTION,
+        parameters: Params,
+        executionMode: "parallel",
+        execute: async (_toolCallId, params) => {
+            const root = resolveInsideCwd(ctx.cwd, params.path ?? ".");
+            const limit = params.max_results ?? DEFAULT_LIMIT;
+            const useGitignore = params.respect_gitignore !== false;
+            const matches = await glob(params.pattern, {
+                cwd: root,
+                ignore: HARDCODED_IGNORES.slice(),
+                dot: false,
+                nodir: true,
+                absolute: true,
+            });
+            let kept = matches.map((abs) => relative(ctx.cwd, abs));
+            let gitignoreApplied = false;
+            if (useGitignore) {
+                const ig = loadGitignore(ctx.cwd, root);
+                if (ig) {
+                    gitignoreApplied = true;
+                    kept = kept.filter((p) => !ig.ignores(p));
+                }
+            }
+            kept.sort((a, b) => mtime(join(ctx.cwd, b)) - mtime(join(ctx.cwd, a)));
+            const truncated = kept.length > limit;
+            if (truncated)
+                kept = kept.slice(0, limit);
+            const tail = truncated ? `\n... (capped at ${limit} of ${matches.length} matches)` : "";
+            const text = kept.length === 0
+                ? `No matches for ${params.pattern} under ${relative(ctx.cwd, root) || "."}`
+                : `${kept.length} match${kept.length === 1 ? "" : "es"}:\n${kept.join("\n")}${tail}`;
+            return {
+                content: [{ type: "text", text }],
+                details: {
+                    pattern: params.pattern,
+                    root: resolve(root),
+                    matches: kept,
+                    truncated,
+                    gitignoreApplied,
+                },
+            };
+        },
+    };
+}
+function loadGitignore(projectRoot, searchRoot) {
+    const ig = ignore();
+    let loaded = false;
+    for (const candidate of dedupe([projectRoot, searchRoot])) {
+        for (const file of [".gitignore", ".git/info/exclude"]) {
+            try {
+                const body = readFileSync(join(candidate, file), "utf8");
+                ig.add(body);
+                loaded = true;
+            }
+            catch {
+                // missing file is fine
+            }
+        }
+    }
+    return loaded ? ig : null;
+}
+function dedupe(values) {
+    return Array.from(new Set(values));
+}
+function mtime(path) {
+    try {
+        return require("node:fs").statSync(path).mtimeMs;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=glob.js.map

package/dist/tools/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../src/tools/glob.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,MAAuB,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAe,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC1B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC;QACpB,WAAW,EACV,mJAAmJ;KACpJ,CAAC;IACF,IAAI,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,MAAM,CAAC;QACX,WAAW,EAAE,0EAA0E;KACvF,CAAC,CACF;IACD,WAAW,EAAE,IAAI,CAAC,QAAQ,CACzB,IAAI,CAAC,OAAO,CAAC;QACZ,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,uCAAuC;KACpD,CAAC,CACF;IACD,iBAAiB,EAAE,IAAI,CAAC,QAAQ,CAC/B,IAAI,CAAC,OAAO,CAAC;QACZ,WAAW,EAAE,yEAAyE;KACtF,CAAC,CACF;CACD,CAAC,CAAC;AAYH,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,iBAAiB,GAAG;IACzB,oBAAoB;IACpB,YAAY;IACZ,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,WAAW;IACX,aAAa;IACb,aAAa;IACb,cAAc;IACd,cAAc;IACd,mBAAmB;IACnB,qBAAqB;IACrB,cAAc;IACd,cAAc;CACd,CAAC;AAEF,MAAM,WAAW,GAAG;;;;;;;;;;oIAUgH,CAAC;AAErI,MAAM,UAAU,UAAU,CAAC,GAAgB;IAC1C,OAAO;QACN,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,WAAW;QACxB,UAAU,EAAE,MAAM;QAClB,aAAa,EAAE,UAAU;QACzB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE;YACtC,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC;YAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,IAAI,aAAa,CAAC;YAClD,MAAM,YAAY,GAAG,MAAM,CAAC,iBAAiB,KAAK,KAAK,CAAC;YAExD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;gBAC1C,GAAG,EAAE,IAAI;gBACT,MAAM,EAAE,iBAAiB,CAAC,KAAK,EAAE;gBACjC,GAAG,EAAE,KAAK;gBACV,KAAK,EAAE,IAAI;gBACX,QAAQ,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;YAExD,IAAI,gBAAgB,GAAG,KAAK,CAAC;YAC7B,IAAI,YAAY,EAAE,CAAC;gBAClB,MAAM,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACxC,IAAI,EAAE,EAAE,CAAC;oBACR,gBAAgB,GAAG,IAAI,CAAC;oBACxB,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC3C,CAAC;YACF,CAAC;YAED,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAEvE,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YACtC,IAAI,SAAS;gBAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAE3C,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,oBAAoB,KAAK,OAAO,OAAO,CAAC,MAAM,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;YACxF,MAAM,IAAI,GACT,IAAI,CAAC,MAAM,KAAK,CAAC;gBAChB,CAAC,CAAC,kBAAkB,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,GAAG,EAAE;gBAC5E,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,SAAS,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;YAEvF,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACjC,OAAO,EAAE;oBACR,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC;oBACnB,OAAO,EAAE,IAAI;oBACb,SAAS;oBACT,gBAAgB;iBAChB;aACD,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,WAAmB,EAAE,UAAkB;IAC7D,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IACpB,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;QAC3D,KAAK,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,mBAAmB,CAAC,EAAE,CAAC;YACxD,IAAI,CAAC;gBACJ,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;gBACzD,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACb,MAAM,GAAG,IAAI,CAAC;YACf,CAAC;YAAC,MAAM,CAAC;gBACR,uBAAuB;YACxB,CAAC;QACF,CAAC;IACF,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3B,CAAC;AAED,SAAS,MAAM,CAAI,MAAW;IAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,KAAK,CAAC,IAAY;IAC1B,IAAI,CAAC;QACJ,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,CAAC,CAAC;IACV,CAAC;AACF,CAAC"}

package/dist/tools/grep.js

@@ -0,0 +1,199 @@
+import { spawn } from "node:child_process";
+import { relative, resolve } from "node:path";
+import { Type } from "typebox";
+import { resolveInsideCwd } from "./file-ops.js";
+const Params = Type.Object({
+    pattern: Type.String({
+        description: "Regex pattern (PCRE2-like via ripgrep). Use fixed_strings: true to disable regex interpretation.",
+    }),
+    path: Type.Optional(Type.String({
+        description: "Search root, relative to the project root. Defaults to the project root.",
+    })),
+    glob: Type.Optional(Type.String({
+        description: 'File glob to scope the search, e.g. "*.ts" or "src/**/*.{ts,tsx}".',
+    })),
+    case_insensitive: Type.Optional(Type.Boolean({ description: "Case-insensitive match. Default false." })),
+    fixed_strings: Type.Optional(Type.Boolean({ description: "Treat pattern as a literal string, not regex. Default false." })),
+    context_lines: Type.Optional(Type.Integer({
+        minimum: 0,
+        maximum: 10,
+        description: "Lines of context around each match (-C flag). Default 0.",
+    })),
+    max_results: Type.Optional(Type.Integer({
+        minimum: 1,
+        maximum: 5000,
+        description: "Cap on matched lines returned. Default 500.",
+    })),
+});
+const DEFAULT_LIMIT = 500;
+const DESCRIPTION = `Search file contents for a pattern.
+
+Behavior:
+- Uses ripgrep when available (faster, regex-rich, automatic .gitignore support); falls back to grep -rn.
+- Pattern is regex by default; pass fixed_strings: true to match literally.
+- Standard build/VCS dirs are skipped automatically (node_modules, .git, dist, target, etc.).
+- Results capped at 500 by default; truncation reported in details.
+- Output format: "path:line:text", one match per line — easy for the model to quote back to read_file.
+
+Use this for content discovery. For path-pattern lookups use glob, for directory orientation use list_files.`;
+export function createGrep(ctx) {
+    return {
+        name: "grep",
+        label: "Grep",
+        description: DESCRIPTION,
+        parameters: Params,
+        executionMode: "parallel",
+        execute: async (_toolCallId, params, signal) => {
+            const root = resolveInsideCwd(ctx.cwd, params.path ?? ".");
+            const limit = params.max_results ?? DEFAULT_LIMIT;
+            const useRipgrep = await canUseRipgrep();
+            const engine = useRipgrep ? "ripgrep" : "grep";
+            const argv = useRipgrep ? buildRipgrepArgs(params) : buildGrepArgs(params);
+            const { stdout, stderr, exitCode } = await runChild(argv[0], argv.slice(1), root, signal);
+            // rg/grep exit 0 = matches, 1 = no matches, ≥2 = error
+            if (exitCode >= 2) {
+                const reason = stderr.trim() || `${engine} exited ${exitCode}`;
+                throw new Error(reason);
+            }
+            // rg/grep emit paths relative to the cwd we passed (root). Re-anchor against the project cwd.
+            const allMatches = parseMatches(stdout, useRipgrep).map((m) => ({
+                ...m,
+                file: relative(ctx.cwd, resolve(root, m.file)),
+            }));
+            const truncated = allMatches.length > limit;
+            const matches = truncated ? allMatches.slice(0, limit) : allMatches;
+            const text = formatOutput(matches, root, ctx.cwd, params.pattern, truncated, allMatches.length, limit);
+            return {
+                content: [{ type: "text", text }],
+                details: {
+                    pattern: params.pattern,
+                    root: resolve(root),
+                    engine,
+                    matches,
+                    truncated,
+                    exitCode,
+                },
+            };
+        },
+    };
+}
+function buildRipgrepArgs(p) {
+    const argv = ["rg", "--vimgrep", "--no-heading", "--line-number", "--color=never"];
+    if (p.case_insensitive)
+        argv.push("-i");
+    if (p.fixed_strings)
+        argv.push("-F");
+    if (p.context_lines && p.context_lines > 0)
+        argv.push("-C", String(p.context_lines));
+    if (p.glob)
+        argv.push("--glob", p.glob);
+    argv.push("--", p.pattern, ".");
+    return argv;
+}
+function buildGrepArgs(p) {
+    const argv = ["grep", "-rn", "--color=never"];
+    if (p.case_insensitive)
+        argv.push("-i");
+    if (p.fixed_strings)
+        argv.push("-F");
+    if (p.context_lines && p.context_lines > 0)
+        argv.push("-C", String(p.context_lines));
+    if (p.glob)
+        argv.push(`--include=${p.glob}`);
+    for (const skip of ["node_modules", ".git", "dist", "build", "target", "__pycache__"]) {
+        argv.push(`--exclude-dir=${skip}`);
+    }
+    argv.push("--", p.pattern, ".");
+    return argv;
+}
+let ripgrepCheck;
+function canUseRipgrep() {
+    if (!ripgrepCheck) {
+        ripgrepCheck = new Promise((resolveCheck) => {
+            const child = spawn("rg", ["--version"], { stdio: "ignore" });
+            child.on("error", () => resolveCheck(false));
+            child.on("close", (code) => resolveCheck(code === 0));
+        });
+    }
+    return ripgrepCheck;
+}
+function runChild(cmd, args, cwd, signal) {
+    return new Promise((resolveRun) => {
+        const child = spawn(cmd, args, {
+            cwd,
+            env: process.env,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const out = [];
+        const err = [];
+        child.stdout?.on("data", (b) => out.push(b));
+        child.stderr?.on("data", (b) => err.push(b));
+        const onAbort = () => child.kill("SIGTERM");
+        signal?.addEventListener("abort", onAbort);
+        child.on("error", (e) => {
+            signal?.removeEventListener("abort", onAbort);
+            resolveRun({ stdout: "", stderr: e.message, exitCode: 1 });
+        });
+        child.on("close", (code) => {
+            signal?.removeEventListener("abort", onAbort);
+            resolveRun({
+                stdout: Buffer.concat(out).toString("utf8"),
+                stderr: Buffer.concat(err).toString("utf8"),
+                exitCode: code ?? 1,
+            });
+        });
+    });
+}
+function parseMatches(stdout, ripgrep) {
+    if (!stdout)
+        return [];
+    const matches = [];
+    for (const raw of stdout.split("\n")) {
+        if (!raw)
+            continue;
+        const m = ripgrep ? parseRipgrepLine(raw) : parseGrepLine(raw);
+        if (m)
+            matches.push(m);
+    }
+    return matches;
+}
+function parseRipgrepLine(line) {
+    // rg --vimgrep: file:line:col:text
+    const first = line.indexOf(":");
+    if (first < 0)
+        return null;
+    const second = line.indexOf(":", first + 1);
+    if (second < 0)
+        return null;
+    const third = line.indexOf(":", second + 1);
+    if (third < 0)
+        return null;
+    const file = line.slice(0, first);
+    const lineNum = Number.parseInt(line.slice(first + 1, second), 10);
+    if (!Number.isFinite(lineNum))
+        return null;
+    return { file, line: lineNum, text: line.slice(third + 1) };
+}
+function parseGrepLine(line) {
+    // grep -rn: file:line:text  (no column)
+    const first = line.indexOf(":");
+    if (first < 0)
+        return null;
+    const second = line.indexOf(":", first + 1);
+    if (second < 0)
+        return null;
+    const file = line.slice(0, first);
+    const lineNum = Number.parseInt(line.slice(first + 1, second), 10);
+    if (!Number.isFinite(lineNum))
+        return null;
+    return { file, line: lineNum, text: line.slice(second + 1) };
+}
+function formatOutput(matches, root, cwd, pattern, truncated, totalFound, limit) {
+    if (matches.length === 0) {
+        return `No matches for ${pattern} under ${relative(cwd, root) || "."}`;
+    }
+    const lines = matches.map((m) => `${m.file}:${m.line}:${m.text}`);
+    const tail = truncated ? `\n... (showing ${limit} of ${totalFound} matches)` : "";
+    return `${matches.length} match${matches.length === 1 ? "" : "es"}:\n${lines.join("\n")}${tail}`;
+}
+//# sourceMappingURL=grep.js.map

package/dist/tools/grep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.js","sourceRoot":"","sources":["../../src/tools/grep.ts"],"names":[],"mappings":"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"}