@mragentix/cli 4.2.37

package/dist/tools/edit-diff.js

@@ -0,0 +1,92 @@
+import { diffLines } from "diff";
+/**
+ * Normalize text for fuzzy matching:
+ * - Strip trailing whitespace per line
+ * - Replace smart quotes with straight quotes
+ * - Replace unicode dashes with hyphens
+ */
+function normalizeForFuzzyMatch(text) {
+    return text
+        .replace(/[^\S\n]+$/gm, "") // trailing whitespace per line
+        .replace(/[\u2018\u2019]/g, "'") // smart single quotes
+        .replace(/[\u201C\u201D]/g, '"') // smart double quotes
+        .replace(/[\u2013\u2014]/g, "-"); // en/em dashes
+}
+/**
+ * Find text in content, trying exact match first then fuzzy.
+ */
+export function fuzzyFindText(content, oldText) {
+    // Exact match first
+    const exactIndex = content.indexOf(oldText);
+    if (exactIndex !== -1) {
+        return { found: true, index: exactIndex, matchLength: oldText.length, usedFuzzy: false };
+    }
+    // Fuzzy match: normalize both sides
+    const normalizedContent = normalizeForFuzzyMatch(content);
+    const normalizedOld = normalizeForFuzzyMatch(oldText);
+    const fuzzyIndex = normalizedContent.indexOf(normalizedOld);
+    if (fuzzyIndex !== -1) {
+        // Map back to original content: find the actual length in original
+        // Since normalization only changes per-character substitutions and trailing whitespace,
+        // we need to find the original range.
+        // Strategy: match line by line to find the original span.
+        const normalizedBefore = normalizedContent.slice(0, fuzzyIndex);
+        const linesBefore = normalizedBefore.split("\n").length - 1;
+        const normalizedMatch = normalizedContent.slice(fuzzyIndex, fuzzyIndex + normalizedOld.length);
+        const matchLineCount = normalizedMatch.split("\n").length;
+        const contentLines = content.split("\n");
+        const matchLines = contentLines.slice(linesBefore, linesBefore + matchLineCount);
+        const originalMatch = matchLines.join("\n");
+        // Find actual index of the first match line start
+        let actualIndex = 0;
+        for (let i = 0; i < linesBefore; i++) {
+            actualIndex += contentLines[i].length + 1; // +1 for \n
+        }
+        return {
+            found: true,
+            index: actualIndex,
+            matchLength: originalMatch.length,
+            usedFuzzy: true,
+        };
+    }
+    return { found: false, index: -1, matchLength: 0, usedFuzzy: false };
+}
+/**
+ * Count occurrences of oldText in content (exact first, then fuzzy).
+ */
+export function countOccurrences(content, oldText) {
+    // Try exact first
+    let count = 0;
+    let pos = 0;
+    while ((pos = content.indexOf(oldText, pos)) !== -1) {
+        count++;
+        pos += oldText.length;
+    }
+    if (count > 0)
+        return count;
+    // Fuzzy count
+    const normalizedContent = normalizeForFuzzyMatch(content);
+    const normalizedOld = normalizeForFuzzyMatch(oldText);
+    pos = 0;
+    while ((pos = normalizedContent.indexOf(normalizedOld, pos)) !== -1) {
+        count++;
+        pos += normalizedOld.length;
+    }
+    return count;
+}
+/**
+ * Generate a unified diff string.
+ */
+export function generateDiff(oldContent, newContent, filePath) {
+    const changes = diffLines(oldContent, newContent);
+    const lines = [`--- a/${filePath}`, `+++ b/${filePath}`];
+    for (const change of changes) {
+        const prefix = change.added ? "+" : change.removed ? "-" : " ";
+        const changeLines = change.value.replace(/\n$/, "").split("\n");
+        for (const line of changeLines) {
+            lines.push(`${prefix}${line}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=edit-diff.js.map

package/dist/tools/edit-diff.js.map

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

package/dist/tools/edit.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+import type { AgentTool } from "@mragentix/agent";
+import { type ToolOperations } from "./operations.js";
+declare const EditParams: z.ZodObject<{
+    file_path: z.ZodString;
+    old_text: z.ZodString;
+    new_text: z.ZodString;
+}, z.core.$strip>;
+export declare function createEditTool(cwd: string, readFiles?: Set<string>, ops?: ToolOperations): AgentTool<typeof EditParams>;
+export {};
+//# sourceMappingURL=edit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../src/tools/edit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEvE,QAAA,MAAM,UAAU;;;;iBAId,CAAC;AAEH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,GAAG,GAAE,cAAgC,GACpC,SAAS,CAAC,OAAO,UAAU,CAAC,CA6D9B"}

package/dist/tools/edit.js

@@ -0,0 +1,57 @@
+import path from "node:path";
+import { z } from "zod";
+import { resolvePath, rejectSymlink } from "./path-utils.js";
+import { fuzzyFindText, countOccurrences, generateDiff } from "./edit-diff.js";
+import { localOperations } from "./operations.js";
+const EditParams = z.object({
+    file_path: z.string().describe("The file path to edit"),
+    old_text: z.string().describe("The exact text to find and replace"),
+    new_text: z.string().describe("The replacement text"),
+});
+export function createEditTool(cwd, readFiles, ops = localOperations) {
+    return {
+        name: "edit",
+        description: "Replace a specific text string in a file. The file must be read first before editing. " +
+            "The old_text must uniquely match exactly one location in the file. Returns a unified diff of the change.",
+        parameters: EditParams,
+        async execute({ file_path, old_text, new_text }) {
+            const resolved = resolvePath(cwd, file_path);
+            await rejectSymlink(resolved);
+            if (readFiles && !readFiles.has(resolved)) {
+                throw new Error("File must be read first before editing. Use the read tool first.");
+            }
+            const content = await ops.readFile(resolved);
+            // Detect line endings
+            const hasCRLF = content.includes("\r\n");
+            // Normalize for matching
+            const normalized = hasCRLF ? content.replace(/\r\n/g, "\n") : content;
+            const normalizedOld = hasCRLF ? old_text.replace(/\r\n/g, "\n") : old_text;
+            const normalizedNew = hasCRLF ? new_text.replace(/\r\n/g, "\n") : new_text;
+            // Check uniqueness
+            const occurrences = countOccurrences(normalized, normalizedOld);
+            if (occurrences === 0) {
+                throw new Error(`old_text not found in ${path.basename(resolved)}. ` +
+                    "Make sure the text matches exactly, including whitespace and indentation.");
+            }
+            if (occurrences > 1) {
+                throw new Error(`old_text found ${occurrences} times in ${path.basename(resolved)}. ` +
+                    "Include more surrounding context to make the match unique.");
+            }
+            // Find and replace
+            const match = fuzzyFindText(normalized, normalizedOld);
+            if (!match.found) {
+                throw new Error(`old_text not found in ${path.basename(resolved)}.`);
+            }
+            const newContent = normalized.slice(0, match.index) +
+                normalizedNew +
+                normalized.slice(match.index + match.matchLength);
+            // Restore line endings if needed
+            const finalContent = hasCRLF ? newContent.replace(/\n/g, "\r\n") : newContent;
+            await ops.writeFile(resolved, finalContent);
+            const relPath = path.relative(cwd, resolved);
+            const diff = generateDiff(normalized, newContent, relPath);
+            return diff;
+        },
+    };
+}
+//# 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/find.d.ts

@@ -0,0 +1,9 @@
+import { z } from "zod";
+import type { AgentTool } from "@mragentix/agent";
+declare const FindParams: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare function createFindTool(cwd: string): AgentTool<typeof FindParams>;
+export {};
+//# sourceMappingURL=find.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../src/tools/find.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,QAAA,MAAM,UAAU;;;iBAGd,CAAC;AAIH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC,OAAO,UAAU,CAAC,CA2CxE"}

package/dist/tools/find.js

@@ -0,0 +1,59 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { resolvePath } from "./path-utils.js";
+const FindParams = z.object({
+    pattern: z.string().describe("Glob pattern to match files (e.g. '**/*.ts', 'src/**/*.tsx')"),
+    path: z.string().optional().describe("Directory to search in (defaults to cwd)"),
+});
+const MAX_RESULTS = 100;
+export function createFindTool(cwd) {
+    return {
+        name: "find",
+        description: "Find files matching a glob pattern. Respects .gitignore. " +
+            "Returns sorted file paths, truncated if more than 100 matches.",
+        parameters: FindParams,
+        async execute({ pattern, path: searchPath }) {
+            const dir = searchPath ? resolvePath(cwd, searchPath) : cwd;
+            // Dynamic import for ESM-only fast-glob
+            const fg = await import("fast-glob");
+            const ignore = await import("ignore");
+            // Load .gitignore patterns
+            const ignorePatterns = await loadGitignore(dir);
+            const ig = ignore.default();
+            ig.add(ignorePatterns);
+            const entries = await fg.default(pattern, {
+                cwd: dir,
+                dot: false,
+                onlyFiles: true,
+                ignore: ["**/node_modules/**", "**/.git/**"],
+            });
+            // Filter by .gitignore
+            const filtered = entries.filter((entry) => !ig.ignores(entry));
+            filtered.sort();
+            const truncated = filtered.length > MAX_RESULTS;
+            const shown = truncated ? filtered.slice(0, MAX_RESULTS) : filtered;
+            let output = shown.join("\n");
+            if (truncated) {
+                output += `\n\n[Truncated: showing ${MAX_RESULTS} of ${filtered.length} matches]`;
+            }
+            else {
+                output += `\n\n${filtered.length} file(s) found`;
+            }
+            return output;
+        },
+    };
+}
+async function loadGitignore(dir) {
+    try {
+        const content = await fs.readFile(path.join(dir, ".gitignore"), "utf-8");
+        return content
+            .split("\n")
+            .map((l) => l.trim())
+            .filter((l) => l && !l.startsWith("#"));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=find.js.map

package/dist/tools/find.js.map

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

package/dist/tools/grep.d.ts

@@ -0,0 +1,13 @@
+import { z } from "zod";
+import type { AgentTool } from "@mragentix/agent";
+import { type ToolOperations } from "./operations.js";
+declare const GrepParams: z.ZodObject<{
+    pattern: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    include: z.ZodOptional<z.ZodString>;
+    max_results: z.ZodOptional<z.ZodNumber>;
+    case_insensitive: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare function createGrepTool(cwd: string, ops?: ToolOperations): AgentTool<typeof GrepParams>;
+export {};
+//# sourceMappingURL=grep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../src/tools/grep.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEvE,QAAA,MAAM,UAAU;;;;;;iBAWd,CAAC;AAKH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,cAAgC,GACpC,SAAS,CAAC,OAAO,UAAU,CAAC,CAyD9B"}

package/dist/tools/grep.js

@@ -0,0 +1,121 @@
+import readline from "node:readline";
+import path from "node:path";
+import { z } from "zod";
+import { resolvePath } from "./path-utils.js";
+import { BINARY_EXTENSIONS } from "./read.js";
+import { localOperations } from "./operations.js";
+const GrepParams = z.object({
+    pattern: z.string().describe("Search pattern (regex supported)"),
+    path: z.string().optional().describe("File or directory to search (defaults to cwd)"),
+    include: z.string().optional().describe("Glob pattern to filter files (e.g. '*.ts')"),
+    max_results: z
+        .number()
+        .int()
+        .min(1)
+        .optional()
+        .describe("Maximum matches to return (default: 50)"),
+    case_insensitive: z.boolean().optional().describe("Case-insensitive search"),
+});
+const DEFAULT_MAX_RESULTS = 50;
+const MAX_LINE_LENGTH = 500;
+export function createGrepTool(cwd, ops = localOperations) {
+    return {
+        name: "grep",
+        description: "Search file contents using regex. Returns filepath:line_number:content for matches. " +
+            "Respects .gitignore. Skips binary files.",
+        parameters: GrepParams,
+        async execute({ pattern, path: searchPath, include, max_results, case_insensitive }) {
+            const dir = searchPath ? resolvePath(cwd, searchPath) : cwd;
+            const maxResults = max_results ?? DEFAULT_MAX_RESULTS;
+            const flags = case_insensitive ? "gi" : "g";
+            let regex;
+            try {
+                regex = new RegExp(pattern, flags);
+            }
+            catch (err) {
+                throw new Error(`Invalid regex pattern: ${err.message}`, { cause: err });
+            }
+            // Check if dir is a file
+            const stat = await ops.stat(dir);
+            if (stat.isFile()) {
+                const results = await searchFile(dir, regex, cwd, maxResults, ops);
+                return formatResults(results, maxResults);
+            }
+            // Enumerate files
+            const fg = await import("fast-glob");
+            const globPattern = include ?? "**/*";
+            const entries = await fg.default(globPattern, {
+                cwd: dir,
+                dot: false,
+                onlyFiles: true,
+                ignore: ["**/node_modules/**", "**/.git/**"],
+            });
+            const results = [];
+            for (const entry of entries) {
+                if (results.length >= maxResults)
+                    break;
+                const ext = path.extname(entry).toLowerCase();
+                if (BINARY_EXTENSIONS.has(ext))
+                    continue;
+                const filePath = path.join(dir, entry);
+                const fileResults = await searchFile(filePath, regex, cwd, maxResults - results.length, ops);
+                results.push(...fileResults);
+            }
+            return formatResults(results, maxResults);
+        },
+    };
+}
+async function searchFile(filePath, regex, cwd, maxResults, ops) {
+    const results = [];
+    const relPath = path.relative(cwd, filePath);
+    const stream = ops.createReadStream(filePath, "utf-8");
+    try {
+        const rl = readline.createInterface({
+            input: stream,
+            crlfDelay: Infinity,
+        });
+        let lineNum = 0;
+        try {
+            for await (const line of rl) {
+                lineNum++;
+                // Bail out if line contains null bytes (binary file not caught by extension check)
+                if (lineNum <= 5 && line.includes("\0")) {
+                    break;
+                }
+                // Reset lastIndex for global regex
+                regex.lastIndex = 0;
+                if (regex.test(line)) {
+                    // Truncate long lines to prevent massive output from binary/minified files
+                    const truncatedLine = line.length > MAX_LINE_LENGTH ? line.slice(0, MAX_LINE_LENGTH) + "…" : line;
+                    results.push(`${relPath}:${lineNum}:${truncatedLine}`);
+                    if (results.length >= maxResults) {
+                        break;
+                    }
+                }
+            }
+        }
+        finally {
+            rl.close();
+        }
+    }
+    catch {
+        // Skip unreadable files
+    }
+    finally {
+        stream.destroy();
+    }
+    return results;
+}
+function formatResults(results, maxResults) {
+    if (results.length === 0)
+        return "No matches found.";
+    let output = results.join("\n");
+    if (results.length >= maxResults) {
+        output += `\n\n[Truncated at ${maxResults} matches]`;
+    }
+    else {
+        output += `\n\n${results.length} match(es) found`;
+    }
+    return output;
+}
+//# 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,30 @@
+import type { AgentTool } from "@mragentix/agent";
+import { ProcessManager } from "../core/process-manager.js";
+import { type ToolOperations } from "./operations.js";
+import type { AgentDefinition } from "../core/agents.js";
+export interface CreateToolsOptions {
+    agents?: AgentDefinition[];
+    provider?: string;
+    model?: string;
+    /** Custom I/O operations for remote execution (SSH, Docker, etc.). Defaults to local filesystem. */
+    operations?: ToolOperations;
+}
+export interface CreateToolsResult {
+    tools: AgentTool[];
+    processManager: ProcessManager;
+}
+export declare function createTools(cwd: string, opts?: CreateToolsOptions): CreateToolsResult;
+export { createReadTool } from "./read.js";
+export { createWriteTool } from "./write.js";
+export { createEditTool } from "./edit.js";
+export { createBashTool } from "./bash.js";
+export { createFindTool } from "./find.js";
+export { createGrepTool } from "./grep.js";
+export { createLsTool } from "./ls.js";
+export { createWebFetchTool } from "./web-fetch.js";
+export { createTaskOutputTool } from "./task-output.js";
+export { createTaskStopTool } from "./task-stop.js";
+export { createTasksTool } from "./tasks.js";
+export { ProcessManager } from "../core/process-manager.js";
+export { localOperations, type ToolOperations } from "./operations.js";
+//# 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,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAa5D,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oGAAoG;IACpG,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;CAChC;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,CAwBrF;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,50 @@
+import { ProcessManager } from "../core/process-manager.js";
+import { createReadTool } from "./read.js";
+import { createWriteTool } from "./write.js";
+import { createEditTool } from "./edit.js";
+import { createBashTool } from "./bash.js";
+import { createFindTool } from "./find.js";
+import { createGrepTool } from "./grep.js";
+import { createLsTool } from "./ls.js";
+import { createSubAgentTool } from "./subagent.js";
+import { createWebFetchTool } from "./web-fetch.js";
+import { createTaskOutputTool } from "./task-output.js";
+import { createTaskStopTool } from "./task-stop.js";
+import { createTasksTool } from "./tasks.js";
+import { localOperations } from "./operations.js";
+export function createTools(cwd, opts) {
+    const readFiles = new Set();
+    const processManager = new ProcessManager();
+    const ops = opts?.operations ?? localOperations;
+    const tools = [
+        createReadTool(cwd, readFiles, ops),
+        createWriteTool(cwd, readFiles, ops),
+        createEditTool(cwd, readFiles, ops),
+        createBashTool(cwd, processManager, ops),
+        createFindTool(cwd),
+        createGrepTool(cwd, ops),
+        createLsTool(cwd, ops),
+        createWebFetchTool(),
+        createTaskOutputTool(processManager),
+        createTaskStopTool(processManager),
+        createTasksTool(cwd),
+    ];
+    if (opts?.agents && opts.agents.length > 0 && opts.provider && opts.model) {
+        tools.push(createSubAgentTool(cwd, opts.agents, opts.provider, opts.model));
+    }
+    return { tools, processManager };
+}
+export { createReadTool } from "./read.js";
+export { createWriteTool } from "./write.js";
+export { createEditTool } from "./edit.js";
+export { createBashTool } from "./bash.js";
+export { createFindTool } from "./find.js";
+export { createGrepTool } from "./grep.js";
+export { createLsTool } from "./ls.js";
+export { createWebFetchTool } from "./web-fetch.js";
+export { createTaskOutputTool } from "./task-output.js";
+export { createTaskStopTool } from "./task-stop.js";
+export { createTasksTool } from "./tasks.js";
+export { ProcessManager } from "../core/process-manager.js";
+export { localOperations } from "./operations.js";
+//# 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":"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"}

package/dist/tools/ls.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import type { AgentTool } from "@mragentix/agent";
+import { type ToolOperations } from "./operations.js";
+declare const LsParams: z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+    all: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare function createLsTool(cwd: string, ops?: ToolOperations): AgentTool<typeof LsParams>;
+export {};
+//# sourceMappingURL=ls.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ls.d.ts","sourceRoot":"","sources":["../../src/tools/ls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEvE,QAAA,MAAM,QAAQ;;;iBAGZ,CAAC;AAEH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,cAAgC,GACpC,SAAS,CAAC,OAAO,QAAQ,CAAC,CAyC5B"}

package/dist/tools/ls.js

@@ -0,0 +1,56 @@
+import path from "node:path";
+import { z } from "zod";
+import { resolvePath } from "./path-utils.js";
+import { localOperations } from "./operations.js";
+const LsParams = z.object({
+    path: z.string().optional().describe("Directory path (defaults to cwd)"),
+    all: z.boolean().optional().describe("Show hidden files (default: false)"),
+});
+export function createLsTool(cwd, ops = localOperations) {
+    return {
+        name: "ls",
+        description: "List directory contents with file types and sizes. Directories listed first.",
+        parameters: LsParams,
+        async execute({ path: dirPath, all }) {
+            const resolved = dirPath ? resolvePath(cwd, dirPath) : cwd;
+            const entries = await ops.readdir(resolved, { withFileTypes: true });
+            // Filter hidden files unless --all
+            const filtered = all ? entries : entries.filter((e) => !e.name.startsWith("."));
+            // Separate dirs and files, then sort each alphabetically
+            const dirs = filtered
+                .filter((e) => e.isDirectory())
+                .sort((a, b) => a.name.localeCompare(b.name));
+            const files = filtered
+                .filter((e) => !e.isDirectory())
+                .sort((a, b) => a.name.localeCompare(b.name));
+            const lines = [];
+            for (const dir of dirs) {
+                lines.push(`d  -        ${dir.name}/`);
+            }
+            for (const file of files) {
+                try {
+                    const stat = await ops.stat(path.join(resolved, file.name));
+                    const size = formatSize(stat.size);
+                    const type = file.isSymbolicLink() ? "l" : "f";
+                    lines.push(`${type}  ${size.padStart(8)}  ${file.name}`);
+                }
+                catch {
+                    lines.push(`?  -        ${file.name}`);
+                }
+            }
+            if (lines.length === 0)
+                return "Empty directory.";
+            return lines.join("\n");
+        },
+    };
+}
+function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}K`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / (1024 * 1024)).toFixed(1)}M`;
+    return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)}G`;
+}
+//# sourceMappingURL=ls.js.map

package/dist/tools/ls.js.map

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

package/dist/tools/operations.d.ts

@@ -0,0 +1,39 @@
+import { type ChildProcess } from "node:child_process";
+import { type ReadStream } from "node:fs";
+import type { Dirent, Stats } from "node:fs";
+/**
+ * Abstraction over filesystem and process operations.
+ * Default implementation uses local Node.js APIs.
+ * Replace with SSH/Docker/cloud implementations for remote execution.
+ */
+export interface ToolOperations {
+    /** Read a file's contents as UTF-8 string. */
+    readFile(path: string): Promise<string>;
+    /** Write content to a file. Creates parent directories if needed. */
+    writeFile(path: string, content: string): Promise<void>;
+    /** Get file/directory stats. */
+    stat(path: string): Promise<Stats>;
+    /** Check if a path is a symbolic link. */
+    lstat(path: string): Promise<Stats>;
+    /** Read directory contents with file type info. */
+    readdir(path: string, options: {
+        withFileTypes: true;
+    }): Promise<Dirent[]>;
+    /** Create a directory (recursive). */
+    mkdir(path: string): Promise<void>;
+    /** Create a readable stream for a file. */
+    createReadStream(path: string, encoding: BufferEncoding): ReadStream;
+    /** Spawn a child process. Returns the ChildProcess handle. */
+    spawn(command: string, args: string[], options: {
+        cwd: string;
+        env?: Record<string, string>;
+        detached?: boolean;
+        stdio?: Array<"pipe" | "ignore">;
+    }): ChildProcess;
+}
+/**
+ * Default local filesystem + process operations.
+ * This is what tools use when running on the local machine.
+ */
+export declare const localOperations: ToolOperations;
+//# sourceMappingURL=operations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/tools/operations.ts"],"names":[],"mappings":"AACA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAExC,qEAAqE;IACrE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD,gCAAgC;IAChC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAEnC,0CAA0C;IAC1C,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAEpC,mDAAmD;IACnD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,aAAa,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE3E,sCAAsC;IACtC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC,2CAA2C;IAC3C,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,UAAU,CAAC;IAErE,8DAA8D;IAC9D,KAAK,CACH,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC;KAClC,GACA,YAAY,CAAC;CACjB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,cA0B7B,CAAC"}