@kavienw/deepseek-cli 0.1.0

package/dist/skills.js

@@ -0,0 +1,147 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { findProjectRoot } from "./project.js";
+import { enabledPluginSkillSources } from "./plugins.js";
+const SKILL_DIR = path.join(".deepseek", "skills");
+const GLOBAL_SKILL_DIR = path.join(os.homedir(), ".deepseek-cli", "skills");
+function normalizeCommandName(value) {
+    return value
+        .trim()
+        .replace(/^\//, "")
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+function parseSkillFile(raw) {
+    if (!raw.startsWith("---\n"))
+        return { metadata: {}, body: raw.trim() };
+    const end = raw.indexOf("\n---", 4);
+    if (end === -1)
+        return { metadata: {}, body: raw.trim() };
+    const frontmatter = raw.slice(4, end).trim();
+    const body = raw.slice(end + "\n---".length).trim();
+    const metadata = {};
+    for (const line of frontmatter.split("\n")) {
+        const idx = line.indexOf(":");
+        if (idx === -1)
+            continue;
+        const key = line.slice(0, idx).trim().toLowerCase();
+        const value = line.slice(idx + 1).trim().replace(/^['\"]|['\"]$/g, "");
+        if (key && value)
+            metadata[key] = value;
+    }
+    return { metadata, body };
+}
+function readSkillFile(file, scope, plugin) {
+    try {
+        const raw = fs.readFileSync(file, "utf8");
+        const parsed = parseSkillFile(raw);
+        const inferredName = path.basename(file, path.extname(file));
+        const name = normalizeCommandName(parsed.metadata.command ?? parsed.metadata.name ?? inferredName);
+        if (!name)
+            return null;
+        return {
+            name,
+            usage: `/${name}`,
+            description: parsed.metadata.description ?? parsed.metadata.summary ?? "custom skill",
+            prompt: parsed.body,
+            source: file,
+            scope,
+            plugin,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function loadSkillDir(dir, scope, plugin) {
+    if (!fs.existsSync(dir))
+        return [];
+    const skills = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (!entry.isFile() || !entry.name.endsWith(".md"))
+            continue;
+        const skill = readSkillFile(path.join(dir, entry.name), scope, plugin);
+        if (skill)
+            skills.push(skill);
+    }
+    return skills;
+}
+export function projectSkillDir(cwd) {
+    return path.join(findProjectRoot(cwd), SKILL_DIR);
+}
+export function globalSkillDir() {
+    return GLOBAL_SKILL_DIR;
+}
+export function loadSkillCommands(cwd) {
+    const merged = new Map();
+    // Precedence (later overrides earlier): global < plugin < project.
+    for (const skill of loadSkillDir(GLOBAL_SKILL_DIR, "global")) {
+        merged.set(skill.name, skill);
+    }
+    for (const { dir, plugin } of enabledPluginSkillSources()) {
+        for (const skill of loadSkillDir(dir, "plugin", plugin)) {
+            merged.set(skill.name, skill);
+        }
+    }
+    for (const skill of loadSkillDir(projectSkillDir(cwd), "project")) {
+        merged.set(skill.name, skill);
+    }
+    return [...merged.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+export function findSkillCommand(cwd, name) {
+    const normalized = normalizeCommandName(name);
+    return loadSkillCommands(cwd).find((skill) => skill.name === normalized);
+}
+export function createSkillTemplate(cwd, rawName) {
+    const name = normalizeCommandName(rawName);
+    if (!name)
+        throw new Error("Skill name must contain letters or numbers.");
+    const dir = projectSkillDir(cwd);
+    const file = path.join(dir, `${name}.md`);
+    if (fs.existsSync(file))
+        return { created: false, path: file };
+    fs.mkdirSync(dir, { recursive: true });
+    const title = name
+        .split(/[-_]/g)
+        .filter(Boolean)
+        .map((part) => part[0].toUpperCase() + part.slice(1))
+        .join(" ");
+    const content = [
+        "---",
+        `name: ${name}`,
+        `description: ${title} task`,
+        "---",
+        "",
+        `You are running the custom /${name} skill.`,
+        "",
+        "User input:",
+        "{{input}}",
+        "",
+        "Instructions:",
+        "- Describe exactly what this skill should do.",
+        "- Mention which files or commands it should inspect when relevant.",
+        "- Keep the final answer concise and actionable.",
+        "",
+    ].join("\n");
+    fs.writeFileSync(file, content, "utf8");
+    return { created: true, path: file };
+}
+export function renderSkillPrompt(skill, input, cwd) {
+    const args = input.trim();
+    const rendered = skill.prompt
+        .replaceAll("{{input}}", args)
+        .replaceAll("{{args}}", args)
+        .replaceAll("{{cwd}}", cwd);
+    const includesInput = skill.prompt.includes("{{input}}") || skill.prompt.includes("{{args}}");
+    return [
+        `Run custom skill /${skill.name}.`,
+        `Skill file: ${skill.source}`,
+        `Description: ${skill.description}`,
+        "",
+        rendered,
+        includesInput ? "" : `\nUser input: ${args || "(none)"}`,
+    ].join("\n").trim();
+}
+//# sourceMappingURL=skills.js.map

package/dist/skills.js.map

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

package/dist/todo.js

@@ -0,0 +1,67 @@
+export const TODO_STATUSES = ["pending", "in_progress", "completed"];
+function isTodoStatus(value) {
+    return typeof value === "string" && TODO_STATUSES.includes(value);
+}
+function fallbackId(index) {
+    return `todo-${index + 1}`;
+}
+export function validateTodos(rawTodos) {
+    if (!Array.isArray(rawTodos)) {
+        return { error: "todos must be an array." };
+    }
+    const ids = new Set();
+    const todos = [];
+    for (let i = 0; i < rawTodos.length; i++) {
+        const raw = rawTodos[i];
+        if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+            return { error: `todo ${i + 1} must be an object.` };
+        }
+        const item = raw;
+        const content = typeof item.content === "string" ? item.content.trim() : "";
+        if (!content) {
+            return { error: `todo ${i + 1} content must be a non-empty string.` };
+        }
+        if (!isTodoStatus(item.status)) {
+            return {
+                error: `todo ${i + 1} status must be one of: ${TODO_STATUSES.join(", ")}.`,
+            };
+        }
+        const id = typeof item.id === "string" && item.id.trim() ? item.id.trim() : fallbackId(i);
+        if (ids.has(id)) {
+            return { error: `duplicate todo id: ${id}.` };
+        }
+        ids.add(id);
+        todos.push({ id, content, status: item.status });
+    }
+    const inProgress = todos.filter((todo) => todo.status === "in_progress");
+    if (inProgress.length > 1) {
+        return { error: "only one todo may be in_progress at a time." };
+    }
+    return { todos };
+}
+export class TodoStore {
+    todos = [];
+    list() {
+        return this.todos.map((todo) => ({ ...todo }));
+    }
+    replace(todos) {
+        this.todos = todos.map((todo) => ({ ...todo }));
+    }
+    clear() {
+        this.todos = [];
+    }
+    formatForModel() {
+        return formatTodoList(this.todos);
+    }
+}
+export function formatTodoList(todos) {
+    if (todos.length === 0)
+        return "No active todos.";
+    const marker = {
+        pending: "[ ]",
+        in_progress: "[>]",
+        completed: "[x]",
+    };
+    return todos.map((todo) => `${marker[todo.status]} ${todo.content} (${todo.id})`).join("\n");
+}
+//# sourceMappingURL=todo.js.map

package/dist/todo.js.map

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

package/dist/tools/bash.js

@@ -0,0 +1,61 @@
+import { exec } from "node:child_process";
+const DEFAULT_TIMEOUT = 120_000;
+const MAX_OUTPUT = 30_000;
+export const bashTool = {
+    name: "bash",
+    description: "Execute a shell command in the working directory and return its stdout/stderr. " +
+        "Use for running builds, tests, git, and other shell tasks. Avoid destructive commands.",
+    needsApproval: true,
+    parameters: {
+        type: "object",
+        properties: {
+            command: {
+                type: "string",
+                description: "The shell command to run.",
+            },
+            timeout: {
+                type: "number",
+                description: `Timeout in milliseconds (optional, default ${DEFAULT_TIMEOUT}, max 600000).`,
+            },
+        },
+        required: ["command"],
+    },
+    preview(args) {
+        return String(args.command);
+    },
+    run(args, ctx) {
+        const command = String(args.command);
+        const timeout = Math.min(Number(args.timeout) || DEFAULT_TIMEOUT, 600_000);
+        return new Promise((resolve) => {
+            exec(command, { cwd: ctx.cwd, timeout, maxBuffer: 10 * 1024 * 1024, shell: "/bin/bash" }, (error, stdout, stderr) => {
+                let out = "";
+                if (stdout)
+                    out += stdout;
+                if (stderr)
+                    out += (out ? "\n" : "") + stderr;
+                out = out.trim();
+                if (out.length > MAX_OUTPUT) {
+                    out = out.slice(0, MAX_OUTPUT) + `\n…[output truncated, ${out.length} chars total]`;
+                }
+                const execErr = error;
+                const exitCode = execErr && typeof execErr.code === "number" ? execErr.code : 0;
+                const timedOut = Boolean(execErr && execErr.signal === "SIGTERM");
+                if (timedOut) {
+                    resolve({
+                        content: `Command timed out after ${timeout}ms.\n${out}`,
+                        summary: `$ ${command} (timed out)`,
+                        isError: true,
+                    });
+                    return;
+                }
+                const header = exitCode === 0 ? "" : `[exit code ${exitCode}]\n`;
+                resolve({
+                    content: (header + out).trim() || "(no output)",
+                    summary: `$ ${command}`,
+                    isError: exitCode !== 0,
+                });
+            });
+        });
+    },
+};
+//# sourceMappingURL=bash.js.map

package/dist/tools/bash.js.map

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

package/dist/tools/diff.js

@@ -0,0 +1,26 @@
+import { structuredPatch } from "diff";
+const MAX_DIFF_LINES = 80;
+/**
+ * Produce a compact unified diff (hunks only) between two strings, or undefined
+ * if they are identical. Lines are prefixed with +/-/space; hunks with @@.
+ * The caller is responsible for colouring.
+ */
+export function makeDiff(label, oldStr, newStr) {
+    if (oldStr === newStr)
+        return undefined;
+    const patch = structuredPatch(label, label, oldStr, newStr, "", "", { context: 2 });
+    const out = [];
+    for (const hunk of patch.hunks) {
+        out.push(`@@ -${hunk.oldStart},${hunk.oldLines} +${hunk.newStart},${hunk.newLines} @@`);
+        for (const line of hunk.lines)
+            out.push(line);
+    }
+    if (out.length === 0)
+        return undefined;
+    if (out.length > MAX_DIFF_LINES) {
+        const omitted = out.length - MAX_DIFF_LINES;
+        return out.slice(0, MAX_DIFF_LINES).join("\n") + `\n…(${omitted} more diff lines)`;
+    }
+    return out.join("\n");
+}
+//# sourceMappingURL=diff.js.map

package/dist/tools/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/tools/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAEvC,MAAM,cAAc,GAAG,EAAE,CAAC;AAE1B;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,MAAc,EAAE,MAAc;IACpE,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IAExC,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IACpF,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC;QACxF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK;YAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAEvC,IAAI,GAAG,CAAC,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,cAAc,CAAC;QAC5C,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,OAAO,mBAAmB,CAAC;IACrF,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/tools/edit.js

@@ -0,0 +1,73 @@
+import fs from "node:fs";
+import path from "node:path";
+import { makeDiff } from "./diff.js";
+export const editTool = {
+    name: "edit_file",
+    description: "Replace an exact string in a file with new text. The old_string must appear exactly once " +
+        "(include surrounding context to make it unique), unless replace_all is true.",
+    needsApproval: true,
+    parameters: {
+        type: "object",
+        properties: {
+            path: {
+                type: "string",
+                description: "Path to the file to edit (absolute or relative to the working directory).",
+            },
+            old_string: {
+                type: "string",
+                description: "The exact text to replace.",
+            },
+            new_string: {
+                type: "string",
+                description: "The replacement text.",
+            },
+            replace_all: {
+                type: "boolean",
+                description: "Replace every occurrence instead of requiring a unique match (default false).",
+            },
+        },
+        required: ["path", "old_string", "new_string"],
+    },
+    preview(args) {
+        return `edit ${String(args.path)}`;
+    },
+    async run(args, ctx) {
+        const rel = String(args.path);
+        const oldStr = String(args.old_string ?? "");
+        const newStr = String(args.new_string ?? "");
+        const replaceAll = Boolean(args.replace_all);
+        const abs = path.isAbsolute(rel) ? rel : path.join(ctx.cwd, rel);
+        if (!fs.existsSync(abs)) {
+            return { content: `Error: file not found: ${rel}`, isError: true };
+        }
+        if (oldStr === newStr) {
+            return { content: "Error: old_string and new_string are identical.", isError: true };
+        }
+        const original = fs.readFileSync(abs, "utf8");
+        const count = original.split(oldStr).length - 1;
+        if (count === 0) {
+            return {
+                content: `Error: old_string not found in ${rel}. Read the file again to get exact text.`,
+                isError: true,
+            };
+        }
+        if (count > 1 && !replaceAll) {
+            return {
+                content: `Error: old_string appears ${count} times in ${rel}. Add more context to make it unique, or set replace_all.`,
+                isError: true,
+            };
+        }
+        const updated = replaceAll
+            ? original.split(oldStr).join(newStr)
+            : original.replace(oldStr, newStr);
+        ctx.recordFileBackup?.(abs, original);
+        fs.writeFileSync(abs, updated, "utf8");
+        const replacements = replaceAll ? count : 1;
+        return {
+            content: `Edited ${rel} (${replacements} replacement${replacements > 1 ? "s" : ""}).`,
+            summary: `Edited ${rel}`,
+            display: makeDiff(rel, original, updated),
+        };
+    },
+};
+//# sourceMappingURL=edit.js.map

package/dist/tools/edit.js.map

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

package/dist/tools/glob.js

@@ -0,0 +1,47 @@
+import { glob } from "glob";
+import path from "node:path";
+const MAX_RESULTS = 300;
+export const globTool = {
+    name: "list_files",
+    description: "List files in a directory matching a glob pattern (e.g. 'src/**/*.ts'). Returns matching paths sorted by " +
+        "most recently modified. Skips node_modules and .git. Use this to discover project structure and locate files.",
+    needsApproval: false,
+    parameters: {
+        type: "object",
+        properties: {
+            pattern: { type: "string", description: "Glob pattern, e.g. 'src/**/*.ts' or '**/*.json'." },
+            path: {
+                type: "string",
+                description: "Base directory to search from (optional, defaults to working directory).",
+            },
+        },
+        required: ["pattern"],
+    },
+    preview(args) {
+        return `list ${String(args.pattern)}`;
+    },
+    async run(args, ctx) {
+        const pattern = String(args.pattern);
+        const rel = args.path ? String(args.path) : ".";
+        const base = path.isAbsolute(rel) ? rel : path.join(ctx.cwd, rel);
+        const matches = await glob(pattern, {
+            cwd: base,
+            nodir: true,
+            ignore: ["**/node_modules/**", "**/.git/**"],
+            stat: true,
+            withFileTypes: true,
+        });
+        matches.sort((a, b) => (b.mtimeMs ?? 0) - (a.mtimeMs ?? 0));
+        const paths = matches.map((m) => m.fullpath());
+        if (paths.length === 0) {
+            return { content: `No files match ${pattern}.`, summary: `list ${pattern}: 0 files` };
+        }
+        const shown = paths.slice(0, MAX_RESULTS);
+        const truncated = paths.length > MAX_RESULTS ? `\n…[${paths.length - MAX_RESULTS} more]` : "";
+        return {
+            content: shown.join("\n") + truncated,
+            summary: `list ${pattern}: ${paths.length} file(s)`,
+        };
+    },
+};
+//# 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,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,MAAM,CAAC,MAAM,QAAQ,GAAS;IAC5B,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,2GAA2G;QAC3G,+GAA+G;IACjH,aAAa,EAAE,KAAK;IACpB,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kDAAkD,EAAE;YAC5F,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0EAA0E;aACxF;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,OAAO,CAAC,IAAI;QACV,OAAO,QAAQ,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IACxC,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG;QACjB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAChD,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAElE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE;YAClC,GAAG,EAAE,IAAI;YACT,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,CAAC,oBAAoB,EAAE,YAAY,CAAC;YAC5C,IAAI,EAAE,IAAI;YACV,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;QAEH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE/C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,OAAO,EAAE,kBAAkB,OAAO,GAAG,EAAE,OAAO,EAAE,QAAQ,OAAO,WAAW,EAAE,CAAC;QACxF,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,MAAM,GAAG,WAAW,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9F,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,SAAS;YACrC,OAAO,EAAE,QAAQ,OAAO,KAAK,KAAK,CAAC,MAAM,UAAU;SACpD,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/grep.js

@@ -0,0 +1,133 @@
+import { execFile } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+const MAX_RESULTS = 200;
+function hasRipgrep() {
+    return new Promise((resolve) => {
+        execFile("rg", ["--version"], (err) => resolve(!err));
+    });
+}
+function runRipgrep(pattern, searchPath, glob, ignoreCase) {
+    const rgArgs = ["--line-number", "--no-heading", "--color", "never", "--max-count", "50"];
+    if (ignoreCase)
+        rgArgs.push("-i");
+    if (glob)
+        rgArgs.push("--glob", glob);
+    rgArgs.push(pattern, searchPath);
+    return new Promise((resolve) => {
+        execFile("rg", rgArgs, { maxBuffer: 10 * 1024 * 1024 }, (_err, stdout) => {
+            resolve(stdout || "");
+        });
+    });
+}
+const IGNORE_DIRS = new Set(["node_modules", ".git", "dist", "build", ".next", "target"]);
+function jsGrep(pattern, searchPath, ignoreCase) {
+    let re;
+    try {
+        re = new RegExp(pattern, ignoreCase ? "i" : undefined);
+    }
+    catch {
+        re = new RegExp(pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), ignoreCase ? "i" : undefined);
+    }
+    const results = [];
+    const walk = (dir) => {
+        if (results.length >= MAX_RESULTS)
+            return;
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (results.length >= MAX_RESULTS)
+                return;
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (!IGNORE_DIRS.has(entry.name))
+                    walk(full);
+            }
+            else if (entry.isFile()) {
+                let content;
+                try {
+                    content = fs.readFileSync(full, "utf8");
+                }
+                catch {
+                    continue;
+                }
+                const lines = content.split("\n");
+                for (let i = 0; i < lines.length; i++) {
+                    if (re.test(lines[i])) {
+                        results.push(`${full}:${i + 1}:${lines[i].slice(0, 300)}`);
+                        if (results.length >= MAX_RESULTS)
+                            return;
+                    }
+                }
+            }
+        }
+    };
+    const stat = fs.existsSync(searchPath) ? fs.statSync(searchPath) : null;
+    if (stat?.isFile()) {
+        const content = fs.readFileSync(searchPath, "utf8").split("\n");
+        content.forEach((line, i) => {
+            if (re.test(line))
+                results.push(`${searchPath}:${i + 1}:${line.slice(0, 300)}`);
+        });
+    }
+    else {
+        walk(searchPath);
+    }
+    return results.join("\n");
+}
+export const grepTool = {
+    name: "search_text",
+    description: "Search file contents for a regular expression pattern. Returns matching lines with file:line:content. " +
+        "Uses ripgrep when available. Skips node_modules/.git/dist by default. " +
+        "Use this to find where a symbol, string, or pattern appears in the codebase.",
+    needsApproval: false,
+    parameters: {
+        type: "object",
+        properties: {
+            pattern: { type: "string", description: "Regular expression to search for." },
+            path: {
+                type: "string",
+                description: "Directory or file to search (optional, defaults to working directory).",
+            },
+            glob: {
+                type: "string",
+                description: "Filter files by glob, e.g. '*.ts' (optional, ripgrep only).",
+            },
+            ignore_case: { type: "boolean", description: "Case-insensitive search (optional)." },
+        },
+        required: ["pattern"],
+    },
+    preview(args) {
+        return `search /${String(args.pattern)}/`;
+    },
+    async run(args, ctx) {
+        const pattern = String(args.pattern);
+        const rel = args.path ? String(args.path) : ".";
+        const searchPath = path.isAbsolute(rel) ? rel : path.join(ctx.cwd, rel);
+        const glob = args.glob ? String(args.glob) : undefined;
+        const ignoreCase = Boolean(args.ignore_case);
+        let output;
+        if (await hasRipgrep()) {
+            output = await runRipgrep(pattern, searchPath, glob, ignoreCase);
+        }
+        else {
+            output = jsGrep(pattern, searchPath, ignoreCase);
+        }
+        const lines = output.trim() ? output.trim().split("\n") : [];
+        if (lines.length === 0) {
+            return { content: `No matches for /${pattern}/.`, summary: `search /${pattern}/: 0 matches` };
+        }
+        const shown = lines.slice(0, MAX_RESULTS);
+        const truncated = lines.length > MAX_RESULTS ? `\n…[${lines.length - MAX_RESULTS} more matches]` : "";
+        return {
+            content: shown.join("\n") + truncated,
+            summary: `search /${pattern}/: ${lines.length} match(es)`,
+        };
+    },
+};
+//# 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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"}