n8n 2.40.5 → 2.41.0

package/dist/modules/instance-ai/instance-ai-step-run.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildMockedStepRunData = buildMockedStepRunData;
+exports.collectAncestorNames = collectAncestorNames;
+exports.planStepRun = planStepRun;
+exports.pinDataForStepRun = pinDataForStepRun;
+exports.toExecutionItems = toExecutionItems;
+const n8n_workflow_1 = require("n8n-workflow");
+function taskDataOnOutput(items, outputIndex, executionIndex) {
+    const outputs = [];
+    for (let i = 0; i < outputIndex; i++)
+        outputs.push([]);
+    outputs.push(items);
+    return {
+        startTime: 0,
+        executionTime: 0,
+        executionIndex,
+        executionStatus: 'success',
+        source: [],
+        data: { [n8n_workflow_1.NodeConnectionTypes.Main]: outputs },
+    };
+}
+function directParents(connectionsByDestination, nodesByName, nodeName, seen = new Set()) {
+    if (seen.has(nodeName))
+        return [];
+    seen.add(nodeName);
+    const inputs = connectionsByDestination[nodeName]?.[n8n_workflow_1.NodeConnectionTypes.Main] ?? [];
+    const edges = [];
+    for (const input of inputs) {
+        for (const connection of input ?? []) {
+            const parent = nodesByName.get(connection.node);
+            if (!parent)
+                continue;
+            if (parent.disabled) {
+                edges.push(...directParents(connectionsByDestination, nodesByName, parent.name, seen));
+                continue;
+            }
+            edges.push({ node: parent, outputIndex: connection.index });
+        }
+    }
+    return edges;
+}
+function buildMockedStepRunData(args) {
+    const { nodes, connections, targetName, mockItems } = args;
+    const nodesByName = new Map(nodes.map((node) => [node.name, node]));
+    const connectionsByDestination = (0, n8n_workflow_1.mapConnectionsByDestination)(connections);
+    const runData = {};
+    const mockedNodeNames = [];
+    let executionIndex = 0;
+    const visited = new Set([targetName]);
+    let frontier = directParents(connectionsByDestination, nodesByName, targetName);
+    let depth = 0;
+    while (frontier.length > 0) {
+        const next = [];
+        for (const edge of frontier) {
+            if (visited.has(edge.node.name))
+                continue;
+            visited.add(edge.node.name);
+            const items = depth === 0 ? mockItems : [{ json: {} }];
+            runData[edge.node.name] = [taskDataOnOutput(items, edge.outputIndex, executionIndex++)];
+            mockedNodeNames.push(edge.node.name);
+            next.push(...directParents(connectionsByDestination, nodesByName, edge.node.name));
+        }
+        frontier = next;
+        depth++;
+    }
+    return { runData, mockedNodeNames };
+}
+function collectAncestorNames(nodes, connections, targetName) {
+    const nodesByName = new Map(nodes.map((node) => [node.name, node]));
+    const connectionsByDestination = (0, n8n_workflow_1.mapConnectionsByDestination)(connections);
+    const seen = new Set();
+    const queue = [targetName];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        for (const edge of directParents(connectionsByDestination, nodesByName, current)) {
+            if (seen.has(edge.node.name))
+                continue;
+            seen.add(edge.node.name);
+            queue.push(edge.node.name);
+        }
+    }
+    return [...seen];
+}
+function planStepRun(args) {
+    const { nodes, connections, targetName, mockItems, priorRunData } = args;
+    if (mockItems !== undefined) {
+        const { runData, mockedNodeNames } = buildMockedStepRunData({
+            nodes,
+            connections,
+            targetName,
+            mockItems,
+        });
+        if (mockedNodeNames.length > 0) {
+            return {
+                inputMode: 'mocked',
+                runData,
+                dirtyNodeNames: [targetName],
+                mockedNodeNames,
+                reusedNodeNames: [],
+            };
+        }
+    }
+    if (priorRunData !== undefined && Object.keys(priorRunData).length > 0) {
+        const ancestors = new Set(collectAncestorNames(nodes, connections, targetName));
+        const reusedNodeNames = Object.keys(priorRunData).filter((name) => ancestors.has(name));
+        if (reusedNodeNames.length > 0) {
+            return {
+                inputMode: 'reused-execution',
+                runData: priorRunData,
+                dirtyNodeNames: [targetName],
+                mockedNodeNames: [],
+                reusedNodeNames,
+            };
+        }
+    }
+    return {
+        inputMode: 'chain',
+        mockedNodeNames: [],
+        reusedNodeNames: [],
+    };
+}
+function pinDataForStepRun(workflowPinData, args) {
+    if (!workflowPinData)
+        return undefined;
+    const overridden = new Set([args.targetName, ...args.mockedNodeNames]);
+    const kept = Object.entries(workflowPinData).filter(([nodeName]) => !overridden.has(nodeName));
+    if (kept.length === Object.keys(workflowPinData).length)
+        return workflowPinData;
+    return Object.fromEntries(kept);
+}
+function toExecutionItems(items) {
+    return items.map((json) => ({ json: (json ?? {}) }));
+}
+//# sourceMappingURL=instance-ai-step-run.js.map

package/dist/modules/instance-ai/instance-ai-step-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-ai-step-run.js","sourceRoot":"","sources":["../../../src/modules/instance-ai/instance-ai-step-run.ts"],"names":[],"mappings":"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"}

package/dist/modules/instance-ai/instance-ai.adapter.service.d.ts

@@ -3,7 +3,7 @@ import { OutboundHttp } from '@n8n/backend-network';
 import { GlobalConfig } from '@n8n/config';
 import type { User, EvaluationConfig } from '@n8n/db';
 import { AiBuilderTemporaryWorkflowRepository, ExecutionRepository, FolderRepository, ProjectRepository, SharedWorkflowRepository, WorkflowRepository } from '@n8n/db';
-import type { InstanceAiContext, InstanceAiConversationHistoryReader, ExecutionResult, ExecutionDebugInfo, NodeOutputResult, ServiceProxyConfig, EvaluationConfigSummary, EvaluationConfigDetail, UpsertEvaluationConfigInput, ModelConfig } from '@n8n/instance-ai';
+import type { InstanceAiContext, InstanceAiConversationHistoryReader, ExecutionResult, ExecutionDebugInfo, NodeOutputResult, ServiceProxyConfig, EvaluationConfigSummary, EvaluationConfigDetail, UpsertEvaluationConfigInput, ExecuteNodeResult as InstanceAiExecuteNodeResult, ModelConfig } from '@n8n/instance-ai';
 import { InstanceSettings } from 'n8n-core';
 import { type ExecutionError } from 'n8n-workflow';
 import { ActiveExecutions } from '../../active-executions';
@@ -20,6 +20,8 @@ import { DataTableRepository } from '../../modules/data-table/data-table.reposit
 import { DataTableService } from '../../modules/data-table/data-table.service';
 import { WorkflowDependencyQueryService } from '../../modules/workflow-index/workflow-dependency-query.service';
 import { NodeCatalogService } from '../../node-catalog';
+import { ExecuteNodeService } from '../../node-execution';
+import type { ExecuteNodeResult } from '../../node-execution';
 import { NodeTypes } from '../../node-types';
 import { PolicyEnforcementService } from '../../policy/policy-enforcement.service';
 import { AiGatewayService } from '../../services/ai-gateway.service';
@@ -82,13 +84,14 @@ export declare class InstanceAiAdapterService {
     private readonly folderRepository?;
     private readonly folderFinderService?;
     private readonly instanceContext?;
+    private readonly executeNodeService?;
     private readonly logger;
     private readonly allowSendingParameterValues;
     private nodesCache;
     private readonly NODES_CACHE_TTL_MS;
     private templatesService;
     private getNodesFromCache;
-    constructor(logger: Logger, globalConfig: GlobalConfig, workflowService: WorkflowService, workflowFinderService: WorkflowFinderService, workflowRepository: WorkflowRepository, sharedWorkflowRepository: SharedWorkflowRepository, projectRepository: ProjectRepository, executionRepository: ExecutionRepository, credentialsService: CredentialsService, credentialsFinderService: CredentialsFinderService, activeExecutions: ActiveExecutions, workflowRunner: WorkflowRunner, loadNodesAndCredentials: LoadNodesAndCredentials, nodeTypes: NodeTypes, instanceSettings: InstanceSettings, dataTableService: DataTableService, dataTableRepository: DataTableRepository, nodeResourceExplorerService: NodeResourceExplorerService, folderService: FolderService, projectService: ProjectService, tagService: TagService, instanceWriteAccess: InstanceWriteAccessService, settingsService: InstanceAiSettingsService, workflowHistoryService: WorkflowHistoryService, enterpriseWorkflowService: EnterpriseWorkflowService, license: License, executionPersistence: ExecutionPersistence, eventService: EventService, roleService: RoleService, telemetry: Telemetry, aiBuilderTemporaryWorkflowRepository: AiBuilderTemporaryWorkflowRepository, outboundHttp: OutboundHttp, aiGatewayService: AiGatewayService, workflowTemplatesService: WorkflowTemplatesService, collaborationService: CollaborationService, policyEnforcementService: PolicyEnforcementService, nodeCatalogService?: NodeCatalogService | undefined, evaluationConfigService?: EvaluationConfigService | undefined, llmJudgeProviderRegistry?: LlmJudgeProviderRegistry | undefined, workflowDependencyQueryService?: WorkflowDependencyQueryService | undefined, folderRepository?: FolderRepository | undefined, folderFinderService?: FolderFinderService | undefined, instanceContext?: InstanceContextService | undefined);
+    constructor(logger: Logger, globalConfig: GlobalConfig, workflowService: WorkflowService, workflowFinderService: WorkflowFinderService, workflowRepository: WorkflowRepository, sharedWorkflowRepository: SharedWorkflowRepository, projectRepository: ProjectRepository, executionRepository: ExecutionRepository, credentialsService: CredentialsService, credentialsFinderService: CredentialsFinderService, activeExecutions: ActiveExecutions, workflowRunner: WorkflowRunner, loadNodesAndCredentials: LoadNodesAndCredentials, nodeTypes: NodeTypes, instanceSettings: InstanceSettings, dataTableService: DataTableService, dataTableRepository: DataTableRepository, nodeResourceExplorerService: NodeResourceExplorerService, folderService: FolderService, projectService: ProjectService, tagService: TagService, instanceWriteAccess: InstanceWriteAccessService, settingsService: InstanceAiSettingsService, workflowHistoryService: WorkflowHistoryService, enterpriseWorkflowService: EnterpriseWorkflowService, license: License, executionPersistence: ExecutionPersistence, eventService: EventService, roleService: RoleService, telemetry: Telemetry, aiBuilderTemporaryWorkflowRepository: AiBuilderTemporaryWorkflowRepository, outboundHttp: OutboundHttp, aiGatewayService: AiGatewayService, workflowTemplatesService: WorkflowTemplatesService, collaborationService: CollaborationService, policyEnforcementService: PolicyEnforcementService, nodeCatalogService?: NodeCatalogService | undefined, evaluationConfigService?: EvaluationConfigService | undefined, llmJudgeProviderRegistry?: LlmJudgeProviderRegistry | undefined, workflowDependencyQueryService?: WorkflowDependencyQueryService | undefined, folderRepository?: FolderRepository | undefined, folderFinderService?: FolderFinderService | undefined, instanceContext?: InstanceContextService | undefined, executeNodeService?: ExecuteNodeService | undefined);
     createContext(user: User, options?: {
         searchProxyConfig?: ServiceProxyConfig;
         pushRef?: string;
@@ -100,6 +103,7 @@ export declare class InstanceAiAdapterService {
         configEvalsEnabled?: boolean;
         mcpConnectionsEnabled?: boolean;
         nodeUsageEnabled?: boolean;
+        instanceContextEnabled?: boolean;
         conversationHistory?: InstanceAiConversationHistoryReader;
         folderExplorationEnabled?: boolean;
         modelId?: ModelConfig;
@@ -114,10 +118,12 @@ export declare class InstanceAiAdapterService {
         nodeUsageEnabled: boolean;
         folderExplorationEnabled: boolean;
         aiPreferencesEnabled: boolean;
+        instanceContextEnabled: boolean;
     }>;
     private mcpPreconditionsHold;
     private createActivityAdapter;
     private createMcpAdapter;
+    private createExecuteNodeAdapter;
     private listMcpRegistryConnections;
     private buildAiGatewayNodeMeta;
     private getTemplatesService;
@@ -261,6 +267,7 @@ export declare function extractExecutionOutcome(executionId: string, includeOutp
 }>;
 export declare function formatExecutionError(error: ExecutionError, includeUpstreamDetails: boolean): string;
 export declare function truncateNodeOutput(items: unknown[]): unknown[] | unknown;
+export declare function redactExecuteNodeResult(result: ExecuteNodeResult, allowSendingParameterValues: boolean): InstanceAiExecuteNodeResult;
 export declare function extractNodeOutput(executionId: string, nodeName: string, options?: {
     startIndex?: number;
     maxItems?: number;