@crewx/sdk 0.8.0-rc.58

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

@@ -0,0 +1,24 @@
+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, 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: 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,30 @@
+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, 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: 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;AAE7B,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,EAAO,EAAE,EAAE;QAClC,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,36 @@
+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, 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: 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,24 @@
+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, 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: 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,EAAO,EAAE,EAAE;QAClC,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,24 @@
+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, 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: any, options: import("@mastra/core/tools").MastraToolInvocationOptions) => Promise<any>;
+};

package/dist/tools/tree.tool.js

@@ -0,0 +1,109 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.treeTool = 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"));
+const INDENT_UNIT = '  ';
+async function buildTreeLines(dirPath, options) {
+    const { currentDepth, maxDepth } = options;
+    let entries;
+    try {
+        entries = await promises_1.default.readdir(dirPath, { withFileTypes: true });
+    }
+    catch (error) {
+        const indent = INDENT_UNIT.repeat(currentDepth);
+        const reason = error?.code === 'EACCES' ? 'permission denied' : error?.message || 'unknown error';
+        return [`${indent}(error reading directory: ${reason})`];
+    }
+    if (entries.length === 0) {
+        return [`${INDENT_UNIT.repeat(currentDepth)}(empty)`];
+    }
+    entries.sort((a, b) => {
+        if (a.isDirectory() && !b.isDirectory())
+            return -1;
+        if (!a.isDirectory() && b.isDirectory())
+            return 1;
+        return a.name.localeCompare(b.name);
+    });
+    const lines = [];
+    for (const entry of entries) {
+        const indent = INDENT_UNIT.repeat(currentDepth);
+        const fullPath = node_path_1.default.join(dirPath, entry.name);
+        if (entry.isDirectory()) {
+            lines.push(`${indent}[DIR] ${entry.name}/`);
+            if (currentDepth < maxDepth) {
+                const childLines = await buildTreeLines(fullPath, {
+                    currentDepth: currentDepth + 1,
+                    maxDepth,
+                });
+                lines.push(...childLines);
+            }
+            else {
+                lines.push(`${INDENT_UNIT.repeat(currentDepth + 1)}(max depth reached)`);
+            }
+        }
+        else {
+            try {
+                const stats = await promises_1.default.stat(fullPath);
+                lines.push(`${indent}[FILE] ${entry.name} (${stats.size} bytes)`);
+            }
+            catch (error) {
+                lines.push(`${indent}[FILE] ${entry.name} (error: ${error?.code || 'stat failed'})`);
+            }
+        }
+    }
+    return lines;
+}
+exports.treeTool = (0, tools_1.createTool)({
+    id: 'tree',
+    description: `Displays a directory tree similar to the Unix 'tree' command. Shows nested directories up to 'max_depth' levels with [DIR]/[FILE] labels and indentation to represent hierarchy.`,
+    inputSchema: zod_1.z.object({
+        path: zod_1.z
+            .string()
+            .optional()
+            .default('.')
+            .describe('Path of the directory to inspect (default: current working directory).'),
+        max_depth: zod_1.z
+            .number()
+            .int()
+            .min(1)
+            .optional()
+            .default(3)
+            .describe('Maximum depth to traverse relative to the root directory (default: 3).'),
+    }),
+    outputSchema: zod_1.z.string().describe('Formatted tree output or an error message'),
+    execute: async ({ context }) => {
+        const { path: targetPath = '.', max_depth = 3 } = context;
+        const resolvedPath = node_path_1.default.resolve(targetPath);
+        try {
+            const stats = await promises_1.default.stat(resolvedPath);
+            if (!stats.isDirectory()) {
+                throw new Error(`Path is not a directory: ${targetPath}`);
+            }
+        }
+        catch (error) {
+            if (error?.code === 'ENOENT') {
+                throw new Error(`Directory not found: ${targetPath}`);
+            }
+            if (error?.code === 'EACCES') {
+                throw new Error(`Permission denied: ${targetPath}`);
+            }
+            throw error;
+        }
+        const relativeRoot = node_path_1.default.relative(process.cwd(), resolvedPath);
+        const rootLabel = relativeRoot === '' ? '.' : relativeRoot;
+        const lines = [`Tree for ${rootLabel} (max depth: ${max_depth})`, `[DIR] ${rootLabel}/`];
+        const treeLines = await buildTreeLines(resolvedPath, {
+            currentDepth: 1,
+            maxDepth: max_depth,
+        });
+        lines.push(...treeLines);
+        return lines.join('\n');
+    },
+});
+//# sourceMappingURL=tree.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tree.tool.js","sourceRoot":"","sources":["../../src/tools/tree.tool.ts"],"names":[],"mappings":";;;;;;AAKA,8CAAgD;AAChD,6BAAwB;AACxB,0DAA6B;AAC7B,gEAAkC;AAGlC,MAAM,WAAW,GAAG,IAAI,CAAC;AAUzB,KAAK,UAAU,cAAc,CAAC,OAAe,EAAE,OAA6B;IAC1E,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE3C,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,kBAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,IAAI,eAAe,CAAC;QAClG,OAAO,CAAC,GAAG,MAAM,6BAA6B,MAAM,GAAG,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACpB,IAAI,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE;YAAE,OAAO,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,WAAW,EAAE;YAAE,OAAO,CAAC,CAAC;QAClD,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAEhD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,SAAS,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;YAE5C,IAAI,YAAY,GAAG,QAAQ,EAAE,CAAC;gBAC5B,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE;oBAChD,YAAY,EAAE,YAAY,GAAG,CAAC;oBAC9B,QAAQ;iBACT,CAAC,CAAC;gBACH,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;YAC5B,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,qBAAqB,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,kBAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACtC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,UAAU,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC;YACpE,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,UAAU,KAAK,CAAC,IAAI,YAAY,KAAK,EAAE,IAAI,IAAI,aAAa,GAAG,CAAC,CAAC;YACvF,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAOY,QAAA,QAAQ,GAAG,IAAA,kBAAU,EAAC;IACjC,EAAE,EAAE,MAAM;IACV,WAAW,EAAE,kLAAkL;IAE/L,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;QACpB,IAAI,EAAE,OAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,OAAO,CAAC,GAAG,CAAC;aACZ,QAAQ,CAAC,wEAAwE,CAAC;QACrF,SAAS,EAAE,OAAC;aACT,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,EAAE;aACV,OAAO,CAAC,CAAC,CAAC;aACV,QAAQ,CAAC,wEAAwE,CAAC;KACtF,CAAC;IAEF,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IAE9E,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAO,EAAE,EAAE;QAClC,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,GAAG,EAAE,SAAS,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;QAE1D,MAAM,YAAY,GAAG,mBAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE9C,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,kBAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC1C,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,4BAA4B,UAAU,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,KAAK,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,wBAAwB,UAAU,EAAE,CAAC,CAAC;YACxD,CAAC;YACD,IAAI,KAAK,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,sBAAsB,UAAU,EAAE,CAAC,CAAC;YACtD,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,YAAY,GAAG,mBAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC;QAChE,MAAM,SAAS,GAAG,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC;QAE3D,MAAM,KAAK,GAAG,CAAC,YAAY,SAAS,gBAAgB,SAAS,GAAG,EAAE,SAAS,SAAS,GAAG,CAAC,CAAC;QACzF,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,YAAY,EAAE;YACnD,YAAY,EAAE,CAAC;YACf,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAC;QAEH,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;QAEzB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/types.d.ts

@@ -0,0 +1,42 @@
+export interface ToolExecutionContext {
+    workingDirectory: string;
+    isPathWithinWorkspace(path: string): boolean;
+    fileSystemService: FileSystemService;
+    shouldIgnoreFile(path: string): boolean;
+    agentId: string;
+    provider: string;
+    model: string;
+    env: Record<string, string | undefined>;
+    vars: Record<string, any>;
+}
+export interface FileSystemService {
+    readFile(path: string): Promise<Buffer>;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<{
+        size: number;
+        isDirectory: boolean;
+    }>;
+    readdir(path: string): Promise<string[]>;
+}
+export interface ProcessedFileReadResult {
+    llmContent: string | {
+        inlineData: {
+            data: string;
+            mimeType: string;
+        };
+    };
+    returnDisplay: string;
+    error?: string;
+    errorType?: ToolErrorType;
+    isTruncated?: boolean;
+    originalLineCount?: number;
+    linesShown?: [number, number];
+}
+export declare enum ToolErrorType {
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    PATH_IS_DIRECTORY = "PATH_IS_DIRECTORY",
+    FILE_TOO_LARGE = "FILE_TOO_LARGE",
+    BINARY_FILE = "BINARY_FILE",
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    UNKNOWN = "UNKNOWN"
+}

package/dist/tools/types.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolErrorType = void 0;
+var ToolErrorType;
+(function (ToolErrorType) {
+    ToolErrorType["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+    ToolErrorType["PATH_IS_DIRECTORY"] = "PATH_IS_DIRECTORY";
+    ToolErrorType["FILE_TOO_LARGE"] = "FILE_TOO_LARGE";
+    ToolErrorType["BINARY_FILE"] = "BINARY_FILE";
+    ToolErrorType["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    ToolErrorType["UNKNOWN"] = "UNKNOWN";
+})(ToolErrorType || (exports.ToolErrorType = ToolErrorType = {}));
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":";;;AAkDA,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,kDAAiC,CAAA;IACjC,wDAAuC,CAAA;IACvC,kDAAiC,CAAA;IACjC,4CAA2B,CAAA;IAC3B,wDAAuC,CAAA;IACvC,oCAAmB,CAAA;AACrB,CAAC,EAPW,aAAa,6BAAb,aAAa,QAOxB"}

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

@@ -0,0 +1,5 @@
+import type { FileSystemService, ProcessedFileReadResult } from '../types.js';
+export declare function getSpecificMimeType(filePath: string): string;
+export declare function processSingleFileContent(filePath: string, rootDirectory: string, fileSystemService: FileSystemService, offset?: number, limit?: number): Promise<ProcessedFileReadResult>;
+export declare function makeRelative(absolutePath: string, rootDir: string): string;
+export declare function shortenPath(filePath: string, maxLength?: number): string;