llm-agent-cli 2.0.0

package/dist/tools/git.js

@@ -0,0 +1,188 @@
+import { exec } from "child_process";
+import { promisify } from "util";
+import { z } from "zod";
+import { resolveProtectedPath, getRuntimeConfig } from "./security.js";
+const execAsync = promisify(exec);
+const GIT_TIMEOUT_MS = 15_000;
+const MAX_OUTPUT_CHARS = 50_000;
+async function runGit(args, cwd) {
+    try {
+        const { stdout, stderr } = await execAsync(`git ${args.join(" ")}`, {
+            cwd,
+            timeout: GIT_TIMEOUT_MS,
+            maxBuffer: 1024 * 1024 * 4, // 4 MB
+        });
+        const out = (stdout + (stderr ? `\n[stderr]: ${stderr}` : "")).trim();
+        return out.length > MAX_OUTPUT_CHARS
+            ? out.slice(0, MAX_OUTPUT_CHARS) + "\n[output truncated]"
+            : out;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return `git error: ${msg}`;
+    }
+}
+function gitRoot() {
+    return getRuntimeConfig().workspaceRoot;
+}
+// ─── git_status ────────────────────────────────────────────────────────────
+export const GitStatusSchema = z.object({
+    path: z
+        .string()
+        .optional()
+        .describe("Optional sub-path to limit status output to"),
+});
+export async function git_status(args) {
+    const parsed = GitStatusSchema.parse(args);
+    const cwd = gitRoot();
+    const pathArg = parsed.path ? [parsed.path] : [];
+    return runGit(["status", "--short", "--branch", ...pathArg], cwd);
+}
+// ─── git_diff ───────────────────────────────────────────────────────────────
+export const GitDiffSchema = z.object({
+    path: z
+        .string()
+        .optional()
+        .describe("Optional file path to diff"),
+    staged: z
+        .boolean()
+        .default(false)
+        .describe("Show staged (index) diff instead of working-tree diff"),
+    base: z
+        .string()
+        .optional()
+        .describe("Base commit/branch to diff against (e.g. HEAD~1, main)"),
+});
+export async function git_diff(args) {
+    const parsed = GitDiffSchema.parse(args);
+    const cwd = gitRoot();
+    const extra = [];
+    if (parsed.staged)
+        extra.push("--staged");
+    if (parsed.base)
+        extra.push(parsed.base);
+    if (parsed.path) {
+        // Validate path is within workspace
+        try {
+            await resolveProtectedPath(parsed.path);
+        }
+        catch {
+            return `Error: path is outside workspace root`;
+        }
+        extra.push("--", parsed.path);
+    }
+    return runGit(["diff", "--stat", ...extra], cwd).then(async (stat) => {
+        const full = await runGit(["diff", ...extra], cwd);
+        if (!stat && !full)
+            return "(no changes)";
+        return stat ? `${stat}\n\n${full}` : full;
+    });
+}
+// ─── git_log ────────────────────────────────────────────────────────────────
+export const GitLogSchema = z.object({
+    path: z
+        .string()
+        .optional()
+        .describe("Optional file path to limit log to"),
+    n: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(20)
+        .describe("Number of commits to show (default 20, max 100)"),
+    oneline: z
+        .boolean()
+        .default(true)
+        .describe("Show one line per commit (default true)"),
+});
+export async function git_log(args) {
+    const parsed = GitLogSchema.parse(args);
+    const cwd = gitRoot();
+    const fmt = parsed.oneline
+        ? [`--pretty=format:'%h %ad %s (%an)'`, "--date=short"]
+        : ["--pretty=medium"];
+    const pathArg = parsed.path ? ["--", parsed.path] : [];
+    return runGit(["log", `-${parsed.n}`, ...fmt, ...pathArg], cwd);
+}
+// ─── git_blame ──────────────────────────────────────────────────────────────
+export const GitBlameSchema = z.object({
+    absolute_path: z
+        .string()
+        .describe("Absolute path to the file to blame"),
+    start_line: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Optional 1-based starting line"),
+    end_line: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe("Optional 1-based ending line"),
+});
+export async function git_blame(args) {
+    const parsed = GitBlameSchema.parse(args);
+    const absPath = await resolveProtectedPath(parsed.absolute_path);
+    const cwd = gitRoot();
+    const lineArg = [];
+    if (parsed.start_line !== undefined && parsed.end_line !== undefined) {
+        lineArg.push(`-L${parsed.start_line},${parsed.end_line}`);
+    }
+    else if (parsed.start_line !== undefined) {
+        lineArg.push(`-L${parsed.start_line},${parsed.start_line + 49}`);
+    }
+    return runGit(["blame", "--date=short", "-p", ...lineArg, "--", absPath], cwd).then((raw) => {
+        // Convert porcelain blame to readable format
+        const lines = raw.split("\n");
+        const result = [];
+        let i = 0;
+        while (i < lines.length) {
+            const header = lines[i] ?? "";
+            if (/^[0-9a-f]{40}/.test(header)) {
+                const parts = header.split(" ");
+                const hash = (parts[0] ?? "").slice(0, 7);
+                const lineNo = parts[2] ?? "?";
+                // Scan forward for "summary" and "author"
+                let author = "";
+                let summary = "";
+                let content = "";
+                let j = i + 1;
+                while (j < lines.length && !/^[0-9a-f]{40}/.test(lines[j] ?? "")) {
+                    const l = lines[j] ?? "";
+                    if (l.startsWith("author "))
+                        author = l.slice(7);
+                    if (l.startsWith("summary "))
+                        summary = l.slice(8);
+                    if (l.startsWith("\t"))
+                        content = l.slice(1);
+                    j++;
+                }
+                result.push(`${lineNo.padStart(5)} ${hash} ${author.padEnd(20).slice(0, 20)} ${summary.slice(0, 50).padEnd(50)} | ${content}`);
+                i = j;
+            }
+            else {
+                i++;
+            }
+        }
+        return result.length > 0 ? result.join("\n") : raw;
+    });
+}
+// ─── git_stash ──────────────────────────────────────────────────────────────
+export const GitStashSchema = z.object({
+    action: z
+        .enum(["list", "show"])
+        .default("list")
+        .describe("'list' to show all stashes, 'show' to show top stash diff"),
+});
+export async function git_stash(args) {
+    const parsed = GitStashSchema.parse(args);
+    const cwd = gitRoot();
+    if (parsed.action === "list") {
+        return runGit(["stash", "list"], cwd);
+    }
+    return runGit(["stash", "show", "-p", "stash@{0}"], cwd);
+}
+//# sourceMappingURL=git.js.map

package/dist/tools/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/tools/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEvE,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC,MAAM,cAAc,GAAG,MAAM,CAAC;AAC9B,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC,KAAK,UAAU,MAAM,CAAC,IAAc,EAAE,GAAW;IAC/C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE;YAClE,GAAG;YACH,OAAO,EAAE,cAAc;YACvB,SAAS,EAAE,IAAI,GAAG,IAAI,GAAG,CAAC,EAAE,OAAO;SACpC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtE,OAAO,GAAG,CAAC,MAAM,GAAG,gBAAgB;YAClC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,GAAG,sBAAsB;YACzD,CAAC,CAAC,GAAG,CAAC;IACV,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,cAAc,GAAG,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,SAAS,OAAO;IACd,OAAO,gBAAgB,EAAE,CAAC,aAAa,CAAC;AAC1C,CAAC;AAED,8EAA8E;AAE9E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,6CAA6C,CAAC;CAC3D,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAqC;IAErC,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,OAAO,MAAM,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;AACpE,CAAC;AAED,+EAA+E;AAE/E,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4BAA4B,CAAC;IACzC,MAAM,EAAE,CAAC;SACN,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,uDAAuD,CAAC;IACpE,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,wDAAwD,CAAC;CACtE,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAmC;IAEnC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IAEtB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,MAAM,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,oCAAoC;QACpC,IAAI,CAAC;YACH,MAAM,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,uCAAuC,CAAC;QACjD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,MAAM,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACnE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,cAAc,CAAC;QAC1C,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E;AAE/E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oCAAoC,CAAC;IACjD,CAAC,EAAE,CAAC;SACD,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,iDAAiD,CAAC;IAC9D,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,yCAAyC,CAAC;CACvD,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,IAAkC;IAElC,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IAEtB,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO;QACxB,CAAC,CAAC,CAAC,mCAAmC,EAAE,cAAc,CAAC;QACvD,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;IAExB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,OAAO,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,MAAM,CAAC,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;AAClE,CAAC;AAED,+EAA+E;AAE/E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,CAAC,oCAAoC,CAAC;IACjD,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,gCAAgC,CAAC;IAC7C,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,8BAA8B,CAAC;CAC5C,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAoC;IAEpC,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IAEtB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5D,CAAC;SAAM,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,GAAG,EAAE,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,MAAM,CACX,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,EAC1D,GAAG,CACJ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;QACb,6CAA6C;QAC7C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC9B,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAChC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;gBAC/B,0CAA0C;gBAC1C,IAAI,MAAM,GAAG,EAAE,CAAC;gBAChB,IAAI,OAAO,GAAG,EAAE,CAAC;gBACjB,IAAI,OAAO,GAAG,EAAE,CAAC;gBACjB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACd,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;oBACjE,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBACzB,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC;wBAAE,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACjD,IAAI,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;wBAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACnD,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;wBAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAC7C,CAAC,EAAE,CAAC;gBACN,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC;gBAC/H,CAAC,GAAG,CAAC,CAAC;YACR,CAAC;iBAAM,CAAC;gBACN,CAAC,EAAE,CAAC;YACN,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,+EAA+E;AAE/E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;SACtB,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,2DAA2D,CAAC;CACzE,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAoC;IAEpC,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,GAAG,CAAC,CAAC;AAC3D,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,386 @@
+import { z } from "zod";
+import { type PermissionMode, type ToolRuntimeConfig } from "./security.js";
+import type { ToolExecutionContext, ToolHandler } from "./types.js";
+declare const TOOL_REGISTRY: {
+    readonly read_file: {
+        readonly description: "Read a local file. Supports optional line-range reads via start_line/end_line.";
+        readonly schema: z.ZodEffects<z.ZodObject<{
+            absolute_path: z.ZodString;
+            start_line: z.ZodOptional<z.ZodNumber>;
+            end_line: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            absolute_path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+        }, {
+            absolute_path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+        }>, {
+            absolute_path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+        }, {
+            absolute_path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly write_to_file: {
+        readonly description: "Write content to a local file. In standard mode this requires confirmation.";
+        readonly schema: z.ZodObject<{
+            absolute_path: z.ZodString;
+            content: z.ZodString;
+            overwrite: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            absolute_path: string;
+            content: string;
+            overwrite: boolean;
+        }, {
+            absolute_path: string;
+            content: string;
+            overwrite?: boolean | undefined;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly apply_diff: {
+        readonly description: "Safely replace one exact text block in an existing file. Fails if match count is not exactly one.";
+        readonly schema: z.ZodObject<{
+            absolute_path: z.ZodString;
+            search_string: z.ZodString;
+            replace_string: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            absolute_path: string;
+            search_string: string;
+            replace_string: string;
+        }, {
+            absolute_path: string;
+            search_string: string;
+            replace_string: string;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly list_directory: {
+        readonly description: "List files and folders in a directory.";
+        readonly schema: z.ZodObject<{
+            path: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+        }, {
+            path: string;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly create_directory: {
+        readonly description: "Create a directory (and optionally parent directories).";
+        readonly schema: z.ZodObject<{
+            path: z.ZodString;
+            recursive: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            recursive: boolean;
+        }, {
+            path: string;
+            recursive?: boolean | undefined;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly delete_file: {
+        readonly description: "Delete a file (or directory with recursive=true). In standard mode this requires confirmation.";
+        readonly schema: z.ZodObject<{
+            path: z.ZodString;
+            recursive: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            recursive: boolean;
+        }, {
+            path: string;
+            recursive?: boolean | undefined;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly move_file: {
+        readonly description: "Move or rename a file/directory path. In standard mode this requires confirmation.";
+        readonly schema: z.ZodObject<{
+            source_path: z.ZodString;
+            destination_path: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            source_path: string;
+            destination_path: string;
+        }, {
+            source_path: string;
+            destination_path: string;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly get_file_info: {
+        readonly description: "Get file metadata (type, size, timestamps, permissions) for a path.";
+        readonly schema: z.ZodObject<{
+            path: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+        }, {
+            path: string;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly search_files: {
+        readonly description: "Search file contents using ripgrep (or fallback scan). Returns file:line:content matches.";
+        readonly schema: z.ZodObject<{
+            pattern: z.ZodString;
+            directory: z.ZodOptional<z.ZodString>;
+            case_sensitive: z.ZodDefault<z.ZodBoolean>;
+            max_results: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            pattern: string;
+            case_sensitive: boolean;
+            max_results: number;
+            directory?: string | undefined;
+        }, {
+            pattern: string;
+            directory?: string | undefined;
+            case_sensitive?: boolean | undefined;
+            max_results?: number | undefined;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly find_files: {
+        readonly description: "Find files by glob pattern, for example **/*.ts. Returns absolute paths.";
+        readonly schema: z.ZodObject<{
+            glob_pattern: z.ZodString;
+            directory: z.ZodOptional<z.ZodString>;
+            max_results: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            max_results: number;
+            glob_pattern: string;
+            directory?: string | undefined;
+        }, {
+            glob_pattern: string;
+            directory?: string | undefined;
+            max_results?: number | undefined;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly show_diff: {
+        readonly description: "Show a colored unified diff between a file on disk and proposed new content. Use before write_to_file to preview changes.";
+        readonly schema: z.ZodObject<{
+            absolute_path: z.ZodString;
+            new_content: z.ZodString;
+            context_lines: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            absolute_path: string;
+            new_content: string;
+            context_lines: number;
+        }, {
+            absolute_path: string;
+            new_content: string;
+            context_lines?: number | undefined;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly search_and_replace_all: {
+        readonly description: "Search for a pattern across all files in a directory and replace it. Use dry_run=true (default) to preview before writing.";
+        readonly schema: z.ZodObject<{
+            directory: z.ZodString;
+            search_pattern: z.ZodString;
+            replace_string: z.ZodString;
+            glob: z.ZodOptional<z.ZodString>;
+            regex: z.ZodDefault<z.ZodBoolean>;
+            dry_run: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            replace_string: string;
+            directory: string;
+            search_pattern: string;
+            regex: boolean;
+            dry_run: boolean;
+            glob?: string | undefined;
+        }, {
+            replace_string: string;
+            directory: string;
+            search_pattern: string;
+            glob?: string | undefined;
+            regex?: boolean | undefined;
+            dry_run?: boolean | undefined;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly fetch_url: {
+        readonly description: "Fetch an HTTP/HTTPS URL and return the response text (with optional truncation).";
+        readonly schema: z.ZodObject<{
+            url: z.ZodString;
+            max_bytes: z.ZodDefault<z.ZodNumber>;
+            timeout_ms: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            max_bytes: number;
+            timeout_ms: number;
+        }, {
+            url: string;
+            max_bytes?: number | undefined;
+            timeout_ms?: number | undefined;
+        }>;
+        readonly handler: (args: Record<string, unknown>, context: ToolExecutionContext) => Promise<string>;
+    };
+    readonly run_bash_command: {
+        readonly description: "Run a shell command in the current working directory. Dangerous patterns are blocked.";
+        readonly schema: z.ZodObject<{
+            command: z.ZodString;
+            timeout_ms: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            command: string;
+            timeout_ms?: number | undefined;
+        }, {
+            command: string;
+            timeout_ms?: number | undefined;
+        }>;
+        readonly handler: (args: Record<string, unknown>, context: ToolExecutionContext) => Promise<string>;
+    };
+    readonly git_status: {
+        readonly description: "Show git working tree status (short format with branch info).";
+        readonly schema: z.ZodObject<{
+            path: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            path?: string | undefined;
+        }, {
+            path?: string | undefined;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly git_diff: {
+        readonly description: "Show git diff for the working tree, staged changes, or against a base commit/branch.";
+        readonly schema: z.ZodObject<{
+            path: z.ZodOptional<z.ZodString>;
+            staged: z.ZodDefault<z.ZodBoolean>;
+            base: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            staged: boolean;
+            path?: string | undefined;
+            base?: string | undefined;
+        }, {
+            path?: string | undefined;
+            staged?: boolean | undefined;
+            base?: string | undefined;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly git_log: {
+        readonly description: "Show recent git commit history, optionally filtered to a file.";
+        readonly schema: z.ZodObject<{
+            path: z.ZodOptional<z.ZodString>;
+            n: z.ZodDefault<z.ZodNumber>;
+            oneline: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            n: number;
+            oneline: boolean;
+            path?: string | undefined;
+        }, {
+            path?: string | undefined;
+            n?: number | undefined;
+            oneline?: boolean | undefined;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly git_blame: {
+        readonly description: "Show who last modified each line of a file (git blame).";
+        readonly schema: z.ZodObject<{
+            absolute_path: z.ZodString;
+            start_line: z.ZodOptional<z.ZodNumber>;
+            end_line: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            absolute_path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+        }, {
+            absolute_path: string;
+            start_line?: number | undefined;
+            end_line?: number | undefined;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly git_stash: {
+        readonly description: "List all stashes or show the diff of the top stash.";
+        readonly schema: z.ZodObject<{
+            action: z.ZodDefault<z.ZodEnum<["list", "show"]>>;
+        }, "strip", z.ZodTypeAny, {
+            action: "list" | "show";
+        }, {
+            action?: "list" | "show" | undefined;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly run_linter: {
+        readonly description: "Run a linter (eslint, tsc, ruff, mypy, clippy, golangci-lint — auto-detected from project files).";
+        readonly schema: z.ZodObject<{
+            path: z.ZodOptional<z.ZodString>;
+            linter: z.ZodDefault<z.ZodEnum<["auto", "eslint", "tsc", "ruff", "mypy", "clippy", "golangci", "biome"]>>;
+            fix: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            linter: "eslint" | "tsc" | "ruff" | "mypy" | "clippy" | "golangci" | "biome" | "auto";
+            fix: boolean;
+            path?: string | undefined;
+        }, {
+            path?: string | undefined;
+            linter?: "eslint" | "tsc" | "ruff" | "mypy" | "clippy" | "golangci" | "biome" | "auto" | undefined;
+            fix?: boolean | undefined;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly run_tests: {
+        readonly description: "Run the project's test suite (vitest, jest, pytest, cargo test, go test — auto-detected).";
+        readonly schema: z.ZodObject<{
+            path: z.ZodOptional<z.ZodString>;
+            runner: z.ZodDefault<z.ZodEnum<["auto", "vitest", "jest", "npm_test", "pytest", "cargo_test", "go_test"]>>;
+            pattern: z.ZodOptional<z.ZodString>;
+            bail: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            runner: "npm_test" | "vitest" | "jest" | "pytest" | "cargo_test" | "go_test" | "auto";
+            bail: boolean;
+            path?: string | undefined;
+            pattern?: string | undefined;
+        }, {
+            path?: string | undefined;
+            pattern?: string | undefined;
+            runner?: "npm_test" | "vitest" | "jest" | "pytest" | "cargo_test" | "go_test" | "auto" | undefined;
+            bail?: boolean | undefined;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+    readonly security_scan: {
+        readonly description: "Scan source files for security issues: hardcoded secrets, XSS, SQL injection, eval usage, weak crypto, etc.";
+        readonly schema: z.ZodObject<{
+            path: z.ZodString;
+            include_low_severity: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            include_low_severity: boolean;
+        }, {
+            path: string;
+            include_low_severity?: boolean | undefined;
+        }>;
+        readonly handler: (args: Record<string, unknown>) => Promise<string>;
+    };
+};
+export type ToolName = keyof typeof TOOL_REGISTRY;
+export declare const TOOL_DEFINITIONS: {
+    type: "function";
+    function: {
+        name: string;
+        description: "Read a local file. Supports optional line-range reads via start_line/end_line." | "Write content to a local file. In standard mode this requires confirmation." | "Safely replace one exact text block in an existing file. Fails if match count is not exactly one." | "List files and folders in a directory." | "Create a directory (and optionally parent directories)." | "Delete a file (or directory with recursive=true). In standard mode this requires confirmation." | "Move or rename a file/directory path. In standard mode this requires confirmation." | "Get file metadata (type, size, timestamps, permissions) for a path." | "Search file contents using ripgrep (or fallback scan). Returns file:line:content matches." | "Find files by glob pattern, for example **/*.ts. Returns absolute paths." | "Show a colored unified diff between a file on disk and proposed new content. Use before write_to_file to preview changes." | "Search for a pattern across all files in a directory and replace it. Use dry_run=true (default) to preview before writing." | "Fetch an HTTP/HTTPS URL and return the response text (with optional truncation)." | "Run a shell command in the current working directory. Dangerous patterns are blocked." | "Show git working tree status (short format with branch info)." | "Show git diff for the working tree, staged changes, or against a base commit/branch." | "Show recent git commit history, optionally filtered to a file." | "Show who last modified each line of a file (git blame)." | "List all stashes or show the diff of the top stash." | "Run a linter (eslint, tsc, ruff, mypy, clippy, golangci-lint — auto-detected from project files)." | "Run the project's test suite (vitest, jest, pytest, cargo test, go test — auto-detected)." | "Scan source files for security issues: hardcoded secrets, XSS, SQL injection, eval usage, weak crypto, etc.";
+        parameters: object & {
+            $schema?: string | undefined;
+            definitions?: {
+                [key: string]: object;
+            } | undefined;
+        };
+    };
+}[];
+export declare const TOOL_MAP: Record<ToolName, ToolHandler>;
+export declare function configureToolRuntime(config: Partial<ToolRuntimeConfig>): void;
+export declare function listAvailableTools(): Array<{
+    name: ToolName;
+    description: string;
+}>;
+export declare function getToolRuntime(): ToolRuntimeConfig;
+export type { ToolExecutionContext, ToolRuntimeConfig, PermissionMode };
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAoDxB,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAQpE,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmImC,CAAC;AAEvD,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,aAAa,CAAC;AAElD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;GAS5B,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,CAEjB,CAAC;AAEnC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAE7E;AAED,wBAAgB,kBAAkB,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAKnF;AAED,wBAAgB,cAAc,IAAI,iBAAiB,CAElD;AAED,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,cAAc,EAAE,CAAC"}