@sowonai/crewx-sdk 0.5.0 → 0.6.0-rc.0

package/dist/tools/index.js

@@ -0,0 +1,40 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StandardFileSystemService = exports.globTool = exports.findTool = exports.grepTool = exports.writeFileTool = exports.treeTool = exports.lsTool = exports.runShellCommandTool = exports.replaceTool = exports.readFileTool = void 0;
+var read_file_tool_js_1 = require("./read-file.tool.js");
+Object.defineProperty(exports, "readFileTool", { enumerable: true, get: function () { return read_file_tool_js_1.readFileTool; } });
+var replace_tool_js_1 = require("./replace.tool.js");
+Object.defineProperty(exports, "replaceTool", { enumerable: true, get: function () { return replace_tool_js_1.replaceTool; } });
+var run_shell_command_tool_js_1 = require("./run-shell-command.tool.js");
+Object.defineProperty(exports, "runShellCommandTool", { enumerable: true, get: function () { return run_shell_command_tool_js_1.runShellCommandTool; } });
+var ls_tool_js_1 = require("./ls.tool.js");
+Object.defineProperty(exports, "lsTool", { enumerable: true, get: function () { return ls_tool_js_1.lsTool; } });
+var tree_tool_js_1 = require("./tree.tool.js");
+Object.defineProperty(exports, "treeTool", { enumerable: true, get: function () { return tree_tool_js_1.treeTool; } });
+var write_file_tool_js_1 = require("./write-file.tool.js");
+Object.defineProperty(exports, "writeFileTool", { enumerable: true, get: function () { return write_file_tool_js_1.writeFileTool; } });
+var grep_tool_js_1 = require("./grep.tool.js");
+Object.defineProperty(exports, "grepTool", { enumerable: true, get: function () { return grep_tool_js_1.grepTool; } });
+var find_tool_js_1 = require("./find.tool.js");
+Object.defineProperty(exports, "findTool", { enumerable: true, get: function () { return find_tool_js_1.findTool; } });
+var glob_tool_js_1 = require("./glob.tool.js");
+Object.defineProperty(exports, "globTool", { enumerable: true, get: function () { return glob_tool_js_1.globTool; } });
+var file_system_service_js_1 = require("./file-system.service.js");
+Object.defineProperty(exports, "StandardFileSystemService", { enumerable: true, get: function () { return file_system_service_js_1.StandardFileSystemService; } });
+__exportStar(require("./types.js"), exports);
+__exportStar(require("./utils/file-utils.js"), exports);
+//# 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":";;;;;;;;;;;;;;;;;AAKA,yDAAmD;AAA1C,iHAAA,YAAY,OAAA;AACrB,qDAAgD;AAAvC,8GAAA,WAAW,OAAA;AACpB,yEAAkE;AAAzD,gIAAA,mBAAmB,OAAA;AAC5B,2CAAsC;AAA7B,oGAAA,MAAM,OAAA;AACf,+CAA0C;AAAjC,wGAAA,QAAQ,OAAA;AACjB,2DAAqD;AAA5C,mHAAA,aAAa,OAAA;AACtB,+CAA0C;AAAjC,wGAAA,QAAQ,OAAA;AACjB,+CAA0C;AAAjC,wGAAA,QAAQ,OAAA;AACjB,+CAA0C;AAAjC,wGAAA,QAAQ,OAAA;AACjB,mEAAqE;AAA5D,mIAAA,yBAAyB,OAAA;AAClC,6CAA2B;AAC3B,wDAAsC"}

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

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+export declare const lsTool: import("@mastra/core/tools").Tool<z.ZodObject<{
+    path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    recursive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    recursive: boolean;
+}, {
+    path?: string | undefined;
+    recursive?: boolean | undefined;
+}>, z.ZodString, any, any, import("@mastra/core/tools").ToolExecutionContext<z.ZodObject<{
+    path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    recursive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    recursive: boolean;
+}, {
+    path?: string | undefined;
+    recursive?: boolean | undefined;
+}>, any, any>> & {
+    inputSchema: z.ZodObject<{
+        path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        recursive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        recursive: boolean;
+    }, {
+        path?: string | undefined;
+        recursive?: boolean | undefined;
+    }>;
+    outputSchema: z.ZodString;
+    execute: (context: import("@mastra/core/tools").ToolExecutionContext<z.ZodObject<{
+        path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        recursive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        recursive: boolean;
+    }, {
+        path?: string | undefined;
+        recursive?: boolean | undefined;
+    }>, any, any>, options: import("@mastra/core/tools").MastraToolInvocationOptions) => Promise<any>;
+};

package/dist/tools/ls.tool.js

@@ -0,0 +1,94 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lsTool = void 0;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+const node_path_1 = __importDefault(require("node:path"));
+const promises_1 = __importDefault(require("node:fs/promises"));
+async function listRecursive(dirPath, basePath, maxDepth = 5, currentDepth = 0) {
+    if (currentDepth >= maxDepth) {
+        return [`${dirPath}/ (max depth reached)`];
+    }
+    const results = [];
+    const entries = await promises_1.default.readdir(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = node_path_1.default.join(dirPath, entry.name);
+        const relativePath = node_path_1.default.relative(basePath, fullPath);
+        if (entry.isDirectory()) {
+            results.push(`${relativePath}/`);
+            try {
+                const subResults = await listRecursive(fullPath, basePath, maxDepth, currentDepth + 1);
+                results.push(...subResults);
+            }
+            catch (error) {
+                results.push(`${relativePath}/ (permission denied)`);
+            }
+        }
+        else {
+            const stats = await promises_1.default.stat(fullPath);
+            results.push(`${relativePath} (${stats.size} bytes)`);
+        }
+    }
+    return results;
+}
+exports.lsTool = (0, tools_1.createTool)({
+    id: 'ls',
+    description: `Lists contents of a directory. Can list recursively with the 'recursive' flag. Shows file sizes and distinguishes directories with trailing slashes.`,
+    inputSchema: zod_1.z.object({
+        path: zod_1.z
+            .string()
+            .optional()
+            .default('.')
+            .describe('The directory path to list (default: current directory).'),
+        recursive: zod_1.z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe('Optional: List contents recursively (default: false).'),
+    }),
+    outputSchema: zod_1.z.string().describe('Directory listing or error message'),
+    execute: async ({ context }) => {
+        const { path: dirPath = '.', recursive = false } = context;
+        const resolvedPath = node_path_1.default.resolve(dirPath);
+        try {
+            const stats = await promises_1.default.stat(resolvedPath);
+            if (!stats.isDirectory()) {
+                throw new Error(`Path is not a directory: ${dirPath}`);
+            }
+            let output = `Directory listing: ${dirPath}\n\n`;
+            if (recursive) {
+                const entries = await listRecursive(resolvedPath, resolvedPath);
+                output += entries.join('\n');
+            }
+            else {
+                const entries = await promises_1.default.readdir(resolvedPath, { withFileTypes: true });
+                const lines = [];
+                for (const entry of entries) {
+                    const fullPath = node_path_1.default.join(resolvedPath, entry.name);
+                    if (entry.isDirectory()) {
+                        lines.push(`${entry.name}/`);
+                    }
+                    else {
+                        const stats = await promises_1.default.stat(fullPath);
+                        lines.push(`${entry.name} (${stats.size} bytes)`);
+                    }
+                }
+                output += lines.join('\n');
+            }
+            return output || 'Directory is empty';
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new Error(`Directory not found: ${dirPath}`);
+            }
+            if (error.code === 'EACCES') {
+                throw new Error(`Permission denied: ${dirPath}`);
+            }
+            throw error;
+        }
+    },
+});
+//# sourceMappingURL=ls.tool.js.map

package/dist/tools/ls.tool.js.map

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

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

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+export declare const readFileTool: import("@mastra/core/tools").Tool<z.ZodObject<{
+    file_path: z.ZodString;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    file_path: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}, {
+    file_path: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}>, z.ZodString, any, any, import("@mastra/core/tools").ToolExecutionContext<z.ZodObject<{
+    file_path: z.ZodString;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    file_path: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}, {
+    file_path: string;
+    offset?: number | undefined;
+    limit?: number | undefined;
+}>, any, any>> & {
+    inputSchema: z.ZodObject<{
+        file_path: z.ZodString;
+        offset: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        file_path: string;
+        offset?: number | undefined;
+        limit?: number | undefined;
+    }, {
+        file_path: string;
+        offset?: number | undefined;
+        limit?: number | undefined;
+    }>;
+    outputSchema: z.ZodString;
+    execute: (context: import("@mastra/core/tools").ToolExecutionContext<z.ZodObject<{
+        file_path: z.ZodString;
+        offset: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        file_path: string;
+        offset?: number | undefined;
+        limit?: number | undefined;
+    }, {
+        file_path: string;
+        offset?: number | undefined;
+        limit?: number | undefined;
+    }>, any, any>, options: import("@mastra/core/tools").MastraToolInvocationOptions) => Promise<any>;
+};

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

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readFileTool = void 0;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+const node_path_1 = __importDefault(require("node:path"));
+const file_utils_js_1 = require("./utils/file-utils.js");
+const file_system_service_js_1 = require("./file-system.service.js");
+exports.readFileTool = (0, tools_1.createTool)({
+    id: 'read_file',
+    description: `Reads and returns the content of a specified file. If the file is large, the content will be truncated. The tool's response will clearly indicate if truncation has occurred and will provide details on how to read more of the file using the 'offset' and 'limit' parameters. Handles text, images (PNG, JPG, GIF, WEBP, SVG, BMP), and PDF files. For text files, it can read specific line ranges.`,
+    inputSchema: zod_1.z.object({
+        file_path: zod_1.z
+            .string()
+            .describe('The path to the file to read.'),
+        offset: zod_1.z
+            .number()
+            .int()
+            .nonnegative()
+            .optional()
+            .describe("Optional: For text files, the 0-based line number to start reading from. Use for paginating through large files."),
+        limit: zod_1.z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Optional: For text files, maximum number of lines to read. Use with 'offset' to paginate through large files."),
+    }),
+    outputSchema: zod_1.z.string().describe('The file content or error message'),
+    execute: async ({ context }) => {
+        const { file_path, offset, limit } = context;
+        if (file_path.trim() === '') {
+            throw new Error("The 'file_path' parameter must be non-empty.");
+        }
+        const targetDir = process.cwd();
+        const resolvedPath = node_path_1.default.resolve(file_path);
+        const fileSystemService = new file_system_service_js_1.StandardFileSystemService();
+        const result = await (0, file_utils_js_1.processSingleFileContent)(resolvedPath, targetDir, fileSystemService, offset, limit);
+        if (result.error) {
+            throw new Error(result.error);
+        }
+        if (typeof result.llmContent === 'string') {
+            if (result.isTruncated) {
+                const [start, end] = result.linesShown;
+                const total = result.originalLineCount;
+                const nextOffset = offset ? offset + end - start + 1 : end;
+                return `IMPORTANT: The file content has been truncated.
+Status: Showing lines ${start}-${end} of ${total} total lines.
+Action: To read more of the file, you can use the 'offset' and 'limit' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use offset: ${nextOffset}.
+
+--- FILE CONTENT (truncated) ---
+${result.llmContent}`;
+            }
+            return result.llmContent;
+        }
+        const relativePath2 = (0, file_utils_js_1.makeRelative)(resolvedPath, targetDir);
+        const inlineData = result.llmContent.inlineData;
+        return `File read successfully: ${(0, file_utils_js_1.shortenPath)(relativePath2)}
+Type: ${inlineData.mimeType}
+Size: ${Buffer.from(inlineData.data, 'base64').length} bytes
+
+Note: Binary content (image/PDF) has been loaded. The agent can work with this file.
+Base64 data: ${inlineData.data.substring(0, 100)}...`;
+    },
+});
+//# sourceMappingURL=read-file.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.tool.js","sourceRoot":"","sources":["../../src/tools/read-file.tool.ts"],"names":[],"mappings":";;;;;;AAKA,8CAAgD;AAChD,6BAAwB;AACxB,0DAA6B;AAG7B,yDAI+B;AAC/B,qEAAqE;AAQxD,QAAA,YAAY,GAAG,IAAA,kBAAU,EAAC;IACrC,EAAE,EAAE,WAAW;IACf,WAAW,EAAE,yYAAyY;IAEtZ,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;QACpB,SAAS,EAAE,OAAC;aACT,MAAM,EAAE;aACR,QAAQ,CAAC,+BAA+B,CAAC;QAC5C,MAAM,EAAE,OAAC;aACN,MAAM,EAAE;aACR,GAAG,EAAE;aACL,WAAW,EAAE;aACb,QAAQ,EAAE;aACV,QAAQ,CACP,kHAAkH,CACnH;QACH,KAAK,EAAE,OAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CACP,+GAA+G,CAChH;KACJ,CAAC;IAEF,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAEtE,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC7B,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAE7C,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QAGD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAChC,MAAM,YAAY,GAAG,mBAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAM7C,MAAM,iBAAiB,GAAsB,IAAI,kDAAyB,EAAE,CAAC;QAG7E,MAAM,MAAM,GAAG,MAAM,IAAA,wCAAwB,EAC3C,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,MAAM,EACN,KAAK,CACN,CAAC;QAEF,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAGD,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAE1C,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACvB,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,UAAW,CAAC;gBACxC,MAAM,KAAK,GAAG,MAAM,CAAC,iBAAkB,CAAC;gBACxC,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;gBAE3D,OAAO;wBACS,KAAK,IAAI,GAAG,OAAO,KAAK;qLACqI,UAAU;;;EAG7L,MAAM,CAAC,UAAU,EAAE,CAAC;YAChB,CAAC;YAED,OAAO,MAAM,CAAC,UAAU,CAAC;QAC3B,CAAC;QAGD,MAAM,aAAa,GAAG,IAAA,4BAAY,EAAC,YAAY,EAAE,SAAS,CAAC,CAAC;QAC5D,MAAM,UAAU,GAAI,MAAM,CAAC,UAAkB,CAAC,UAAU,CAAC;QAEzD,OAAO,2BAA2B,IAAA,2BAAW,EAAC,aAAa,CAAC;QACxD,UAAU,CAAC,QAAQ;QACnB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,MAAM;;;eAGtC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/replace.tool.d.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+export declare const replaceTool: import("@mastra/core/tools").Tool<z.ZodObject<{
+    file_path: z.ZodString;
+    start_line: z.ZodNumber;
+    end_line: z.ZodNumber;
+    new_text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    file_path: string;
+    start_line: number;
+    end_line: number;
+    new_text: string;
+}, {
+    file_path: string;
+    start_line: number;
+    end_line: number;
+    new_text: string;
+}>, z.ZodString, any, any, import("@mastra/core/tools").ToolExecutionContext<z.ZodObject<{
+    file_path: z.ZodString;
+    start_line: z.ZodNumber;
+    end_line: z.ZodNumber;
+    new_text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    file_path: string;
+    start_line: number;
+    end_line: number;
+    new_text: string;
+}, {
+    file_path: string;
+    start_line: number;
+    end_line: number;
+    new_text: string;
+}>, any, any>> & {
+    inputSchema: z.ZodObject<{
+        file_path: z.ZodString;
+        start_line: z.ZodNumber;
+        end_line: z.ZodNumber;
+        new_text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        file_path: string;
+        start_line: number;
+        end_line: number;
+        new_text: string;
+    }, {
+        file_path: string;
+        start_line: number;
+        end_line: number;
+        new_text: string;
+    }>;
+    outputSchema: z.ZodString;
+    execute: (context: import("@mastra/core/tools").ToolExecutionContext<z.ZodObject<{
+        file_path: z.ZodString;
+        start_line: z.ZodNumber;
+        end_line: z.ZodNumber;
+        new_text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        file_path: string;
+        start_line: number;
+        end_line: number;
+        new_text: string;
+    }, {
+        file_path: string;
+        start_line: number;
+        end_line: number;
+        new_text: string;
+    }>, any, any>, options: import("@mastra/core/tools").MastraToolInvocationOptions) => Promise<any>;
+};

package/dist/tools/replace.tool.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replaceTool = void 0;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+const node_path_1 = __importDefault(require("node:path"));
+const promises_1 = __importDefault(require("node:fs/promises"));
+exports.replaceTool = (0, tools_1.createTool)({
+    id: 'replace',
+    description: `Replaces a range of lines in a file with new text. Useful for editing existing files. Requires start_line, end_line, and new_text parameters. Line numbers are 1-based.`,
+    inputSchema: zod_1.z.object({
+        file_path: zod_1.z
+            .string()
+            .describe('The path to the file to modify.'),
+        start_line: zod_1.z
+            .number()
+            .int()
+            .positive()
+            .describe('The starting line number to replace (1-based, inclusive).'),
+        end_line: zod_1.z
+            .number()
+            .int()
+            .positive()
+            .describe('The ending line number to replace (1-based, inclusive).'),
+        new_text: zod_1.z
+            .string()
+            .describe('The new text to insert in place of the specified lines.'),
+    }),
+    outputSchema: zod_1.z.string().describe('Success message or error'),
+    execute: async ({ context }) => {
+        const { file_path, start_line, end_line, new_text } = context;
+        if (file_path.trim() === '') {
+            throw new Error("The 'file_path' parameter must be non-empty.");
+        }
+        if (start_line > end_line) {
+            throw new Error(`Invalid line range: start_line (${start_line}) must be <= end_line (${end_line}).`);
+        }
+        const resolvedPath = node_path_1.default.resolve(file_path);
+        try {
+            await promises_1.default.access(resolvedPath);
+            const content = await promises_1.default.readFile(resolvedPath, 'utf-8');
+            const lines = content.split('\n');
+            if (start_line < 1 || start_line > lines.length) {
+                throw new Error(`start_line (${start_line}) is out of range. File has ${lines.length} lines.`);
+            }
+            if (end_line > lines.length) {
+                throw new Error(`end_line (${end_line}) is out of range. File has ${lines.length} lines.`);
+            }
+            const newLines = new_text.split('\n');
+            lines.splice(start_line - 1, end_line - start_line + 1, ...newLines);
+            await promises_1.default.writeFile(resolvedPath, lines.join('\n'), 'utf-8');
+            return `Successfully replaced lines ${start_line}-${end_line} in ${file_path}`;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new Error(`File not found: ${file_path}`);
+            }
+            if (error.code === 'EACCES') {
+                throw new Error(`Permission denied: ${file_path}`);
+            }
+            throw error;
+        }
+    },
+});
+//# sourceMappingURL=replace.tool.js.map

package/dist/tools/replace.tool.js.map

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

package/dist/tools/run-shell-command.tool.d.ts

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+export declare const runShellCommandTool: import("@mastra/core/tools").Tool<z.ZodObject<{
+    command: z.ZodString;
+    timeout_seconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    timeout_seconds: number;
+}, {
+    command: string;
+    timeout_seconds?: number | undefined;
+}>, z.ZodString, any, any, import("@mastra/core/tools").ToolExecutionContext<z.ZodObject<{
+    command: z.ZodString;
+    timeout_seconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    command: string;
+    timeout_seconds: number;
+}, {
+    command: string;
+    timeout_seconds?: number | undefined;
+}>, any, any>> & {
+    inputSchema: z.ZodObject<{
+        command: z.ZodString;
+        timeout_seconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        timeout_seconds: number;
+    }, {
+        command: string;
+        timeout_seconds?: number | undefined;
+    }>;
+    outputSchema: z.ZodString;
+    execute: (context: import("@mastra/core/tools").ToolExecutionContext<z.ZodObject<{
+        command: z.ZodString;
+        timeout_seconds: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        timeout_seconds: number;
+    }, {
+        command: string;
+        timeout_seconds?: number | undefined;
+    }>, any, any>, options: import("@mastra/core/tools").MastraToolInvocationOptions) => Promise<any>;
+};

package/dist/tools/run-shell-command.tool.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runShellCommandTool = void 0;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+const node_child_process_1 = require("node:child_process");
+const node_util_1 = require("node:util");
+const execAsync = (0, node_util_1.promisify)(node_child_process_1.exec);
+exports.runShellCommandTool = (0, tools_1.createTool)({
+    id: 'run_shell_command',
+    description: `Executes a shell command and returns its output (stdout and stderr). Supports optional timeout in seconds. Use with caution as this can execute any shell command.`,
+    inputSchema: zod_1.z.object({
+        command: zod_1.z
+            .string()
+            .describe('The shell command to execute.'),
+        timeout_seconds: zod_1.z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .default(30)
+            .describe('Optional: Maximum execution time in seconds (default: 30).'),
+    }),
+    outputSchema: zod_1.z.string().describe('Command output or error message'),
+    execute: async ({ context }) => {
+        const { command, timeout_seconds = 30 } = context;
+        if (command.trim() === '') {
+            throw new Error("The 'command' parameter must be non-empty.");
+        }
+        try {
+            const { stdout, stderr } = await execAsync(command, {
+                timeout: timeout_seconds * 1000,
+                maxBuffer: 10 * 1024 * 1024,
+                cwd: process.cwd(),
+            });
+            let output = '';
+            if (stdout) {
+                output += `STDOUT:\n${stdout}`;
+            }
+            if (stderr) {
+                output += stdout ? '\n\n' : '';
+                output += `STDERR:\n${stderr}`;
+            }
+            return output || 'Command executed successfully (no output)';
+        }
+        catch (error) {
+            if (error.killed && error.signal === 'SIGTERM') {
+                throw new Error(`Command timed out after ${timeout_seconds} seconds`);
+            }
+            let errorMsg = `Command failed: ${command}\n`;
+            if (error.stdout) {
+                errorMsg += `\nSTDOUT:\n${error.stdout}`;
+            }
+            if (error.stderr) {
+                errorMsg += `\nSTDERR:\n${error.stderr}`;
+            }
+            if (error.code !== undefined) {
+                errorMsg += `\nExit code: ${error.code}`;
+            }
+            throw new Error(errorMsg);
+        }
+    },
+});
+//# sourceMappingURL=run-shell-command.tool.js.map

package/dist/tools/run-shell-command.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-shell-command.tool.js","sourceRoot":"","sources":["../../src/tools/run-shell-command.tool.ts"],"names":[],"mappings":";;;AAKA,8CAAgD;AAChD,6BAAwB;AACxB,2DAA0C;AAC1C,yCAAsC;AAEtC,MAAM,SAAS,GAAG,IAAA,qBAAS,EAAC,yBAAI,CAAC,CAAC;AAOrB,QAAA,mBAAmB,GAAG,IAAA,kBAAU,EAAC;IAC5C,EAAE,EAAE,mBAAmB;IACvB,WAAW,EAAE,oKAAoK;IAEjL,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,OAAC;aACP,MAAM,EAAE;aACR,QAAQ,CAAC,+BAA+B,CAAC;QAC5C,eAAe,EAAE,OAAC;aACf,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,CAAC,4DAA4D,CAAC;KAC1E,CAAC;IAEF,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAEpE,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC7B,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;QAGlD,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE;gBAClD,OAAO,EAAE,eAAe,GAAG,IAAI;gBAC/B,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;gBAC3B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;aACnB,CAAC,CAAC;YAEH,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,IAAI,YAAY,MAAM,EAAE,CAAC;YACjC,CAAC;YACD,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,YAAY,MAAM,EAAE,CAAC;YACjC,CAAC;YAED,OAAO,MAAM,IAAI,2CAA2C,CAAC;QAC/D,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CAAC,2BAA2B,eAAe,UAAU,CAAC,CAAC;YACxE,CAAC;YAED,IAAI,QAAQ,GAAG,mBAAmB,OAAO,IAAI,CAAC;YAC9C,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,QAAQ,IAAI,cAAc,KAAK,CAAC,MAAM,EAAE,CAAC;YAC3C,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,QAAQ,IAAI,cAAc,KAAK,CAAC,MAAM,EAAE,CAAC;YAC3C,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC7B,QAAQ,IAAI,gBAAgB,KAAK,CAAC,IAAI,EAAE,CAAC;YAC3C,CAAC;YAED,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/tree.tool.d.ts

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+export declare const treeTool: import("@mastra/core/tools").Tool<z.ZodObject<{
+    path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    max_depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    max_depth: number;
+}, {
+    path?: string | undefined;
+    max_depth?: number | undefined;
+}>, z.ZodString, any, any, import("@mastra/core/tools").ToolExecutionContext<z.ZodObject<{
+    path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    max_depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    max_depth: number;
+}, {
+    path?: string | undefined;
+    max_depth?: number | undefined;
+}>, any, any>> & {
+    inputSchema: z.ZodObject<{
+        path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        max_depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        max_depth: number;
+    }, {
+        path?: string | undefined;
+        max_depth?: number | undefined;
+    }>;
+    outputSchema: z.ZodString;
+    execute: (context: import("@mastra/core/tools").ToolExecutionContext<z.ZodObject<{
+        path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        max_depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        max_depth: number;
+    }, {
+        path?: string | undefined;
+        max_depth?: number | undefined;
+    }>, any, any>, options: import("@mastra/core/tools").MastraToolInvocationOptions) => Promise<any>;
+};