@n8n/instance-ai 1.1.0 → 1.2.0

package/dist/tools/best-practices/guides/triage.js

@@ -1,142 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDocumentation = getDocumentation;
-function getDocumentation() {
-    return `# Best Practices: Triage Workflows
-
-## Workflow Design
-
-Triage workflows automatically classify incoming data and route it based on priority or category. Common use cases include sorting support tickets by urgency, categorizing emails for follow-up, or scoring leads for sales routing.
-
-Define clear categories and outcomes before building. Design in logical stages:
-
-1. **Trigger & Input**: Capture incoming items (webhook, email trigger, form submission, schedule)
-2. **Preprocessing**: Fetch additional data if needed (CRM lookup, field normalization)
-3. **Classification**: Assign categories via rules or AI
-4. **Routing**: Direct items to appropriate branches using Switch node or Text Classifier Node
-5. **Actions**: Execute category-specific tasks (create tasks, send alerts, update records)
-6. **Logging**: Track outcomes for monitoring and analysis
-
-Include a default/fallback path to catch unclassified items so data is tracked rather than dropped silently.
-
-## Classification Strategies
-
-### Rule-Based Classification
-Use IF/Switch nodes for keyword detection, sender addresses, or numeric thresholds. Chain multiple conditions or use Switch for multi-way branching.
-
-Example: IF email contains "urgent" -> High Priority branch
-
-### AI-Powered Classification
-For unstructured text or nuanced decisions, use AI nodes with clear prompts and defined output labels.
-
-Example prompt: "Classify this email as INTERESTED, NOT_INTERESTED, or QUESTION"
-
-Best practices:
-- Use structured output format (JSON with specific fields)
-- Set low temperature parameter of the model (0-0.2) for consistency
-- Include few-shot examples of input + classification
-- Implement error handling for unexpected outputs
-
-#### Text Classifier Node
-Use the Text Classifier node (@n8n/n8n-nodes-langchain.textClassifier) for straightforward text classification tasks. Configure with predefined category labels and descriptions for accurate results.
-
-Example workflow pattern:
-\`\`\`mermaid
-flowchart LR
-    A[Webhook Trigger] --> B[Set: Normalize Data]
-    B --> C[Text Classifier]
-    C --> D{Switch: Route by Category}
-    D -->|High Priority| E[Slack: Alert Team]
-    D -->|Medium Priority| F[Create Task]
-    D -->|Low Priority| G[Log to Sheet]
-    D -->|Default| H[Manual Review]
-\`\`\`
-
-### Combined Approach
-For robust triage, combine rule-based and AI classification. Use AI Agent node with structured output to assign categories, scores, or tags, then route with Switch nodes.
-When using AI with structured output, always add reasoning field alongside category or score to aid debugging.
-
-Example workflow pattern:
-\`\`\`mermaid
-flowchart LR
-    A[Email Trigger] --> B[Set: Extract Fields]
-    B --> C{IF: Contains Keywords}
-    C -->|Yes| D[Set: Rule-based Category]
-    C -->|No| E[AI Agent: Classify with Structured Output]
-    D --> F[Merge]
-    E --> F
-    F --> G{Switch: Route by Category}
-    G -->|Category A| H[Action A]
-    G -->|Category B| I[Action B]
-    G -->|Default| J[Manual Review]
-\`\`\`
-
-**Structured Output Schema Example:**
-\`\`\`json
-{
-  "category": "INTERESTED | NOT_INTERESTED | QUESTION",
-  "confidence": 0.95,
-  "reasoning": "Customer asked about pricing and availability"
-}
-\`\`\`
-
-## Routing & Branching
-
-Use Switch node as primary traffic controller:
-- Configure cases for each classification value
-- Always define Default case for unexpected values
-- Each item follows exactly one branch
-
-Avoid parallel IF nodes that could match multiple conditions - use Switch node.
-
-## Recommended Nodes
-
-**IF** (n8n-nodes-base.if):
-- Purpose: Simple binary decisions
-- Use when: Two-way branching based on conditions
-- Example: Check if priority field equals "high"
-
-**Switch** (n8n-nodes-base.switch):
-- Purpose: Multi-way branching based on field values
-- Use when: Multiple categories (3+ outcomes)
-- Configure Default output for unmatched items
-
-**Merge** (n8n-nodes-base.merge):
-- Purpose: Consolidate branches for unified logging
-- Use after: Category-specific actions before final logging step
-
-**Text Classifier** (@n8n/n8n-nodes-langchain.textClassifier):
-- Purpose: AI-powered text classification with predefined labels
-- Use when: Need to assign categories to unstructured text
-- Configure "When No Clear Match" option to output items to "Other" branch
-
-**AI Agent** (@n8n/n8n-nodes-langchain.agent):
-- Purpose: Complex classification or scoring requiring multiple steps or tool use
-- Use when: Classification needs context lookup, multi-step reasoning with tools, numerical scoring or other complex outputs
-- Use structured output format (JSON schema)
-
-For all AI nodes (Text Classifier, AI Agent):
-	- Set low temperature of the model (0-0.2) for consistency
-	- Include few-shot examples in prompts
-
-## Common Pitfalls to Avoid
-
-### No Default Path
-**Problem**: Every Switch must have a Default output. Unmatched items should go to manual review or logging, never drop silently.
-
-**Solution**: Always configure Default case to route unclassified items to a fallback action (e.g., manual review queue, admin notification)
-
-### No "Other" Branch in Text Classifier
-**Problem**: Items that don't match any category get dropped if "When No Clear Match" isn't set.
-
-**Solution**: In Text Classifier node, set "When No Clear Match" to "Output on Extra, 'Other' Branch" to capture unmatched items.
-
-### Overlapping Conditions
-**Problem**: Categories must be mutually exclusive. Items matching multiple conditions cause unpredictable routing.
-
-**Solution**:
-- Order checks from most specific to general
-- Use Switch with distinct values instead of multiple IF nodes
-`;
-}
-//# sourceMappingURL=triage.js.map

package/dist/tools/best-practices/guides/triage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"triage.js","sourceRoot":"","sources":["../../../../src/tools/best-practices/guides/triage.ts"],"names":[],"mappings":";;AAAA,4CAyIC;AAzID,SAAgB,gBAAgB;IAC/B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuIP,CAAC;AACF,CAAC"}

package/dist/tools/filesystem/get-file-tree.tool.d.ts

@@ -1,22 +0,0 @@
-import type { InstanceAiContext } from '../../types';
-export declare function createGetFileTreeTool(context: InstanceAiContext): import("@mastra/core/tools").Tool<{
-    dirPath: string;
-    maxDepth?: number | undefined;
-}, {
-    tree: string;
-    truncated: boolean;
-    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>, "get-file-tree", unknown>;

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

@@ -1,64 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,30 +0,0 @@
-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

@@ -1,100 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,25 +0,0 @@
-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

@@ -1,83 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,31 +0,0 @@
-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

@@ -1,96 +0,0 @@
-"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

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