@n8n/instance-ai 1.12.2 → 1.13.0

package/dist/tools/workflows/workflow-source-compiler.js

@@ -0,0 +1,217 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isWorkflowJsonSourceFile = isWorkflowJsonSourceFile;
+exports.compileWorkflowSource = compileWorkflowSource;
+const sandbox_1 = require("@n8n/agents/sandbox");
+const utils_1 = require("@n8n/utils");
+const workflow_sdk_1 = require("@n8n/workflow-sdk");
+const workflow_validation_warnings_1 = require("./workflow-validation-warnings");
+const sandbox_fs_1 = require("../../workspace/sandbox-fs");
+const workspace_paths_1 = require("../../workspace/workspace-paths");
+function isWorkflowJson(value) {
+    return ((0, utils_1.isRecord)(value) &&
+        typeof value.name === 'string' &&
+        Array.isArray(value.nodes) &&
+        (0, utils_1.isRecord)(value.connections));
+}
+function isTypeScriptWorkflowSource(filePath) {
+    const normalized = filePath.toLowerCase();
+    return normalized.endsWith('.ts') || normalized.endsWith('.tsx');
+}
+function isWorkflowJsonSourceFile(filePath) {
+    return filePath.toLowerCase().endsWith('.json');
+}
+function normalizeWorkflowNodeParameters(json) {
+    for (const node of json.nodes ?? []) {
+        if (!(0, utils_1.isRecord)(node.parameters)) {
+            node.parameters = {};
+        }
+    }
+}
+function validateCompiledWorkflow(json, context, compilerWarnings = []) {
+    normalizeWorkflowNodeParameters(json);
+    const schemaValidation = (0, workflow_sdk_1.validateWorkflow)(json, {
+        nodeTypesProvider: context.nodeTypesProvider,
+        strictMode: true,
+    });
+    const warnings = [...compilerWarnings];
+    (0, workflow_validation_warnings_1.collectValidationIssues)(schemaValidation.errors, warnings);
+    (0, workflow_validation_warnings_1.collectValidationIssues)(schemaValidation.warnings, warnings);
+    return warnings;
+}
+function parseWorkflowJsonSource(source) {
+    let parsed;
+    try {
+        parsed = JSON.parse(source);
+    }
+    catch (error) {
+        return {
+            success: false,
+            reason: 'workflow_json_parse_failed',
+            editable: true,
+            errors: [
+                `Failed to parse workflow JSON: ${error instanceof Error ? error.message : 'Invalid JSON'}`,
+            ],
+            summary: 'Workflow JSON source did not parse.',
+        };
+    }
+    if (!isWorkflowJson(parsed)) {
+        return {
+            success: false,
+            reason: 'workflow_json_invalid',
+            editable: true,
+            errors: ['Workflow JSON must include name, nodes, and connections.'],
+            summary: 'Workflow JSON source is missing required workflow fields.',
+        };
+    }
+    return { success: true, workflow: parsed, warnings: [], compiler: 'workflow-json' };
+}
+function parseSandboxWarnings(value) {
+    if (!Array.isArray(value))
+        return [];
+    const warnings = [];
+    for (const warning of value) {
+        if (!(0, utils_1.isRecord)(warning))
+            continue;
+        if (typeof warning.code !== 'string' || typeof warning.message !== 'string')
+            continue;
+        warnings.push({
+            code: warning.code,
+            message: warning.message,
+            nodeName: typeof warning.nodeName === 'string' ? warning.nodeName : undefined,
+        });
+    }
+    return warnings;
+}
+function parseSandboxErrors(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.filter((error) => typeof error === 'string');
+}
+function parseSandboxBuildOutput(stdout) {
+    const lastJsonLine = stdout
+        .trim()
+        .split('\n')
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .pop();
+    if (!lastJsonLine)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(lastJsonLine);
+    }
+    catch {
+        return undefined;
+    }
+    if (!(0, utils_1.isRecord)(parsed) || typeof parsed.success !== 'boolean')
+        return undefined;
+    return {
+        success: parsed.success,
+        workflow: isWorkflowJson(parsed.workflow) ? parsed.workflow : undefined,
+        warnings: parseSandboxWarnings(parsed.warnings),
+        errors: parseSandboxErrors(parsed.errors),
+    };
+}
+function enhanceBuildErrors(errors) {
+    const needsTemplateGuidance = errors.some((error) => {
+        const normalized = error.toLowerCase();
+        return (normalized.includes('unterminated template') ||
+            normalized.includes('unexpected end of input') ||
+            normalized.includes('unexpected identifier') ||
+            normalized.includes('unexpected token') ||
+            normalized.includes('expected unicode escape') ||
+            normalized.includes('missing ) after argument list'));
+    });
+    if (!needsTemplateGuidance)
+        return errors;
+    return [
+        ...errors,
+        'Code node guidance: for large HTML, write it to a separate file (e.g., chunks/page.html), then in your SDK TypeScript use readFileSync + JSON.stringify to safely embed it. NEVER embed large HTML directly in jsCode. See the web_app_pattern in your instructions.',
+    ];
+}
+async function compileTypeScriptWorkflowSource(context, filePath) {
+    if (!context.workspace) {
+        return {
+            success: false,
+            reason: 'workflow_source_sandbox_unavailable',
+            editable: false,
+            errors: [
+                'Runtime workspace with sandbox support is required for TypeScript workflow builds.',
+            ],
+            summary: 'Workflow source could not be built because the sandbox is unavailable.',
+        };
+    }
+    let root;
+    let buildResult;
+    try {
+        root = await (0, sandbox_1.getWorkspaceRoot)(context.workspace);
+        const sandboxFilePath = (0, workspace_paths_1.joinWorkspacePath)(root, filePath);
+        buildResult = await (0, sandbox_fs_1.runInSandbox)(context.workspace, `node --import tsx build.mjs '${(0, sandbox_fs_1.escapeSingleQuotes)(sandboxFilePath)}'`, root);
+    }
+    catch (error) {
+        return {
+            success: false,
+            reason: 'workflow_source_sandbox_unavailable',
+            editable: false,
+            errors: [error instanceof Error ? error.message : String(error)],
+            summary: 'Workflow source could not be built because the sandbox is unavailable.',
+        };
+    }
+    const buildOutput = parseSandboxBuildOutput(buildResult.stdout);
+    if (!buildOutput) {
+        const detail = buildResult.stderr.trim() || buildResult.stdout.trim() || 'No output';
+        return {
+            success: false,
+            reason: 'workflow_source_sandbox_failed',
+            editable: true,
+            errors: [
+                `Failed to execute workflow file in sandbox (exit code ${buildResult.exitCode}).`,
+                detail,
+            ],
+            summary: 'Workflow source did not produce parseable sandbox output.',
+        };
+    }
+    if (!buildOutput.success || !buildOutput.workflow) {
+        return {
+            success: false,
+            reason: 'workflow_source_build_failed',
+            editable: true,
+            errors: enhanceBuildErrors(buildOutput.errors ?? ['Unknown workflow build error']),
+            summary: 'Workflow source failed during sandbox execution.',
+        };
+    }
+    return {
+        success: true,
+        workflow: buildOutput.workflow,
+        warnings: buildOutput.warnings ?? [],
+        compiler: 'sandbox-tsx',
+    };
+}
+async function compileWorkflowSource(context, filePath, source) {
+    let result;
+    if (isWorkflowJsonSourceFile(filePath)) {
+        result = parseWorkflowJsonSource(source);
+    }
+    else if (isTypeScriptWorkflowSource(filePath)) {
+        result = await compileTypeScriptWorkflowSource(context, filePath);
+    }
+    else {
+        result = {
+            success: false,
+            reason: 'workflow_source_unsupported_extension',
+            editable: true,
+            errors: [
+                'Workflow source file must be a TypeScript SDK file (.ts or .tsx) or WorkflowJSON file (.json).',
+            ],
+            summary: 'Workflow source file extension is unsupported.',
+        };
+    }
+    if (!result.success)
+        return result;
+    return {
+        ...result,
+        warnings: validateCompiledWorkflow(result.workflow, context, result.warnings),
+    };
+}
+//# sourceMappingURL=workflow-source-compiler.js.map

package/dist/tools/workflows/workflow-source-compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-source-compiler.js","sourceRoot":"","sources":["../../../src/tools/workflows/workflow-source-compiler.ts"],"names":[],"mappings":";;AAuDA,4DAEC;AAqMD,sDA4BC;AA1RD,iDAAuD;AACvD,sCAAsC;AACtC,oDAAwE;AAExE,iFAAiG;AAEjG,2DAA8E;AAC9E,qEAAoE;AAkCpE,SAAS,cAAc,CAAC,KAAc;IACrC,OAAO,CACN,IAAA,gBAAQ,EAAC,KAAK,CAAC;QACf,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QAC1B,IAAA,gBAAQ,EAAC,KAAK,CAAC,WAAW,CAAC,CAC3B,CAAC;AACH,CAAC;AAED,SAAS,0BAA0B,CAAC,QAAgB;IACnD,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC1C,OAAO,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAClE,CAAC;AAED,SAAgB,wBAAwB,CAAC,QAAgB;IACxD,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,+BAA+B,CAAC,IAAkB;IAC1D,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACrC,IAAI,CAAC,IAAA,gBAAQ,EAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;QACtB,CAAC;IACF,CAAC;AACF,CAAC;AAED,SAAS,wBAAwB,CAChC,IAAkB,EAClB,OAA0B,EAC1B,mBAAwC,EAAE;IAE1C,+BAA+B,CAAC,IAAI,CAAC,CAAC;IAEtC,MAAM,gBAAgB,GAAG,IAAA,+BAAgB,EAAC,IAAI,EAAE;QAC/C,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,UAAU,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,CAAC,GAAG,gBAAgB,CAAC,CAAC;IACvC,IAAA,sDAAuB,EAAC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3D,IAAA,sDAAuB,EAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC7D,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAc;IAC9C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO;YACN,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,4BAA4B;YACpC,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE;gBACP,kCAAkC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,EAAE;aAC3F;YACD,OAAO,EAAE,qCAAqC;SAC9C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO;YACN,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,uBAAuB;YAC/B,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,CAAC,0DAA0D,CAAC;YACpE,OAAO,EAAE,2DAA2D;SACpE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;AACrF,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,MAAM,QAAQ,GAAwB,EAAE,CAAC;IACzC,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAA,gBAAQ,EAAC,OAAO,CAAC;YAAE,SAAS;QACjC,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;YAAE,SAAS;QAEtF,QAAQ,CAAC,IAAI,CAAC;YACb,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;SAC7E,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAc;IAC9C,MAAM,YAAY,GAAG,MAAM;SACzB,IAAI,EAAE;SACN,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,EAAE,CAAC;IAER,IAAI,CAAC,YAAY;QAAE,OAAO,SAAS,CAAC;IAEpC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACJ,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,IAAA,gBAAQ,EAAC,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE/E,OAAO;QACN,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;QACvE,QAAQ,EAAE,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC/C,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC;KACzC,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAgB;IAC3C,MAAM,qBAAqB,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QACnD,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QACvC,OAAO,CACN,UAAU,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAC5C,UAAU,CAAC,QAAQ,CAAC,yBAAyB,CAAC;YAC9C,UAAU,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAC5C,UAAU,CAAC,QAAQ,CAAC,kBAAkB,CAAC;YACvC,UAAU,CAAC,QAAQ,CAAC,yBAAyB,CAAC;YAC9C,UAAU,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CACpD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,qBAAqB;QAAE,OAAO,MAAM,CAAC;IAE1C,OAAO;QACN,GAAG,MAAM;QACT,sQAAsQ;KACtQ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,+BAA+B,CAC7C,OAA0B,EAC1B,QAAgB;IAEhB,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACxB,OAAO;YACN,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,qCAAqC;YAC7C,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE;gBACP,oFAAoF;aACpF;YACD,OAAO,EAAE,wEAAwE;SACjF,CAAC;IACH,CAAC;IAED,IAAI,IAAY,CAAC;IACjB,IAAI,WAAqD,CAAC;IAC1D,IAAI,CAAC;QACJ,IAAI,GAAG,MAAM,IAAA,0BAAgB,EAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACjD,MAAM,eAAe,GAAG,IAAA,mCAAiB,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC1D,WAAW,GAAG,MAAM,IAAA,yBAAY,EAC/B,OAAO,CAAC,SAAS,EACjB,gCAAgC,IAAA,+BAAkB,EAAC,eAAe,CAAC,GAAG,EACtE,IAAI,CACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO;YACN,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,qCAAqC;YAC7C,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAChE,OAAO,EAAE,wEAAwE;SACjF,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,uBAAuB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAChE,IAAI,CAAC,WAAW,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,WAAW,CAAC;QACrF,OAAO;YACN,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,gCAAgC;YACxC,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE;gBACP,yDAAyD,WAAW,CAAC,QAAQ,IAAI;gBACjF,MAAM;aACN;YACD,OAAO,EAAE,2DAA2D;SACpE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,WAAW,CAAC,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;QACnD,OAAO;YACN,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,8BAA8B;YACtC,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,kBAAkB,CAAC,WAAW,CAAC,MAAM,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAClF,OAAO,EAAE,kDAAkD;SAC3D,CAAC;IACH,CAAC;IAED,OAAO;QACN,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,QAAQ,EAAE,WAAW,CAAC,QAAQ,IAAI,EAAE;QACpC,QAAQ,EAAE,aAAa;KACvB,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,qBAAqB,CAC1C,OAA0B,EAC1B,QAAgB,EAChB,MAAc;IAEd,IAAI,MAAmC,CAAC;IACxC,IAAI,wBAAwB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,MAAM,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;SAAM,IAAI,0BAA0B,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjD,MAAM,GAAG,MAAM,+BAA+B,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnE,CAAC;SAAM,CAAC;QACP,MAAM,GAAG;YACR,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,uCAAuC;YAC/C,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE;gBACP,gGAAgG;aAChG;YACD,OAAO,EAAE,gDAAgD;SACzD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC;IAEnC,OAAO;QACN,GAAG,MAAM;QACT,QAAQ,EAAE,wBAAwB,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC;KAC7E,CAAC;AACH,CAAC"}

package/dist/tools/workflows/workflow-validation-warnings.d.ts

@@ -0,0 +1,14 @@
+export interface ValidationWarning {
+    code: string;
+    message: string;
+    nodeName?: string;
+}
+export declare function collectValidationIssues(issues: Array<{
+    code: string;
+    message: string;
+    nodeName?: string;
+}>, allWarnings: ValidationWarning[]): void;
+export declare function partitionWarnings(warnings: ValidationWarning[]): {
+    errors: ValidationWarning[];
+    informational: ValidationWarning[];
+};

package/dist/tools/workflows/workflow-validation-warnings.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectValidationIssues = collectValidationIssues;
+exports.partitionWarnings = partitionWarnings;
+function collectValidationIssues(issues, allWarnings) {
+    for (const issue of issues) {
+        allWarnings.push({
+            code: issue.code,
+            message: issue.message,
+            nodeName: issue.nodeName,
+        });
+    }
+}
+function partitionWarnings(warnings) {
+    const informationalCodes = new Set(['MISSING_TRIGGER', 'DISCONNECTED_NODE']);
+    const errors = [];
+    const informational = [];
+    for (const warning of warnings) {
+        if (informationalCodes.has(warning.code)) {
+            informational.push(warning);
+        }
+        else {
+            errors.push(warning);
+        }
+    }
+    return { errors, informational };
+}
+//# sourceMappingURL=workflow-validation-warnings.js.map

package/dist/tools/workflows/workflow-validation-warnings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-validation-warnings.js","sourceRoot":"","sources":["../../../src/tools/workflows/workflow-validation-warnings.ts"],"names":[],"mappings":";;AAMA,0DAWC;AAED,8CAkBC;AA/BD,SAAgB,uBAAuB,CACtC,MAAmE,EACnE,WAAgC;IAEhC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,WAAW,CAAC,IAAI,CAAC;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACxB,CAAC,CAAC;IACJ,CAAC;AACF,CAAC;AAED,SAAgB,iBAAiB,CAAC,QAA6B;IAI9D,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAE7E,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,MAAM,aAAa,GAAwB,EAAE,CAAC;IAE9C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;IACF,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AAClC,CAAC"}

package/dist/tools/workflows.tool.js

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createWorkflowsTool = createWorkflowsTool;
 const agents_1 = require("@n8n/agents");
+const utils_1 = require("@n8n/utils");
 const nanoid_1 = require("nanoid");
 const zod_1 = require("zod");
 const sanitize_mcp_schemas_1 = require("../agent/sanitize-mcp-schemas");
@@ -44,7 +45,9 @@ const setup_workflow_service_1 = require("./workflows/setup-workflow.service");
 const validate_workflow_service_1 = require("./workflows/validate-workflow.service");
 const workflow_json_utils_1 = require("./workflows/workflow-json-utils");
 const listAction = zod_1.z.object({
-    action: zod_1.z.literal('list').describe('List workflows accessible to the current user'),
+    action: zod_1.z
+        .literal('list')
+        .describe('List workflows accessible to the current user. Use for workflow inspection.'),
     query: zod_1.z.string().optional().describe('Filter workflows by name'),
     limit: zod_1.z.number().int().positive().max(100).optional().describe('Max results to return'),
     status: zod_1.z
@@ -57,17 +60,21 @@ const listAction = zod_1.z.object({
         .describe("Which project(s) to search. Defaults to this conversation's project. Use 'instance' only when you have a clear reason to look across all projects you can access."),
 });
 const getAction = zod_1.z.object({
-    action: zod_1.z.literal('get').describe('Get full details of a specific workflow'),
+    action: zod_1.z
+        .literal('get')
+        .describe('Get full details of a specific workflow. Use for workflow inspection.'),
     workflowId: zod_1.z.string().describe('ID of the workflow'),
 });
 const getJsonAction = zod_1.z.object({
     action: zod_1.z
         .literal('get-json')
-        .describe('Get full WorkflowJSON for safe read-modify-update workflow edits'),
+        .describe('Get full WorkflowJSON for workspace-file workflow edits. Write it to a .workflow.json file, edit the file, then save with build-workflow.'),
     workflowId: zod_1.z.string().describe('ID of the workflow'),
 });
 const getAsCodeAction = zod_1.z.object({
-    action: zod_1.z.literal('get-as-code').describe('Convert an existing workflow to TypeScript SDK code'),
+    action: zod_1.z
+        .literal('get-as-code')
+        .describe('Convert an existing workflow to TypeScript SDK code. Call before precise patches when you need the current code.'),
     workflowId: zod_1.z.string().describe('ID of the workflow'),
 });
 const deleteAction = zod_1.z.object({
@@ -85,7 +92,7 @@ const unarchiveAction = zod_1.z.object({
 const setupAction = zod_1.z.object({
     action: zod_1.z
         .literal('setup')
-        .describe('Open the inline AI Assistant workflow setup card for credential and parameter configuration'),
+        .describe('Open the inline AI Assistant workflow setup card for credential and parameter configuration. Use for setup routing after a build.'),
     workflowId: zod_1.z.string().describe('ID of the workflow'),
     projectId: zod_1.z.string().optional().describe('Project ID to scope credential creation to'),
 });
@@ -102,7 +109,7 @@ const validateAction = zod_1.z.object({
 const updateAction = zod_1.z.object({
     action: zod_1.z
         .literal('update')
-        .describe('Save a complete modified WorkflowJSON back to the workflow. Use after reading via `get-json` and modifying the JSON. Replaces the full workflow definition.'),
+        .describe('Internal/raw update escape hatch. Save a complete modified WorkflowJSON back to the workflow. Replaces the full workflow definition.'),
     workflowId: zod_1.z.string().describe('ID of the workflow'),
     workflow: zod_1.z
         .record(zod_1.z.unknown())
@@ -198,14 +205,13 @@ function getSupportedWorkflowActionSchemas(context, surface = 'full') {
     return {
         list: listAction,
         get: getAction,
-        ...(surface !== 'orchestrator'
-            ? { 'get-json': getJsonAction, 'get-as-code': getAsCodeAction }
-            : {}),
+        'get-json': getJsonAction,
+        'get-as-code': getAsCodeAction,
         delete: deleteAction,
         unarchive: unarchiveAction,
         setup: setupAction,
         validate: validateAction,
-        update: updateAction,
+        ...(surface !== 'orchestrator' ? { update: updateAction } : {}),
         publish: hasNamedVersions ? publishExtendedAction : publishBaseAction,
         unpublish: unpublishAction,
         ...(hasVersions
@@ -341,86 +347,66 @@ async function handleUnarchive(context, input, ctx) {
     await context.workflowService.unarchive(input.workflowId);
     return { success: true };
 }
-async function handleSetup(context, input, ctx, state) {
-    if (context.permissions?.updateWorkflow === 'blocked') {
-        return { success: false, denied: true, reason: 'Action blocked by admin' };
-    }
-    const resumeData = ctx.resumeData;
-    if (resumeData === undefined || resumeData === null) {
-        const setupRequests = await (0, setup_workflow_service_1.analyzeWorkflow)(context, input.workflowId);
-        if (setupRequests.length === 0) {
-            return { success: true, reason: 'No nodes require setup.' };
-        }
-        state.currentRequestId = (0, nanoid_1.nanoid)();
-        return await ctx.suspend({
-            requestId: state.currentRequestId,
-            message: 'Configure credentials for your workflow',
-            severity: 'info',
-            setupRequests,
-            workflowId: input.workflowId,
-            ...(input.projectId ? { projectId: input.projectId } : {}),
+async function runTriggerTest(context, workflowId, triggerNodeName) {
+    try {
+        const result = await context.executionService.run(workflowId, undefined, {
+            timeout: 30_000,
+            triggerNodeName,
         });
+        if (result.status === 'success')
+            return { status: 'success' };
+        if (result.status === 'waiting')
+            return { status: 'listening' };
+        return { status: 'error', error: result.error ?? 'Trigger test failed' };
     }
-    if (!resumeData.approved) {
-        if (state.preTestSnapshot) {
-            await context.workflowService.updateFromWorkflowJSON(input.workflowId, state.preTestSnapshot);
-            state.preTestSnapshot = null;
-        }
+    catch (error) {
         return {
-            success: true,
-            deferred: true,
-            reason: 'User skipped workflow setup for now.',
+            status: 'error',
+            error: error instanceof Error ? error.message : 'Trigger test failed',
         };
     }
-    if (resumeData.action === 'test-trigger' && resumeData.testTriggerNode) {
-        state.preTestSnapshot ??= await context.workflowService.getAsWorkflowJSON(input.workflowId);
-        const preTestApply = await (0, setup_workflow_service_1.applyNodeChanges)(context, input.workflowId, resumeData.credentials, resumeData.nodeParameters);
-        const applyFailures = preTestApply.failed;
-        if (applyFailures.length > 0) {
-            return {
-                success: false,
-                error: `Failed to apply setup before trigger test: ${applyFailures.map((f) => `${f.nodeName}: ${f.error}`).join('; ')}`,
-                failedNodes: applyFailures,
-            };
-        }
-        let triggerTestResult;
-        try {
-            const result = await context.executionService.run(input.workflowId, undefined, {
-                timeout: 30_000,
-                triggerNodeName: resumeData.testTriggerNode,
+}
+function collectCredentialTestFailures(remainingRequests, credentials) {
+    const failures = [];
+    for (const req of remainingRequests) {
+        if (req.credentialTestResult &&
+            !req.credentialTestResult.success &&
+            req.credentialType &&
+            credentials?.[req.node.name]?.[req.credentialType]) {
+            failures.push({
+                nodeName: req.node.name,
+                error: `Credential test failed for ${req.credentialType}: ${req.credentialTestResult.message ?? 'Invalid credentials'}`,
             });
-            if (result.status === 'success') {
-                triggerTestResult = { status: 'success' };
-            }
-            else if (result.status === 'waiting') {
-                triggerTestResult = { status: 'listening' };
-            }
-            else {
-                triggerTestResult = {
-                    status: 'error',
-                    error: result.error ?? 'Trigger test failed',
-                };
-            }
-        }
-        catch (error) {
-            triggerTestResult = {
-                status: 'error',
-                error: error instanceof Error ? error.message : 'Trigger test failed',
-            };
         }
-        const refreshedRequests = await (0, setup_workflow_service_1.analyzeWorkflow)(context, input.workflowId, {
-            [resumeData.testTriggerNode]: triggerTestResult,
-        });
-        state.currentRequestId = (0, nanoid_1.nanoid)();
-        return await ctx.suspend({
-            requestId: state.currentRequestId,
-            message: 'Configure credentials for your workflow',
-            severity: 'info',
-            setupRequests: refreshedRequests,
-            workflowId: input.workflowId,
-            ...(input.projectId ? { projectId: input.projectId } : {}),
-        });
     }
+    return failures;
+}
+async function handleSetupTestTrigger(context, input, ctx, state, resumeData, testTriggerNode) {
+    state.preTestSnapshot ??= await context.workflowService.getAsWorkflowJSON(input.workflowId);
+    const preTestApply = await (0, setup_workflow_service_1.applyNodeChanges)(context, input.workflowId, resumeData.credentials, resumeData.nodeParameters);
+    const applyFailures = preTestApply.failed;
+    if (applyFailures.length > 0) {
+        return {
+            success: false,
+            error: `Failed to apply setup before trigger test: ${applyFailures.map((f) => `${f.nodeName}: ${f.error}`).join('; ')}`,
+            failedNodes: applyFailures,
+        };
+    }
+    const triggerTestResult = await runTriggerTest(context, input.workflowId, testTriggerNode);
+    const refreshedRequests = await (0, setup_workflow_service_1.analyzeWorkflow)(context, input.workflowId, {
+        [testTriggerNode]: triggerTestResult,
+    });
+    state.currentRequestId = (0, nanoid_1.nanoid)();
+    return await ctx.suspend({
+        requestId: state.currentRequestId,
+        message: 'Configure credentials for your workflow',
+        severity: 'info',
+        setupRequests: refreshedRequests,
+        workflowId: input.workflowId,
+        ...(input.projectId ? { projectId: input.projectId } : {}),
+    });
+}
+async function handleSetupApply(context, input, state, resumeData) {
     try {
         state.preTestSnapshot = null;
         const applyResult = await (0, setup_workflow_service_1.applyNodeChanges)(context, input.workflowId, resumeData.credentials, resumeData.nodeParameters);
@@ -440,18 +426,7 @@ async function handleSetup(context, input, ctx, state) {
         const remainingRequests = await (0, setup_workflow_service_1.analyzeWorkflow)(context, input.workflowId);
         const pendingRequests = remainingRequests.filter((r) => r.needsAction);
         const completedNodes = (0, setup_workflow_service_1.buildCompletedReport)(resumeData.credentials, resumeData.nodeParameters);
-        const credTestFailures = [];
-        for (const req of remainingRequests) {
-            if (req.credentialTestResult &&
-                !req.credentialTestResult.success &&
-                req.credentialType &&
-                resumeData.credentials?.[req.node.name]?.[req.credentialType]) {
-                credTestFailures.push({
-                    nodeName: req.node.name,
-                    error: `Credential test failed for ${req.credentialType}: ${req.credentialTestResult.message ?? 'Invalid credentials'}`,
-                });
-            }
-        }
+        const credTestFailures = collectCredentialTestFailures(remainingRequests, resumeData.credentials);
         const credFailedNodeNames = new Set(credTestFailures.map((f) => f.nodeName));
         const validCompletedNodes = completedNodes.filter((n) => !credFailedNodeNames.has(n.nodeName));
         const allFailedNodes = [...(failedNodes ?? []), ...credTestFailures];
@@ -487,6 +462,42 @@ async function handleSetup(context, input, ctx, state) {
         };
     }
 }
+async function handleSetup(context, input, ctx, state) {
+    if (context.permissions?.updateWorkflow === 'blocked') {
+        return { success: false, denied: true, reason: 'Action blocked by admin' };
+    }
+    const resumeData = ctx.resumeData;
+    if (resumeData === undefined || resumeData === null) {
+        const setupRequests = await (0, setup_workflow_service_1.analyzeWorkflow)(context, input.workflowId);
+        if (setupRequests.length === 0) {
+            return { success: true, reason: 'No nodes require setup.' };
+        }
+        state.currentRequestId = (0, nanoid_1.nanoid)();
+        return await ctx.suspend({
+            requestId: state.currentRequestId,
+            message: 'Configure credentials for your workflow',
+            severity: 'info',
+            setupRequests,
+            workflowId: input.workflowId,
+            ...(input.projectId ? { projectId: input.projectId } : {}),
+        });
+    }
+    if (!resumeData.approved) {
+        if (state.preTestSnapshot) {
+            await context.workflowService.updateFromWorkflowJSON(input.workflowId, state.preTestSnapshot);
+            state.preTestSnapshot = null;
+        }
+        return {
+            success: true,
+            deferred: true,
+            reason: 'User skipped workflow setup for now.',
+        };
+    }
+    if (resumeData.action === 'test-trigger' && resumeData.testTriggerNode) {
+        return await handleSetupTestTrigger(context, input, ctx, state, resumeData, resumeData.testTriggerNode);
+    }
+    return await handleSetupApply(context, input, state, resumeData);
+}
 async function handleValidate(context, input) {
     try {
         return await (0, validate_workflow_service_1.validateWorkflowConfig)(context, {
@@ -504,14 +515,11 @@ async function handleValidate(context, input) {
         };
     }
 }
-function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
 function isWorkflowJson(value) {
-    return (isRecord(value) &&
+    return ((0, utils_1.isRecord)(value) &&
         typeof value.name === 'string' &&
         Array.isArray(value.nodes) &&
-        isRecord(value.connections));
+        (0, utils_1.isRecord)(value.connections));
 }
 async function handleUpdate(context, input, ctx) {
     const resumeData = ctx.resumeData;