@n8n/instance-ai 1.0.0

package/dist/tools/orchestration/tracing-utils.js.map

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

package/dist/tools/orchestration/update-tasks.tool.d.ts

@@ -0,0 +1,10 @@
+import type { OrchestrationContext } from '../../types';
+export declare function createUpdateTasksTool(context: OrchestrationContext): import("@mastra/core/tools").Tool<{
+    tasks: {
+        status: "cancelled" | "failed" | "todo" | "in_progress" | "done";
+        id: string;
+        description: string;
+    }[];
+}, {
+    saved: boolean;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "update-tasks", unknown>;

package/dist/tools/orchestration/update-tasks.tool.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUpdateTasksTool = createUpdateTasksTool;
+const tools_1 = require("@mastra/core/tools");
+const api_types_1 = require("@n8n/api-types");
+const zod_1 = require("zod");
+function createUpdateTasksTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'update-tasks',
+        description: 'Write or update a visible task checklist for multi-step work. ' +
+            'Pass the full task list each time — it replaces the previous one.',
+        inputSchema: api_types_1.taskListSchema,
+        outputSchema: zod_1.z.object({ saved: zod_1.z.boolean() }),
+        execute: async (input) => {
+            await context.taskStorage.save(context.threadId, input);
+            context.eventBus.publish(context.threadId, {
+                type: 'tasks-update',
+                runId: context.runId,
+                agentId: context.orchestratorAgentId,
+                payload: { tasks: input },
+            });
+            return { saved: true };
+        },
+    });
+}
+//# sourceMappingURL=update-tasks.tool.js.map

package/dist/tools/orchestration/update-tasks.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-tasks.tool.js","sourceRoot":"","sources":["../../../src/tools/orchestration/update-tasks.tool.ts"],"names":[],"mappings":";;AAMA,sDAmBC;AAzBD,8CAAgD;AAChD,8CAAgD;AAChD,6BAAwB;AAIxB,SAAgB,qBAAqB,CAAC,OAA6B;IAClE,OAAO,IAAA,kBAAU,EAAC;QACjB,EAAE,EAAE,cAAc;QAClB,WAAW,EACV,gEAAgE;YAChE,mEAAmE;QACpE,WAAW,EAAE,0BAAc;QAC3B,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACxB,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE;gBAC1C,IAAI,EAAE,cAAc;gBACpB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,OAAO,EAAE,OAAO,CAAC,mBAAmB;gBACpC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;aACzB,CAAC,CAAC;YACH,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACxB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/orchestration/verify-built-workflow.tool.d.ts

@@ -0,0 +1,13 @@
+import type { OrchestrationContext } from '../../types';
+export declare function createVerifyBuiltWorkflowTool(context: OrchestrationContext): import("@mastra/core/tools").Tool<{
+    workItemId: string;
+    workflowId: string;
+    timeout?: number | undefined;
+    inputData?: Record<string, unknown> | undefined;
+}, {
+    success: boolean;
+    error?: string | undefined;
+    status?: "error" | "success" | "unknown" | "running" | "waiting" | undefined;
+    executionId?: string | undefined;
+    data?: Record<string, unknown> | undefined;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "verify-built-workflow", unknown>;

package/dist/tools/orchestration/verify-built-workflow.tool.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createVerifyBuiltWorkflowTool = createVerifyBuiltWorkflowTool;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+function createVerifyBuiltWorkflowTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'verify-built-workflow',
+        description: 'Run a built workflow that has mocked credentials, using sidecar verification pin data ' +
+            'from the build outcome. Use this instead of run-workflow when the build had mocked credentials.',
+        inputSchema: zod_1.z.object({
+            workItemId: zod_1.z.string().describe('The work item ID from the build (wi_XXXXXXXX)'),
+            workflowId: zod_1.z.string().describe('The workflow ID to verify'),
+            inputData: zod_1.z
+                .record(zod_1.z.unknown())
+                .optional()
+                .describe('Input data passed to the workflow trigger'),
+            timeout: zod_1.z
+                .number()
+                .int()
+                .min(1000)
+                .max(600_000)
+                .optional()
+                .describe('Max wait time in milliseconds (default 300000)'),
+        }),
+        outputSchema: zod_1.z.object({
+            executionId: zod_1.z.string().optional(),
+            success: zod_1.z.boolean(),
+            status: zod_1.z.enum(['running', 'success', 'error', 'waiting', 'unknown']).optional(),
+            data: zod_1.z.record(zod_1.z.unknown()).optional(),
+            error: zod_1.z.string().optional(),
+        }),
+        execute: async (input) => {
+            if (!context.workflowTaskService || !context.domainContext) {
+                return { success: false, error: 'Verification support not available.' };
+            }
+            const buildOutcome = await context.workflowTaskService.getBuildOutcome(input.workItemId);
+            if (!buildOutcome) {
+                return {
+                    success: false,
+                    error: `No build outcome found for work item ${input.workItemId}.`,
+                };
+            }
+            const result = await context.domainContext.executionService.run(input.workflowId, input.inputData, {
+                timeout: input.timeout,
+                pinData: buildOutcome.verificationPinData,
+            });
+            return {
+                executionId: result.executionId || undefined,
+                success: result.status === 'success',
+                status: result.status,
+                data: result.data,
+                error: result.error,
+            };
+        },
+    });
+}
+//# sourceMappingURL=verify-built-workflow.tool.js.map

package/dist/tools/orchestration/verify-built-workflow.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-built-workflow.tool.js","sourceRoot":"","sources":["../../../src/tools/orchestration/verify-built-workflow.tool.ts"],"names":[],"mappings":";;AAaA,sEA2DC;AAhED,8CAAgD;AAChD,6BAAwB;AAIxB,SAAgB,6BAA6B,CAAC,OAA6B;IAC1E,OAAO,IAAA,kBAAU,EAAC;QACjB,EAAE,EAAE,uBAAuB;QAC3B,WAAW,EACV,wFAAwF;YACxF,iGAAiG;QAClG,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACrB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;YAChF,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YAC5D,SAAS,EAAE,OAAC;iBACV,MAAM,CAAC,OAAC,CAAC,OAAO,EAAE,CAAC;iBACnB,QAAQ,EAAE;iBACV,QAAQ,CAAC,2CAA2C,CAAC;YACvD,OAAO,EAAE,OAAC;iBACR,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,IAAI,CAAC;iBACT,GAAG,CAAC,OAAO,CAAC;iBACZ,QAAQ,EAAE;iBACV,QAAQ,CAAC,gDAAgD,CAAC;SAC5D,CAAC;QACF,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC;YACtB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;YACpB,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;YAChF,IAAI,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;YACtC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC5B,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACxB,IAAI,CAAC,OAAO,CAAC,mBAAmB,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;gBAC5D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;YACzE,CAAC;YAED,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,mBAAmB,CAAC,eAAe,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACzF,IAAI,CAAC,YAAY,EAAE,CAAC;gBACnB,OAAO;oBACN,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,wCAAwC,KAAK,CAAC,UAAU,GAAG;iBAClE,CAAC;YACH,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,gBAAgB,CAAC,GAAG,CAC9D,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,SAAS,EACf;gBACC,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,OAAO,EAAE,YAAY,CAAC,mBAA4D;aAClF,CACD,CAAC;YAEF,OAAO;gBACN,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,SAAS;gBAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,SAAS;gBACpC,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;aACnB,CAAC;QACH,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/shared/ask-user.tool.d.ts

@@ -0,0 +1,61 @@
+export declare function createAskUserTool(): import("@mastra/core/tools").Tool<{
+    questions: {
+        type: "text" | "single" | "multi";
+        id: string;
+        question: string;
+        options?: string[] | undefined;
+    }[];
+    introMessage?: string | undefined;
+}, {
+    answered: boolean;
+    answers?: undefined;
+} | {
+    answered: boolean;
+    answers: {
+        question: string;
+        questionId: string;
+        selectedOptions: string[];
+        customText?: string | undefined;
+        skipped?: boolean | undefined;
+    }[];
+}, {
+    message: string;
+    requestId: string;
+    severity: "info";
+    inputType: "questions";
+    questions: {
+        type: "text" | "single" | "multi";
+        id: string;
+        question: string;
+        options?: string[] | undefined;
+    }[];
+    introMessage?: string | undefined;
+}, {
+    approved: boolean;
+    answers?: {
+        questionId: string;
+        selectedOptions: string[];
+        customText?: string | undefined;
+        skipped?: boolean | undefined;
+    }[] | undefined;
+}, import("@mastra/core/tools").ToolExecutionContext<{
+    message: string;
+    requestId: string;
+    severity: "info";
+    inputType: "questions";
+    questions: {
+        type: "text" | "single" | "multi";
+        id: string;
+        question: string;
+        options?: string[] | undefined;
+    }[];
+    introMessage?: string | undefined;
+}, {
+    approved: boolean;
+    answers?: {
+        questionId: string;
+        selectedOptions: string[];
+        customText?: string | undefined;
+        skipped?: boolean | undefined;
+    }[] | undefined;
+}, unknown>, "ask-user", unknown>;

package/dist/tools/shared/ask-user.tool.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAskUserTool = createAskUserTool;
+const tools_1 = require("@mastra/core/tools");
+const nanoid_1 = require("nanoid");
+const zod_1 = require("zod");
+const questionSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Unique question identifier'),
+    question: zod_1.z.string().describe('The question text to display to the user'),
+    type: zod_1.z
+        .enum(['single', 'multi', 'text'])
+        .describe('single = pick one option, multi = pick many, text = free-form input'),
+    options: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .describe('Suggested answers (required for single/multi, ignored for text)'),
+});
+const answerSchema = zod_1.z.object({
+    questionId: zod_1.z.string(),
+    selectedOptions: zod_1.z.array(zod_1.z.string()),
+    customText: zod_1.z.string().optional(),
+    skipped: zod_1.z.boolean().optional(),
+});
+function createAskUserTool() {
+    return (0, tools_1.createTool)({
+        id: 'ask-user',
+        description: 'Ask the user one or more structured questions. Each question can be ' +
+            'single-select (pick one), multi-select (pick many), or free-text. ' +
+            'The agent is suspended until the user responds. ' +
+            'IMPORTANT: The UI already provides a built-in "Something else" free-text ' +
+            'input for every single/multi question, so NEVER include generic catch-all ' +
+            'options like "Something else", "Other", "None of the above", or similar in ' +
+            'the options array — they duplicate the built-in input and confuse users. ' +
+            'Also NEVER add a separate follow-up question asking the user to elaborate ' +
+            'on a previous "other" choice. Keep questions concise and ' +
+            'avoid questions that reference answers to previous questions.',
+        inputSchema: zod_1.z.object({
+            questions: zod_1.z
+                .array(questionSchema)
+                .min(1)
+                .describe('Questions to present to the user in a paginated wizard'),
+            introMessage: zod_1.z
+                .string()
+                .optional()
+                .describe('Brief intro text shown above the first question'),
+        }),
+        outputSchema: zod_1.z.object({
+            answered: zod_1.z.boolean(),
+            answers: zod_1.z
+                .array(zod_1.z.object({
+                questionId: zod_1.z.string(),
+                question: zod_1.z.string(),
+                selectedOptions: zod_1.z.array(zod_1.z.string()),
+                customText: zod_1.z.string().optional(),
+                skipped: zod_1.z.boolean().optional(),
+            }))
+                .optional(),
+        }),
+        suspendSchema: zod_1.z.object({
+            requestId: zod_1.z.string(),
+            message: zod_1.z.string(),
+            severity: zod_1.z.literal('info'),
+            inputType: zod_1.z.literal('questions'),
+            questions: zod_1.z.array(questionSchema),
+            introMessage: zod_1.z.string().optional(),
+        }),
+        resumeSchema: zod_1.z.object({
+            approved: zod_1.z.boolean(),
+            answers: zod_1.z.array(answerSchema).optional(),
+        }),
+        execute: async (input, ctx) => {
+            const { resumeData, suspend } = ctx?.agent ?? {};
+            if (resumeData === undefined || resumeData === null) {
+                await suspend?.({
+                    requestId: (0, nanoid_1.nanoid)(),
+                    message: input.introMessage ?? input.questions[0].question,
+                    severity: 'info',
+                    inputType: 'questions',
+                    questions: input.questions,
+                    introMessage: input.introMessage,
+                });
+                return { answered: false };
+            }
+            if (!resumeData.approved || !resumeData.answers) {
+                return { answered: false };
+            }
+            const enrichedAnswers = resumeData.answers.map((a) => {
+                const q = input.questions.find((q2) => q2.id === a.questionId);
+                return {
+                    ...a,
+                    question: q?.question ?? a.questionId,
+                };
+            });
+            return { answered: true, answers: enrichedAnswers };
+        },
+    });
+}
+//# sourceMappingURL=ask-user.tool.js.map

package/dist/tools/shared/ask-user.tool.js.map

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

package/dist/tools/templates/search-template-parameters.tool.d.ts

@@ -0,0 +1,11 @@
+export declare function createSearchTemplateParametersTool(): import("@mastra/core/tools").Tool<{
+    search?: string | undefined;
+    nodeType?: string | undefined;
+    rows?: number | undefined;
+    category?: "AI" | "AI Chatbot" | "AI RAG" | "AI Summarization" | "Content Creation" | "CRM" | "Crypto Trading" | "DevOps" | "Document Extraction" | "Document Ops" | "Engineering" | "File Management" | "HR" | "Internal Wiki" | "Invoice Processing" | "IT Ops" | "Lead Generation" | "Lead Nurturing" | "Marketing" | "Market Research" | "Miscellaneous" | "Multimodal AI" | "Other" | "Personal Productivity" | "Project Management" | "Sales" | "SecOps" | "Social Media" | "Support" | "Support Chatbot" | "Ticket Management" | undefined;
+}, {
+    configurations: import("./types").NodeConfigurationsMap;
+    nodeTypes: string[];
+    totalTemplatesSearched: number;
+    formatted: string;
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "search-template-parameters", unknown>;

package/dist/tools/templates/search-template-parameters.tool.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSearchTemplateParametersTool = createSearchTemplateParametersTool;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+const template_api_1 = require("./template-api");
+const types_1 = require("./types");
+const node_configuration_utils_1 = require("../utils/node-configuration.utils");
+function createSearchTemplateParametersTool() {
+    return (0, tools_1.createTool)({
+        id: 'search-template-parameters',
+        description: 'Search n8n workflow templates and return node parameter configurations showing how specific nodes are typically set up. Use this to understand how nodes should be configured.',
+        inputSchema: zod_1.z.object({
+            search: zod_1.z.string().optional().describe('Free-text search query for templates'),
+            category: zod_1.z.enum(types_1.categories).optional().describe('Filter by template category'),
+            rows: zod_1.z
+                .number()
+                .min(1)
+                .max(10)
+                .optional()
+                .describe('Number of templates to search (default: 5, max: 10)'),
+            nodeType: zod_1.z
+                .string()
+                .optional()
+                .describe('Filter to show configurations for a specific node type only (e.g. "n8n-nodes-base.telegram")'),
+        }),
+        outputSchema: zod_1.z.object({
+            configurations: zod_1.z.record(zod_1.z.string(), zod_1.z.array(zod_1.z.object({
+                version: zod_1.z.number(),
+                parameters: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()),
+            }))),
+            nodeTypes: zod_1.z.array(zod_1.z.string()),
+            totalTemplatesSearched: zod_1.z.number(),
+            formatted: zod_1.z.string(),
+        }),
+        execute: async ({ search, category, rows, nodeType }) => {
+            const result = await (0, template_api_1.fetchWorkflowsFromTemplates)({ search, category, rows });
+            const allConfigurations = (0, node_configuration_utils_1.collectNodeConfigurationsFromWorkflows)(result.workflows);
+            let filteredConfigurations = allConfigurations;
+            if (nodeType) {
+                const matching = allConfigurations[nodeType];
+                filteredConfigurations = matching ? { [nodeType]: matching } : {};
+            }
+            const nodeTypes = Object.keys(filteredConfigurations);
+            const formattedParts = nodeTypes.map((nt) => (0, node_configuration_utils_1.formatNodeConfigurationExamples)(nt, filteredConfigurations[nt], undefined, 3));
+            return {
+                configurations: filteredConfigurations,
+                nodeTypes,
+                totalTemplatesSearched: result.totalFound,
+                formatted: formattedParts.join('\n\n'),
+            };
+        },
+    });
+}
+//# sourceMappingURL=search-template-parameters.tool.js.map

package/dist/tools/templates/search-template-parameters.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-template-parameters.tool.js","sourceRoot":"","sources":["../../../src/tools/templates/search-template-parameters.tool.ts"],"names":[],"mappings":";;AAUA,gFA6DC;AAvED,8CAAgD;AAChD,6BAAwB;AAExB,iDAA6D;AAC7D,mCAAqC;AACrC,gFAG2C;AAE3C,SAAgB,kCAAkC;IACjD,OAAO,IAAA,kBAAU,EAAC;QACjB,EAAE,EAAE,4BAA4B;QAChC,WAAW,EACV,gLAAgL;QACjL,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACrB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YAC9E,QAAQ,EAAE,OAAC,CAAC,IAAI,CAAC,kBAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;YAC/E,IAAI,EAAE,OAAC;iBACL,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,EAAE;iBACV,QAAQ,CAAC,qDAAqD,CAAC;YACjE,QAAQ,EAAE,OAAC;iBACT,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACR,8FAA8F,CAC9F;SACF,CAAC;QACF,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC;YACtB,cAAc,EAAE,OAAC,CAAC,MAAM,CACvB,OAAC,CAAC,MAAM,EAAE,EACV,OAAC,CAAC,KAAK,CACN,OAAC,CAAC,MAAM,CAAC;gBACR,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;gBACnB,UAAU,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC;aAC7C,CAAC,CACF,CACD;YACD,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;YAC9B,sBAAsB,EAAE,OAAC,CAAC,MAAM,EAAE;YAClC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE;SACrB,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;YACvD,MAAM,MAAM,GAAG,MAAM,IAAA,0CAA2B,EAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YAE7E,MAAM,iBAAiB,GAAG,IAAA,iEAAsC,EAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAGnF,IAAI,sBAAsB,GAAG,iBAAiB,CAAC;YAC/C,IAAI,QAAQ,EAAE,CAAC;gBACd,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;gBAC7C,sBAAsB,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,CAAC;YAGD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YACtD,MAAM,cAAc,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAC3C,IAAA,0DAA+B,EAAC,EAAE,EAAE,sBAAsB,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAC7E,CAAC;YAEF,OAAO;gBACN,cAAc,EAAE,sBAAsB;gBACtC,SAAS;gBACT,sBAAsB,EAAE,MAAM,CAAC,UAAU;gBACzC,SAAS,EAAE,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC;aACtC,CAAC;QACH,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/templates/search-template-structures.tool.d.ts

@@ -0,0 +1,12 @@
+export declare function createSearchTemplateStructuresTool(): import("@mastra/core/tools").Tool<{
+    search?: string | undefined;
+    rows?: number | undefined;
+    category?: "AI" | "AI Chatbot" | "AI RAG" | "AI Summarization" | "Content Creation" | "CRM" | "Crypto Trading" | "DevOps" | "Document Extraction" | "Document Ops" | "Engineering" | "File Management" | "HR" | "Internal Wiki" | "Invoice Processing" | "IT Ops" | "Lead Generation" | "Lead Nurturing" | "Marketing" | "Market Research" | "Miscellaneous" | "Multimodal AI" | "Other" | "Personal Productivity" | "Project Management" | "Sales" | "SecOps" | "Social Media" | "Support" | "Support Chatbot" | "Ticket Management" | undefined;
+}, {
+    totalResults: number;
+    examples: {
+        name: string;
+        mermaid: string;
+        description?: string | undefined;
+    }[];
+}, unknown, unknown, import("@mastra/core/tools").ToolExecutionContext<unknown, unknown, unknown>, "search-template-structures", unknown>;

package/dist/tools/templates/search-template-structures.tool.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSearchTemplateStructuresTool = createSearchTemplateStructuresTool;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+const template_api_1 = require("./template-api");
+const types_1 = require("./types");
+const mermaid_utils_1 = require("../utils/mermaid.utils");
+function createSearchTemplateStructuresTool() {
+    return (0, tools_1.createTool)({
+        id: 'search-template-structures',
+        description: 'Search n8n workflow templates and return mermaid diagrams showing their structure. Use this to find reference workflow patterns before building complex workflows.',
+        inputSchema: zod_1.z.object({
+            search: zod_1.z.string().optional().describe('Free-text search query for templates'),
+            category: zod_1.z.enum(types_1.categories).optional().describe('Filter by template category'),
+            rows: zod_1.z
+                .number()
+                .min(1)
+                .max(10)
+                .optional()
+                .describe('Number of templates to return (default: 5, max: 10)'),
+        }),
+        outputSchema: zod_1.z.object({
+            examples: zod_1.z.array(zod_1.z.object({
+                name: zod_1.z.string(),
+                description: zod_1.z.string().optional(),
+                mermaid: zod_1.z.string(),
+            })),
+            totalResults: zod_1.z.number(),
+        }),
+        execute: async ({ search, category, rows }) => {
+            const result = await (0, template_api_1.fetchWorkflowsFromTemplates)({ search, category, rows });
+            const examples = result.workflows.map((wf) => ({
+                name: wf.name,
+                description: wf.description,
+                mermaid: (0, mermaid_utils_1.mermaidStringify)(wf, { includeNodeParameters: false }),
+            }));
+            return {
+                examples,
+                totalResults: result.totalFound,
+            };
+        },
+    });
+}
+//# sourceMappingURL=search-template-structures.tool.js.map

package/dist/tools/templates/search-template-structures.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-template-structures.tool.js","sourceRoot":"","sources":["../../../src/tools/templates/search-template-structures.tool.ts"],"names":[],"mappings":";;AAOA,gFAwCC;AA/CD,8CAAgD;AAChD,6BAAwB;AAExB,iDAA6D;AAC7D,mCAAqC;AACrC,0DAA0D;AAE1D,SAAgB,kCAAkC;IACjD,OAAO,IAAA,kBAAU,EAAC;QACjB,EAAE,EAAE,4BAA4B;QAChC,WAAW,EACV,oKAAoK;QACrK,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACrB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YAC9E,QAAQ,EAAE,OAAC,CAAC,IAAI,CAAC,kBAAU,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;YAC/E,IAAI,EAAE,OAAC;iBACL,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,EAAE;iBACV,QAAQ,CAAC,qDAAqD,CAAC;SACjE,CAAC;QACF,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC;YACtB,QAAQ,EAAE,OAAC,CAAC,KAAK,CAChB,OAAC,CAAC,MAAM,CAAC;gBACR,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;gBAChB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAClC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;aACnB,CAAC,CACF;YACD,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE;SACxB,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE;YAC7C,MAAM,MAAM,GAAG,MAAM,IAAA,0CAA2B,EAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YAE7E,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAC9C,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,WAAW,EAAE,EAAE,CAAC,WAAW;gBAC3B,OAAO,EAAE,IAAA,gCAAgB,EAAC,EAAE,EAAE,EAAE,qBAAqB,EAAE,KAAK,EAAE,CAAC;aAC/D,CAAC,CAAC,CAAC;YAEJ,OAAO;gBACN,QAAQ;gBACR,YAAY,EAAE,MAAM,CAAC,UAAU;aAC/B,CAAC;QACH,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/templates/template-api.d.ts

@@ -0,0 +1,21 @@
+import type { Category, TemplateFetchResponse, TemplateSearchResponse, WorkflowMetadata } from './types';
+export declare function fetchTemplateList(query: {
+    search?: string;
+    category?: Category;
+    rows?: number;
+    nodes?: string;
+}): Promise<TemplateSearchResponse>;
+export declare function fetchTemplateByID(id: number): Promise<TemplateFetchResponse>;
+export interface FetchWorkflowsResult {
+    workflows: WorkflowMetadata[];
+    totalFound: number;
+    templateIds: number[];
+}
+export declare function fetchWorkflowsFromTemplates(query: {
+    search?: string;
+    category?: Category;
+    rows?: number;
+    nodes?: string;
+}, options?: {
+    maxTemplates?: number;
+}): Promise<FetchWorkflowsResult>;

package/dist/tools/templates/template-api.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchTemplateList = fetchTemplateList;
+exports.fetchTemplateByID = fetchTemplateByID;
+exports.fetchWorkflowsFromTemplates = fetchWorkflowsFromTemplates;
+const N8N_API_BASE_URL = 'https://api.n8n.io/api';
+function isTemplateSearchResponse(data) {
+    if (typeof data !== 'object' || data === null)
+        return false;
+    const obj = data;
+    return typeof obj.totalWorkflows === 'number' && Array.isArray(obj.workflows);
+}
+function isTemplateFetchResponse(data) {
+    if (typeof data !== 'object' || data === null)
+        return false;
+    const obj = data;
+    return (typeof obj.id === 'number' &&
+        typeof obj.name === 'string' &&
+        typeof obj.workflow === 'object' &&
+        obj.workflow !== null);
+}
+function buildSearchQueryString(query) {
+    const params = new URLSearchParams();
+    params.append('price', '0');
+    params.append('combineWith', 'and');
+    params.append('sort', 'createdAt:desc,rank:desc');
+    params.append('rows', String(query.rows ?? 5));
+    params.append('page', '1');
+    if (query.search)
+        params.append('search', query.search);
+    if (query.category)
+        params.append('category', query.category);
+    if (query.nodes)
+        params.append('nodes', query.nodes);
+    return params.toString();
+}
+async function fetchTemplateList(query) {
+    const queryString = buildSearchQueryString(query);
+    const url = `${N8N_API_BASE_URL}/templates/search${queryString ? `?${queryString}` : ''}`;
+    const response = await fetch(url, {
+        method: 'GET',
+        headers: {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch templates: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    if (!isTemplateSearchResponse(data)) {
+        throw new Error('Invalid response format from templates API');
+    }
+    return data;
+}
+async function fetchTemplateByID(id) {
+    const url = `${N8N_API_BASE_URL}/workflows/templates/${id}`;
+    const response = await fetch(url, {
+        method: 'GET',
+        headers: {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch template ${id}: ${response.status} ${response.statusText}`);
+    }
+    const data = await response.json();
+    if (!isTemplateFetchResponse(data)) {
+        throw new Error(`Invalid response format from template ${id} API`);
+    }
+    return data;
+}
+async function fetchWorkflowsFromTemplates(query, options) {
+    const { maxTemplates } = options ?? {};
+    const searchResponse = await fetchTemplateList(query);
+    const templatesToFetch = maxTemplates
+        ? searchResponse.workflows.slice(0, maxTemplates)
+        : searchResponse.workflows;
+    const workflowResults = await Promise.all(templatesToFetch.map(async (template) => {
+        try {
+            const fullWorkflow = await fetchTemplateByID(template.id);
+            return {
+                metadata: {
+                    templateId: template.id,
+                    name: template.name,
+                    description: template.description,
+                    workflow: fullWorkflow.workflow,
+                },
+                templateId: template.id,
+            };
+        }
+        catch {
+            return null;
+        }
+    }));
+    const validResults = workflowResults.filter((result) => result !== null);
+    return {
+        workflows: validResults.map((r) => r.metadata),
+        totalFound: searchResponse.totalWorkflows,
+        templateIds: validResults.map((r) => r.templateId),
+    };
+}
+//# sourceMappingURL=template-api.js.map

package/dist/tools/templates/template-api.js.map

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

package/dist/tools/templates/types.d.ts

@@ -0,0 +1,52 @@
+export interface TemplateNode {
+    id?: string;
+    name: string;
+    type: string;
+    typeVersion: number;
+    position: [number, number];
+    parameters: Record<string, unknown>;
+}
+export interface ConnectionEntry {
+    node: string;
+    type?: string;
+    index?: number;
+}
+export type TemplateConnections = Record<string, Record<string, Array<ConnectionEntry[] | null>>>;
+export interface TemplateWorkflow {
+    name?: string;
+    nodes: TemplateNode[];
+    connections: TemplateConnections;
+}
+export declare const categories: readonly ["AI", "AI Chatbot", "AI RAG", "AI Summarization", "Content Creation", "CRM", "Crypto Trading", "DevOps", "Document Extraction", "Document Ops", "Engineering", "File Management", "HR", "Internal Wiki", "Invoice Processing", "IT Ops", "Lead Generation", "Lead Nurturing", "Marketing", "Market Research", "Miscellaneous", "Multimodal AI", "Other", "Personal Productivity", "Project Management", "Sales", "SecOps", "Social Media", "Support", "Support Chatbot", "Ticket Management"];
+export type Category = (typeof categories)[number];
+export interface TemplateSearchQuery {
+    search?: string;
+    rows?: number;
+    category?: Category;
+    nodes?: string;
+}
+export interface TemplateWorkflowDescription {
+    id: number;
+    name: string;
+    description: string;
+}
+export interface TemplateSearchResponse {
+    totalWorkflows: number;
+    workflows: TemplateWorkflowDescription[];
+}
+export interface TemplateFetchResponse {
+    id: number;
+    name: string;
+    workflow: TemplateWorkflow;
+}
+export interface WorkflowMetadata {
+    templateId: number;
+    name: string;
+    description?: string;
+    workflow: TemplateWorkflow;
+}
+export interface NodeConfigurationEntry {
+    version: number;
+    parameters: Record<string, unknown>;
+}
+export type NodeConfigurationsMap = Record<string, NodeConfigurationEntry[]>;