callman-core 1.25.0 → 1.26.0

package/dist/scenario-runner/boundSnapshot.js

@@ -0,0 +1,67 @@
+// 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.
+export const 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.
+ */
+export const boundSnapshot = (value, limits = DEFAULT_BOUND_SNAPSHOT_LIMITS) => (value === null || value === undefined ? value : boundValueAt(value, 0, limits));
+//# sourceMappingURL=boundSnapshot.js.map

package/dist/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;AAStE,MAAM,CAAC,MAAM,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;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,KAAQ,EACR,SAA8B,6BAA6B,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"}

package/dist/scenario-runner/runScenario.d.ts

@@ -1,3 +1,3 @@
 import type { RunScenarioOptions, ScenarioRunReport } from "./types.js";
-export declare const runScenario: ({ scenario, environment, globals, runtimeAdapters, eventHandlers, signal, minNodeVisualStateMs, }: RunScenarioOptions) => Promise<ScenarioRunReport>;
+export declare const runScenario: ({ scenario, environment, globals, runtimeAdapters, eventHandlers, signal, minNodeVisualStateMs, eventContextMode, }: RunScenarioOptions) => Promise<ScenarioRunReport>;
 //# sourceMappingURL=runScenario.d.ts.map

package/dist/scenario-runner/runScenario.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runScenario.d.ts","sourceRoot":"","sources":["../../src/scenario-runner/runScenario.ts"],"names":[],"mappings":"AAyDA,OAAO,KAAK,EAMV,kBAAkB,EAUlB,iBAAiB,EAKlB,MAAM,YAAY,CAAC;AA2uBpB,eAAO,MAAM,WAAW,GAAU,mGAQ/B,kBAAkB,KAAG,OAAO,CAAC,iBAAiB,CAs/EhD,CAAC"}
+{"version":3,"file":"runScenario.d.ts","sourceRoot":"","sources":["../../src/scenario-runner/runScenario.ts"],"names":[],"mappings":"AA2DA,OAAO,KAAK,EAMV,kBAAkB,EAUlB,iBAAiB,EAKlB,MAAM,YAAY,CAAC;AAmvBpB,eAAO,MAAM,WAAW,GAAU,qHAS/B,kBAAkB,KAAG,OAAO,CAAC,iBAAiB,CAggFhD,CAAC"}

package/dist/scenario-runner/runScenario.js

@@ -4,6 +4,7 @@ import { evaluateAssertionConfig, validateAssertionConfig, } from "./assertion.j
 import { createSubScenarioStepId, buildRuntimeStepDescriptors, DEFAULT_END_LOOP_DELAY_MS, DEFAULT_END_LOOP_ITERATIONS, flattenScenarioNodesForContext, MAX_END_LOOP_ITERATIONS, DEFAULT_POLL_INTERVAL_MS, DEFAULT_POLL_MAX_ATTEMPTS, MAX_POLL_ATTEMPTS, DEFAULT_FOREACH_MAX_ITERATIONS, MAX_FOREACH_ITERATIONS, DEFAULT_WS_CONNECT_TIMEOUT_MS, MAX_WS_CONNECT_TIMEOUT_MS, DEFAULT_WS_EXPECT_TIMEOUT_MS, MAX_WS_EXPECT_TIMEOUT_MS, MAX_WS_WAIT_DURATION_MS, MAX_WS_STEPS, DEFAULT_WS_CLOSE_CODE, } from "./graphTraversal.js";
 import { evaluateWebsocketExpect } from "./websocket.js";
 import { executeWithScenarioNodePolicy } from "./executionPolicyRunner.js";
+import { boundSnapshot } from "./boundSnapshot.js";
 import { getLegacyScenarioNodeExecutionPolicy, getScenarioNodeExecutionPolicy, supportsScenarioNodeExecutionPolicy, } from "./nodePolicy.js";
 import { buildScenarioExecutionGraph, buildScenarioTemplateValues, collectExclusiveBranchNodeIds, evaluateScenarioExpression, resolveScenarioJsonTemplateString, resolveScenarioTemplateString, } from "./templateResolver.js";
 import { executeWaitNode, ScenarioWaitNodeCancelledError, ScenarioWaitNodeValidationError, } from "./waitNodeExecutor.js";
@@ -110,19 +111,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 : (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,
@@ -311,6 +317,7 @@ const createStepExecutionRecord = ({ stepId, stepType, title, }) => ({
     errors: [],
     durationMs: null,
     statusCode: null,
+    statusExpectation: null,
     errorMessage: null,
     response: null,
     testResults: [],
@@ -487,6 +494,7 @@ const updateRecordFromEvent = (records, event) => {
         errors: event.errors ?? current.errors,
         durationMs: event.durationMs ?? current.durationMs,
         statusCode: event.statusCode ?? current.statusCode,
+        statusExpectation: event.statusExpectation ?? current.statusExpectation,
         errorMessage: event.type === "step:fail"
             ? event.errorMessage
             : current.errorMessage,
@@ -555,7 +563,7 @@ const callHandler = async (handlers, event) => {
             return;
     }
 };
-export const runScenario = async ({ scenario, environment = {}, globals = {}, runtimeAdapters, eventHandlers, signal, minNodeVisualStateMs = DEFAULT_MIN_NODE_VISUAL_STATE_MS, }) => {
+export 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();
@@ -566,6 +574,9 @@ export const runScenario = async ({ scenario, environment = {}, globals = {}, ru
     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,
@@ -861,6 +872,7 @@ export const runScenario = async ({ scenario, environment = {}, globals = {}, ru
         const executionStartedAtMs = Date.now();
         let inputData = createInputSnapshot(runtimeContext);
         let statusCode = null;
+        let statusExpectation = null;
         let response = null;
         let outputData = null;
         let testResults = [];
@@ -974,7 +986,7 @@ export const runScenario = async ({ scenario, environment = {}, globals = {}, ru
                         runId,
                         stepId,
                         node,
-                        context: createContextSnapshot(runtimeContext),
+                        context: snapshotContext(),
                         kafkaCapturePlans,
                         captureFromTimestampMs: startedAtMs,
                         signal,
@@ -988,6 +1000,7 @@ export const runScenario = async ({ scenario, environment = {}, globals = {}, ru
                     runtimeContext.responseRoot = requestResult.responseRoot;
                     response = requestResult.response;
                     statusCode = requestResult.response.status;
+                    statusExpectation = requestResult.statusExpectation ?? null;
                     outputData = requestResult.outputData;
                     testResults = requestResult.testResults;
                     contractResults = requestResult.contractResults;
@@ -1034,7 +1047,7 @@ export const runScenario = async ({ scenario, environment = {}, globals = {}, ru
                                 },
                             }
                             : {}),
-                        context: createContextSnapshot(runtimeContext),
+                        context: snapshotContext(),
                         signal,
                     });
                     runtimeContext.dbResult = dbResult.dbResult;
@@ -1067,7 +1080,7 @@ export const runScenario = async ({ scenario, environment = {}, globals = {}, ru
                         runId,
                         stepId,
                         node,
-                        context: createContextSnapshot(runtimeContext),
+                        context: snapshotContext(),
                         signal,
                     });
                     scriptSource = scriptResult.scriptSource;
@@ -1091,7 +1104,7 @@ export const runScenario = async ({ scenario, environment = {}, globals = {}, ru
                         stepId,
                         node,
                         resolvedCommands,
-                        context: createContextSnapshot(runtimeContext),
+                        context: snapshotContext(),
                         signal,
                     });
                     runtimeContext.redisResult = redisResult.redisResult;
@@ -1143,7 +1156,7 @@ export const runScenario = async ({ scenario, environment = {}, globals = {}, ru
                                     position: node.position,
                                     data: { label: node.data.label, config: pollConfig.request },
                                 },
-                                context: createContextSnapshot(runtimeContext),
+                                context: snapshotContext(),
                                 kafkaCapturePlans: [],
                                 captureFromTimestampMs: startedAtMs,
                                 signal,
@@ -1157,6 +1170,7 @@ export const runScenario = async ({ scenario, environment = {}, globals = {}, ru
                             runtimeContext.responseRoot = tickResult.responseRoot;
                             response = tickResult.response;
                             statusCode = tickResult.response.status;
+                            statusExpectation = tickResult.statusExpectation ?? null;
                             testResults = tickResult.testResults;
                             contractResults = tickResult.contractResults;
                             contractSummary = tickResult.contractSummary;
@@ -1182,7 +1196,7 @@ export const runScenario = async ({ scenario, environment = {}, globals = {}, ru
                                 },
                                 resolvedQuery,
                                 resolvedParams,
-                                context: createContextSnapshot(runtimeContext),
+                                context: snapshotContext(),
                                 signal,
                             });
                             runtimeContext.dbResult = tickResult.dbResult;
@@ -1205,7 +1219,7 @@ export const runScenario = async ({ scenario, environment = {}, globals = {}, ru
                                     data: { label: node.data.label, config: pollConfig.redis },
                                 },
                                 resolvedCommands,
-                                context: createContextSnapshot(runtimeContext),
+                                context: snapshotContext(),
                                 signal,
                             });
                             runtimeContext.redisResult = tickResult.redisResult;
@@ -1223,7 +1237,7 @@ export const runScenario = async ({ scenario, environment = {}, globals = {}, ru
                                 position: node.position,
                                 data: { label: node.data.label, config: pollConfig.script },
                             },
-                            context: createContextSnapshot(runtimeContext),
+                            context: snapshotContext(),
                             signal,
                         });
                         scriptSource = tickResult.scriptSource;
@@ -1346,7 +1360,7 @@ export const runScenario = async ({ scenario, environment = {}, globals = {}, ru
                         runId,
                         stepId,
                         node,
-                        context: createContextSnapshot(runtimeContext),
+                        context: snapshotContext(),
                         deliveryRequest,
                         signal,
                     });
@@ -1642,7 +1656,7 @@ export const runScenario = async ({ scenario, environment = {}, globals = {}, ru
                         runId,
                         stepId,
                         node,
-                        context: createContextSnapshot(runtimeContext),
+                        context: snapshotContext(),
                         signal,
                     });
                     throwIfStopped(signal);
@@ -2212,6 +2226,7 @@ export const runScenario = async ({ scenario, environment = {}, globals = {}, ru
                     errorMessage: policyResult.finalErrorMessage ?? "Scenario node failed",
                     durationMs,
                     statusCode,
+                    statusExpectation,
                     response,
                     testResults,
                     contractResults,
@@ -2294,6 +2309,7 @@ export const runScenario = async ({ scenario, environment = {}, globals = {}, ru
                         "Scenario node failed but execution continued.",
                     durationMs,
                     statusCode,
+                    statusExpectation,
                     response,
                     testResults,
                     contractResults,
@@ -2371,6 +2387,7 @@ export const runScenario = async ({ scenario, environment = {}, globals = {}, ru
                     nodeMeta,
                     durationMs,
                     statusCode,
+                    statusExpectation,
                     response,
                     testResults,
                     contractResults,
@@ -2631,7 +2648,7 @@ export const runScenario = async ({ scenario, environment = {}, globals = {}, ru
         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);