@n8n/instance-ai 1.12.2 → 1.13.0

package/dist/tools/workflows/workflow-build-reporting.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reportWorkflowBuildOutcome = reportWorkflowBuildOutcome;
+exports.promoteMainWorkflow = promoteMainWorkflow;
+exports.reportFailedWorkflowBuildOutcome = reportFailedWorkflowBuildOutcome;
+const workflow_build_routing_1 = require("./workflow-build-routing");
+async function reportWorkflowBuildOutcome(context, outcome, options = {}) {
+    const buildContext = context.workflowBuildContext;
+    if (!buildContext)
+        return;
+    if (options.storeOnRunContext !== false) {
+        try {
+            await buildContext.onBuildOutcome?.(outcome);
+        }
+        catch (error) {
+            context.logger.warn('Failed to store workflow build outcome on run context', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    try {
+        await buildContext.workflowTaskService?.reportBuildOutcome(outcome);
+    }
+    catch (error) {
+        context.logger.warn('Failed to report workflow build outcome to workflow loop', {
+            workItemId: outcome.workItemId,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+    if (options.markPlannedTaskSucceeded === false)
+        return;
+    try {
+        await buildContext.plannedTaskService?.markSucceeded(buildContext.threadId, buildContext.taskId, {
+            result: outcome.summary,
+            outcome,
+        });
+    }
+    catch (error) {
+        context.logger.warn('Failed to mark planned workflow build task succeeded', {
+            taskId: buildContext.taskId,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+}
+async function promoteMainWorkflow(context, workflowId) {
+    try {
+        await context.workflowService.clearAiTemporary(workflowId);
+    }
+    catch (error) {
+        context.logger.warn(`Failed to clear AI-builder temporary marker on main workflow ${workflowId}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+async function reportFailedWorkflowBuildOutcome(context, input) {
+    const buildContext = context.workflowBuildContext;
+    const outcome = (0, workflow_build_routing_1.withDeterministicRouting)({
+        workItemId: input.workItemId,
+        ...((buildContext?.runId ?? context.runId)
+            ? { runId: buildContext?.runId ?? context.runId }
+            : {}),
+        taskId: input.taskId,
+        owner: input.owner,
+        plannedTaskId: input.plannedTaskId,
+        workflowId: input.targetWorkflowId,
+        ...(input.sourceFilePath ? { sourceFilePath: input.sourceFilePath } : {}),
+        submitted: false,
+        triggerType: 'manual_or_testable',
+        needsUserInput: false,
+        blockingReason: input.remediation.guidance,
+        failureSignature: input.errors.join('\n').slice(0, 500),
+        remediation: input.remediation,
+        summary: input.summary,
+    });
+    await reportWorkflowBuildOutcome(context, outcome, {
+        storeOnRunContext: input.storeOnRunContext,
+        markPlannedTaskSucceeded: false,
+    });
+}
+//# sourceMappingURL=workflow-build-reporting.js.map

package/dist/tools/workflows/workflow-build-reporting.js.map

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

package/dist/tools/workflows/workflow-build-routing.d.ts

@@ -0,0 +1,2 @@
+import type { WorkflowBuildOutcome } from '../../workflow-loop/workflow-loop-state';
+export declare function withDeterministicRouting(outcome: Omit<WorkflowBuildOutcome, 'verificationReadiness' | 'setupRequirement'>): WorkflowBuildOutcome;

package/dist/tools/workflows/workflow-build-routing.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withDeterministicRouting = withDeterministicRouting;
+const workflow_json_utils_1 = require("./workflow-json-utils");
+function hasMockedCredentials(outcome) {
+    return ((outcome.mockedCredentialTypes?.length ?? 0) > 0 ||
+        Object.keys(outcome.mockedCredentialsByNode ?? {}).length > 0);
+}
+function hasCredentialVerificationData(outcome) {
+    const mocked = outcome.mockedNodeNames ?? [];
+    if (mocked.length === 0)
+        return false;
+    const simulated = new Set((outcome.nodeSimulationPlan ?? [])
+        .filter((verdict) => verdict.verdict === 'simulate')
+        .map((verdict) => verdict.nodeName));
+    return mocked.every((name) => simulated.has(name));
+}
+function determineVerificationReadiness(outcome) {
+    if (!outcome.submitted) {
+        return {
+            status: 'not_verifiable',
+            reason: 'not-submitted',
+            guidance: 'The build did not submit a workflow, so there is nothing to verify.',
+        };
+    }
+    if (!outcome.workflowId) {
+        return {
+            status: 'not_verifiable',
+            reason: 'missing-workflow-id',
+            guidance: 'The build outcome does not include a workflow ID.',
+        };
+    }
+    if (outcome.hasUnresolvedPlaceholders) {
+        return {
+            status: 'needs_setup',
+            reason: 'unresolved-placeholders',
+            guidance: 'Route the workflow through setup before verification.',
+        };
+    }
+    if (hasMockedCredentials(outcome) && !hasCredentialVerificationData(outcome)) {
+        return {
+            status: 'needs_setup',
+            reason: 'missing-mocked-credential-pin-data',
+            guidance: 'Route the workflow through setup because mocked credentials cannot be verified.',
+        };
+    }
+    if (!outcome.triggerNodes?.some((node) => (0, workflow_json_utils_1.isMockableTriggerNodeType)(node.nodeType))) {
+        return {
+            status: 'not_verifiable',
+            reason: 'non-mockable-trigger',
+            guidance: 'The workflow does not have a trigger the post-build verifier can exercise.',
+        };
+    }
+    return { status: 'ready' };
+}
+function determineSetupRequirement(outcome) {
+    if (!outcome.submitted || !outcome.workflowId) {
+        return { status: 'not_required' };
+    }
+    if (outcome.hasUnresolvedPlaceholders) {
+        return {
+            status: 'required',
+            reason: 'unresolved-placeholders',
+            guidance: 'Route the workflow through setup so the user can fill unresolved values.',
+        };
+    }
+    if (hasMockedCredentials(outcome)) {
+        return {
+            status: 'required',
+            reason: 'mocked-credentials',
+            guidance: 'Route the workflow through setup so the user can add real credentials.',
+        };
+    }
+    return { status: 'not_required' };
+}
+function withDeterministicRouting(outcome) {
+    return {
+        ...outcome,
+        verificationReadiness: determineVerificationReadiness(outcome),
+        setupRequirement: determineSetupRequirement(outcome),
+    };
+}
+//# sourceMappingURL=workflow-build-routing.js.map

package/dist/tools/workflows/workflow-build-routing.js.map

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

package/dist/tools/workflows/workflow-build-telemetry.d.ts

@@ -0,0 +1,18 @@
+import type { WorkflowSourceFileBinding } from './workflow-file-bindings';
+import type { InstanceAiContext } from '../../types';
+import type { RemediationMetadata } from '../../workflow-loop/workflow-loop-state';
+export type BuildTelemetryResult = 'success' | 'failure' | 'blocked' | 'denied' | 'suspended';
+export type BuildTelemetryStage = 'source_read' | 'permission' | 'hitl' | 'parse' | 'validation' | 'name' | 'save';
+export declare function trackWorkflowSourceBuild(context: InstanceAiContext, input: {
+    result: BuildTelemetryResult;
+    stage: BuildTelemetryStage;
+    binding: WorkflowSourceFileBinding;
+    targetWorkflowId?: string;
+    savedWorkflowId?: string;
+    saveOperation?: 'create' | 'update';
+    isSupportingWorkflow?: boolean;
+    isAuxiliarySupportingWorkflow?: boolean;
+    remediation?: RemediationMetadata;
+    errorCount?: number;
+    warningCount?: number;
+}): void;

package/dist/tools/workflows/workflow-build-telemetry.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackWorkflowSourceBuild = trackWorkflowSourceBuild;
+function trackWorkflowSourceBuild(context, input) {
+    const buildContext = context.workflowBuildContext;
+    context.trackTelemetry?.('instance_ai_workflow_source_build', {
+        source_transport: 'workspace_file',
+        result: input.result,
+        stage: input.stage,
+        thread_id: context.threadId ?? buildContext?.threadId ?? 'unknown',
+        run_id: buildContext?.runId ?? context.runId ?? 'unknown',
+        work_item_id: buildContext?.workItemId ?? 'unknown',
+        task_id: buildContext?.taskId ?? 'unknown',
+        file_path: input.binding.filePath,
+        identity_bound: Boolean(input.binding.workflowId),
+        is_supporting_workflow: input.isSupportingWorkflow === true,
+        is_auxiliary_supporting_workflow: input.isAuxiliarySupportingWorkflow === true,
+        error_count: input.errorCount ?? 0,
+        warning_count: input.warningCount ?? 0,
+        ...(input.targetWorkflowId ? { target_workflow_id: input.targetWorkflowId } : {}),
+        ...(input.savedWorkflowId ? { workflow_id: input.savedWorkflowId } : {}),
+        ...(input.binding.sourceHash ? { source_hash: input.binding.sourceHash } : {}),
+        ...(input.saveOperation ? { save_operation: input.saveOperation } : {}),
+        ...(input.remediation
+            ? {
+                remediation_category: input.remediation.category,
+                remediation_should_edit: input.remediation.shouldEdit,
+                ...(input.remediation.reason ? { remediation_reason: input.remediation.reason } : {}),
+            }
+            : {}),
+    });
+}
+//# sourceMappingURL=workflow-build-telemetry.js.map

package/dist/tools/workflows/workflow-build-telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-build-telemetry.js","sourceRoot":"","sources":["../../../src/tools/workflows/workflow-build-telemetry.ts"],"names":[],"mappings":";;AAcA,4DA2CC;AA3CD,SAAgB,wBAAwB,CACvC,OAA0B,EAC1B,KAYC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAClD,OAAO,CAAC,cAAc,EAAE,CAAC,mCAAmC,EAAE;QAC7D,gBAAgB,EAAE,gBAAgB;QAClC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,SAAS,EAAE,OAAO,CAAC,QAAQ,IAAI,YAAY,EAAE,QAAQ,IAAI,SAAS;QAClE,MAAM,EAAE,YAAY,EAAE,KAAK,IAAI,OAAO,CAAC,KAAK,IAAI,SAAS;QACzD,YAAY,EAAE,YAAY,EAAE,UAAU,IAAI,SAAS;QACnD,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,SAAS;QAC1C,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ;QACjC,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QACjD,sBAAsB,EAAE,KAAK,CAAC,oBAAoB,KAAK,IAAI;QAC3D,gCAAgC,EAAE,KAAK,CAAC,6BAA6B,KAAK,IAAI;QAC9E,WAAW,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC;QAClC,aAAa,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC;QACtC,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,KAAK,CAAC,WAAW;YACpB,CAAC,CAAC;gBACA,oBAAoB,EAAE,KAAK,CAAC,WAAW,CAAC,QAAQ;gBAChD,uBAAuB,EAAE,KAAK,CAAC,WAAW,CAAC,UAAU;gBACrD,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,KAAK,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrF;YACF,CAAC,CAAC,EAAE,CAAC;KACN,CAAC,CAAC;AACJ,CAAC"}

package/dist/tools/workflows/workflow-file-bindings.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import type { InstanceAiContext } from '../../types';
+declare const workflowSourceFileBindingSchema: z.ZodObject<{
+    filePath: z.ZodString;
+    workflowId: z.ZodOptional<z.ZodString>;
+    workflowVersionId: z.ZodOptional<z.ZodString>;
+    sourceHash: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    filePath: string;
+    workflowId?: string | undefined;
+    workflowVersionId?: string | undefined;
+    sourceHash?: string | undefined;
+}, {
+    filePath: string;
+    workflowId?: string | undefined;
+    workflowVersionId?: string | undefined;
+    sourceHash?: string | undefined;
+}>;
+export type WorkflowSourceFileBinding = z.infer<typeof workflowSourceFileBindingSchema>;
+export declare function hashWorkflowSource(source: string): string;
+export declare function normalizeWorkflowSourceFilePath(filePath: string): string;
+export declare function getWorkflowSourceFileBinding(context: InstanceAiContext, filePath: string): Promise<WorkflowSourceFileBinding | undefined>;
+export declare function saveWorkflowSourceFileBinding(context: InstanceAiContext, binding: WorkflowSourceFileBinding): Promise<WorkflowSourceFileBinding>;
+export declare function readWorkflowSourceFile(context: InstanceAiContext, filePath: string): Promise<{
+    source: string;
+    sourceHash: string;
+}>;
+export {};

package/dist/tools/workflows/workflow-file-bindings.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hashWorkflowSource = hashWorkflowSource;
+exports.normalizeWorkflowSourceFilePath = normalizeWorkflowSourceFilePath;
+exports.getWorkflowSourceFileBinding = getWorkflowSourceFileBinding;
+exports.saveWorkflowSourceFileBinding = saveWorkflowSourceFileBinding;
+exports.readWorkflowSourceFile = readWorkflowSourceFile;
+const node_crypto_1 = require("node:crypto");
+const zod_1 = require("zod");
+const thread_patch_1 = require("../../storage/thread-patch");
+const workspace_files_1 = require("../../workspace/workspace-files");
+const workspace_paths_1 = require("../../workspace/workspace-paths");
+const METADATA_KEY = 'instanceAiWorkflowSourceFiles';
+const workflowSourceFileBindingSchema = zod_1.z.object({
+    filePath: zod_1.z.string(),
+    workflowId: zod_1.z.string().optional(),
+    workflowVersionId: zod_1.z.string().optional(),
+    sourceHash: zod_1.z.string().optional(),
+});
+const workflowSourceFileBindingsSchema = zod_1.z.record(zod_1.z.string(), workflowSourceFileBindingSchema);
+const fallbackBindings = new WeakMap();
+function hashWorkflowSource(source) {
+    return (0, node_crypto_1.createHash)('sha256').update(source).digest('hex');
+}
+function normalizeWorkflowSourceFilePath(filePath) {
+    return (0, workspace_paths_1.normalizeWorkspaceRelativePath)(filePath, { resourceLabel: 'Workflow source file' });
+}
+function parseBindings(raw) {
+    const parsed = workflowSourceFileBindingsSchema.safeParse(raw);
+    return parsed.success ? parsed.data : {};
+}
+function getFallbackBindings(context) {
+    let bindings = fallbackBindings.get(context);
+    if (!bindings) {
+        bindings = new Map();
+        fallbackBindings.set(context, bindings);
+    }
+    return bindings;
+}
+async function readThreadBindings(context) {
+    if (!context.threadMemory || !context.threadId)
+        return undefined;
+    try {
+        const thread = await (0, thread_patch_1.getThread)(context.threadMemory, context.threadId);
+        return parseBindings(thread?.metadata?.[METADATA_KEY]);
+    }
+    catch (error) {
+        context.logger?.debug('Failed to read workflow source file bindings from thread metadata', {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return undefined;
+    }
+}
+async function getWorkflowSourceFileBinding(context, filePath) {
+    const normalizedFilePath = normalizeWorkflowSourceFilePath(filePath);
+    const threadBindings = await readThreadBindings(context);
+    if (threadBindings) {
+        return (threadBindings[normalizedFilePath] ?? getFallbackBindings(context).get(normalizedFilePath));
+    }
+    return getFallbackBindings(context).get(normalizedFilePath);
+}
+async function saveWorkflowSourceFileBinding(context, binding) {
+    const normalizedBinding = {
+        ...binding,
+        filePath: normalizeWorkflowSourceFilePath(binding.filePath),
+    };
+    if (context.threadMemory && context.threadId) {
+        try {
+            const updatedThread = await (0, thread_patch_1.patchThread)(context.threadMemory, {
+                threadId: context.threadId,
+                update: ({ metadata = {} }) => {
+                    const bindings = parseBindings(metadata[METADATA_KEY]);
+                    bindings[normalizedBinding.filePath] = normalizedBinding;
+                    return { metadata: { ...metadata, [METADATA_KEY]: bindings } };
+                },
+            });
+            if (updatedThread)
+                return normalizedBinding;
+        }
+        catch (error) {
+            context.logger?.warn('Failed to persist workflow source file binding to thread metadata', {
+                filePath: normalizedBinding.filePath,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    getFallbackBindings(context).set(normalizedBinding.filePath, normalizedBinding);
+    return normalizedBinding;
+}
+async function readWorkflowSourceFile(context, filePath) {
+    if (!context.workspace) {
+        throw new Error('Runtime workspace is required for workflow source files.');
+    }
+    const normalizedFilePath = normalizeWorkflowSourceFilePath(filePath);
+    const source = await (0, workspace_files_1.readWorkspaceFile)(context.workspace, normalizedFilePath, {
+        logger: context.logger,
+        resourceLabel: 'Workflow source file',
+    });
+    if (source === null) {
+        throw new Error(`Workflow source file not found: ${normalizedFilePath}`);
+    }
+    return { source, sourceHash: hashWorkflowSource(source) };
+}
+//# sourceMappingURL=workflow-file-bindings.js.map

package/dist/tools/workflows/workflow-file-bindings.js.map

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

package/dist/tools/workflows/workflow-json-utils.d.ts

@@ -1,4 +1,7 @@
 import type { WorkflowJSON } from '@n8n/workflow-sdk';
+import type { InstanceAiContext } from '../../types';
 export declare function isMockableTriggerNodeType(nodeType: string | undefined): boolean;
 export declare function isTriggerNodeType(nodeType: string | undefined): boolean;
 export declare function getReferencedWorkflowIds(json: WorkflowJSON): string[];
+export declare function ensureWebhookIds(json: WorkflowJSON, workflowId: string | undefined, ctx: InstanceAiContext): Promise<void>;
+export declare function preserveExistingNodeGroupIds(json: WorkflowJSON, workflowId: string | undefined, ctx: InstanceAiContext): Promise<void>;

package/dist/tools/workflows/workflow-json-utils.js

@@ -3,15 +3,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isMockableTriggerNodeType = isMockableTriggerNodeType;
 exports.isTriggerNodeType = isTriggerNodeType;
 exports.getReferencedWorkflowIds = getReferencedWorkflowIds;
+exports.ensureWebhookIds = ensureWebhookIds;
+exports.preserveExistingNodeGroupIds = preserveExistingNodeGroupIds;
+const utils_1 = require("@n8n/utils");
+const node_crypto_1 = require("node:crypto");
 const KNOWN_MOCKABLE_TRIGGER_TYPES = new Set([
+    'n8n-nodes-base.manualTrigger',
     'n8n-nodes-base.webhook',
     'n8n-nodes-base.formTrigger',
     'n8n-nodes-base.scheduleTrigger',
     '@n8n/n8n-nodes-langchain.chatTrigger',
 ]);
-function isRecord(value) {
-    return typeof value === 'object' && value !== null;
-}
+const WEBHOOK_NODE_TYPES = new Set([
+    'n8n-nodes-base.webhook',
+    'n8n-nodes-base.formTrigger',
+    '@n8n/n8n-nodes-langchain.mcpTrigger',
+    '@n8n/n8n-nodes-langchain.chatTrigger',
+]);
 function isMockableTriggerNodeType(nodeType) {
     return nodeType !== undefined && KNOWN_MOCKABLE_TRIGGER_TYPES.has(nodeType);
 }
@@ -23,7 +31,7 @@ function isTriggerNodeType(nodeType) {
     return nodeType.endsWith('Trigger') || nodeType.endsWith('trigger');
 }
 function extractWorkflowIdParameter(value) {
-    const rawValue = isRecord(value) ? value.value : value;
+    const rawValue = (0, utils_1.isRecord)(value) ? value.value : value;
     if (typeof rawValue !== 'string')
         return undefined;
     const workflowId = rawValue.trim();
@@ -40,7 +48,7 @@ function getReferencedWorkflowIds(json) {
     for (const node of json.nodes ?? []) {
         if (node.disabled || node.type !== 'n8n-nodes-base.executeWorkflow')
             continue;
-        const parameters = isRecord(node.parameters) ? node.parameters : {};
+        const parameters = (0, utils_1.isRecord)(node.parameters) ? node.parameters : {};
         if (shouldSkipReferencedWorkflow(parameters.source))
             continue;
         const workflowId = extractWorkflowIdParameter(parameters.workflowId);
@@ -51,4 +59,45 @@ function getReferencedWorkflowIds(json) {
     }
     return referencedWorkflowIds;
 }
+async function ensureWebhookIds(json, workflowId, ctx) {
+    const existingWebhookIds = new Map();
+    if (workflowId) {
+        try {
+            const existing = await ctx.workflowService.getAsWorkflowJSON(workflowId);
+            for (const node of existing.nodes ?? []) {
+                if (node.webhookId && node.name) {
+                    existingWebhookIds.set(node.name, node.webhookId);
+                }
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to load existing workflow ${workflowId} to preserve webhook IDs: ${message}`, { cause: error });
+        }
+    }
+    for (const node of json.nodes ?? []) {
+        if (WEBHOOK_NODE_TYPES.has(node.type) && !node.webhookId) {
+            node.webhookId = (node.name && existingWebhookIds.get(node.name)) ?? (0, node_crypto_1.randomUUID)();
+        }
+    }
+}
+async function preserveExistingNodeGroupIds(json, workflowId, ctx) {
+    if (!workflowId || !json.nodeGroups?.length)
+        return;
+    let existingGroupIdsByName;
+    try {
+        const existing = await ctx.workflowService.getAsWorkflowJSON(workflowId);
+        existingGroupIdsByName = new Map((existing.nodeGroups ?? []).map((group) => [group.name, group.id]));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to load existing workflow ${workflowId} to preserve node-group IDs: ${message}`, { cause: error });
+    }
+    for (const group of json.nodeGroups) {
+        const existingId = existingGroupIdsByName.get(group.name);
+        if (existingId) {
+            group.id = existingId;
+        }
+    }
+}
 //# sourceMappingURL=workflow-json-utils.js.map

package/dist/tools/workflows/workflow-json-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-json-utils.js","sourceRoot":"","sources":["../../../src/tools/workflows/workflow-json-utils.ts"],"names":[],"mappings":";;AAaA,8DAEC;AAED,8CAIC;AAgBD,4DAiBC;AApDD,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAC;IAC5C,wBAAwB;IACxB,4BAA4B;IAC5B,gCAAgC;IAChC,sCAAsC;CACtC,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACpD,CAAC;AAED,SAAgB,yBAAyB,CAAC,QAA4B;IACrE,OAAO,QAAQ,KAAK,SAAS,IAAI,4BAA4B,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC7E,CAAC;AAED,SAAgB,iBAAiB,CAAC,QAA4B;IAC7D,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,IAAI,yBAAyB,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,OAAO,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAc;IACjD,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IACvD,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEnD,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,UAAU,KAAK,EAAE,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAEtE,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,SAAS,4BAA4B,CAAC,MAAe;IACpD,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,UAAU,CAAC;AAC5D,CAAC;AAED,SAAgB,wBAAwB,CAAC,IAAkB;IAC1D,MAAM,qBAAqB,GAAa,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,KAAK,gCAAgC;YAAE,SAAS;QAC9E,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,IAAI,4BAA4B,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,SAAS;QAE9D,MAAM,UAAU,GAAG,0BAA0B,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACrE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,SAAS;QAElD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACrB,qBAAqB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,OAAO,qBAAqB,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"workflow-json-utils.js","sourceRoot":"","sources":["../../../src/tools/workflows/workflow-json-utils.ts"],"names":[],"mappings":"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"}

package/dist/tools/workflows/workflow-source-compiler.d.ts

@@ -0,0 +1,19 @@
+import { type WorkflowJSON } from '@n8n/workflow-sdk';
+import { type ValidationWarning } from './workflow-validation-warnings';
+import type { InstanceAiContext } from '../../types';
+export type WorkflowSourceCompiler = 'workflow-json' | 'sandbox-tsx';
+export type WorkflowSourceCompileFailureReason = 'workflow_json_parse_failed' | 'workflow_json_invalid' | 'workflow_source_unsupported_extension' | 'workflow_source_sandbox_unavailable' | 'workflow_source_sandbox_failed' | 'workflow_source_build_failed';
+export type WorkflowSourceCompileResult = {
+    success: true;
+    workflow: WorkflowJSON;
+    warnings: ValidationWarning[];
+    compiler: WorkflowSourceCompiler;
+} | {
+    success: false;
+    errors: string[];
+    reason: WorkflowSourceCompileFailureReason;
+    editable: boolean;
+    summary: string;
+};
+export declare function isWorkflowJsonSourceFile(filePath: string): boolean;
+export declare function compileWorkflowSource(context: InstanceAiContext, filePath: string, source: string): Promise<WorkflowSourceCompileResult>;