@n8n/instance-ai 1.0.0

package/dist/tools/workflows/materialize-node-type.tool.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMaterializeNodeTypeTool = createMaterializeNodeTypeTool;
+const tools_1 = require("@mastra/core/tools");
+const zod_1 = require("zod");
+const sandbox_fs_1 = require("../../workspace/sandbox-fs");
+const sandbox_setup_1 = require("../../workspace/sandbox-setup");
+const nodeRequestSchema = zod_1.z.union([
+    zod_1.z.string().describe('Simple node ID, e.g. "n8n-nodes-base.httpRequest"'),
+    zod_1.z.object({
+        nodeId: zod_1.z.string().describe('Node type ID'),
+        version: zod_1.z.string().optional().describe('Version, e.g. "4.3" or "v43"'),
+        resource: zod_1.z.string().optional().describe('Resource discriminator for split nodes'),
+        operation: zod_1.z.string().optional().describe('Operation discriminator for split nodes'),
+        mode: zod_1.z.string().optional().describe('Mode discriminator for split nodes'),
+    }),
+]);
+function nodeIdToPath(nodeId) {
+    const dotIndex = nodeId.lastIndexOf('.');
+    if (dotIndex === -1)
+        return nodeId;
+    return `${nodeId.substring(0, dotIndex)}/${nodeId.substring(dotIndex + 1)}`;
+}
+function esc(s) {
+    return s.replace(/'/g, "'\\''");
+}
+function createMaterializeNodeTypeTool(context, workspace) {
+    return (0, tools_1.createTool)({
+        id: 'materialize-node-type',
+        description: 'Get TypeScript type definitions for nodes. Returns the full definition content ' +
+            'AND writes the files to the sandbox so tsc can reference them. ' +
+            'Use after search-nodes to get exact schemas before writing workflow code. ' +
+            'No need to cat the files afterward — content is returned directly.',
+        inputSchema: zod_1.z.object({
+            nodeIds: zod_1.z
+                .array(nodeRequestSchema)
+                .min(1)
+                .max(5)
+                .describe('Node IDs to materialize definitions for (max 5)'),
+        }),
+        outputSchema: zod_1.z.object({
+            definitions: zod_1.z.array(zod_1.z.object({
+                nodeId: zod_1.z.string(),
+                path: zod_1.z.string(),
+                content: zod_1.z.string(),
+                error: zod_1.z.string().optional(),
+            })),
+        }),
+        execute: async ({ nodeIds }) => {
+            if (!context.nodeService.getNodeTypeDefinition) {
+                return {
+                    definitions: nodeIds.map((req) => ({
+                        nodeId: typeof req === 'string' ? req : req.nodeId,
+                        path: '',
+                        content: '',
+                        error: 'Node type definitions are not available.',
+                    })),
+                };
+            }
+            const root = await (0, sandbox_setup_1.getWorkspaceRoot)(workspace);
+            const resolved = await Promise.all(nodeIds.map(async (req) => {
+                const nodeId = typeof req === 'string' ? req : req.nodeId;
+                const options = typeof req === 'string' ? undefined : req;
+                const result = await context.nodeService.getNodeTypeDefinition(nodeId, options);
+                if (!result || result.error) {
+                    return {
+                        nodeId,
+                        path: '',
+                        content: '',
+                        error: result?.error ?? `No type definition found for '${nodeId}'.`,
+                    };
+                }
+                const version = result.version ?? 'latest';
+                const filePath = `${root}/node-types/${nodeIdToPath(nodeId)}/${version}.ts`;
+                return { nodeId, path: filePath, content: result.content };
+            }));
+            const toWrite = resolved.filter((r) => r.content && !r.error);
+            if (toWrite.length > 0) {
+                const lines = ['#!/bin/bash', 'set -e'];
+                const dirs = new Set();
+                for (const f of toWrite) {
+                    const lastSlash = f.path.lastIndexOf('/');
+                    if (lastSlash > 0)
+                        dirs.add(f.path.substring(0, lastSlash));
+                }
+                lines.push(`mkdir -p ${[...dirs].map((d) => `'${esc(d)}'`).join(' ')}`);
+                for (const f of toWrite) {
+                    const b64 = Buffer.from(f.content, 'utf-8').toString('base64');
+                    lines.push(`echo '${b64}' | base64 -d > '${esc(f.path)}'`);
+                }
+                const script = lines.join('\n');
+                const scriptB64 = Buffer.from(script, 'utf-8').toString('base64');
+                const result = await (0, sandbox_fs_1.runInSandbox)(workspace, `echo '${scriptB64}' | base64 -d | bash`);
+                if (result.exitCode !== 0) {
+                    for (const f of toWrite) {
+                        f.error =
+                            `File write failed (content still usable): ${result.stderr.substring(0, 100)}`;
+                    }
+                }
+            }
+            return { definitions: resolved };
+        },
+    });
+}
+//# sourceMappingURL=materialize-node-type.tool.js.map

package/dist/tools/workflows/materialize-node-type.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize-node-type.tool.js","sourceRoot":"","sources":["../../../src/tools/workflows/materialize-node-type.tool.ts"],"names":[],"mappings":";;AA6CA,sEAgGC;AAlID,8CAAgD;AAEhD,6BAAwB;AAGxB,2DAA0D;AAC1D,iEAAiE;AAEjE,MAAM,iBAAiB,GAAG,OAAC,CAAC,KAAK,CAAC;IACjC,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IACxE,OAAC,CAAC,MAAM,CAAC;QACR,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;QAC3C,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QACvE,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;QAClF,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QACpF,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;KAC1E,CAAC;CACF,CAAC,CAAC;AAMH,SAAS,YAAY,CAAC,MAAc;IACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,QAAQ,KAAK,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IACnC,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC;AAGD,SAAS,GAAG,CAAC,CAAS;IACrB,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,SAAgB,6BAA6B,CAAC,OAA0B,EAAE,SAAoB;IAC7F,OAAO,IAAA,kBAAU,EAAC;QACjB,EAAE,EAAE,uBAAuB;QAC3B,WAAW,EACV,iFAAiF;YACjF,iEAAiE;YACjE,4EAA4E;YAC5E,oEAAoE;QACrE,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACrB,OAAO,EAAE,OAAC;iBACR,KAAK,CAAC,iBAAiB,CAAC;iBACxB,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,iDAAiD,CAAC;SAC7D,CAAC;QACF,YAAY,EAAE,OAAC,CAAC,MAAM,CAAC;YACtB,WAAW,EAAE,OAAC,CAAC,KAAK,CACnB,OAAC,CAAC,MAAM,CAAC;gBACR,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;gBAClB,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;gBAChB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;gBACnB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aAC5B,CAAC,CACF;SACD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YAC9B,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,qBAAqB,EAAE,CAAC;gBAChD,OAAO;oBACN,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;wBAClC,MAAM,EAAE,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM;wBAClD,IAAI,EAAE,EAAE;wBACR,OAAO,EAAE,EAAE;wBACX,KAAK,EAAE,0CAA0C;qBACjD,CAAC,CAAC;iBACH,CAAC;YACH,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,IAAA,gCAAgB,EAAC,SAAS,CAAC,CAAC;YAG/C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBACzB,MAAM,MAAM,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;gBAC1D,MAAM,OAAO,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC1D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,qBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEjF,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;oBAC7B,OAAO;wBACN,MAAM;wBACN,IAAI,EAAE,EAAE;wBACR,OAAO,EAAE,EAAE;wBACX,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,iCAAiC,MAAM,IAAI;qBACnE,CAAC;gBACH,CAAC;gBAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,QAAQ,CAAC;gBAC3C,MAAM,QAAQ,GAAG,GAAG,IAAI,eAAe,YAAY,CAAC,MAAM,CAAC,IAAI,OAAO,KAAK,CAAC;gBAC5E,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YAC5D,CAAC,CAAC,CACF,CAAC;YAGF,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAC9D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAa,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;gBAGlD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;gBAC/B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;oBACzB,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;oBAC1C,IAAI,SAAS,GAAG,CAAC;wBAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;gBAC7D,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAGxE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;oBACzB,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;oBAC/D,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,oBAAoB,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC5D,CAAC;gBAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAClE,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAY,EAAC,SAAS,EAAE,SAAS,SAAS,sBAAsB,CAAC,CAAC;gBAEvF,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBAE3B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;wBACxB,CAAwB,CAAC,KAAK;4BAC9B,6CAA6C,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;oBACjF,CAAC;gBACF,CAAC;YACF,CAAC;YAED,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;QAClC,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/workflows/publish-workflow.tool.d.ts

@@ -0,0 +1,24 @@
+import type { InstanceAiContext } from '../../types';
+export declare function createPublishWorkflowTool(context: InstanceAiContext): import("@mastra/core/tools").Tool<{
+    workflowId: string;
+    workflowName?: string | undefined;
+    versionId?: string | undefined;
+}, {
+    success: boolean;
+    error?: string | undefined;
+    denied?: boolean | undefined;
+    reason?: string | undefined;
+    activeVersionId?: 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>, "publish-workflow", unknown>;

package/dist/tools/workflows/publish-workflow.tool.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPublishWorkflowTool = createPublishWorkflowTool;
+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 createPublishWorkflowTool(context) {
+    const hasNamedVersions = !!context.workflowService.updateVersion;
+    const baseSchema = zod_1.z.object({
+        workflowId: zod_1.z.string().describe('ID of the workflow'),
+        workflowName: zod_1.z.string().optional().describe('Name of the workflow (for confirmation message)'),
+        versionId: zod_1.z
+            .string()
+            .optional()
+            .describe('Specific version to publish (omit to publish the latest draft)'),
+    });
+    const inputSchema = hasNamedVersions
+        ? baseSchema.extend({
+            name: zod_1.z
+                .string()
+                .optional()
+                .describe('Name for this published version (e.g. "v1.2 — added retry logic")'),
+            description: zod_1.z
+                .string()
+                .optional()
+                .describe('Description of what this version does or what changed'),
+        })
+        : baseSchema;
+    return (0, tools_1.createTool)({
+        id: 'publish-workflow',
+        description: 'Publish a workflow version to production. Publishing makes the specified version active — ' +
+            'it will run on its triggers. If the workflow has been edited since last publish, you must ' +
+            're-publish for changes to take effect. Omit versionId to publish the latest draft.',
+        inputSchema,
+        outputSchema: zod_1.z.object({
+            success: zod_1.z.boolean(),
+            activeVersionId: zod_1.z
+                .string()
+                .optional()
+                .describe('The now-active version ID. Confirms the workflow is published.'),
+            error: zod_1.z.string().optional(),
+            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 (input, ctx) => {
+            const { resumeData, suspend } = ctx?.agent ?? {};
+            const needsApproval = context.permissions?.publishWorkflow !== 'always_allow';
+            if (needsApproval && (resumeData === undefined || resumeData === null)) {
+                const label = input.workflowName ?? input.workflowId;
+                await suspend?.({
+                    requestId: (0, nanoid_1.nanoid)(),
+                    message: input.versionId
+                        ? `Publish version "${input.versionId}" of workflow "${label}"?`
+                        : `Publish workflow "${label}"?`,
+                    severity: 'warning',
+                });
+                return { success: false };
+            }
+            if (resumeData !== undefined && resumeData !== null && !resumeData.approved) {
+                return { success: false, denied: true, reason: 'User denied the action' };
+            }
+            try {
+                const result = await context.workflowService.publish(input.workflowId, {
+                    versionId: input.versionId,
+                    ...(hasNamedVersions
+                        ? {
+                            name: input.name,
+                            description: input.description,
+                        }
+                        : {}),
+                });
+                return { success: true, activeVersionId: result.activeVersionId };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Publish failed',
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=publish-workflow.tool.js.map

package/dist/tools/workflows/publish-workflow.tool.js.map

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

package/dist/tools/workflows/resolve-credentials.d.ts

@@ -0,0 +1,14 @@
+import type { WorkflowJSON } from '@n8n/workflow-sdk';
+import type { InstanceAiContext } from '../../types';
+export type CredentialMap = Map<string, {
+    id: string;
+    name: string;
+}>;
+export declare function buildCredentialMap(credentialService: Pick<InstanceAiContext['credentialService'], 'list'>): Promise<CredentialMap>;
+export interface CredentialResolutionResult {
+    mockedNodeNames: string[];
+    mockedCredentialTypes: string[];
+    mockedCredentialsByNode: Record<string, string[]>;
+    verificationPinData: Record<string, Array<Record<string, unknown>>>;
+}
+export declare function resolveCredentials(json: WorkflowJSON, workflowId: string | undefined, ctx: InstanceAiContext, credentialMap: CredentialMap): Promise<CredentialResolutionResult>;

package/dist/tools/workflows/resolve-credentials.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCredentialMap = buildCredentialMap;
+exports.resolveCredentials = resolveCredentials;
+async function buildCredentialMap(credentialService) {
+    const map = new Map();
+    try {
+        const allCreds = await credentialService.list();
+        for (const cred of allCreds) {
+            map.set(cred.type, { id: cred.id, name: cred.name });
+        }
+    }
+    catch {
+    }
+    return map;
+}
+async function resolveCredentials(json, workflowId, ctx, credentialMap) {
+    const mockedNodeNames = [];
+    const mockedCredentialTypesSet = new Set();
+    const mockedCredentialsByNode = {};
+    const verificationPinData = {};
+    const existingCredsByNode = new Map();
+    if (workflowId) {
+        try {
+            const existing = await ctx.workflowService.getAsWorkflowJSON(workflowId);
+            for (const existingNode of existing.nodes ?? []) {
+                if (existingNode.credentials && existingNode.name) {
+                    existingCredsByNode.set(existingNode.name, existingNode.credentials);
+                }
+            }
+        }
+        catch {
+        }
+    }
+    for (const node of json.nodes ?? []) {
+        if (!node.credentials)
+            continue;
+        const creds = node.credentials;
+        let nodeMocked = false;
+        for (const [key, value] of Object.entries(creds)) {
+            if (value !== undefined && value !== null)
+                continue;
+            const fromMap = credentialMap.get(key);
+            if (fromMap) {
+                creds[key] = fromMap;
+                cleanupMockPinData(json, node.name);
+                continue;
+            }
+            const existingCreds = node.name ? existingCredsByNode.get(node.name) : undefined;
+            if (existingCreds?.[key]) {
+                creds[key] = existingCreds[key];
+                cleanupMockPinData(json, node.name);
+                continue;
+            }
+            const nodeName = node.name ?? '';
+            delete creds[key];
+            mockedCredentialTypesSet.add(key);
+            nodeMocked = true;
+            if (nodeName) {
+                mockedCredentialsByNode[nodeName] ??= [];
+                mockedCredentialsByNode[nodeName].push(key);
+                if (!(json.pinData && nodeName in json.pinData)) {
+                    verificationPinData[nodeName] ??= [];
+                    if (verificationPinData[nodeName].length === 0) {
+                        verificationPinData[nodeName].push({ _mockedCredential: key });
+                    }
+                }
+            }
+        }
+        if (nodeMocked && node.name) {
+            mockedNodeNames.push(node.name);
+        }
+    }
+    return {
+        mockedNodeNames,
+        mockedCredentialTypes: [...mockedCredentialTypesSet],
+        mockedCredentialsByNode,
+        verificationPinData,
+    };
+}
+function cleanupMockPinData(json, nodeName) {
+    if (!nodeName || !json.pinData?.[nodeName])
+        return;
+    const items = json.pinData[nodeName];
+    if (items.length === 1 && '_mockedCredential' in items[0]) {
+        delete json.pinData[nodeName];
+    }
+}
+//# sourceMappingURL=resolve-credentials.js.map

package/dist/tools/workflows/resolve-credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-credentials.js","sourceRoot":"","sources":["../../../src/tools/workflows/resolve-credentials.ts"],"names":[],"mappings":";;AAqBA,gDAaC;AA0BD,gDA0FC;AAjIM,KAAK,UAAU,kBAAkB,CACvC,iBAAuE;IAEvE,MAAM,GAAG,GAAkB,IAAI,GAAG,EAAE,CAAC;IACrC,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,CAAC;QAChD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC7B,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;IACF,CAAC;IAAC,MAAM,CAAC;IAET,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AA0BM,KAAK,UAAU,kBAAkB,CACvC,IAAkB,EAClB,UAA8B,EAC9B,GAAsB,EACtB,aAA4B;IAE5B,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,MAAM,wBAAwB,GAAG,IAAI,GAAG,EAAU,CAAC;IACnD,MAAM,uBAAuB,GAA6B,EAAE,CAAC;IAC7D,MAAM,mBAAmB,GAAmD,EAAE,CAAC;IAG/E,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAmC,CAAC;IACvE,IAAI,UAAU,EAAE,CAAC;QAChB,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YACzE,KAAK,MAAM,YAAY,IAAI,QAAQ,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;gBACjD,IAAI,YAAY,CAAC,WAAW,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC;oBACnD,mBAAmB,CAAC,GAAG,CACtB,YAAY,CAAC,IAAI,EACjB,YAAY,CAAC,WAAsC,CACnD,CAAC;gBACH,CAAC;YACF,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;QAET,CAAC;IACF,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,SAAS;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAsC,CAAC;QAC1D,IAAI,UAAU,GAAG,KAAK,CAAC;QAEvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;gBAAE,SAAS;YAGpD,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACvC,IAAI,OAAO,EAAE,CAAC;gBACb,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;gBACrB,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpC,SAAS;YACV,CAAC;YAGD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACjF,IAAI,aAAa,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,KAAK,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;gBAChC,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpC,SAAS;YACV,CAAC;YAMD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YACjC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;YAClB,wBAAwB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClC,UAAU,GAAG,IAAI,CAAC;YAElB,IAAI,QAAQ,EAAE,CAAC;gBAEd,uBAAuB,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACzC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAK5C,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;oBACjD,mBAAmB,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;oBACrC,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBAChD,mBAAmB,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,iBAAiB,EAAE,GAAG,EAAE,CAAC,CAAC;oBAChE,CAAC;gBACF,CAAC;YACF,CAAC;QACF,CAAC;QAED,IAAI,UAAU,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC7B,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;IACF,CAAC;IAED,OAAO;QACN,eAAe;QACf,qBAAqB,EAAE,CAAC,GAAG,wBAAwB,CAAC;QACpD,uBAAuB;QACvB,mBAAmB;KACnB,CAAC;AACH,CAAC;AAOD,SAAS,kBAAkB,CAAC,IAAkB,EAAE,QAA4B;IAC3E,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC;QAAE,OAAO;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,mBAAmB,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;AACF,CAAC"}

package/dist/tools/workflows/restore-workflow-version.tool.d.ts

@@ -0,0 +1,22 @@
+import type { InstanceAiContext } from '../../types';
+export declare function createRestoreWorkflowVersionTool(context: InstanceAiContext): import("@mastra/core/tools").Tool<{
+    workflowId: string;
+    versionId: string;
+}, {
+    success: boolean;
+    error?: string | undefined;
+    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>, "restore-workflow-version", unknown>;

package/dist/tools/workflows/restore-workflow-version.tool.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRestoreWorkflowVersionTool = createRestoreWorkflowVersionTool;
+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 format_timestamp_1 = require("../../utils/format-timestamp");
+function createRestoreWorkflowVersionTool(context) {
+    return (0, tools_1.createTool)({
+        id: 'restore-workflow-version',
+        description: 'Restore a workflow to a previous version by overwriting the current draft with that ' +
+            "version's nodes and connections. This does NOT affect the published/active version — " +
+            'you must publish separately after restoring.',
+        inputSchema: zod_1.z.object({
+            workflowId: zod_1.z.string().describe('ID of the workflow'),
+            versionId: zod_1.z.string().describe('ID of the version to restore'),
+        }),
+        outputSchema: zod_1.z.object({
+            success: zod_1.z.boolean(),
+            error: zod_1.z.string().optional(),
+            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 (input, ctx) => {
+            const { resumeData, suspend } = ctx?.agent ?? {};
+            const needsApproval = context.permissions?.restoreWorkflowVersion !== 'always_allow';
+            if (needsApproval && (resumeData === undefined || resumeData === null)) {
+                const version = await context.workflowService.getVersion(input.workflowId, input.versionId).catch(() => undefined);
+                const timestamp = version?.createdAt ? (0, format_timestamp_1.formatTimestamp)(version.createdAt) : undefined;
+                const versionLabel = version?.name
+                    ? `"${version.name}" (${timestamp})`
+                    : `"${input.versionId}" (${timestamp ?? 'unknown date'})`;
+                await suspend?.({
+                    requestId: (0, nanoid_1.nanoid)(),
+                    message: `Restore workflow to version ${versionLabel}? This will overwrite the current draft.`,
+                    severity: 'warning',
+                });
+                return { success: false };
+            }
+            if (resumeData !== undefined && resumeData !== null && !resumeData.approved) {
+                return { success: false, denied: true, reason: 'User denied the action' };
+            }
+            try {
+                await context.workflowService.restoreVersion(input.workflowId, input.versionId);
+                return { success: true };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : 'Restore failed',
+                };
+            }
+        },
+    });
+}
+//# sourceMappingURL=restore-workflow-version.tool.js.map

package/dist/tools/workflows/restore-workflow-version.tool.js.map

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