callman-core 1.25.1 → 1.26.0

package/dist-cjs/scenario-runner/boundSnapshot.js

@@ -0,0 +1,71 @@
+"use strict";
+// Size-capped deep copy of a runtime value for event context snapshots
+// (`RunScenarioOptions.eventContextMode: "bounded"`).
+//
+// The caps are deliberately LOOSER than the backend report mapper's persist-
+// time truncation (16 KB strings / 50 array items / 50 keys / depth 6), so
+// everything the mapper keeps is still present verbatim after bounding —
+// the persisted report is byte-identical whether bounding ran or not. What
+// changes is what stays in the HEAP while the run is in flight: a bounded
+// snapshot never holds a reference to a multi-megabyte response body.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.boundSnapshot = exports.DEFAULT_BOUND_SNAPSHOT_LIMITS = void 0;
+exports.DEFAULT_BOUND_SNAPSHOT_LIMITS = {
+    maxStringLength: 32 * 1024,
+    maxArrayItems: 100,
+    maxObjectKeys: 100,
+    maxDepth: 8,
+};
+const TRUNCATED = "…[truncated]";
+const boundValueAt = (value, depth, limits) => {
+    if (value === null || value === undefined)
+        return value;
+    switch (typeof value) {
+        case "string":
+            return value.length > limits.maxStringLength
+                ? `${value.slice(0, limits.maxStringLength)}${TRUNCATED}`
+                : value;
+        case "number":
+        case "boolean":
+            return value;
+        case "bigint":
+            return value.toString();
+        case "function":
+        case "symbol":
+            return undefined;
+        default:
+            break;
+    }
+    if (value instanceof Date)
+        return new Date(value.getTime());
+    if (depth >= limits.maxDepth)
+        return TRUNCATED;
+    if (Array.isArray(value)) {
+        const kept = value.slice(0, limits.maxArrayItems).map((item) => boundValueAt(item, depth + 1, limits));
+        return kept;
+    }
+    if (typeof value.toJSON === "function") {
+        return boundValueAt(value.toJSON(), depth, limits);
+    }
+    const out = {};
+    let count = 0;
+    for (const [key, entry] of Object.entries(value)) {
+        if (count >= limits.maxObjectKeys)
+            break;
+        const bounded = boundValueAt(entry, depth + 1, limits);
+        if (bounded !== undefined) {
+            out[key] = bounded;
+            count += 1;
+        }
+    }
+    return out;
+};
+/**
+ * Returns a bounded deep copy of `value`. `undefined` and `null` pass
+ * through unchanged; typed callers cast the result back to their shape —
+ * bounding never changes the top-level structure, only trims what is nested
+ * inside it.
+ */
+const boundSnapshot = (value, limits = exports.DEFAULT_BOUND_SNAPSHOT_LIMITS) => (value === null || value === undefined ? value : boundValueAt(value, 0, limits));
+exports.boundSnapshot = boundSnapshot;
+//# sourceMappingURL=boundSnapshot.js.map

package/dist-cjs/scenario-runner/boundSnapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundSnapshot.js","sourceRoot":"","sources":["../../src/scenario-runner/boundSnapshot.ts"],"names":[],"mappings":";AAAA,uEAAuE;AACvE,sDAAsD;AACtD,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,yEAAyE;AACzE,2EAA2E;AAC3E,0EAA0E;AAC1E,sEAAsE;;;AASzD,QAAA,6BAA6B,GAAwB;IAChE,eAAe,EAAE,EAAE,GAAG,IAAI;IAC1B,aAAa,EAAE,GAAG;IAClB,aAAa,EAAE,GAAG;IAClB,QAAQ,EAAE,CAAC;CACZ,CAAC;AAEF,MAAM,SAAS,GAAG,cAAc,CAAC;AAEjC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAE,KAAa,EAAE,MAA2B,EAAW,EAAE;IAC3F,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxD,QAAQ,OAAO,KAAK,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,eAAe;gBAC1C,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,eAAe,CAAC,GAAG,SAAS,EAAE;gBACzD,CAAC,CAAC,KAAK,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC1B,KAAK,UAAU,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,SAAS,CAAC;QACnB;YACE,MAAM;IACV,CAAC;IACD,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5D,IAAI,KAAK,IAAI,MAAM,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACvG,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAQ,KAA8B,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QACjE,OAAO,YAAY,CAAE,KAAmC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;QAC5E,IAAI,KAAK,IAAI,MAAM,CAAC,aAAa;YAAE,MAAM;QACzC,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;QACvD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;YACnB,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF;;;;;GAKG;AACI,MAAM,aAAa,GAAG,CAC3B,KAAQ,EACR,SAA8B,qCAA6B,EACxD,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,YAAY,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAO,CAAC,CAAC;AAHnF,QAAA,aAAa,iBAGsE"}

package/dist-cjs/scenario-runner/runScenario.js

@@ -7,6 +7,7 @@ const assertion_js_1 = require("./assertion.js");
 const graphTraversal_js_1 = require("./graphTraversal.js");
 const websocket_js_1 = require("./websocket.js");
 const executionPolicyRunner_js_1 = require("./executionPolicyRunner.js");
+const boundSnapshot_js_1 = require("./boundSnapshot.js");
 const nodePolicy_js_1 = require("./nodePolicy.js");
 const templateResolver_js_1 = require("./templateResolver.js");
 const waitNodeExecutor_js_1 = require("./waitNodeExecutor.js");
@@ -113,19 +114,24 @@ const createInputSnapshot = (context) => ({
         result: context.redisResult ?? null,
     },
 });
-const createContextSnapshot = (context) => ({
-    environment: { ...context.environment },
-    globals: { ...context.globals },
-    workflowContext: { ...context.workflowContext },
-    nodeMetaByLabel: cloneNodeMetaByLabel(context.nodeMetaByLabel),
-    workflowMeta: cloneWorkflowExecutionMeta(context.workflowMeta),
-    responseRoot: context.responseRoot ? { ...context.responseRoot } : null,
-    lastResponse: context.lastResponse,
-    dbResult: context.dbResult,
-    kafkaEvent: context.kafkaEvent,
-    kafkaCapture: context.kafkaCapture,
-    redisResult: context.redisResult,
-});
+const createContextSnapshot = (context, mode = "full") => {
+    // "bounded": the payload-bearing slots are size-capped copies instead of
+    // references, so the event log never pins a node's full response body.
+    const bound = mode === "bounded" ? boundSnapshot_js_1.boundSnapshot : (value) => value;
+    return {
+        environment: { ...context.environment },
+        globals: { ...context.globals },
+        workflowContext: bound({ ...context.workflowContext }),
+        nodeMetaByLabel: cloneNodeMetaByLabel(context.nodeMetaByLabel),
+        workflowMeta: cloneWorkflowExecutionMeta(context.workflowMeta),
+        responseRoot: context.responseRoot ? bound({ ...context.responseRoot }) : null,
+        lastResponse: bound(context.lastResponse),
+        dbResult: bound(context.dbResult),
+        kafkaEvent: bound(context.kafkaEvent),
+        kafkaCapture: bound(context.kafkaCapture),
+        redisResult: bound(context.redisResult),
+    };
+};
 const buildKafkaEventValue = (message) => {
     const fallbackValue = {
         value: message.valueJson ?? message.valueText,
@@ -560,7 +566,7 @@ const callHandler = async (handlers, event) => {
             return;
     }
 };
-const runScenario = async ({ scenario, environment = {}, globals = {}, runtimeAdapters, eventHandlers, signal, minNodeVisualStateMs = DEFAULT_MIN_NODE_VISUAL_STATE_MS, }) => {
+const runScenario = async ({ scenario, environment = {}, globals = {}, runtimeAdapters, eventHandlers, signal, minNodeVisualStateMs = DEFAULT_MIN_NODE_VISUAL_STATE_MS, eventContextMode = "full", }) => {
     const runId = createRunId();
     const startedAtMs = Date.now();
     const startedAt = new Date(startedAtMs).toISOString();
@@ -571,6 +577,9 @@ const runScenario = async ({ scenario, environment = {}, globals = {}, runtimeAd
     const localStatuses = new Map(runtimeStepIds.map((stepId) => [stepId, "idle"]));
     const records = new Map();
     const events = [];
+    // Every emitted event carries a context snapshot; `runtimeContext` is
+    // assigned just below and is always initialised before the first emit.
+    const snapshotContext = () => createContextSnapshot(runtimeContext, eventContextMode);
     const initialWorkflowMeta = createInitialWorkflowMeta({
         startedAt,
         totalNodes: runtimeStepIds.length,
@@ -980,7 +989,7 @@ const runScenario = async ({ scenario, environment = {}, globals = {}, runtimeAd
                         runId,
                         stepId,
                         node,
-                        context: createContextSnapshot(runtimeContext),
+                        context: snapshotContext(),
                         kafkaCapturePlans,
                         captureFromTimestampMs: startedAtMs,
                         signal,
@@ -1041,7 +1050,7 @@ const runScenario = async ({ scenario, environment = {}, globals = {}, runtimeAd
                                 },
                             }
                             : {}),
-                        context: createContextSnapshot(runtimeContext),
+                        context: snapshotContext(),
                         signal,
                     });
                     runtimeContext.dbResult = dbResult.dbResult;
@@ -1074,7 +1083,7 @@ const runScenario = async ({ scenario, environment = {}, globals = {}, runtimeAd
                         runId,
                         stepId,
                         node,
-                        context: createContextSnapshot(runtimeContext),
+                        context: snapshotContext(),
                         signal,
                     });
                     scriptSource = scriptResult.scriptSource;
@@ -1098,7 +1107,7 @@ const runScenario = async ({ scenario, environment = {}, globals = {}, runtimeAd
                         stepId,
                         node,
                         resolvedCommands,
-                        context: createContextSnapshot(runtimeContext),
+                        context: snapshotContext(),
                         signal,
                     });
                     runtimeContext.redisResult = redisResult.redisResult;
@@ -1150,7 +1159,7 @@ const runScenario = async ({ scenario, environment = {}, globals = {}, runtimeAd
                                     position: node.position,
                                     data: { label: node.data.label, config: pollConfig.request },
                                 },
-                                context: createContextSnapshot(runtimeContext),
+                                context: snapshotContext(),
                                 kafkaCapturePlans: [],
                                 captureFromTimestampMs: startedAtMs,
                                 signal,
@@ -1190,7 +1199,7 @@ const runScenario = async ({ scenario, environment = {}, globals = {}, runtimeAd
                                 },
                                 resolvedQuery,
                                 resolvedParams,
-                                context: createContextSnapshot(runtimeContext),
+                                context: snapshotContext(),
                                 signal,
                             });
                             runtimeContext.dbResult = tickResult.dbResult;
@@ -1213,7 +1222,7 @@ const runScenario = async ({ scenario, environment = {}, globals = {}, runtimeAd
                                     data: { label: node.data.label, config: pollConfig.redis },
                                 },
                                 resolvedCommands,
-                                context: createContextSnapshot(runtimeContext),
+                                context: snapshotContext(),
                                 signal,
                             });
                             runtimeContext.redisResult = tickResult.redisResult;
@@ -1231,7 +1240,7 @@ const runScenario = async ({ scenario, environment = {}, globals = {}, runtimeAd
                                 position: node.position,
                                 data: { label: node.data.label, config: pollConfig.script },
                             },
-                            context: createContextSnapshot(runtimeContext),
+                            context: snapshotContext(),
                             signal,
                         });
                         scriptSource = tickResult.scriptSource;
@@ -1354,7 +1363,7 @@ const runScenario = async ({ scenario, environment = {}, globals = {}, runtimeAd
                         runId,
                         stepId,
                         node,
-                        context: createContextSnapshot(runtimeContext),
+                        context: snapshotContext(),
                         deliveryRequest,
                         signal,
                     });
@@ -1650,7 +1659,7 @@ const runScenario = async ({ scenario, environment = {}, globals = {}, runtimeAd
                         runId,
                         stepId,
                         node,
-                        context: createContextSnapshot(runtimeContext),
+                        context: snapshotContext(),
                         signal,
                     });
                     throwIfStopped(signal);
@@ -2642,7 +2651,7 @@ const runScenario = async ({ scenario, environment = {}, globals = {}, runtimeAd
         durationMs: Date.now() - startedAtMs,
         totalSteps: runtimeStepIds.length,
         completedSteps: Array.from(localStatuses.values()).filter(isTerminalStatus).length,
-        context: createContextSnapshot(runtimeContext),
+        context: snapshotContext(),
         workflowMeta: cloneWorkflowExecutionMeta(finalWorkflowMeta),
         nodeExecutions: runtimeStepIds.map((stepId) => {
             const descriptor = runtimeStepDescriptors.find((entry) => entry.stepId === stepId);