@n8n/instance-ai 1.0.0

package/dist/tools/filesystem/get-file-tree.tool.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGetFileTreeTool = createGetFileTreeTool;
+const tools_1 = require("@mastra/core/tools");
+const api_types_1 = require("@n8n/api-types");
+const nanoid_1 = require("nanoid");
+const zod_1 = require("zod");
+function createGetFileTreeTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'get-file-tree',
+        description: 'Get a shallow directory tree. Start at depth 1-2 for an overview, then call again on specific subdirectories to drill deeper. Always use absolute paths or ~/relative paths.',
+        inputSchema: zod_1.z.object({
+            dirPath: zod_1.z
+                .string()
+                .describe('Absolute directory path or ~/relative path (e.g. "/home/user/project" or "~/project/src"). Call with subdirectory paths to explore deeper.'),
+            maxDepth: zod_1.z
+                .number()
+                .int()
+                .positive()
+                .max(5)
+                .default(2)
+                .optional()
+                .describe('Maximum directory depth to show (default 2, max 5). Start low and increase only if needed.'),
+        }),
+        outputSchema: zod_1.z.object({
+            tree: zod_1.z.string().describe('Directory tree as indented text'),
+            truncated: zod_1.z.boolean(),
+            denied: zod_1.z.boolean().optional(),
+            reason: zod_1.z.string().optional(),
+        }),
+        suspendSchema: zod_1.z.object({
+            requestId: zod_1.z.string(),
+            message: zod_1.z.string(),
+            severity: api_types_1.instanceAiConfirmationSeveritySchema,
+        }),
+        resumeSchema: zod_1.z.object({
+            approved: zod_1.z.boolean(),
+        }),
+        execute: async ({ dirPath, maxDepth }, ctx) => {
+            const { resumeData, suspend } = ctx?.agent ?? {};
+            const needsApproval = context.permissions?.readFilesystem !== 'always_allow';
+            if (needsApproval && (resumeData === undefined || resumeData === null)) {
+                await suspend?.({
+                    requestId: (0, nanoid_1.nanoid)(),
+                    message: `Read filesystem tree at "${dirPath}"?`,
+                    severity: 'info',
+                });
+                return { tree: '', truncated: false };
+            }
+            if (resumeData !== undefined && resumeData !== null && !resumeData.approved) {
+                return { tree: '', truncated: false, denied: true, reason: 'User denied the action' };
+            }
+            if (!context.filesystemService) {
+                throw new Error('No filesystem access available.');
+            }
+            const tree = await context.filesystemService.getFileTree(dirPath, {
+                maxDepth: maxDepth ?? 2,
+            });
+            const truncated = tree.includes('call get-file-tree on a subdirectory') || tree.includes('... (truncated at');
+            return { tree, truncated };
+        },
+    });
+}
+//# sourceMappingURL=get-file-tree.tool.js.map

package/dist/tools/filesystem/get-file-tree.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-file-tree.tool.js","sourceRoot":"","sources":["../../../src/tools/filesystem/get-file-tree.tool.ts"],"names":[],"mappings":";;AAOA,sDAiEC;AAxED,8CAAgD;AAChD,8CAAsE;AACtE,mCAAgC;AAChC,6BAAwB;AAIxB,SAAgB,qBAAqB,CAAC,OAA0B;IAC/D,OAAO,IAAA,kBAAU,EAAC;QACjB,EAAE,EAAE,eAAe;QACnB,WAAW,EACV,8KAA8K;QAC/K,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACrB,OAAO,EAAE,OAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,CACR,4IAA4I,CAC5I;YACF,QAAQ,EAAE,OAAC;iBACT,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,GAAG,CAAC,CAAC,CAAC;iBACN,OAAO,CAAC,CAAC,CAAC;iBACV,QAAQ,EAAE;iBACV,QAAQ,CACR,4FAA4F,CAC5F;SACF,CAAC;QACF,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC;YACtB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;YAC5D,SAAS,EAAE,OAAC,CAAC,OAAO,EAAE;YACtB,MAAM,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC9B,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B,CAAC;QACF,aAAa,EAAE,OAAC,CAAC,MAAM,CAAC;YACvB,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;YACrB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;YACnB,QAAQ,EAAE,gDAAoC;SAC9C,CAAC;QACF,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC;YACtB,QAAQ,EAAE,OAAC,CAAC,OAAO,EAAE;SACrB,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE;YAC7C,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC;YACjD,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,EAAE,cAAc,KAAK,cAAc,CAAC;YAE7E,IAAI,aAAa,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,CAAC,EAAE,CAAC;gBACxE,MAAM,OAAO,EAAE,CAAC;oBACf,SAAS,EAAE,IAAA,eAAM,GAAE;oBACnB,OAAO,EAAE,4BAA4B,OAAO,IAAI;oBAChD,QAAQ,EAAE,MAAe;iBACzB,CAAC,CAAC;gBACH,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YACvC,CAAC;YAED,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;gBAC7E,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;YACvF,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,OAAO,EAAE;gBACjE,QAAQ,EAAE,QAAQ,IAAI,CAAC;aACvB,CAAC,CAAC;YACH,MAAM,SAAS,GACd,IAAI,CAAC,QAAQ,CAAC,sCAAsC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;YAE7F,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC5B,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/filesystem/list-files.tool.d.ts

@@ -0,0 +1,30 @@
+import type { InstanceAiContext } from '../../types';
+export declare function createListFilesTool(context: InstanceAiContext): import("@mastra/core/tools").Tool<{
+    dirPath: string;
+    type?: "directory" | "file" | "all" | undefined;
+    recursive?: boolean | undefined;
+    pattern?: string | undefined;
+    maxResults?: number | undefined;
+}, {
+    files: {
+        type: "directory" | "file";
+        path: string;
+        sizeBytes?: number | undefined;
+    }[];
+    truncated: boolean;
+    totalCount: number;
+    denied?: boolean | undefined;
+    reason?: string | undefined;
+}, {
+    message: string;
+    requestId: string;
+    severity: "destructive" | "warning" | "info";
+}, {
+    approved: boolean;
+}, import("@mastra/core/tools").ToolExecutionContext<{
+    message: string;
+    requestId: string;
+    severity: "destructive" | "warning" | "info";
+}, {
+    approved: boolean;
+}, unknown>, "list-files", unknown>;

package/dist/tools/filesystem/list-files.tool.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createListFilesTool = createListFilesTool;
+const tools_1 = require("@mastra/core/tools");
+const api_types_1 = require("@n8n/api-types");
+const nanoid_1 = require("nanoid");
+const zod_1 = require("zod");
+function createListFilesTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'list-files',
+        description: "List files and/or directories matching optional filters. Use this to explore what exists in a directory. To see only top-level folders, set type='directory' and recursive=false. Always use absolute paths or ~/relative paths.",
+        inputSchema: zod_1.z.object({
+            dirPath: zod_1.z
+                .string()
+                .describe('Absolute directory path or ~/relative path (e.g. "/home/user/project" or "~/project"). Do NOT use bare relative paths.'),
+            pattern: zod_1.z
+                .string()
+                .optional()
+                .describe('Glob pattern to filter files (e.g. "**/*.ts", "src/**/*.json")'),
+            type: zod_1.z
+                .enum(['file', 'directory', 'all'])
+                .default('all')
+                .optional()
+                .describe('Filter by entry type: "file" for files only, "directory" for folders only, "all" for both (default "all")'),
+            recursive: zod_1.z
+                .boolean()
+                .default(true)
+                .optional()
+                .describe('Whether to recurse into subdirectories (default true). Set to false for a shallow listing of immediate children only.'),
+            maxResults: zod_1.z
+                .number()
+                .int()
+                .positive()
+                .max(1000)
+                .default(200)
+                .optional()
+                .describe('Maximum number of results to return (default 200, max 1000)'),
+        }),
+        outputSchema: zod_1.z.object({
+            files: zod_1.z.array(zod_1.z.object({
+                path: zod_1.z.string(),
+                type: zod_1.z.enum(['file', 'directory']),
+                sizeBytes: zod_1.z.number().optional(),
+            })),
+            truncated: zod_1.z.boolean(),
+            totalCount: zod_1.z.number(),
+            denied: zod_1.z.boolean().optional(),
+            reason: zod_1.z.string().optional(),
+        }),
+        suspendSchema: zod_1.z.object({
+            requestId: zod_1.z.string(),
+            message: zod_1.z.string(),
+            severity: api_types_1.instanceAiConfirmationSeveritySchema,
+        }),
+        resumeSchema: zod_1.z.object({
+            approved: zod_1.z.boolean(),
+        }),
+        execute: async ({ dirPath, pattern, maxResults, type, recursive }, ctx) => {
+            const { resumeData, suspend } = ctx?.agent ?? {};
+            const needsApproval = context.permissions?.readFilesystem !== 'always_allow';
+            if (needsApproval && (resumeData === undefined || resumeData === null)) {
+                await suspend?.({
+                    requestId: (0, nanoid_1.nanoid)(),
+                    message: `List files in "${dirPath}"?`,
+                    severity: 'info',
+                });
+                return { files: [], truncated: false, totalCount: 0 };
+            }
+            if (resumeData !== undefined && resumeData !== null && !resumeData.approved) {
+                return {
+                    files: [],
+                    truncated: false,
+                    totalCount: 0,
+                    denied: true,
+                    reason: 'User denied the action',
+                };
+            }
+            if (!context.filesystemService) {
+                throw new Error('No filesystem access available.');
+            }
+            const limit = maxResults ?? 200;
+            const typeFilter = type ?? 'all';
+            const isRecursive = recursive ?? true;
+            const fetched = await context.filesystemService.listFiles(dirPath, {
+                pattern: pattern ?? undefined,
+                maxResults: limit + 1,
+                type: typeFilter,
+                recursive: isRecursive,
+            });
+            const truncated = fetched.length > limit;
+            const files = truncated ? fetched.slice(0, limit) : fetched;
+            return {
+                files,
+                truncated,
+                totalCount: files.length,
+            };
+        },
+    });
+}
+//# sourceMappingURL=list-files.tool.js.map

package/dist/tools/filesystem/list-files.tool.js.map

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

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

@@ -0,0 +1,25 @@
+import type { InstanceAiContext } from '../../types';
+export declare function createReadFileTool(context: InstanceAiContext): import("@mastra/core/tools").Tool<{
+    filePath: string;
+    startLine?: number | undefined;
+    maxLines?: number | undefined;
+}, {
+    path: string;
+    content: string;
+    truncated: boolean;
+    totalLines: number;
+    denied?: boolean | undefined;
+    reason?: string | undefined;
+}, {
+    message: string;
+    requestId: string;
+    severity: "destructive" | "warning" | "info";
+}, {
+    approved: boolean;
+}, import("@mastra/core/tools").ToolExecutionContext<{
+    message: string;
+    requestId: string;
+    severity: "destructive" | "warning" | "info";
+}, {
+    approved: boolean;
+}, unknown>, "read-file", unknown>;

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

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createReadFileTool = createReadFileTool;
+const tools_1 = require("@mastra/core/tools");
+const api_types_1 = require("@n8n/api-types");
+const nanoid_1 = require("nanoid");
+const zod_1 = require("zod");
+const sanitize_web_content_1 = require("../web-research/sanitize-web-content");
+function createReadFileTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'read-file',
+        description: 'Read the contents of a file. Returns the text content with optional line range. Use after list-files or search-files to read specific files. Always use absolute paths or ~/relative paths.',
+        inputSchema: zod_1.z.object({
+            filePath: zod_1.z
+                .string()
+                .describe('Absolute file path or ~/relative path (e.g. "/home/user/project/file.ts" or "~/project/file.ts"). Do NOT use bare relative paths.'),
+            startLine: zod_1.z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe('Start reading from this line (1-indexed, default: 1)'),
+            maxLines: zod_1.z
+                .number()
+                .int()
+                .positive()
+                .max(500)
+                .default(200)
+                .optional()
+                .describe('Maximum number of lines to read (default 200, max 500)'),
+        }),
+        outputSchema: zod_1.z.object({
+            path: zod_1.z.string(),
+            content: zod_1.z.string(),
+            truncated: zod_1.z.boolean(),
+            totalLines: zod_1.z.number(),
+            denied: zod_1.z.boolean().optional(),
+            reason: zod_1.z.string().optional(),
+        }),
+        suspendSchema: zod_1.z.object({
+            requestId: zod_1.z.string(),
+            message: zod_1.z.string(),
+            severity: api_types_1.instanceAiConfirmationSeveritySchema,
+        }),
+        resumeSchema: zod_1.z.object({
+            approved: zod_1.z.boolean(),
+        }),
+        execute: async ({ filePath, startLine, maxLines }, ctx) => {
+            const { resumeData, suspend } = ctx?.agent ?? {};
+            const needsApproval = context.permissions?.readFilesystem !== 'always_allow';
+            if (needsApproval && (resumeData === undefined || resumeData === null)) {
+                await suspend?.({
+                    requestId: (0, nanoid_1.nanoid)(),
+                    message: `Read file "${filePath}"?`,
+                    severity: 'info',
+                });
+                return { path: '', content: '', truncated: false, totalLines: 0 };
+            }
+            if (resumeData !== undefined && resumeData !== null && !resumeData.approved) {
+                return {
+                    path: '',
+                    content: '',
+                    truncated: false,
+                    totalLines: 0,
+                    denied: true,
+                    reason: 'User denied the action',
+                };
+            }
+            if (!context.filesystemService) {
+                throw new Error('No filesystem access available.');
+            }
+            const result = await context.filesystemService.readFile(filePath, {
+                startLine: startLine ?? undefined,
+                maxLines: maxLines ?? undefined,
+            });
+            return {
+                ...result,
+                content: (0, sanitize_web_content_1.wrapUntrustedData)(result.content, 'file', filePath),
+            };
+        },
+    });
+}
+//# sourceMappingURL=read-file.tool.js.map

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

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

package/dist/tools/filesystem/search-files.tool.d.ts

@@ -0,0 +1,31 @@
+import type { InstanceAiContext } from '../../types';
+export declare function createSearchFilesTool(context: InstanceAiContext): import("@mastra/core/tools").Tool<{
+    query: string;
+    dirPath: string;
+    maxResults?: number | undefined;
+    filePattern?: string | undefined;
+    ignoreCase?: boolean | undefined;
+}, {
+    query: string;
+    truncated: boolean;
+    matches: {
+        path: string;
+        lineNumber: number;
+        line: string;
+    }[];
+    totalMatches: number;
+    denied?: boolean | undefined;
+    reason?: string | undefined;
+}, {
+    message: string;
+    requestId: string;
+    severity: "destructive" | "warning" | "info";
+}, {
+    approved: boolean;
+}, import("@mastra/core/tools").ToolExecutionContext<{
+    message: string;
+    requestId: string;
+    severity: "destructive" | "warning" | "info";
+}, {
+    approved: boolean;
+}, unknown>, "search-files", unknown>;

package/dist/tools/filesystem/search-files.tool.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSearchFilesTool = createSearchFilesTool;
+const tools_1 = require("@mastra/core/tools");
+const api_types_1 = require("@n8n/api-types");
+const nanoid_1 = require("nanoid");
+const zod_1 = require("zod");
+const sanitize_web_content_1 = require("../web-research/sanitize-web-content");
+function createSearchFilesTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'search-files',
+        description: 'Search file contents for a text pattern or regex across a directory. Returns matching lines with file paths and line numbers. Always use absolute paths or ~/relative paths.',
+        inputSchema: zod_1.z.object({
+            dirPath: zod_1.z
+                .string()
+                .describe('Absolute directory path or ~/relative path (e.g. "/home/user/project" or "~/project"). Do NOT use bare relative paths.'),
+            query: zod_1.z.string().describe('Search query — supports regex patterns'),
+            filePattern: zod_1.z
+                .string()
+                .optional()
+                .describe('File pattern to restrict search (e.g. "*.ts", "*.json")'),
+            ignoreCase: zod_1.z
+                .boolean()
+                .default(true)
+                .optional()
+                .describe('Case-insensitive search (default: true)'),
+            maxResults: zod_1.z
+                .number()
+                .int()
+                .positive()
+                .max(100)
+                .default(50)
+                .optional()
+                .describe('Maximum number of matching lines to return (default 50, max 100)'),
+        }),
+        outputSchema: zod_1.z.object({
+            query: zod_1.z.string(),
+            matches: zod_1.z.array(zod_1.z.object({
+                path: zod_1.z.string(),
+                lineNumber: zod_1.z.number(),
+                line: zod_1.z.string(),
+            })),
+            truncated: zod_1.z.boolean(),
+            totalMatches: zod_1.z.number(),
+            denied: zod_1.z.boolean().optional(),
+            reason: zod_1.z.string().optional(),
+        }),
+        suspendSchema: zod_1.z.object({
+            requestId: zod_1.z.string(),
+            message: zod_1.z.string(),
+            severity: api_types_1.instanceAiConfirmationSeveritySchema,
+        }),
+        resumeSchema: zod_1.z.object({
+            approved: zod_1.z.boolean(),
+        }),
+        execute: async ({ dirPath, query, filePattern, ignoreCase, maxResults }, ctx) => {
+            const { resumeData, suspend } = ctx?.agent ?? {};
+            const needsApproval = context.permissions?.readFilesystem !== 'always_allow';
+            if (needsApproval && (resumeData === undefined || resumeData === null)) {
+                await suspend?.({
+                    requestId: (0, nanoid_1.nanoid)(),
+                    message: `Search files in "${dirPath}" for "${query}"?`,
+                    severity: 'info',
+                });
+                return { query, matches: [], truncated: false, totalMatches: 0 };
+            }
+            if (resumeData !== undefined && resumeData !== null && !resumeData.approved) {
+                return {
+                    query,
+                    matches: [],
+                    truncated: false,
+                    totalMatches: 0,
+                    denied: true,
+                    reason: 'User denied the action',
+                };
+            }
+            if (!context.filesystemService) {
+                throw new Error('No filesystem access available.');
+            }
+            const result = await context.filesystemService.searchFiles(dirPath, {
+                query,
+                filePattern: filePattern ?? undefined,
+                ignoreCase: ignoreCase ?? undefined,
+                maxResults: maxResults ?? undefined,
+            });
+            return {
+                ...result,
+                matches: result.matches.map((match) => ({
+                    ...match,
+                    line: (0, sanitize_web_content_1.wrapUntrustedData)(match.line, 'file', `${match.path}:${match.lineNumber}`),
+                })),
+            };
+        },
+    });
+}
+//# sourceMappingURL=search-files.tool.js.map

package/dist/tools/filesystem/search-files.tool.js.map

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