grok-agent 0.5.0

package/dist/tools/grep.js

@@ -0,0 +1,102 @@
+import fs from "node:fs";
+import path from "node:path";
+import fg from "fast-glob";
+import { ensurePathAllowed } from "./policy.js";
+const MAX_RESULTS = 100;
+const MAX_FILE_SIZE = 2 * 1024 * 1024; // 2MB
+export async function executeGrep(args, projectCwd, options) {
+    const searchPath = args.path ? path.resolve(projectCwd, args.path) : projectCwd;
+    const maxResults = Math.min(args.max_results || MAX_RESULTS, 500);
+    const sandboxError = ensurePathAllowed(searchPath, projectCwd, options.sandboxMode || "danger-full-access", "read");
+    if (sandboxError)
+        return sandboxError;
+    try {
+        const regex = new RegExp(args.pattern, args.ignore_case ? "gi" : "g");
+        // If searchPath is a file, search just that file
+        if (fs.existsSync(searchPath) && fs.statSync(searchPath).isFile()) {
+            return searchFile(searchPath, regex, maxResults, projectCwd);
+        }
+        // Otherwise, search directory
+        const globPattern = args.include || "**/*";
+        const files = await fg(globPattern, {
+            cwd: searchPath,
+            dot: false,
+            onlyFiles: true,
+            ignore: [
+                "**/node_modules/**",
+                "**/.git/**",
+                "**/dist/**",
+                "**/build/**",
+                "**/__pycache__/**",
+                "**/.venv/**",
+                "**/target/**",
+                "**/*.min.js",
+                "**/*.map",
+                "**/package-lock.json",
+                "**/pnpm-lock.yaml",
+                "**/yarn.lock",
+            ],
+        });
+        const matches = [];
+        for (const file of files) {
+            if (matches.length >= maxResults)
+                break;
+            const fullPath = path.join(searchPath, file);
+            try {
+                const stat = fs.statSync(fullPath);
+                if (stat.size > MAX_FILE_SIZE)
+                    continue;
+                const content = fs.readFileSync(fullPath, "utf-8");
+                const lines = content.split("\n");
+                for (let i = 0; i < lines.length; i++) {
+                    if (matches.length >= maxResults)
+                        break;
+                    if (regex.test(lines[i])) {
+                        const relativePath = path.relative(projectCwd, fullPath);
+                        matches.push(`${relativePath}:${i + 1}: ${lines[i].trimEnd()}`);
+                    }
+                    regex.lastIndex = 0; // Reset regex state
+                }
+            }
+            catch {
+                // Skip files we can't read (binary, permissions, etc)
+            }
+        }
+        if (matches.length === 0) {
+            return { output: `No matches for pattern: ${args.pattern}` };
+        }
+        let output = matches.join("\n");
+        if (matches.length >= maxResults) {
+            output += `\n... (limited to ${maxResults} results)`;
+        }
+        return { output: `${matches.length} match(es) for /${args.pattern}/:\n${output}` };
+    }
+    catch (err) {
+        if (err instanceof SyntaxError) {
+            return { output: `Invalid regex pattern: ${err.message}`, error: true };
+        }
+        return { output: `Grep error: ${err.message}`, error: true };
+    }
+}
+function searchFile(filePath, regex, maxResults, projectCwd) {
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        const lines = content.split("\n");
+        const matches = [];
+        const relativePath = path.relative(projectCwd, filePath);
+        for (let i = 0; i < lines.length && matches.length < maxResults; i++) {
+            if (regex.test(lines[i])) {
+                matches.push(`${relativePath}:${i + 1}: ${lines[i].trimEnd()}`);
+            }
+            regex.lastIndex = 0;
+        }
+        if (matches.length === 0) {
+            return { output: `No matches in ${relativePath}` };
+        }
+        return { output: `${matches.length} match(es):\n${matches.join("\n")}` };
+    }
+    catch (err) {
+        return { output: `Error searching file: ${err.message}`, error: true };
+    }
+}
+//# 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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"}

package/dist/tools/index.d.ts

@@ -0,0 +1,10 @@
+import type { ToolResult } from "../types.js";
+import { toolDefinitions } from "./definitions.js";
+import type { SandboxMode } from "../types.js";
+export { toolDefinitions };
+export interface ToolExecutionOptions {
+    sandboxMode?: SandboxMode;
+}
+export declare function setMaxOutputTokens(n: number): void;
+export declare function executeTool(name: string, argsJson: string, cwd: string, options?: ToolExecutionOptions): Promise<ToolResult>;
+//# 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,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AASnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAeD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAyB;AAE5E,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,UAAU,CAAC,CAkBrB"}

package/dist/tools/index.js

@@ -0,0 +1,41 @@
+import { toolDefinitions } from "./definitions.js";
+import { executeBash } from "./bash.js";
+import { executeReadFile } from "./read-file.js";
+import { executeWriteFile } from "./write-file.js";
+import { executeEditFile } from "./edit-file.js";
+import { executeGlob } from "./glob.js";
+import { executeGrep } from "./grep.js";
+import { executeListDir } from "./list-dir.js";
+import { truncateOutput } from "../truncation.js";
+export { toolDefinitions };
+const executors = {
+    bash: executeBash,
+    read_file: executeReadFile,
+    write_file: executeWriteFile,
+    edit_file: executeEditFile,
+    glob: executeGlob,
+    grep: executeGrep,
+    list_directory: executeListDir,
+};
+let maxOutputTokens = 8000;
+export function setMaxOutputTokens(n) { maxOutputTokens = n; }
+export async function executeTool(name, argsJson, cwd, options = {}) {
+    const executor = executors[name];
+    if (!executor) {
+        return { output: `Unknown tool: ${name}`, error: true };
+    }
+    try {
+        const args = JSON.parse(argsJson);
+        const result = await executor(args, cwd, options);
+        // Truncate large outputs to prevent context window blowup
+        result.output = truncateOutput(result.output, maxOutputTokens);
+        return result;
+    }
+    catch (err) {
+        if (err instanceof SyntaxError) {
+            return { output: `Invalid tool arguments JSON: ${err.message}`, error: true };
+        }
+        return { output: `Tool execution error: ${err.message}`, error: true };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,eAAe,EAAE,CAAC;AAQ3B,MAAM,SAAS,GAAiC;IAC9C,IAAI,EAAE,WAAW;IACjB,SAAS,EAAE,eAAe;IAC1B,UAAU,EAAE,gBAAgB;IAC5B,SAAS,EAAE,eAAe;IAC1B,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,cAAc,EAAE,cAAc;CAC/B,CAAC;AAEF,IAAI,eAAe,GAAG,IAAI,CAAC;AAC3B,MAAM,UAAU,kBAAkB,CAAC,CAAS,IAAU,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC;AAE5E,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,QAAgB,EAChB,GAAW,EACX,UAAgC,EAAE;IAElC,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,MAAM,EAAE,iBAAiB,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAClD,0DAA0D;QAC1D,MAAM,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QAC/D,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,IAAI,GAAG,YAAY,WAAW,EAAE,CAAC;YAC/B,OAAO,EAAE,MAAM,EAAE,gCAAgC,GAAG,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAChF,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,yBAAyB,GAAG,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzE,CAAC;AACH,CAAC"}

package/dist/tools/list-dir.d.ts

@@ -0,0 +1,7 @@
+import type { ToolResult } from "../types.js";
+import type { ToolExecutionOptions } from "./index.js";
+export declare function executeListDir(args: {
+    path?: string;
+    recursive?: boolean;
+}, projectCwd: string, options: ToolExecutionOptions): Promise<ToolResult>;
+//# sourceMappingURL=list-dir.d.ts.map

package/dist/tools/list-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-dir.d.ts","sourceRoot":"","sources":["../../src/tools/list-dir.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAKvD,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CA8BzE"}

package/dist/tools/list-dir.js

@@ -0,0 +1,68 @@
+import fs from "node:fs";
+import path from "node:path";
+import { ensurePathAllowed } from "./policy.js";
+const MAX_ENTRIES = 500;
+export async function executeListDir(args, projectCwd, options) {
+    const dirPath = args.path ? path.resolve(projectCwd, args.path) : projectCwd;
+    const sandboxError = ensurePathAllowed(dirPath, projectCwd, options.sandboxMode || "danger-full-access", "read");
+    if (sandboxError)
+        return sandboxError;
+    try {
+        if (!fs.existsSync(dirPath)) {
+            return { output: `Directory not found: ${dirPath}`, error: true };
+        }
+        if (!fs.statSync(dirPath).isDirectory()) {
+            return { output: `Not a directory: ${dirPath}`, error: true };
+        }
+        const entries = [];
+        listRecursive(dirPath, "", entries, args.recursive ? 3 : 0, 0);
+        if (entries.length === 0) {
+            return { output: `Empty directory: ${args.path || "."}` };
+        }
+        let output = entries.join("\n");
+        if (entries.length >= MAX_ENTRIES) {
+            output += "\n... (truncated)";
+        }
+        return { output };
+    }
+    catch (err) {
+        return { output: `Error listing directory: ${err.message}`, error: true };
+    }
+}
+function listRecursive(basePath, relativePath, entries, maxDepth, currentDepth) {
+    if (entries.length >= MAX_ENTRIES)
+        return;
+    const fullPath = path.join(basePath, relativePath);
+    const items = fs.readdirSync(fullPath, { withFileTypes: true });
+    // Sort: directories first, then files
+    const sorted = items.sort((a, b) => {
+        if (a.isDirectory() && !b.isDirectory())
+            return -1;
+        if (!a.isDirectory() && b.isDirectory())
+            return 1;
+        return a.name.localeCompare(b.name);
+    });
+    const skipDirs = new Set([
+        "node_modules", ".git", "dist", "build", ".next",
+        "coverage", "__pycache__", ".venv", "target", ".cache",
+    ]);
+    for (const item of sorted) {
+        if (entries.length >= MAX_ENTRIES)
+            return;
+        const itemRelative = relativePath ? `${relativePath}/${item.name}` : item.name;
+        if (item.isDirectory()) {
+            if (skipDirs.has(item.name))
+                continue;
+            const indent = "  ".repeat(currentDepth);
+            entries.push(`${indent}${item.name}/`);
+            if (currentDepth < maxDepth) {
+                listRecursive(basePath, itemRelative, entries, maxDepth, currentDepth + 1);
+            }
+        }
+        else {
+            const indent = "  ".repeat(currentDepth);
+            entries.push(`${indent}${item.name}`);
+        }
+    }
+}
+//# sourceMappingURL=list-dir.js.map

package/dist/tools/list-dir.js.map

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

package/dist/tools/policy.d.ts

@@ -0,0 +1,4 @@
+import type { SandboxMode, ToolResult } from "../types.js";
+export declare function ensurePathAllowed(inputPath: string, projectCwd: string, sandboxMode: SandboxMode, access: "read" | "write"): ToolResult | null;
+export declare function ensureCommandAllowed(sandboxMode: SandboxMode): ToolResult | null;
+//# sourceMappingURL=policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/tools/policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM3D,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,GAAG,OAAO,GACvB,UAAU,GAAG,IAAI,CAwBnB;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,GAAG,IAAI,CAShF"}

package/dist/tools/policy.js

@@ -0,0 +1,36 @@
+import path from "node:path";
+function normalizePath(p) {
+    return path.resolve(p);
+}
+export function ensurePathAllowed(inputPath, projectCwd, sandboxMode, access) {
+    if (sandboxMode === "danger-full-access")
+        return null;
+    const resolvedPath = normalizePath(inputPath);
+    const root = normalizePath(projectCwd);
+    const relative = path.relative(root, resolvedPath);
+    const outsideWorkspace = relative.startsWith("..") || path.isAbsolute(relative) && !resolvedPath.startsWith(root);
+    if (outsideWorkspace) {
+        return {
+            output: `Sandbox policy (${sandboxMode}) blocks ${access} access outside the workspace: ${resolvedPath}`,
+            error: true,
+        };
+    }
+    if (sandboxMode === "read-only" && access === "write") {
+        return {
+            output: `Sandbox policy (read-only) blocks write access: ${resolvedPath}`,
+            error: true,
+        };
+    }
+    return null;
+}
+export function ensureCommandAllowed(sandboxMode) {
+    if (sandboxMode === "danger-full-access")
+        return null;
+    return {
+        output: sandboxMode === "read-only"
+            ? "Sandbox policy (read-only) blocks shell execution."
+            : "Sandbox policy (workspace-write) blocks shell execution. Use structured file tools instead or switch to --sandbox danger-full-access.",
+        error: true,
+    };
+}
+//# sourceMappingURL=policy.js.map

package/dist/tools/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/tools/policy.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,SAAS,aAAa,CAAC,CAAS;IAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,SAAiB,EACjB,UAAkB,EAClB,WAAwB,EACxB,MAAwB;IAExB,IAAI,WAAW,KAAK,oBAAoB;QAAE,OAAO,IAAI,CAAC;IAEtD,MAAM,YAAY,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACnD,MAAM,gBAAgB,GACpB,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAE3F,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO;YACL,MAAM,EAAE,mBAAmB,WAAW,YAAY,MAAM,kCAAkC,YAAY,EAAE;YACxG,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAED,IAAI,WAAW,KAAK,WAAW,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACtD,OAAO;YACL,MAAM,EAAE,mDAAmD,YAAY,EAAE;YACzE,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,WAAwB;IAC3D,IAAI,WAAW,KAAK,oBAAoB;QAAE,OAAO,IAAI,CAAC;IACtD,OAAO;QACL,MAAM,EACJ,WAAW,KAAK,WAAW;YACzB,CAAC,CAAC,oDAAoD;YACtD,CAAC,CAAC,uIAAuI;QAC7I,KAAK,EAAE,IAAI;KACZ,CAAC;AACJ,CAAC"}

package/dist/tools/read-file.d.ts

@@ -0,0 +1,8 @@
+import type { ToolResult } from "../types.js";
+import type { ToolExecutionOptions } from "./index.js";
+export declare function executeReadFile(args: {
+    file_path: string;
+    offset?: number;
+    limit?: number;
+}, projectCwd: string, options: ToolExecutionOptions): Promise<ToolResult>;
+//# sourceMappingURL=read-file.d.ts.map

package/dist/tools/read-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAKvD,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CA4CzE"}

package/dist/tools/read-file.js

@@ -0,0 +1,45 @@
+import fs from "node:fs";
+import path from "node:path";
+import { ensurePathAllowed } from "./policy.js";
+const MAX_LINES = 5000;
+export async function executeReadFile(args, projectCwd, options) {
+    const filePath = path.resolve(projectCwd, args.file_path);
+    const offset = Math.max((args.offset || 1) - 1, 0); // Convert 1-based to 0-based
+    const limit = Math.min(args.limit || 2000, MAX_LINES);
+    const sandboxError = ensurePathAllowed(filePath, projectCwd, options.sandboxMode || "danger-full-access", "read");
+    if (sandboxError)
+        return sandboxError;
+    try {
+        if (!fs.existsSync(filePath)) {
+            return { output: `File not found: ${filePath}`, error: true };
+        }
+        const stat = fs.statSync(filePath);
+        if (stat.isDirectory()) {
+            return { output: `Path is a directory, not a file: ${filePath}`, error: true };
+        }
+        // Warn on very large files
+        if (stat.size > 5 * 1024 * 1024) {
+            return {
+                output: `File is very large (${(stat.size / 1024 / 1024).toFixed(1)}MB). Use offset/limit to read specific portions.`,
+                error: true,
+            };
+        }
+        const content = fs.readFileSync(filePath, "utf-8");
+        const lines = content.split("\n");
+        const selected = lines.slice(offset, offset + limit);
+        // Format with line numbers
+        const numbered = selected
+            .map((line, i) => `${offset + i + 1}\t${line}`)
+            .join("\n");
+        const total = lines.length;
+        let header = `File: ${args.file_path} (${total} lines)`;
+        if (offset > 0 || offset + limit < total) {
+            header += ` — showing lines ${offset + 1}-${Math.min(offset + limit, total)}`;
+        }
+        return { output: `${header}\n${numbered}` };
+    }
+    catch (err) {
+        return { output: `Error reading file: ${err.message}`, error: true };
+    }
+}
+//# sourceMappingURL=read-file.js.map

package/dist/tools/read-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.js","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,SAAS,GAAG,IAAI,CAAC;AAEvB,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAIrC,EAAE,UAAkB,EAAE,OAA6B;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,6BAA6B;IACjF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE,SAAS,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,iBAAiB,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,WAAW,IAAI,oBAAoB,EAAE,MAAM,CAAC,CAAC;IAClH,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAEtC,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,MAAM,EAAE,mBAAmB,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAChE,CAAC;QAED,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,OAAO,EAAE,MAAM,EAAE,oCAAoC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACjF,CAAC;QAED,2BAA2B;QAC3B,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;YAChC,OAAO;gBACL,MAAM,EAAE,uBAAuB,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,kDAAkD;gBACrH,KAAK,EAAE,IAAI;aACZ,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;QAErD,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,QAAQ;aACtB,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;aAC9C,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,MAAM,GAAG,SAAS,IAAI,CAAC,SAAS,KAAK,KAAK,SAAS,CAAC;QACxD,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,KAAK,GAAG,KAAK,EAAE,CAAC;YACzC,MAAM,IAAI,oBAAoB,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;QAChF,CAAC;QAED,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,QAAQ,EAAE,EAAE,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,uBAAuB,GAAG,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACvE,CAAC;AACH,CAAC"}

package/dist/tools/write-file.d.ts

@@ -0,0 +1,7 @@
+import type { ToolResult } from "../types.js";
+import type { ToolExecutionOptions } from "./index.js";
+export declare function executeWriteFile(args: {
+    file_path: string;
+    content: string;
+}, projectCwd: string, options: ToolExecutionOptions): Promise<ToolResult>;
+//# sourceMappingURL=write-file.d.ts.map

package/dist/tools/write-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.d.ts","sourceRoot":"","sources":["../../src/tools/write-file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGvD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiCzE"}

package/dist/tools/write-file.js

@@ -0,0 +1,35 @@
+import fs from "node:fs";
+import path from "node:path";
+import { ensurePathAllowed } from "./policy.js";
+export async function executeWriteFile(args, projectCwd, options) {
+    const filePath = path.resolve(projectCwd, args.file_path);
+    const sandboxError = ensurePathAllowed(filePath, projectCwd, options.sandboxMode || "danger-full-access", "write");
+    if (sandboxError)
+        return sandboxError;
+    // Safety: block writing to sensitive paths
+    const basename = path.basename(filePath).toLowerCase();
+    const sensitiveFiles = [".env", "credentials.json", "secrets.json", ".npmrc"];
+    if (sensitiveFiles.some(s => basename === s || basename.startsWith(".env"))) {
+        return {
+            output: `Refusing to write to sensitive file: ${basename}. This could expose secrets.`,
+            error: true,
+        };
+    }
+    try {
+        const dir = path.dirname(filePath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        const existed = fs.existsSync(filePath);
+        fs.writeFileSync(filePath, args.content, "utf-8");
+        const lines = args.content.split("\n").length;
+        const bytes = Buffer.byteLength(args.content, "utf-8");
+        return {
+            output: `${existed ? "Updated" : "Created"} ${args.file_path} (${lines} lines, ${bytes} bytes)`,
+        };
+    }
+    catch (err) {
+        return { output: `Error writing file: ${err.message}`, error: true };
+    }
+}
+//# sourceMappingURL=write-file.js.map

package/dist/tools/write-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.js","sourceRoot":"","sources":["../../src/tools/write-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAGtC,EAAE,UAAkB,EAAE,OAA6B;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,iBAAiB,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,WAAW,IAAI,oBAAoB,EAAE,OAAO,CAAC,CAAC;IACnH,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAEtC,2CAA2C;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACvD,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;IAC9E,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,KAAK,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QAC5E,OAAO;YACL,MAAM,EAAE,wCAAwC,QAAQ,8BAA8B;YACtF,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACxC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAElD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAEvD,OAAO;YACL,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,KAAK,WAAW,KAAK,SAAS;SAChG,CAAC;IACJ,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,uBAAuB,GAAG,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACvE,CAAC;AACH,CAAC"}

package/dist/truncation.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Token estimation and output truncation.
+ * Prevents massive tool outputs from blowing the context window.
+ */
+export declare function approxTokenCountFromChars(charCount: number): number;
+export declare function approxTokenCount(text: string): number;
+export declare function approxBytesForTokens(tokens: number): number;
+/**
+ * Truncate output to fit within a token budget.
+ * Preserves the beginning and end, inserting a truncation notice in the middle.
+ */
+export declare function truncateOutput(output: string, maxTokens?: number): string;
+//# sourceMappingURL=truncation.d.ts.map

package/dist/truncation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncation.d.ts","sourceRoot":"","sources":["../src/truncation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,MAAa,GACvB,MAAM,CAqCR"}

package/dist/truncation.js

@@ -0,0 +1,55 @@
+/**
+ * Token estimation and output truncation.
+ * Prevents massive tool outputs from blowing the context window.
+ */
+// Rough approximation: ~4 chars per token for English text
+const CHARS_PER_TOKEN = 4;
+export function approxTokenCountFromChars(charCount) {
+    return Math.ceil(Math.max(0, charCount) / CHARS_PER_TOKEN);
+}
+export function approxTokenCount(text) {
+    return approxTokenCountFromChars(text.length);
+}
+export function approxBytesForTokens(tokens) {
+    return tokens * CHARS_PER_TOKEN;
+}
+/**
+ * Truncate output to fit within a token budget.
+ * Preserves the beginning and end, inserting a truncation notice in the middle.
+ */
+export function truncateOutput(output, maxTokens = 8000) {
+    const estimatedTokens = approxTokenCount(output);
+    if (estimatedTokens <= maxTokens)
+        return output;
+    const maxChars = maxTokens * CHARS_PER_TOKEN;
+    const keepStart = Math.floor(maxChars * 0.6); // 60% from start
+    const keepEnd = Math.floor(maxChars * 0.3); // 30% from end
+    const lines = output.split("\n");
+    const totalLines = lines.length;
+    // Find line boundaries
+    let startChars = 0;
+    let startLineEnd = 0;
+    for (let i = 0; i < lines.length; i++) {
+        if (startChars + lines[i].length + 1 > keepStart)
+            break;
+        startChars += lines[i].length + 1;
+        startLineEnd = i + 1;
+    }
+    let endChars = 0;
+    let endLineStart = lines.length;
+    for (let i = lines.length - 1; i >= 0; i--) {
+        if (endChars + lines[i].length + 1 > keepEnd)
+            break;
+        endChars += lines[i].length + 1;
+        endLineStart = i;
+    }
+    if (startLineEnd >= endLineStart) {
+        // Overlap — just hard truncate
+        return output.slice(0, maxChars) + `\n\n[... truncated, ${totalLines} total lines, ~${estimatedTokens} tokens]`;
+    }
+    const omitted = endLineStart - startLineEnd;
+    const head = lines.slice(0, startLineEnd).join("\n");
+    const tail = lines.slice(endLineStart).join("\n");
+    return `${head}\n\n[... ${omitted} lines omitted, ${totalLines} total lines, ~${estimatedTokens} tokens ...]\n\n${tail}`;
+}
+//# sourceMappingURL=truncation.js.map

package/dist/truncation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"truncation.js","sourceRoot":"","sources":["../src/truncation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,2DAA2D;AAC3D,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,MAAM,UAAU,yBAAyB,CAAC,SAAiB;IACzD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,eAAe,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,MAAM,GAAG,eAAe,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAc,EACd,YAAoB,IAAI;IAExB,MAAM,eAAe,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,eAAe,IAAI,SAAS;QAAE,OAAO,MAAM,CAAC;IAEhD,MAAM,QAAQ,GAAG,SAAS,GAAG,eAAe,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,iBAAiB;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAG,eAAe;IAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;IAEhC,uBAAuB;IACvB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG,SAAS;YAAE,MAAM;QACxD,UAAU,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAClC,YAAY,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,IAAI,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG,OAAO;YAAE,MAAM;QACpD,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAChC,YAAY,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,IAAI,YAAY,IAAI,YAAY,EAAE,CAAC;QACjC,+BAA+B;QAC/B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,uBAAuB,UAAU,kBAAkB,eAAe,UAAU,CAAC;IAClH,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,GAAG,YAAY,CAAC;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAElD,OAAO,GAAG,IAAI,YAAY,OAAO,mBAAmB,UAAU,kBAAkB,eAAe,mBAAmB,IAAI,EAAE,CAAC;AAC3H,CAAC"}