n8n 2.45.4 → 2.46.0

package/dist/memory-guard/memory-stopped-executions.js

@@ -0,0 +1,62 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryStoppedExecutions = void 0;
+const di_1 = require("@n8n/di");
+const n8n_workflow_1 = require("n8n-workflow");
+let MemoryStoppedExecutions = class MemoryStoppedExecutions {
+    constructor() {
+        this.enabled = false;
+        this.stopped = new Map();
+        this.finishing = new Set();
+    }
+    markStopped(executionId, stop) {
+        this.stopped.set(executionId, stop);
+    }
+    forget(executionId) {
+        this.stopped.delete(executionId);
+    }
+    isStopped(executionId) {
+        return this.stopped.has(executionId);
+    }
+    isFinishing(executionId) {
+        return this.finishing.has(executionId);
+    }
+    pruneFinishing(isActive) {
+        for (const executionId of this.finishing) {
+            if (!isActive(executionId))
+                this.finishing.delete(executionId);
+        }
+    }
+    onWorkflowExecuteStart(executionId) {
+        this.finishing.delete(executionId);
+    }
+    onWorkflowExecuteAfter(executionId, run) {
+        if (!this.enabled)
+            return;
+        const stop = this.stopped.get(executionId);
+        if (!stop) {
+            this.finishing.add(executionId);
+            return;
+        }
+        const { parentExecution, parentAgentRun, manualData } = run.data;
+        run.status = 'error';
+        run.data = (0, n8n_workflow_1.createRunExecutionData)({
+            resultData: { runData: {}, lastNodeExecuted: stop.runningNode, error: stop.error },
+            executionData: null,
+            parentExecution,
+            parentAgentRun,
+            manualData,
+        });
+    }
+};
+exports.MemoryStoppedExecutions = MemoryStoppedExecutions;
+exports.MemoryStoppedExecutions = MemoryStoppedExecutions = __decorate([
+    (0, di_1.Service)()
+], MemoryStoppedExecutions);
+//# sourceMappingURL=memory-stopped-executions.js.map

package/dist/memory-guard/memory-stopped-executions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-stopped-executions.js","sourceRoot":"","sources":["../../src/memory-guard/memory-stopped-executions.ts"],"names":[],"mappings":";;;;;;;;;AAAA,gCAAkC;AAElC,+CAAsD;AAY/C,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IAA7B;QAEN,YAAO,GAAG,KAAK,CAAC;QAEC,YAAO,GAAG,IAAI,GAAG,EAA4B,CAAC;QAG9C,cAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IAwDhD,CAAC;IAtDA,WAAW,CAAC,WAAmB,EAAE,IAAsB;QACtD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAGD,MAAM,CAAC,WAAmB;QACzB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;IAED,SAAS,CAAC,WAAmB;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAED,WAAW,CAAC,WAAmB;QAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;IAGD,cAAc,CAAC,QAA0C;QACxD,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC1C,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;gBAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAChE,CAAC;IACF,CAAC;IAGD,sBAAsB,CAAC,WAAmB;QACzC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC;IAOD,sBAAsB,CAAC,WAAmB,EAAE,GAAS;QACpD,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,EAAE,CAAC;YACX,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAChC,OAAO;QACR,CAAC;QAGD,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;QACjE,GAAG,CAAC,MAAM,GAAG,OAAO,CAAC;QACrB,GAAG,CAAC,IAAI,GAAG,IAAA,qCAAsB,EAAC;YACjC,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,gBAAgB,EAAE,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;YAClF,aAAa,EAAE,IAAI;YACnB,eAAe;YACf,cAAc;YACd,UAAU;SACV,CAAC,CAAC;IACJ,CAAC;CACD,CAAA;;kCA/DY,uBAAuB;IADnC,IAAA,YAAO,GAAE;GACG,uBAAuB,CA+DnC"}

package/dist/memory-guard/memory-usage.d.ts

@@ -0,0 +1,7 @@
+export interface MemoryUsage {
+    utilization: number;
+    usedBytes: number;
+    limitBytes: number;
+}
+export declare function getContainerLimit(): number | undefined;
+export declare function readMemoryUsage(containerLimit: number | undefined): MemoryUsage;

package/dist/memory-guard/memory-usage.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getContainerLimit = getContainerLimit;
+exports.readMemoryUsage = readMemoryUsage;
+const node_os_1 = require("node:os");
+const node_v8_1 = require("node:v8");
+function getContainerLimit() {
+    const limit = process.constrainedMemory();
+    return limit > 0 && limit <= (0, node_os_1.totalmem)() ? limit : undefined;
+}
+function readMemoryUsage(containerLimit) {
+    const heap = (0, node_v8_1.getHeapStatistics)();
+    const heapUsage = {
+        utilization: heap.used_heap_size / heap.heap_size_limit,
+        usedBytes: heap.used_heap_size,
+        limitBytes: heap.heap_size_limit,
+    };
+    if (containerLimit === undefined)
+        return heapUsage;
+    const rss = process.memoryUsage.rss();
+    const containerUsage = {
+        utilization: rss / containerLimit,
+        usedBytes: rss,
+        limitBytes: containerLimit,
+    };
+    return containerUsage.utilization >= heapUsage.utilization ? containerUsage : heapUsage;
+}
+//# sourceMappingURL=memory-usage.js.map

package/dist/memory-guard/memory-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-usage.js","sourceRoot":"","sources":["../../src/memory-guard/memory-usage.ts"],"names":[],"mappings":";;;;AAAA,qCAAmC;AACnC,qCAA4C;AAe5C;IACC,MAAM,KAAK,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAC1C,OAAO,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,IAAA,kBAAQ,GAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAMD,yBAAgC,cAAkC;IACjE,MAAM,IAAI,GAAG,IAAA,2BAAiB,GAAE,CAAC;IACjC,MAAM,SAAS,GAAgB;QAC9B,WAAW,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,eAAe;QACvD,SAAS,EAAE,IAAI,CAAC,cAAc;QAC9B,UAAU,EAAE,IAAI,CAAC,eAAe;KAChC,CAAC;IACF,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAEnD,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,cAAc,GAAgB;QACnC,WAAW,EAAE,GAAG,GAAG,cAAc;QACjC,SAAS,EAAE,GAAG;QACd,UAAU,EAAE,cAAc;KAC1B,CAAC;IACF,OAAO,cAAc,CAAC,WAAW,IAAI,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;AACzF,CAAC"}

package/dist/memory-guard/production-hold.d.ts

@@ -0,0 +1,14 @@
+import type { WorkflowExecuteMode } from 'n8n-workflow';
+export declare class ProductionHold {
+    private holding;
+    private readonly held;
+    start(): void;
+    end(): void;
+    shouldHold(mode: WorkflowExecuteMode): boolean;
+    wait(executionId: string): Promise<void>;
+    admit(count: number): number;
+    remove(executionId: string): boolean;
+    has(executionId: string): boolean;
+    get heldCount(): number;
+    get oldestHeldAt(): number | undefined;
+}

package/dist/memory-guard/production-hold.js

@@ -0,0 +1,63 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProductionHold = void 0;
+const di_1 = require("@n8n/di");
+const memory_guard_utils_1 = require("./memory-guard.utils");
+let ProductionHold = class ProductionHold {
+    constructor() {
+        this.holding = false;
+        this.held = [];
+    }
+    start() {
+        this.holding = true;
+    }
+    end() {
+        this.holding = false;
+    }
+    shouldHold(mode) {
+        return (0, memory_guard_utils_1.isProductionMode)(mode) && (this.holding || this.held.length > 0);
+    }
+    async wait(executionId) {
+        await new Promise((admit) => {
+            this.held.push({ executionId, heldAt: Date.now(), admit });
+        });
+    }
+    admit(count) {
+        let started = 0;
+        while (started < count) {
+            const item = this.held.shift();
+            if (!item)
+                break;
+            item.admit();
+            started++;
+        }
+        return started;
+    }
+    remove(executionId) {
+        const index = this.held.findIndex((item) => item.executionId === executionId);
+        if (index === -1)
+            return false;
+        this.held.splice(index, 1);
+        return true;
+    }
+    has(executionId) {
+        return this.held.some((item) => item.executionId === executionId);
+    }
+    get heldCount() {
+        return this.held.length;
+    }
+    get oldestHeldAt() {
+        return this.held[0]?.heldAt;
+    }
+};
+exports.ProductionHold = ProductionHold;
+exports.ProductionHold = ProductionHold = __decorate([
+    (0, di_1.Service)()
+], ProductionHold);
+//# sourceMappingURL=production-hold.js.map

package/dist/memory-guard/production-hold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"production-hold.js","sourceRoot":"","sources":["../../src/memory-guard/production-hold.ts"],"names":[],"mappings":";;;;;;;;;AAAA,gCAAkC;AAGlC,6DAAwD;AAajD,IAAM,cAAc,GAApB,MAAM,cAAc;IAApB;QACE,YAAO,GAAG,KAAK,CAAC;QAGP,SAAI,GAAoB,EAAE,CAAC;IAwD7C,CAAC;IArDA,KAAK;QACJ,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACrB,CAAC;IAGD,GAAG;QACF,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACtB,CAAC;IAGD,UAAU,CAAC,IAAyB;QACnC,OAAO,IAAA,qCAAgB,EAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzE,CAAC;IAGD,KAAK,CAAC,IAAI,CAAC,WAAmB;QAC7B,MAAM,IAAI,OAAO,CAAO,CAAC,KAAK,EAAE,EAAE;YACjC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;IACJ,CAAC;IAGD,KAAK,CAAC,KAAa;QAClB,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,OAAO,OAAO,GAAG,KAAK,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI;gBAAE,MAAM;YACjB,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,OAAO,EAAE,CAAC;QACX,CAAC;QACD,OAAO,OAAO,CAAC;IAChB,CAAC;IAGD,MAAM,CAAC,WAAmB;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;QAC9E,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACb,CAAC;IAED,GAAG,CAAC,WAAmB;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,SAAS;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IACzB,CAAC;IAGD,IAAI,YAAY;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAC7B,CAAC;CACD,CAAA;;yBA5DY,cAAc;IAD1B,IAAA,YAAO,GAAE;GACG,cAAc,CA4D1B"}

package/dist/memory-guard/run-data-tracker.d.ts

@@ -0,0 +1,27 @@
+import { Logger } from '@n8n/backend-common';
+import type { NodeExecuteAfterContext, NodeExecuteBeforeContext, WorkflowExecuteAfterContext, WorkflowExecuteBeforeContext, WorkflowExecuteResumeContext } from '@n8n/decorators';
+import { ActiveExecutions } from '../active-executions';
+export interface RunDataEstimate {
+    totalBytes: number;
+    bytesByNode: ReadonlyMap<string, number>;
+    runningNode: string | undefined;
+}
+export declare class RunDataTracker {
+    private readonly logger;
+    private readonly activeExecutions;
+    private readonly executions;
+    constructor(logger: Logger, activeExecutions: ActiveExecutions);
+    onExecutionStart({ executionId, executionData }: WorkflowExecuteBeforeContext): void;
+    onExecutionResume({ executionId, executionData }: WorkflowExecuteResumeContext): void;
+    onNodeStart({ executionId, nodeName, taskData }: NodeExecuteBeforeContext): void;
+    onNodeFinish({ executionId, nodeName, taskData, executionData }: NodeExecuteAfterContext): void;
+    onExecutionEnd({ executionId }: WorkflowExecuteAfterContext): void;
+    getEstimate(executionId: string): RunDataEstimate | undefined;
+    private safely;
+    private finishRun;
+    private track;
+    private addEstimate;
+    private addBytes;
+    private dropFinished;
+    private logEstimate;
+}

package/dist/memory-guard/run-data-tracker.js

@@ -0,0 +1,242 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunDataTracker = void 0;
+const backend_common_1 = require("@n8n/backend-common");
+const decorators_1 = require("@n8n/decorators");
+const di_1 = require("@n8n/di");
+const bytes_1 = require("@n8n/utils/number/bytes");
+const active_executions_1 = require("../active-executions");
+const estimate_run_data_size_1 = require("./estimate-run-data-size");
+const MEASURED_RUNS_BUDGET = 25;
+let RunDataTracker = class RunDataTracker {
+    constructor(logger, activeExecutions) {
+        this.logger = logger;
+        this.activeExecutions = activeExecutions;
+        this.executions = new Map();
+        this.logger = this.logger.scoped('memory-guard');
+    }
+    onExecutionStart({ executionId, executionData }) {
+        this.safely(executionId, () => this.track(executionId, executionData?.resultData.runData));
+    }
+    onExecutionResume({ executionId, executionData }) {
+        this.safely(executionId, () => this.track(executionId, executionData.resultData.runData));
+    }
+    onNodeStart({ executionId, nodeName, taskData }) {
+        this.safely(executionId, () => {
+            const execution = this.executions.get(executionId);
+            if (!execution)
+                return;
+            execution.runningNodes.set(taskData.executionIndex, {
+                name: nodeName,
+                source: taskData.source[0]?.previousNode,
+            });
+            if (hasInputOverride(taskData)) {
+                this.addEstimate(execution, executionId, nodeName, () => (0, estimate_run_data_size_1.estimateInputSize)(taskData, execution.seen));
+            }
+        });
+    }
+    onNodeFinish({ executionId, nodeName, taskData, executionData }) {
+        this.safely(executionId, () => {
+            const execution = this.executions.get(executionId);
+            if (!execution)
+                return;
+            this.finishRun(execution, nodeName, taskData.executionIndex);
+            const { runData } = executionData.resultData;
+            this.addEstimate(execution, executionId, nodeName, () => (0, estimate_run_data_size_1.estimateTaskDataSize)(taskData, runData, execution.seen));
+        });
+    }
+    onExecutionEnd({ executionId }) {
+        this.safely(executionId, () => {
+            const execution = this.executions.get(executionId);
+            if (!execution)
+                return;
+            this.executions.delete(executionId);
+            this.logEstimate(executionId, execution);
+        });
+    }
+    getEstimate(executionId) {
+        const execution = this.executions.get(executionId);
+        if (!execution)
+            return undefined;
+        return {
+            totalBytes: execution.totalBytes,
+            bytesByNode: execution.bytesByNode,
+            runningNode: [...execution.runningNodes.values()].at(-1)?.name,
+        };
+    }
+    safely(executionId, handler) {
+        try {
+            handler();
+        }
+        catch {
+            this.logger.debug('Failed to track run data', { executionId });
+        }
+    }
+    finishRun(execution, nodeName, executionIndex) {
+        const { runningNodes } = execution;
+        if (!runningNodes.delete(executionIndex)) {
+            const resumed = [...runningNodes].findLast(([, run]) => run.name === nodeName);
+            if (resumed)
+                runningNodes.delete(resumed[0]);
+        }
+        const finished = new Set([nodeName]);
+        for (const [index, run] of runningNodes) {
+            if (run.source !== undefined && finished.has(run.source)) {
+                runningNodes.delete(index);
+                finished.add(run.name);
+            }
+        }
+    }
+    track(executionId, runData = {}) {
+        this.dropFinished();
+        const execution = {
+            totalBytes: 0,
+            bytesByNode: new Map(),
+            runningNodes: new Map(),
+            seen: new WeakSet(),
+        };
+        this.executions.set(executionId, execution);
+        const nodes = Object.entries(runData);
+        const sampleCounts = spreadBudget(nodes.map(([, runs]) => runs.length), MEASURED_RUNS_BUDGET);
+        let ownBytes = 0;
+        let ownRuns = 0;
+        const measuredCounts = nodes.map(() => 0);
+        for (const [i, [nodeName, runs]] of nodes.entries()) {
+            const sampled = sampleCounts[i];
+            if (sampled === 0)
+                continue;
+            const sampledRuns = Array.from({ length: sampled }, (_, j) => runs[sampleIndex(j, runs.length, sampled)]);
+            const sharing = sampled < runs.length ? new estimate_run_data_size_1.RunSharing() : undefined;
+            const measuredBytes = sampledRuns.map((taskData, run) => this.addEstimate(execution, executionId, nodeName, () => (0, estimate_run_data_size_1.estimateTaskDataSize)(taskData, runData, execution.seen, sharing ? { runs: sharing, run } : undefined)));
+            let nodeOwnBytes = 0;
+            let measured = 0;
+            for (const [run, bytes] of measuredBytes.entries()) {
+                if (bytes === undefined)
+                    continue;
+                nodeOwnBytes += Math.max(0, bytes - (sharing?.sharedBytesOf(run) ?? 0));
+                measured++;
+            }
+            if (measured === 0)
+                continue;
+            measuredCounts[i] = measured;
+            ownBytes += nodeOwnBytes;
+            ownRuns += measured;
+            this.addBytes(execution, nodeName, Math.round((nodeOwnBytes / measured) * (runs.length - measured)));
+        }
+        if (ownRuns === 0)
+            return;
+        for (const [i, [nodeName, runs]] of nodes.entries()) {
+            if (measuredCounts[i] === 0 && runs.length > 0) {
+                this.addBytes(execution, nodeName, Math.round((ownBytes / ownRuns) * runs.length));
+            }
+        }
+    }
+    addEstimate(execution, executionId, nodeName, estimateBytes) {
+        let bytes;
+        try {
+            bytes = estimateBytes();
+        }
+        catch {
+            this.logger.debug('Failed to estimate node output size', { executionId, nodeName });
+            return undefined;
+        }
+        this.addBytes(execution, nodeName, bytes);
+        return bytes;
+    }
+    addBytes(execution, nodeName, bytes) {
+        if (bytes === 0)
+            return;
+        execution.totalBytes += bytes;
+        execution.bytesByNode.set(nodeName, (execution.bytesByNode.get(nodeName) ?? 0) + bytes);
+    }
+    dropFinished() {
+        for (const executionId of this.executions.keys()) {
+            if (!this.activeExecutions.has(executionId))
+                this.executions.delete(executionId);
+        }
+    }
+    logEstimate(executionId, { totalBytes, bytesByNode }) {
+        if (totalBytes === 0)
+            return;
+        let largestNode = '';
+        let largestBytes = 0;
+        for (const [nodeName, bytes] of bytesByNode) {
+            if (bytes > largestBytes)
+                [largestNode, largestBytes] = [nodeName, bytes];
+        }
+        this.logger.debug(`Execution ${executionId} held an estimated ${(0, bytes_1.formatBytes)(totalBytes)} of run data, most of it from node "${largestNode}" (${(0, bytes_1.formatBytes)(largestBytes)})`, { executionId });
+    }
+};
+exports.RunDataTracker = RunDataTracker;
+__decorate([
+    (0, decorators_1.OnLifecycleEvent)('workflowExecuteBefore'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], RunDataTracker.prototype, "onExecutionStart", null);
+__decorate([
+    (0, decorators_1.OnLifecycleEvent)('workflowExecuteResume'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], RunDataTracker.prototype, "onExecutionResume", null);
+__decorate([
+    (0, decorators_1.OnLifecycleEvent)('nodeExecuteBefore'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], RunDataTracker.prototype, "onNodeStart", null);
+__decorate([
+    (0, decorators_1.OnLifecycleEvent)('nodeExecuteAfter'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], RunDataTracker.prototype, "onNodeFinish", null);
+__decorate([
+    (0, decorators_1.OnLifecycleEvent)('workflowExecuteAfter'),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], RunDataTracker.prototype, "onExecutionEnd", null);
+exports.RunDataTracker = RunDataTracker = __decorate([
+    (0, di_1.Service)(),
+    __metadata("design:paramtypes", [backend_common_1.Logger, active_executions_1.ActiveExecutions])
+], RunDataTracker);
+function spreadBudget(runCounts, budget) {
+    const sampleCounts = runCounts.map(() => 0);
+    let left = budget;
+    let added = true;
+    while (left > 0 && added) {
+        added = false;
+        for (const [i, runCount] of runCounts.entries()) {
+            if (left === 0)
+                break;
+            if (sampleCounts[i] < runCount) {
+                sampleCounts[i]++;
+                left--;
+                added = true;
+            }
+        }
+    }
+    return sampleCounts;
+}
+function sampleIndex(j, count, sampled) {
+    const start = Math.floor((j * count) / sampled);
+    const end = Math.floor(((j + 1) * count) / sampled);
+    const placeInPart = ((j + 1) * GOLDEN_RATIO) % 1;
+    return start + Math.floor(placeInPart * (end - start));
+}
+const GOLDEN_RATIO = (1 + Math.sqrt(5)) / 2;
+function hasInputOverride(taskData) {
+    return 'inputOverride' in taskData && taskData.inputOverride !== undefined;
+}
+//# sourceMappingURL=run-data-tracker.js.map

package/dist/memory-guard/run-data-tracker.js.map

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

package/dist/metrics/prometheus/memory-guard-metrics.service.d.ts

@@ -0,0 +1,13 @@
+import { EventService } from '@n8n/backend-services';
+import { ExecutionsConfig, MemoryGuardConfig, PrometheusMetricsConfig } from '@n8n/config';
+import type { PrometheusMetricsCollector } from './base';
+export declare class PrometheusMemoryGuardMetricsService implements PrometheusMetricsCollector {
+    private readonly config;
+    private readonly memoryGuardConfig;
+    private readonly executionsConfig;
+    private readonly eventService;
+    private isInitialized;
+    constructor(config: PrometheusMetricsConfig, memoryGuardConfig: MemoryGuardConfig, executionsConfig: ExecutionsConfig, eventService: EventService);
+    get enabled(): boolean;
+    init(): void;
+}

package/dist/metrics/prometheus/memory-guard-metrics.service.js

@@ -0,0 +1,91 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrometheusMemoryGuardMetricsService = void 0;
+const backend_services_1 = require("@n8n/backend-services");
+const config_1 = require("@n8n/config");
+const di_1 = require("@n8n/di");
+const prom_client_1 = __importDefault(require("prom-client"));
+let PrometheusMemoryGuardMetricsService = class PrometheusMemoryGuardMetricsService {
+    constructor(config, memoryGuardConfig, executionsConfig, eventService) {
+        this.config = config;
+        this.memoryGuardConfig = memoryGuardConfig;
+        this.executionsConfig = executionsConfig;
+        this.eventService = eventService;
+        this.isInitialized = false;
+    }
+    get enabled() {
+        return this.memoryGuardConfig.enabled && this.executionsConfig.mode === 'regular';
+    }
+    init() {
+        if (this.isInitialized)
+            return;
+        this.isInitialized = true;
+        const prefix = this.config.prefix;
+        const holds = new prom_client_1.default.Counter({
+            name: `${prefix}memory_guard_holds_total`,
+            help: 'Total number of times the memory guard started to hold new production executions.',
+        });
+        const holding = new prom_client_1.default.Gauge({
+            name: `${prefix}memory_guard_holding`,
+            help: 'Whether the memory guard holds new production executions now (1) or not (0).',
+        });
+        holding.set(0);
+        const heldSeconds = new prom_client_1.default.Counter({
+            name: `${prefix}memory_guard_hold_seconds_total`,
+            help: 'Total time in seconds that the memory guard held new production executions, counted when each hold ends.',
+        });
+        const stops = new prom_client_1.default.Counter({
+            name: `${prefix}memory_guard_stops_total`,
+            help: 'Total number of executions that the memory guard stopped, by reason (threshold, critical, hold_limit) and whether the stop freed memory.',
+            labelNames: ['reason', 'freed'],
+        });
+        for (const reason of ['threshold', 'critical', 'hold_limit']) {
+            for (const freed of ['true', 'false'])
+                stops.inc({ reason, freed }, 0);
+        }
+        const deactivations = new prom_client_1.default.Counter({
+            name: `${prefix}memory_guard_deactivations_total`,
+            help: 'Total number of workflows that the memory guard deactivated after repeated stops.',
+        });
+        const crashes = new prom_client_1.default.Counter({
+            name: `${prefix}memory_guard_crashes_total`,
+            help: 'Total number of crashed sessions, by the strongest memory guard action since memory was last low (none, hold, stop). Kept across restarts.',
+            labelNames: ['last_action'],
+        });
+        this.eventService.on('memory-guard-crashes-counted', ({ crashes: totals }) => {
+            for (const [action, count] of Object.entries(totals)) {
+                crashes.inc({ last_action: action }, count);
+            }
+        });
+        this.eventService.on('memory-guard-hold-started', () => {
+            holds.inc();
+            holding.set(1);
+        });
+        this.eventService.on('memory-guard-hold-ended', ({ heldMs }) => {
+            holding.set(0);
+            heldSeconds.inc(heldMs / 1000);
+        });
+        this.eventService.on('memory-guard-workflow-deactivated', () => deactivations.inc());
+        this.eventService.on('memory-guard-execution-stopped', (event) => {
+            stops.inc({ reason: event.reason.replace('-', '_'), freed: String(event.freedMemory) });
+        });
+    }
+};
+exports.PrometheusMemoryGuardMetricsService = PrometheusMemoryGuardMetricsService;
+exports.PrometheusMemoryGuardMetricsService = PrometheusMemoryGuardMetricsService = __decorate([
+    (0, di_1.Service)(),
+    __metadata("design:paramtypes", [config_1.PrometheusMetricsConfig, config_1.MemoryGuardConfig, config_1.ExecutionsConfig, backend_services_1.EventService])
+], PrometheusMemoryGuardMetricsService);
+//# sourceMappingURL=memory-guard-metrics.service.js.map

package/dist/metrics/prometheus/memory-guard-metrics.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-guard-metrics.service.js","sourceRoot":"","sources":["../../../src/metrics/prometheus/memory-guard-metrics.service.ts"],"names":[],"mappings":"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"}

package/dist/metrics/prometheus/prometheus.service.d.ts

@@ -12,6 +12,7 @@ import { PrometheusExecutionDataMetricsService } from './execution-data-metrics.
 import { PrometheusInstanceAiMetricsService } from './instance-ai-metrics.service';
 import { PrometheusInstanceRoleMetricsService } from './instance-role-metrics.service';
 import { PrometheusMcpPostSaveMetricsService } from './mcp-post-save-metrics.service';
+import { PrometheusMemoryGuardMetricsService } from './memory-guard-metrics.service';
 import { PrometheusPollTriggerMetricsService } from './poll-trigger-metrics.service';
 import { PrometheusPssMetricsService } from './pss-metrics.service';
 import { PrometheusQueueMetricsService } from './queue-metrics.service';
@@ -31,7 +32,7 @@ export declare class PrometheusMetricsService {
     private initialized;
     private readonly logger;
     private readonly collectors;
-    constructor(logger: Logger, cache: PrometheusCacheMetricsService, eventBus: PrometheusEventBusMetricsService, queue: PrometheusQueueMetricsService, route: PrometheusRouteMetricsService, roleInstance: PrometheusInstanceRoleMetricsService, activeWorkflow: PrometheusActiveWorkflowMetricsService, workflowExecutionDuration: PrometheusWorkflowExecutionDurationMetricsService, workflowStatistics: PrometheusWorkflowStatisticsMetricsService, executionData: PrometheusExecutionDataMetricsService, pss: PrometheusPssMetricsService, version: PrometheusVersionMetricsService, defaultMetrics: PrometheusDefaultMetricsService, tokenExchange: PrometheusTokenExchangeMetricsService, ssrf: PrometheusSsrfMetricsService, dnsCache: PrometheusDnsCacheMetricsService, webhook: PrometheusWebhookAndFormMetricsService, workflowInfo: PrometheusWorkflowInfoMetricsService, instanceAi: PrometheusInstanceAiMetricsService, mcpPostSave: PrometheusMcpPostSaveMetricsService, dbPool: PrometheusDbPoolMetricsService, workflowPublication: PrometheusWorkflowPublicationMetricsService, scheduler: PrometheusSchedulerMetricsService, pollTrigger: PrometheusPollTriggerMetricsService, encryption: PrometheusEncryptionMetricsService, systemTask: PrometheusSystemTaskMetricsService, databaseIndependentRoutes: DatabaseIndependentRoutes);
+    constructor(logger: Logger, cache: PrometheusCacheMetricsService, eventBus: PrometheusEventBusMetricsService, queue: PrometheusQueueMetricsService, route: PrometheusRouteMetricsService, roleInstance: PrometheusInstanceRoleMetricsService, activeWorkflow: PrometheusActiveWorkflowMetricsService, workflowExecutionDuration: PrometheusWorkflowExecutionDurationMetricsService, workflowStatistics: PrometheusWorkflowStatisticsMetricsService, executionData: PrometheusExecutionDataMetricsService, pss: PrometheusPssMetricsService, version: PrometheusVersionMetricsService, defaultMetrics: PrometheusDefaultMetricsService, tokenExchange: PrometheusTokenExchangeMetricsService, ssrf: PrometheusSsrfMetricsService, dnsCache: PrometheusDnsCacheMetricsService, webhook: PrometheusWebhookAndFormMetricsService, workflowInfo: PrometheusWorkflowInfoMetricsService, instanceAi: PrometheusInstanceAiMetricsService, mcpPostSave: PrometheusMcpPostSaveMetricsService, dbPool: PrometheusDbPoolMetricsService, workflowPublication: PrometheusWorkflowPublicationMetricsService, scheduler: PrometheusSchedulerMetricsService, pollTrigger: PrometheusPollTriggerMetricsService, encryption: PrometheusEncryptionMetricsService, systemTask: PrometheusSystemTaskMetricsService, memoryGuard: PrometheusMemoryGuardMetricsService, databaseIndependentRoutes: DatabaseIndependentRoutes);
     init(app: express.Application): void;
     private initCollectors;
     private mountMetricsEndpoint;