@n8n/expression-runtime 0.10.1 → 0.12.0

package/dist/cjs/evaluator/error-classification.d.ts

@@ -0,0 +1,3 @@
+export type ExpressionErrorType = 'timeout' | 'memory_limit' | 'security' | 'syntax' | 'unknown';
+export declare function classifyExpressionError(error: unknown): ExpressionErrorType;
+//# sourceMappingURL=error-classification.d.ts.map

package/dist/cjs/evaluator/error-classification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classification.d.ts","sourceRoot":"","sources":["../../../src/evaluator/error-classification.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,cAAc,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEjG,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAM3E"}

package/dist/cjs/evaluator/error-classification.js

@@ -0,0 +1,26 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "../types"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.classifyExpressionError = classifyExpressionError;
+    const types_1 = require("../types");
+    function classifyExpressionError(error) {
+        if (error instanceof types_1.TimeoutError)
+            return 'timeout';
+        if (error instanceof types_1.MemoryLimitError)
+            return 'memory_limit';
+        if (error instanceof types_1.SecurityViolationError)
+            return 'security';
+        if (error instanceof types_1.SyntaxError)
+            return 'syntax';
+        return 'unknown';
+    }
+});
+//# sourceMappingURL=error-classification.js.map

package/dist/cjs/evaluator/error-classification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classification.js","sourceRoot":"","sources":["../../../src/evaluator/error-classification.ts"],"names":[],"mappings":";;;;;;;;;;;IAIA,0DAMC;IAVD,oCAA+F;IAI/F,SAAgB,uBAAuB,CAAC,KAAc;QACrD,IAAI,KAAK,YAAY,oBAAY;YAAE,OAAO,SAAS,CAAC;QACpD,IAAI,KAAK,YAAY,wBAAgB;YAAE,OAAO,cAAc,CAAC;QAC7D,IAAI,KAAK,YAAY,8BAAsB;YAAE,OAAO,UAAU,CAAC;QAC/D,IAAI,KAAK,YAAY,mBAAW;YAAE,OAAO,QAAQ,CAAC;QAClD,OAAO,SAAS,CAAC;IAClB,CAAC"}

package/dist/cjs/evaluator/expression-evaluator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expression-evaluator.d.ts","sourceRoot":"","sources":["../../../src/evaluator/expression-evaluator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,eAAe,EAEf,MAAM,UAAU,CAAC;AAMlB,qBAAa,mBAAoB,YAAW,oBAAoB;IAC/D,OAAO,CAAC,MAAM,CAAkB;IAEhC,OAAO,CAAC,QAAQ,CAAS;IAGzB,OAAO,CAAC,UAAU,CAAC,CAAa;IAIhC,OAAO,CAAC,SAAS,CAA2B;IAE5C,OAAO,CAAC,IAAI,CAAc;IAE1B,OAAO,CAAC,eAAe,CAAwC;IAE/D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;gBAEhD,MAAM,EAAE,eAAe;IAsB7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5C,QAAQ,CACP,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO;IA0BV,OAAO,CAAC,SAAS;IAeX,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3C;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IA2BpB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,UAAU,IAAI,OAAO;CAGrB"}
+{"version":3,"file":"expression-evaluator.d.ts","sourceRoot":"","sources":["../../../src/evaluator/expression-evaluator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACX,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,eAAe,EAGf,MAAM,UAAU,CAAC;AAyBlB,qBAAa,mBAAoB,YAAW,oBAAoB;IAC/D,OAAO,CAAC,MAAM,CAAkB;IAEhC,OAAO,CAAC,QAAQ,CAAS;IAGzB,OAAO,CAAC,UAAU,CAAC,CAAa;IAIhC,OAAO,CAAC,SAAS,CAA2B;IAE5C,OAAO,CAAC,IAAI,CAAQ;IAEpB,OAAO,CAAC,eAAe,CAAwC;IAE/D,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;gBAEhD,MAAM,EAAE,eAAe;IA8B7B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5C,QAAQ,CACP,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,eAAe,GACvB,OAAO;IAuBV,OAAO,CAAC,SAAS;IAeX,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3C;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IA8BpB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,UAAU,IAAI,OAAO;CAGrB"}

package/dist/cjs/evaluator/expression-evaluator.js

@@ -4,7 +4,7 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "@n8n/tournament", "../types/bridge", "@n8n/errors", "../pool/isolate-pool", "./lru-cache"], factory);
+        define(["require", "exports", "@n8n/tournament", "../types/bridge", "@n8n/errors", "../pool/idle-scaling-pool", "../pool/isolate-pool", "../observability/metrics", "./error-classification", "./lru-cache"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -13,8 +13,21 @@
     const tournament_1 = require("@n8n/tournament");
     const bridge_1 = require("../types/bridge");
     const errors_1 = require("@n8n/errors");
+    const idle_scaling_pool_1 = require("../pool/idle-scaling-pool");
     const isolate_pool_1 = require("../pool/isolate-pool");
+    const metrics_1 = require("../observability/metrics");
+    const error_classification_1 = require("./error-classification");
     const lru_cache_1 = require("./lru-cache");
+    function recordOutcome(observability, start, status, error) {
+        if (!observability)
+            return;
+        const durationSeconds = (performance.now() - start) / 1000;
+        const errorType = error !== undefined ? (0, error_classification_1.classifyExpressionError)(error) : undefined;
+        observability.metrics.histogram(metrics_1.EXPRESSION_METRICS.evaluationDuration.name, durationSeconds, {
+            status,
+            type: errorType ?? 'none',
+        });
+    }
     class ExpressionEvaluator {
         config;
         disposed = false;
@@ -29,7 +42,7 @@
         constructor(config) {
             this.config = config;
             this.codeCache = new lru_cache_1.LruCache(config.maxCodeCacheSize, () => {
-                this.config.observability?.metrics.counter('expression.code_cache.eviction', 1);
+                this.config.observability?.metrics.counter(metrics_1.EXPRESSION_METRICS.codeCacheEviction.name, 1);
             });
             const logger = config.logger ?? bridge_1.DEFAULT_BRIDGE_CONFIG.logger;
             this.createBridge = async () => {
@@ -37,10 +50,14 @@
                 await bridge.initialize();
                 return bridge;
             };
-            this.pool = new isolate_pool_1.IsolatePool(this.createBridge, config.poolSize ?? 1, (error) => {
+            const onReplenishFailed = (error) => {
                 logger.error('[IsolatePool] Failed to replenish bridge', { error });
-                config.observability?.metrics.counter('expression.pool.replenish_failed', 1);
-            }, logger);
+                config.observability?.metrics.counter(metrics_1.EXPRESSION_METRICS.poolReplenishFailed.name, 1);
+            };
+            this.pool =
+                config.idleTimeoutMs === undefined
+                    ? new isolate_pool_1.IsolatePool(this.createBridge, config.poolSize ?? 1, onReplenishFailed, logger)
+                    : new idle_scaling_pool_1.IdleScalingPool(this.createBridge, config.poolSize ?? 1, config.idleTimeoutMs, onReplenishFailed, logger, config.observability);
         }
         async initialize() {
             await this.pool.initialize();
@@ -59,7 +76,7 @@
                     throw error;
                 bridge = await this.createBridge();
             }
-            this.config.observability?.metrics.counter('expression.pool.acquired', 1);
+            this.config.observability?.metrics.counter(metrics_1.EXPRESSION_METRICS.poolAcquired.name, 1);
             this.bridgesByCaller.set(caller, bridge);
         }
         evaluate(expression, data, caller, options) {
@@ -68,19 +85,17 @@
             const bridge = this.getBridge(caller);
             // Transform template expression → sanitized JavaScript (cached)
             const transformedCode = this.getTransformedCode(expression);
+            const { observability } = this.config;
+            const start = performance.now();
             try {
                 const result = bridge.execute(transformedCode, data, {
                     timezone: options?.timezone,
                 });
-                if (this.config.observability) {
-                    this.config.observability.metrics.counter('expression.evaluation.success', 1);
-                }
+                recordOutcome(observability, start, 'success');
                 return result;
             }
             catch (error) {
-                if (this.config.observability) {
-                    this.config.observability.metrics.counter('expression.evaluation.error', 1);
-                }
+                recordOutcome(observability, start, 'error', error);
                 throw error;
             }
         }
@@ -118,10 +133,10 @@
         getTransformedCode(expression) {
             const cached = this.codeCache.get(expression);
             if (cached !== undefined) {
-                this.config.observability?.metrics.counter('expression.code_cache.hit', 1);
+                this.config.observability?.metrics.counter(metrics_1.EXPRESSION_METRICS.codeCacheHit.name, 1);
                 return cached;
             }
-            this.config.observability?.metrics.counter('expression.code_cache.miss', 1);
+            this.config.observability?.metrics.counter(metrics_1.EXPRESSION_METRICS.codeCacheMiss.name, 1);
             if (!this.tournament) {
                 // Tournament requires an errorHandler but we only use getExpressionCode()
                 // for AST transformation — we never call tournament.execute(), so this
@@ -135,13 +150,13 @@
             }
             const [transformedCode] = this.tournament.getExpressionCode(expression);
             this.codeCache.set(expression, transformedCode);
-            this.config.observability?.metrics.gauge('expression.code_cache.size', this.codeCache.size);
+            this.config.observability?.metrics.gauge(metrics_1.EXPRESSION_METRICS.codeCacheSize.name, this.codeCache.size);
             return transformedCode;
         }
         async dispose() {
             this.disposed = true;
             this.codeCache.clear();
-            this.config.observability?.metrics.gauge('expression.code_cache.size', 0);
+            this.config.observability?.metrics.gauge(metrics_1.EXPRESSION_METRICS.codeCacheSize.name, 0);
             await this.pool.dispose();
         }
         isDisposed() {

package/dist/cjs/evaluator/expression-evaluator.js.map

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

package/dist/cjs/index.d.ts

@@ -3,6 +3,11 @@ export { IsolatedVmBridge } from './bridge/isolated-vm-bridge';
 export type { IExpressionEvaluator, EvaluatorConfig, WorkflowData, EvaluateOptions, ExecuteOptions, RuntimeBridge, BridgeConfig, Logger, ObservabilityProvider, MetricsAPI, TracesAPI, Span, LogsAPI, } from './types';
 export { ExpressionError, MemoryLimitError, TimeoutError, SecurityViolationError, SyntaxError, } from './types';
 export { IsolateError } from '@n8n/errors';
+export { NoOpProvider } from './observability/noop-provider';
+export { EXPRESSION_METRICS } from './observability/metrics';
+export type { ExpressionMetricDef, ExpressionMetricKey, MetricDef } from './observability/metrics';
+export { classifyExpressionError } from './evaluator/error-classification';
+export type { ExpressionErrorType } from './evaluator/error-classification';
 export { extend, extendOptional, EXTENSION_OBJECTS } from './extensions/extend';
 export { ExpressionExtensionError } from './extensions/expression-extension-error';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAIvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D,YAAY,EACX,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,MAAM,EACN,qBAAqB,EACrB,UAAU,EACV,SAAS,EACT,IAAI,EACJ,OAAO,GACP,MAAM,SAAS,CAAC;AAGjB,OAAO,EACN,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,sBAAsB,EACtB,WAAW,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAIvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D,YAAY,EACX,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,MAAM,EACN,qBAAqB,EACrB,UAAU,EACV,SAAS,EACT,IAAI,EACJ,OAAO,GACP,MAAM,SAAS,CAAC;AAGjB,OAAO,EACN,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,sBAAsB,EACtB,WAAW,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACnG,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,YAAY,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAG5E,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/cjs/index.js

@@ -4,12 +4,12 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "./evaluator/expression-evaluator", "./bridge/isolated-vm-bridge", "./types", "@n8n/errors", "./extensions/extend", "./extensions/expression-extension-error"], factory);
+        define(["require", "exports", "./evaluator/expression-evaluator", "./bridge/isolated-vm-bridge", "./types", "@n8n/errors", "./observability/noop-provider", "./observability/metrics", "./evaluator/error-classification", "./extensions/extend", "./extensions/expression-extension-error"], factory);
     }
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.ExpressionExtensionError = exports.EXTENSION_OBJECTS = exports.extendOptional = exports.extend = exports.IsolateError = exports.SyntaxError = exports.SecurityViolationError = exports.TimeoutError = exports.MemoryLimitError = exports.ExpressionError = exports.IsolatedVmBridge = exports.ExpressionEvaluator = void 0;
+    exports.ExpressionExtensionError = exports.EXTENSION_OBJECTS = exports.extendOptional = exports.extend = exports.classifyExpressionError = exports.EXPRESSION_METRICS = exports.NoOpProvider = exports.IsolateError = exports.SyntaxError = exports.SecurityViolationError = exports.TimeoutError = exports.MemoryLimitError = exports.ExpressionError = exports.IsolatedVmBridge = exports.ExpressionEvaluator = void 0;
     // Main exports
     var expression_evaluator_1 = require("./evaluator/expression-evaluator");
     Object.defineProperty(exports, "ExpressionEvaluator", { enumerable: true, get: function () { return expression_evaluator_1.ExpressionEvaluator; } });
@@ -26,6 +26,12 @@
     Object.defineProperty(exports, "SyntaxError", { enumerable: true, get: function () { return types_1.SyntaxError; } });
     var errors_1 = require("@n8n/errors");
     Object.defineProperty(exports, "IsolateError", { enumerable: true, get: function () { return errors_1.IsolateError; } });
+    var noop_provider_1 = require("./observability/noop-provider");
+    Object.defineProperty(exports, "NoOpProvider", { enumerable: true, get: function () { return noop_provider_1.NoOpProvider; } });
+    var metrics_1 = require("./observability/metrics");
+    Object.defineProperty(exports, "EXPRESSION_METRICS", { enumerable: true, get: function () { return metrics_1.EXPRESSION_METRICS; } });
+    var error_classification_1 = require("./evaluator/error-classification");
+    Object.defineProperty(exports, "classifyExpressionError", { enumerable: true, get: function () { return error_classification_1.classifyExpressionError; } });
     // Extension runtime exports
     var extend_1 = require("./extensions/extend");
     Object.defineProperty(exports, "extend", { enumerable: true, get: function () { return extend_1.extend; } });

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;IAAA,eAAe;IACf,yEAAuE;IAA9D,2HAAA,mBAAmB,OAAA;IAE5B,uEAAuE;IACvE,6EAA6E;IAC7E,kEAA+D;IAAtD,sHAAA,gBAAgB,OAAA;IAmBzB,cAAc;IACd,iCAMiB;IALhB,wGAAA,eAAe,OAAA;IACf,yGAAA,gBAAgB,OAAA;IAChB,qGAAA,YAAY,OAAA;IACZ,+GAAA,sBAAsB,OAAA;IACtB,oGAAA,WAAW,OAAA;IAEZ,sCAA2C;IAAlC,sGAAA,YAAY,OAAA;IAErB,4BAA4B;IAC5B,8CAAgF;IAAvE,gGAAA,MAAM,OAAA;IAAE,wGAAA,cAAc,OAAA;IAAE,2GAAA,iBAAiB,OAAA;IAClD,sFAAmF;IAA1E,sIAAA,wBAAwB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;IAAA,eAAe;IACf,yEAAuE;IAA9D,2HAAA,mBAAmB,OAAA;IAE5B,uEAAuE;IACvE,6EAA6E;IAC7E,kEAA+D;IAAtD,sHAAA,gBAAgB,OAAA;IAmBzB,cAAc;IACd,iCAMiB;IALhB,wGAAA,eAAe,OAAA;IACf,yGAAA,gBAAgB,OAAA;IAChB,qGAAA,YAAY,OAAA;IACZ,+GAAA,sBAAsB,OAAA;IACtB,oGAAA,WAAW,OAAA;IAEZ,sCAA2C;IAAlC,sGAAA,YAAY,OAAA;IAErB,+DAA6D;IAApD,6GAAA,YAAY,OAAA;IACrB,mDAA6D;IAApD,6GAAA,kBAAkB,OAAA;IAE3B,yEAA2E;IAAlE,+HAAA,uBAAuB,OAAA;IAGhC,4BAA4B;IAC5B,8CAAgF;IAAvE,gGAAA,MAAM,OAAA;IAAE,wGAAA,cAAc,OAAA;IAAE,2GAAA,iBAAiB,OAAA;IAClD,sFAAmF;IAA1E,sIAAA,wBAAwB,OAAA"}

package/dist/cjs/observability/metrics.d.ts

@@ -0,0 +1,65 @@
+export interface MetricDef {
+    name: string;
+    kind: 'counter' | 'gauge' | 'histogram';
+    labels: readonly string[];
+    help: string;
+}
+export declare const EXPRESSION_METRICS: {
+    readonly evaluationDuration: {
+        readonly name: "expression.evaluation.duration_seconds";
+        readonly kind: "histogram";
+        readonly labels: readonly ["status", "type"];
+        readonly help: "Duration of VM-based expression evaluation in seconds.";
+    };
+    readonly codeCacheHit: {
+        readonly name: "expression.code_cache.hit";
+        readonly kind: "counter";
+        readonly labels: readonly [];
+        readonly help: "Expression code cache hits.";
+    };
+    readonly codeCacheMiss: {
+        readonly name: "expression.code_cache.miss";
+        readonly kind: "counter";
+        readonly labels: readonly [];
+        readonly help: "Expression code cache misses.";
+    };
+    readonly codeCacheEviction: {
+        readonly name: "expression.code_cache.eviction";
+        readonly kind: "counter";
+        readonly labels: readonly [];
+        readonly help: "Expression code cache evictions.";
+    };
+    readonly codeCacheSize: {
+        readonly name: "expression.code_cache.size";
+        readonly kind: "gauge";
+        readonly labels: readonly [];
+        readonly help: "Current expression code cache size.";
+    };
+    readonly poolAcquired: {
+        readonly name: "expression.pool.acquired";
+        readonly kind: "counter";
+        readonly labels: readonly [];
+        readonly help: "Bridges acquired from the expression pool.";
+    };
+    readonly poolReplenishFailed: {
+        readonly name: "expression.pool.replenish_failed";
+        readonly kind: "counter";
+        readonly labels: readonly [];
+        readonly help: "Failed pool bridge replenishments.";
+    };
+    readonly poolScaledUp: {
+        readonly name: "expression.pool.scaled_up";
+        readonly kind: "counter";
+        readonly labels: readonly [];
+        readonly help: "Expression pool scaled up from idle.";
+    };
+    readonly poolScaledToZero: {
+        readonly name: "expression.pool.scaled_to_zero";
+        readonly kind: "counter";
+        readonly labels: readonly [];
+        readonly help: "Expression pool scaled to zero after inactivity.";
+    };
+};
+export type ExpressionMetricKey = keyof typeof EXPRESSION_METRICS;
+export type ExpressionMetricDef = (typeof EXPRESSION_METRICS)[ExpressionMetricKey];
+//# sourceMappingURL=metrics.d.ts.map

package/dist/cjs/observability/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/observability/metrics.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;IACxC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACb;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuDe,CAAC;AAE/C,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/cjs/observability/metrics.js

@@ -0,0 +1,70 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.EXPRESSION_METRICS = void 0;
+    exports.EXPRESSION_METRICS = {
+        evaluationDuration: {
+            name: 'expression.evaluation.duration_seconds',
+            kind: 'histogram',
+            labels: ['status', 'type'],
+            help: 'Duration of VM-based expression evaluation in seconds.',
+        },
+        codeCacheHit: {
+            name: 'expression.code_cache.hit',
+            kind: 'counter',
+            labels: [],
+            help: 'Expression code cache hits.',
+        },
+        codeCacheMiss: {
+            name: 'expression.code_cache.miss',
+            kind: 'counter',
+            labels: [],
+            help: 'Expression code cache misses.',
+        },
+        codeCacheEviction: {
+            name: 'expression.code_cache.eviction',
+            kind: 'counter',
+            labels: [],
+            help: 'Expression code cache evictions.',
+        },
+        codeCacheSize: {
+            name: 'expression.code_cache.size',
+            kind: 'gauge',
+            labels: [],
+            help: 'Current expression code cache size.',
+        },
+        poolAcquired: {
+            name: 'expression.pool.acquired',
+            kind: 'counter',
+            labels: [],
+            help: 'Bridges acquired from the expression pool.',
+        },
+        poolReplenishFailed: {
+            name: 'expression.pool.replenish_failed',
+            kind: 'counter',
+            labels: [],
+            help: 'Failed pool bridge replenishments.',
+        },
+        poolScaledUp: {
+            name: 'expression.pool.scaled_up',
+            kind: 'counter',
+            labels: [],
+            help: 'Expression pool scaled up from idle.',
+        },
+        poolScaledToZero: {
+            name: 'expression.pool.scaled_to_zero',
+            kind: 'counter',
+            labels: [],
+            help: 'Expression pool scaled to zero after inactivity.',
+        },
+    };
+});
+//# sourceMappingURL=metrics.js.map

package/dist/cjs/observability/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/observability/metrics.ts"],"names":[],"mappings":";;;;;;;;;;;;IAOa,QAAA,kBAAkB,GAAG;QACjC,kBAAkB,EAAE;YACnB,IAAI,EAAE,wCAAwC;YAC9C,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;YAC1B,IAAI,EAAE,wDAAwD;SAC9D;QACD,YAAY,EAAE;YACb,IAAI,EAAE,2BAA2B;YACjC,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,EAAE;YACV,IAAI,EAAE,6BAA6B;SACnC;QACD,aAAa,EAAE;YACd,IAAI,EAAE,4BAA4B;YAClC,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,EAAE;YACV,IAAI,EAAE,+BAA+B;SACrC;QACD,iBAAiB,EAAE;YAClB,IAAI,EAAE,gCAAgC;YACtC,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,EAAE;YACV,IAAI,EAAE,kCAAkC;SACxC;QACD,aAAa,EAAE;YACd,IAAI,EAAE,4BAA4B;YAClC,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,EAAE;YACV,IAAI,EAAE,qCAAqC;SAC3C;QACD,YAAY,EAAE;YACb,IAAI,EAAE,0BAA0B;YAChC,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,EAAE;YACV,IAAI,EAAE,4CAA4C;SAClD;QACD,mBAAmB,EAAE;YACpB,IAAI,EAAE,kCAAkC;YACxC,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,EAAE;YACV,IAAI,EAAE,oCAAoC;SAC1C;QACD,YAAY,EAAE;YACb,IAAI,EAAE,2BAA2B;YACjC,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,EAAE;YACV,IAAI,EAAE,sCAAsC;SAC5C;QACD,gBAAgB,EAAE;YACjB,IAAI,EAAE,gCAAgC;YACtC,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,EAAE;YACV,IAAI,EAAE,kDAAkD;SACxD;KAC4C,CAAC"}

package/dist/cjs/observability/noop-provider.d.ts

@@ -0,0 +1,3 @@
+import type { ObservabilityProvider } from '../types';
+export declare const NoOpProvider: ObservabilityProvider;
+//# sourceMappingURL=noop-provider.d.ts.map

package/dist/cjs/observability/noop-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-provider.d.ts","sourceRoot":"","sources":["../../../src/observability/noop-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAuB,qBAAqB,EAAmB,MAAM,UAAU,CAAC;AA0B5F,eAAO,MAAM,YAAY,EAAE,qBAI1B,CAAC"}

package/dist/cjs/observability/noop-provider.js

@@ -0,0 +1,39 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.NoOpProvider = void 0;
+    const noopSpan = {
+        setStatus() { },
+        setAttribute() { },
+        recordException() { },
+        end() { },
+    };
+    const noopMetrics = {
+        counter() { },
+        gauge() { },
+        histogram() { },
+    };
+    const noopTraces = {
+        startSpan: () => noopSpan,
+    };
+    const noopLogs = {
+        error() { },
+        warn() { },
+        info() { },
+        debug() { },
+    };
+    exports.NoOpProvider = {
+        metrics: noopMetrics,
+        traces: noopTraces,
+        logs: noopLogs,
+    };
+});
+//# sourceMappingURL=noop-provider.js.map

package/dist/cjs/observability/noop-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop-provider.js","sourceRoot":"","sources":["../../../src/observability/noop-provider.ts"],"names":[],"mappings":";;;;;;;;;;;;IAEA,MAAM,QAAQ,GAAS;QACtB,SAAS,KAAI,CAAC;QACd,YAAY,KAAI,CAAC;QACjB,eAAe,KAAI,CAAC;QACpB,GAAG,KAAI,CAAC;KACR,CAAC;IAEF,MAAM,WAAW,GAAe;QAC/B,OAAO,KAAI,CAAC;QACZ,KAAK,KAAI,CAAC;QACV,SAAS,KAAI,CAAC;KACd,CAAC;IAEF,MAAM,UAAU,GAAc;QAC7B,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ;KACzB,CAAC;IAEF,MAAM,QAAQ,GAAY;QACzB,KAAK,KAAI,CAAC;QACV,IAAI,KAAI,CAAC;QACT,IAAI,KAAI,CAAC;QACT,KAAK,KAAI,CAAC;KACV,CAAC;IAEW,QAAA,YAAY,GAA0B;QAClD,OAAO,EAAE,WAAW;QACpB,MAAM,EAAE,UAAU;QAClB,IAAI,EAAE,QAAQ;KACd,CAAC"}

package/dist/cjs/pool/idle-scaling-pool.d.ts

@@ -0,0 +1,35 @@
+import type { ObservabilityProvider, RuntimeBridge } from '../types';
+import type { Logger } from '../types/bridge';
+import type { IPool } from './isolate-pool';
+/**
+ * Wraps an `IsolatePool`, disposing it after a configured idle period and
+ * recreating it on the next acquire. The inner pool either fully exists or
+ * does not; callers never observe a partial state.
+ */
+export declare class IdleScalingPool implements IPool {
+    private readonly createBridge;
+    private readonly size;
+    private readonly idleTimeoutMs?;
+    private readonly onReplenishFailed?;
+    private readonly logger?;
+    private readonly observability?;
+    private innerPool;
+    private pendingScaleUp;
+    private pendingScaleDown;
+    private idleTimer?;
+    private disposed;
+    private disposePromise?;
+    constructor(createBridge: () => Promise<RuntimeBridge>, size: number, idleTimeoutMs?: number | undefined, onReplenishFailed?: ((error: unknown) => void) | undefined, logger?: Logger | undefined, observability?: ObservabilityProvider | undefined);
+    initialize(): Promise<void>;
+    acquire(): RuntimeBridge;
+    release(bridge: RuntimeBridge): Promise<void>;
+    dispose(): Promise<void>;
+    private doDispose;
+    waitForReplenishment(): Promise<void>;
+    private drainPendingTransitions;
+    private createInnerPool;
+    private resetIdleTimer;
+    private triggerScaleUp;
+    private triggerScaleDown;
+}
+//# sourceMappingURL=idle-scaling-pool.d.ts.map

package/dist/cjs/pool/idle-scaling-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle-scaling-pool.d.ts","sourceRoot":"","sources":["../../../src/pool/idle-scaling-pool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAG5C;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,KAAK;IAS3C,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IAbhC,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,SAAS,CAAC,CAAiB;IACnC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAC,CAAgB;gBAGrB,YAAY,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,EAC1C,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,MAAM,YAAA,EACtB,iBAAiB,CAAC,GAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,aAAA,EAC5C,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,aAAa,CAAC,EAAE,qBAAqB,YAAA;IAGjD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC,OAAO,IAAI,aAAa;IAUlB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAIhB,SAAS;IAcjB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;YAK7B,uBAAuB;IAUrC,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,gBAAgB;CAkBxB"}

package/dist/cjs/pool/idle-scaling-pool.js

@@ -0,0 +1,154 @@
+(function (factory) {
+    if (typeof module === "object" && typeof module.exports === "object") {
+        var v = factory(require, exports);
+        if (v !== undefined) module.exports = v;
+    }
+    else if (typeof define === "function" && define.amd) {
+        define(["require", "exports", "../observability/metrics", "./isolate-pool"], factory);
+    }
+})(function (require, exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", { value: true });
+    exports.IdleScalingPool = void 0;
+    const metrics_1 = require("../observability/metrics");
+    const isolate_pool_1 = require("./isolate-pool");
+    /**
+     * Wraps an `IsolatePool`, disposing it after a configured idle period and
+     * recreating it on the next acquire. The inner pool either fully exists or
+     * does not; callers never observe a partial state.
+     */
+    class IdleScalingPool {
+        createBridge;
+        size;
+        idleTimeoutMs;
+        onReplenishFailed;
+        logger;
+        observability;
+        innerPool = null;
+        pendingScaleUp = null;
+        pendingScaleDown = null;
+        idleTimer;
+        disposed = false;
+        disposePromise;
+        constructor(createBridge, size, idleTimeoutMs, onReplenishFailed, logger, observability) {
+            this.createBridge = createBridge;
+            this.size = size;
+            this.idleTimeoutMs = idleTimeoutMs;
+            this.onReplenishFailed = onReplenishFailed;
+            this.logger = logger;
+            this.observability = observability;
+        }
+        async initialize() {
+            this.innerPool = this.createInnerPool();
+            await this.innerPool.initialize();
+            this.resetIdleTimer();
+        }
+        acquire() {
+            if (this.disposed)
+                throw new isolate_pool_1.PoolDisposedError();
+            if (!this.innerPool) {
+                this.triggerScaleUp();
+                throw new isolate_pool_1.PoolExhaustedError();
+            }
+            this.resetIdleTimer();
+            return this.innerPool.acquire();
+        }
+        async release(bridge) {
+            if (this.innerPool && !this.disposed) {
+                // Pool is live: delegate so the inner pool disposes and replenishes.
+                await this.innerPool.release(bridge);
+            }
+            else if (!bridge.isDisposed()) {
+                // Pool is idle, disposed, or the bridge came from cold-start fallback:
+                // no pool to delegate to, just dispose to free the V8 isolate.
+                await bridge.dispose();
+            }
+        }
+        async dispose() {
+            return (this.disposePromise ??= this.doDispose());
+        }
+        async doDispose() {
+            this.disposed = true;
+            if (this.idleTimer) {
+                clearTimeout(this.idleTimer);
+                this.idleTimer = undefined;
+            }
+            await this.drainPendingTransitions();
+            if (this.innerPool) {
+                const toDispose = this.innerPool;
+                this.innerPool = null;
+                await toDispose.dispose();
+            }
+        }
+        async waitForReplenishment() {
+            await this.drainPendingTransitions();
+            if (this.innerPool)
+                await this.innerPool.waitForReplenishment();
+        }
+        async drainPendingTransitions() {
+            // Snapshot both fields before awaiting so a transition starting between reads
+            // can't be missed. Waits for transitions in flight now, not ones started later.
+            const promises = [];
+            if (this.pendingScaleUp)
+                promises.push(this.pendingScaleUp.catch(() => { }));
+            if (this.pendingScaleDown)
+                promises.push(this.pendingScaleDown.catch(() => { }));
+            await Promise.all(promises);
+        }
+        createInnerPool() {
+            return new isolate_pool_1.IsolatePool(this.createBridge, this.size, this.onReplenishFailed, this.logger);
+        }
+        resetIdleTimer() {
+            if (this.idleTimeoutMs === undefined)
+                return;
+            if (this.idleTimer)
+                clearTimeout(this.idleTimer);
+            this.idleTimer = setTimeout(() => this.triggerScaleDown(), this.idleTimeoutMs);
+            this.idleTimer.unref();
+        }
+        triggerScaleUp() {
+            if (this.pendingScaleUp || this.innerPool || this.disposed)
+                return;
+            this.logger?.info('[IdleScalingPool] Scaling up from idle');
+            this.observability?.metrics.counter(metrics_1.EXPRESSION_METRICS.poolScaledUp.name, 1);
+            const newInner = this.createInnerPool();
+            this.pendingScaleUp = newInner
+                .initialize()
+                .then(async () => {
+                if (this.disposed) {
+                    await newInner.dispose();
+                    return;
+                }
+                this.innerPool = newInner;
+                this.resetIdleTimer();
+            })
+                .catch(async (error) => {
+                this.logger?.error('[IdleScalingPool] Scale-up failed', { error });
+                await newInner.dispose().catch(() => { });
+            })
+                .finally(() => {
+                this.pendingScaleUp = null;
+            });
+        }
+        triggerScaleDown() {
+            if (this.pendingScaleDown || this.pendingScaleUp || !this.innerPool || this.disposed)
+                return;
+            this.logger?.info('[IdleScalingPool] Scaling to 0 after inactivity', {
+                idleTimeoutMs: this.idleTimeoutMs,
+            });
+            this.observability?.metrics.counter(metrics_1.EXPRESSION_METRICS.poolScaledToZero.name, 1);
+            const oldInner = this.innerPool;
+            this.innerPool = null;
+            this.pendingScaleDown = oldInner
+                .dispose()
+                .catch((error) => {
+                this.logger?.error('[IdleScalingPool] Scale-down dispose failed', { error });
+            })
+                .finally(() => {
+                this.pendingScaleDown = null;
+            });
+        }
+    }
+    exports.IdleScalingPool = IdleScalingPool;
+});
+//# sourceMappingURL=idle-scaling-pool.js.map