mcpgraph 0.1.15 → 0.1.17

package/dist/expressions/json-logic.js

@@ -5,19 +5,22 @@
 import jsonLogic from "json-logic-js";
 import jsonata from "jsonata";
 import { logger } from "../logger.js";
+import { registerHistoryFunctions } from "./jsonata-extensions.js";
+import { validateJsonataSyntax } from "./jsonata.js";
 /**
  * Evaluate a JSON Logic rule with the given context data
  * @param rule - JSON Logic rule (can be any valid JSON Logic structure)
  * @param context - Context data object to evaluate the rule against
- * @param previousNodeId - Optional previous node ID for $previousNode() support
+ * @param history - Execution history for history functions
+ * @param currentIndex - Current execution index for history functions
  * @returns Boolean result of the rule evaluation
  */
-export async function evaluateJsonLogic(rule, context, previousNodeId) {
+export async function evaluateJsonLogic(rule, context, history, currentIndex) {
     try {
         logger.debug(`Evaluating JSON Logic rule: ${JSON.stringify(rule)}`);
         logger.debug(`Context keys: ${Object.keys(context).join(", ")}`);
         // Pre-process the rule: replace all var operations with their JSONata-evaluated values
-        const processedRule = await preprocessJsonLogicRule(rule, context, previousNodeId);
+        const processedRule = await preprocessJsonLogicRule(rule, context, history, currentIndex);
         // Now apply the processed rule (all var operations have been replaced with values)
         const result = jsonLogic.apply(processedRule, context);
         logger.debug(`JSON Logic result: ${result}`);
@@ -25,28 +28,47 @@ export async function evaluateJsonLogic(rule, context, previousNodeId) {
         return Boolean(result);
     }
     catch (error) {
-        logger.error(`JSON Logic evaluation error: ${error instanceof Error ? error.message : String(error)}`);
-        throw new Error(`Failed to evaluate JSON Logic rule: ${error instanceof Error ? error.message : String(error)}`);
+        // Extract detailed error message
+        let errorMessage;
+        if (error instanceof Error) {
+            errorMessage = error.message || error.toString();
+            if (errorMessage === '[object Object]' || !errorMessage) {
+                errorMessage = error.toString();
+                if (error.stack) {
+                    errorMessage = error.stack.split('\n')[0] || errorMessage;
+                }
+            }
+        }
+        else if (error && typeof error === 'object') {
+            const errorObj = error;
+            if (errorObj.message && typeof errorObj.message === 'string') {
+                errorMessage = errorObj.message;
+            }
+            else {
+                errorMessage = JSON.stringify(error, null, 2);
+            }
+        }
+        else {
+            errorMessage = String(error);
+        }
+        logger.error(`JSON Logic evaluation error: ${errorMessage}`);
+        logger.error(`Rule: ${JSON.stringify(rule, null, 2)}`);
+        logger.error(`Context keys: ${Object.keys(context).join(', ')}`);
+        throw new Error(`JSON Logic evaluation failed: ${errorMessage}\nRule: ${JSON.stringify(rule, null, 2)}`);
     }
 }
 /**
  * Recursively pre-process JSON Logic rule, replacing var operations with JSONata-evaluated values
  */
-async function preprocessJsonLogicRule(rule, context, previousNodeId) {
+async function preprocessJsonLogicRule(rule, context, history, currentIndex) {
     // If rule is a var operation, evaluate it with JSONata and return the value
     if (typeof rule === "object" && rule !== null && "var" in rule && Object.keys(rule).length === 1) {
         const path = rule.var;
         logger.debug(`Evaluating var operation: "${path}" as JSONata expression`);
         try {
             const expr = jsonata(path);
-            // Register $previousNode() function if previousNodeId is provided
-            if (previousNodeId) {
-                expr.registerFunction("previousNode", () => {
-                    const previousOutput = context[previousNodeId];
-                    logger.debug(`$previousNode() returning output from node: ${previousNodeId}`);
-                    return previousOutput !== undefined ? previousOutput : null;
-                }, "<:o>");
-            }
+            // Register history access functions
+            registerHistoryFunctions(expr, history, currentIndex);
             const result = await expr.evaluate(context);
             logger.debug(`JSONata evaluation result: ${JSON.stringify(result)}`);
             return result;
@@ -58,17 +80,77 @@ async function preprocessJsonLogicRule(rule, context, previousNodeId) {
     }
     // If rule is an array, recursively process each element
     if (Array.isArray(rule)) {
-        return Promise.all(rule.map(item => preprocessJsonLogicRule(item, context, previousNodeId)));
+        return Promise.all(rule.map(item => preprocessJsonLogicRule(item, context, history, currentIndex)));
     }
     // If rule is an object, recursively process each property
     if (typeof rule === "object" && rule !== null) {
         const result = {};
         for (const [key, value] of Object.entries(rule)) {
-            result[key] = await preprocessJsonLogicRule(value, context, previousNodeId);
+            result[key] = await preprocessJsonLogicRule(value, context, history, currentIndex);
         }
         return result;
     }
     // Primitive value, return as-is
     return rule;
 }
+/**
+ * Validate JSON Logic rule syntax without evaluating it
+ * Validates rule structure and any JSONata expressions in var operations
+ * @param rule - JSON Logic rule to validate
+ * @throws Error if syntax is invalid
+ */
+export function validateJsonLogicSyntax(rule) {
+    try {
+        validateJsonLogicRuleRecursive(rule);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw error;
+        }
+        throw new Error(`Invalid JSON Logic syntax: ${String(error)}`);
+    }
+}
+/**
+ * Recursively validate JSON Logic rule structure and JSONata in var operations
+ */
+function validateJsonLogicRuleRecursive(rule) {
+    // If rule is a var operation, validate the JSONata expression
+    if (typeof rule === "object" && rule !== null && "var" in rule && Object.keys(rule).length === 1) {
+        const path = rule.var;
+        if (typeof path !== "string") {
+            throw new Error(`JSON Logic var operation must have a string value, got ${typeof path}`);
+        }
+        // If the var value looks like a JSONata expression (starts with $), validate it
+        if (path.startsWith("$")) {
+            try {
+                validateJsonataSyntax(path);
+            }
+            catch (error) {
+                if (error instanceof Error) {
+                    throw new Error(`Invalid JSONata in JSON Logic var operation "${path}": ${error.message}`);
+                }
+                throw error;
+            }
+        }
+        // If it's not a JSONata expression, it's just a path reference (valid)
+        return;
+    }
+    // If rule is an array, recursively validate each element
+    if (Array.isArray(rule)) {
+        for (const item of rule) {
+            validateJsonLogicRuleRecursive(item);
+        }
+        return;
+    }
+    // If rule is an object, recursively validate each property
+    if (typeof rule === "object" && rule !== null) {
+        for (const value of Object.values(rule)) {
+            validateJsonLogicRuleRecursive(value);
+        }
+        return;
+    }
+    // Primitive values are valid
+    // Note: We can't fully validate JSON Logic operators without context,
+    // but we've validated the structure and any JSONata expressions
+}
 //# sourceMappingURL=json-logic.js.map

package/dist/expressions/json-logic.js.map

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

package/dist/expressions/jsonata-extensions.d.ts

@@ -0,0 +1,10 @@
+/**
+ * JSONata extensions for execution history access
+ */
+import jsonata from "jsonata";
+import type { NodeExecutionRecord } from "../types/execution.js";
+/**
+ * Register custom JSONata functions for history access
+ */
+export declare function registerHistoryFunctions(expr: jsonata.Expression, history: NodeExecutionRecord[], currentIndex: number): void;
+//# sourceMappingURL=jsonata-extensions.d.ts.map

package/dist/expressions/jsonata-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonata-extensions.d.ts","sourceRoot":"","sources":["../../src/expressions/jsonata-extensions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,OAAO,CAAC,UAAU,EACxB,OAAO,EAAE,mBAAmB,EAAE,EAC9B,YAAY,EAAE,MAAM,GACnB,IAAI,CAiFN"}

package/dist/expressions/jsonata-extensions.js

@@ -0,0 +1,69 @@
+/**
+ * JSONata extensions for execution history access
+ */
+import { logger } from "../logger.js";
+/**
+ * Register custom JSONata functions for history access
+ */
+export function registerHistoryFunctions(expr, history, currentIndex) {
+    // $previousNode() - returns previous node's output
+    // $previousNode(index) - returns node that executed N steps before current
+    expr.registerFunction("previousNode", (offset) => {
+        const stepsBack = offset !== undefined ? offset : 1;
+        const targetIndex = currentIndex - stepsBack;
+        if (targetIndex < 0 || targetIndex >= history.length) {
+            logger.debug(`$previousNode(${stepsBack}): No node at index ${targetIndex}`);
+            return null;
+        }
+        const record = history[targetIndex];
+        logger.debug(`$previousNode(${stepsBack}) returning output from node: ${record.nodeId} (index ${targetIndex})`);
+        return record.output;
+    }, "<n?:o>" // Optional number argument, returns object
+    );
+    // $executionCount(nodeName) - count of executions for a node
+    expr.registerFunction("executionCount", (nodeName) => {
+        if (typeof nodeName !== "string") {
+            return 0;
+        }
+        const count = history.filter(r => r.nodeId === nodeName).length;
+        logger.debug(`$executionCount("${nodeName}") = ${count}`);
+        return count;
+    }, "<s:n>" // String argument, returns number
+    );
+    // $nodeExecution(nodeName, index) - specific execution by index (0 = first, -1 = last)
+    expr.registerFunction("nodeExecution", (nodeName, index) => {
+        if (typeof nodeName !== "string" || typeof index !== "number") {
+            return null;
+        }
+        const executions = history.filter(r => r.nodeId === nodeName);
+        if (executions.length === 0) {
+            logger.debug(`$nodeExecution("${nodeName}", ${index}): No executions found`);
+            return null;
+        }
+        // Handle negative indices (from end)
+        let actualIndex = index;
+        if (index < 0) {
+            actualIndex = executions.length + index;
+        }
+        if (actualIndex < 0 || actualIndex >= executions.length) {
+            logger.debug(`$nodeExecution("${nodeName}", ${index}): Index ${actualIndex} out of range`);
+            return null;
+        }
+        const record = executions[actualIndex];
+        logger.debug(`$nodeExecution("${nodeName}", ${index}) = execution at index ${actualIndex}`);
+        return record.output;
+    }, "<s-n:o>" // String and number arguments, returns object
+    );
+    // $nodeExecutions(nodeName) - array of all executions for a node
+    expr.registerFunction("nodeExecutions", (nodeName) => {
+        if (typeof nodeName !== "string") {
+            return [];
+        }
+        const executions = history.filter(r => r.nodeId === nodeName);
+        const outputs = executions.map(r => r.output);
+        logger.debug(`$nodeExecutions("${nodeName}") = ${executions.length} executions`);
+        return outputs;
+    }, "<s:a>" // String argument, returns array
+    );
+}
+//# sourceMappingURL=jsonata-extensions.js.map

package/dist/expressions/jsonata-extensions.js.map

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

package/dist/expressions/jsonata.d.ts

@@ -1,5 +1,12 @@
 /**
  * JSONata expression evaluation
  */
-export declare function evaluateJsonata(expression: string, context: Record<string, unknown>, previousNodeId?: string | null): Promise<unknown>;
+import type { NodeExecutionRecord } from "../types/execution.js";
+/**
+ * Validate JSONata expression syntax without evaluating it
+ * @param expression - JSONata expression string to validate
+ * @throws Error if syntax is invalid
+ */
+export declare function validateJsonataSyntax(expression: string): void;
+export declare function evaluateJsonata(expression: string, context: Record<string, unknown>, history: NodeExecutionRecord[], currentIndex: number): Promise<unknown>;
 //# sourceMappingURL=jsonata.d.ts.map

package/dist/expressions/jsonata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsonata.d.ts","sourceRoot":"","sources":["../../src/expressions/jsonata.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAC7B,OAAO,CAAC,OAAO,CAAC,CAmClB"}
+{"version":3,"file":"jsonata.d.ts","sourceRoot":"","sources":["../../src/expressions/jsonata.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGjE;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CA2B9D;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,mBAAmB,EAAE,EAC9B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC,CAqDlB"}

package/dist/expressions/jsonata.js

@@ -3,18 +3,48 @@
  */
 import jsonata from "jsonata";
 import { logger } from "../logger.js";
-export async function evaluateJsonata(expression, context, previousNodeId) {
+import { registerHistoryFunctions } from "./jsonata-extensions.js";
+/**
+ * Validate JSONata expression syntax without evaluating it
+ * @param expression - JSONata expression string to validate
+ * @throws Error if syntax is invalid
+ */
+export function validateJsonataSyntax(expression) {
     try {
-        const expr = jsonata(expression);
-        // Register $previousNode() function if previousNodeId is provided
-        if (previousNodeId) {
-            expr.registerFunction("previousNode", () => {
-                const previousOutput = context[previousNodeId];
-                logger.debug(`$previousNode() returning output from node: ${previousNodeId}`);
-                return previousOutput !== undefined ? previousOutput : null;
-            }, "<:o>" // No arguments, returns object
-            );
+        jsonata(expression);
+    }
+    catch (error) {
+        // Extract detailed error message
+        let errorMessage;
+        if (error instanceof Error) {
+            errorMessage = error.message || error.toString();
+            if (errorMessage === '[object Object]' || !errorMessage) {
+                errorMessage = error.toString();
+                if (error.stack) {
+                    errorMessage = error.stack.split('\n')[0] || errorMessage;
+                }
+            }
+        }
+        else if (error && typeof error === 'object') {
+            const errorObj = error;
+            if (errorObj.message && typeof errorObj.message === 'string') {
+                errorMessage = errorObj.message;
+            }
+            else {
+                errorMessage = JSON.stringify(error, null, 2);
+            }
+        }
+        else {
+            errorMessage = String(error);
         }
+        throw new Error(`Invalid JSONata syntax: ${errorMessage}`);
+    }
+}
+export async function evaluateJsonata(expression, context, history, currentIndex) {
+    try {
+        const expr = jsonata(expression);
+        // Register history access functions
+        registerHistoryFunctions(expr, history, currentIndex);
         const result = await expr.evaluate(context);
         // Log for debugging
         logger.debug(`JSONata expression: ${expression}`);
@@ -27,10 +57,40 @@ export async function evaluateJsonata(expression, context, previousNodeId) {
         return result;
     }
     catch (error) {
-        logger.error(`JSONata evaluation error: ${error instanceof Error ? error.message : String(error)}`);
+        // Extract detailed error message
+        let errorMessage;
+        if (error instanceof Error) {
+            errorMessage = error.message || error.toString();
+            // If message is still unhelpful, try to get more details
+            if (errorMessage === '[object Object]' || !errorMessage) {
+                errorMessage = error.toString();
+                // Try to get stack trace or other properties
+                if (error.stack) {
+                    errorMessage = error.stack.split('\n')[0] || errorMessage;
+                }
+            }
+        }
+        else if (error && typeof error === 'object') {
+            // Try to extract meaningful information from error object
+            const errorObj = error;
+            if (errorObj.message && typeof errorObj.message === 'string') {
+                errorMessage = errorObj.message;
+            }
+            else if (errorObj.code && typeof errorObj.code === 'string') {
+                errorMessage = `Error code: ${errorObj.code}`;
+            }
+            else {
+                errorMessage = JSON.stringify(error, null, 2);
+            }
+        }
+        else {
+            errorMessage = String(error);
+        }
+        logger.error(`JSONata evaluation error: ${errorMessage}`);
         logger.error(`Expression: ${expression}`);
+        logger.error(`Context keys: ${Object.keys(context).join(', ')}`);
         logger.error(`Context: ${JSON.stringify(context, null, 2)}`);
-        throw error;
+        throw new Error(`JSONata evaluation failed: ${errorMessage}\nExpression: ${expression}`);
     }
 }
 //# sourceMappingURL=jsonata.js.map

package/dist/expressions/jsonata.js.map

@@ -1 +1 @@
-{"version":3,"file":"jsonata.js","sourceRoot":"","sources":["../../src/expressions/jsonata.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,OAAgC,EAChC,cAA8B;IAE9B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QAEjC,kEAAkE;QAClE,IAAI,cAAc,EAAE,CAAC;YACnB,IAAI,CAAC,gBAAgB,CACnB,cAAc,EACd,GAAG,EAAE;gBACH,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;gBAC/C,MAAM,CAAC,KAAK,CAAC,+CAA+C,cAAc,EAAE,CAAC,CAAC;gBAC9E,OAAO,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9D,CAAC,EACD,MAAM,CAAC,+BAA+B;aACvC,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE5C,oBAAoB;QACpB,MAAM,CAAC,KAAK,CAAC,uBAAuB,UAAU,EAAE,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,yBAAyB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzE,IAAI,OAAO,OAAO,CAAC,mBAAmB,KAAK,QAAQ,EAAE,CAAC;YACpD,MAAM,CAAC,KAAK,CAAC,gDAAiD,OAAO,CAAC,mBAA8B,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1H,MAAM,CAAC,KAAK,CAAC,4CAA6C,OAAO,CAAC,mBAA8B,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrH,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAE1D,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,6BAA6B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpG,MAAM,CAAC,KAAK,CAAC,eAAe,UAAU,EAAE,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7D,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"jsonata.js","sourceRoot":"","sources":["../../src/expressions/jsonata.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAkB;IACtD,IAAI,CAAC;QACH,OAAO,CAAC,UAAU,CAAC,CAAC;IACtB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iCAAiC;QACjC,IAAI,YAAoB,CAAC;QACzB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,YAAY,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACjD,IAAI,YAAY,KAAK,iBAAiB,IAAI,CAAC,YAAY,EAAE,CAAC;gBACxD,YAAY,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAChC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;oBAChB,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC;gBAC5D,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,KAAgC,CAAC;YAClD,IAAI,QAAQ,CAAC,OAAO,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC7D,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,2BAA2B,YAAY,EAAE,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,OAAgC,EAChC,OAA8B,EAC9B,YAAoB;IAEpB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;QAEjC,oCAAoC;QACpC,wBAAwB,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE5C,oBAAoB;QACpB,MAAM,CAAC,KAAK,CAAC,uBAAuB,UAAU,EAAE,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,yBAAyB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzE,IAAI,OAAO,OAAO,CAAC,mBAAmB,KAAK,QAAQ,EAAE,CAAC;YACpD,MAAM,CAAC,KAAK,CAAC,gDAAiD,OAAO,CAAC,mBAA8B,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1H,MAAM,CAAC,KAAK,CAAC,4CAA6C,OAAO,CAAC,mBAA8B,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrH,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAE1D,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,iCAAiC;QACjC,IAAI,YAAoB,CAAC;QACzB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,YAAY,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACjD,yDAAyD;YACzD,IAAI,YAAY,KAAK,iBAAiB,IAAI,CAAC,YAAY,EAAE,CAAC;gBACxD,YAAY,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAChC,6CAA6C;gBAC7C,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;oBAChB,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC;gBAC5D,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9C,0DAA0D;YAC1D,MAAM,QAAQ,GAAG,KAAgC,CAAC;YAClD,IAAI,QAAQ,CAAC,OAAO,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC7D,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC;YAClC,CAAC;iBAAM,IAAI,QAAQ,CAAC,IAAI,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC9D,YAAY,GAAG,eAAe,QAAQ,CAAC,IAAI,EAAE,CAAC;YAChD,CAAC;iBAAM,CAAC;gBACN,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,6BAA6B,YAAY,EAAE,CAAC,CAAC;QAC1D,MAAM,CAAC,KAAK,CAAC,eAAe,UAAU,EAAE,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,iBAAiB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjE,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QAE7D,MAAM,IAAI,KAAK,CAAC,8BAA8B,YAAY,iBAAiB,UAAU,EAAE,CAAC,CAAC;IAC3F,CAAC;AACH,CAAC"}

package/dist/types/config.d.ts

@@ -1,10 +1,15 @@
 /**
  * Type definitions for mcpGraph configuration
  */
+export interface ExecutionLimits {
+    maxNodeExecutions?: number;
+    maxExecutionTimeMs?: number;
+}
 export interface McpGraphConfig {
     version: string;
     server: ServerMetadata;
     servers?: Record<string, ServerConfig>;
+    executionLimits?: ExecutionLimits;
     tools: ToolDefinition[];
     nodes: NodeDefinition[];
 }

package/dist/types/config.d.ts.map

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

package/dist/types/execution.d.ts

@@ -5,12 +5,12 @@ import type { NodeDefinition } from "./config.js";
 import type { ExecutionContext } from "../execution/context.js";
 export type ExecutionStatus = "not_started" | "running" | "paused" | "finished" | "error" | "stopped";
 export interface NodeExecutionRecord {
+    executionIndex: number;
     nodeId: string;
     nodeType: string;
     startTime: number;
     endTime: number;
     duration: number;
-    input: unknown;
     output: unknown;
     error?: Error;
 }

package/dist/types/execution.d.ts.map

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

package/docs/design.md

@@ -124,17 +124,26 @@ Graph definitions should feel like Kubernetes manifests or GitHub Actions - decl
 The YAML configuration centers around MCP server and tool definitions:
 
 1. **MCP Server Metadata**: Defines the MCP server information (name, version, description)
-2. **Tools**: Array of tool definitions, each containing:
+2. **Execution Limits** (optional): Guardrails to prevent infinite loops in cyclical graphs:
+   - **`maxNodeExecutions`** (optional): Maximum total node executions across the entire graph. Default: `1000`. If execution reaches this limit, an error is thrown.
+   - **`maxExecutionTimeMs`** (optional): Maximum wall-clock time for graph execution in milliseconds. Default: `300000` (5 minutes). If execution exceeds this time, an error is thrown.
+   - Both limits are checked before each node execution. If either limit is exceeded, execution stops immediately with a clear error message.
+3. **Tools**: Array of tool definitions, each containing:
    - Standard MCP tool metadata (name, description)
    - Input parameters schema (MCP tool parameter definitions)
    - Output schema (what the tool returns)
    - Note: Entry and exit nodes are defined in the nodes section with a `tool` field indicating which tool they belong to
-3. **Nodes**: The directed graph of nodes that execute when tools are called. Node types include:
+4. **Nodes**: The directed graph of nodes that execute when tools are called. Node types include:
    - **`entry`**: Entry point for a tool's graph execution. Receives tool arguments and initializes execution context.
+     - **Output**: The tool input arguments (passed through as-is)
    - **`mcp`**: Calls an MCP tool on an internal or external MCP server using `callTool`
+     - **Output**: The MCP tool's response (parsed from the tool's content)
    - **`transform`**: Applies JSONata expressions to transform data between nodes
+     - **Output**: The result of evaluating the JSONata expression
    - **`switch`**: Uses JSON Logic to conditionally route to different nodes based on data
+     - **Output**: The node ID of the target node that was routed to (string)
    - **`exit`**: Exit point for a tool's graph execution. Extracts and returns the final result to the MCP tool caller
+     - **Output**: The output from the previous node in the execution history
 
 ### Example YAML Structure: count_files Tool
 
@@ -149,6 +158,11 @@ server:
   version: "1.0.0"
   description: "File utilities"
 
+# Optional: Execution limits to prevent infinite loops
+executionLimits:
+  maxNodeExecutions: 1000      # Maximum total node executions (default: 1000)
+  maxExecutionTimeMs: 300000   # Maximum execution time in milliseconds (default: 300000 = 5 minutes)
+
 # Tool Definitions
 tools:
   - name: "count_files"
@@ -223,5 +237,10 @@ nodes:
 2. **Programmatic API**: Exports `McpGraphApi` class for programmatic use (e.g., by visualizer applications)
 3. **Graph Executor**: Core orchestration engine that executes the directed graph sequentially
 4. **Execution Context**: Tracks execution state, data flow, and history
+   - **Execution History**: Single source of truth - ordered array of all node executions with unique `executionIndex`
+   - **Context Building**: Context for expressions is built from history (most recent execution of each node wins)
+   - **Flat Structure**: Simple `{ "node_id": output }` structure - backward compatible with `$.node_id` notation
+   - **Loop Handling**: When nodes execute multiple times, context shows latest; history functions provide access to all executions
+   - **Time-Travel Debugging**: Can reconstruct context at any point in execution history
 5. **Visual Editor**: Tools to visually view and edit the graph (future)
 6. **Execution Observer**: Ability to observe and debug graph execution (future - see `docs/future-introspection-debugging.md`)

package/docs/implementation.md

@@ -33,6 +33,7 @@ The implementation creates a working MCP server that can:
 All TypeScript interfaces defined:
 - `McpGraphConfig` - Root configuration structure
 - `ServerMetadata` - MCP server metadata
+- `ExecutionLimits` - Optional execution limits configuration (maxNodeExecutions, maxExecutionTimeMs)
 - `ToolDefinition` - Tool definition with input/output schemas (entry/exit nodes are defined in nodes with `tool` field)
 - `NodeDefinition` - Base node interface
 - `EntryNode` - Entry point node that receives tool arguments
@@ -212,11 +213,15 @@ Exit node execution:
 **File: `src/execution/context.ts`**
 
 Execution state management:
-- Current node tracking
-- Data context (node outputs stored by node ID, e.g., `$.entry_node_id.*`, `$.mcp_node_id.*`)
-- Execution history
-- Error state
-- Data access for expressions (all data referenced by node ID)
+- **Execution History**: Single source of truth - ordered array of `NodeExecutionRecord` objects
+  - Each record includes: `executionIndex` (unique sequential ID), `nodeId`, `nodeType`, `startTime`, `endTime`, `duration`, `output`, `error`
+  - No `input` field - input context is derived from history when needed
+- **Context Building**: Context for JSONata/JSON Logic is built from history once per node execution
+  - Walks backwards through history, most recent execution of each node wins
+  - Flat context structure: `{ "node_id": output, ... }` - backward compatible with `$.node_id` notation
+  - Supports time-travel debugging via `getContextForExecution(executionIndex)` - builds context up to a specific point
+- **Data Access**: All data referenced by node ID (e.g., `$.entry_node_id.*`, `$.mcp_node_id.*`)
+- **Loop Support**: When same node executes multiple times, context contains latest execution; history functions provide access to all executions
 
 ### 6.2 Graph Executor
 
@@ -231,7 +236,11 @@ Main graph execution orchestrator:
 - Track execution history (node inputs/outputs)
 - Handle errors with context
 
-**Note:** The execution loop supports cycles (directed graphs with cycles), but infinite loops are prevented by the exit node check. Future loop node types can leverage this cycle support.
+**Note:** The execution loop supports cycles (directed graphs with cycles). To prevent infinite loops, execution limits are enforced:
+- **`maxNodeExecutions`**: Maximum total node executions across the entire graph (default: 1000)
+- **`maxExecutionTimeMs`**: Maximum wall-clock time for graph execution in milliseconds (default: 300000 = 5 minutes)
+- Both limits are checked before each node execution. If either limit is exceeded, execution stops immediately with a clear error message.
+- Limits are configurable in the YAML configuration via the optional `executionLimits` section.
 
 ### 6.3 Execution Flow
 

package/docs/introspection-debugging.md

@@ -364,17 +364,19 @@ Execution history provides a complete record of all node executions with detaile
 
 ```typescript
 interface NodeExecutionRecord {
+  executionIndex: number;  // Position in overall execution history (0, 1, 2, ...) - unique identifier
   nodeId: string;           // ID of the executed node
   nodeType: string;         // Type of node (entry, exit, transform, mcp, switch)
   startTime: number;        // Timestamp when node started (milliseconds)
   endTime: number;          // Timestamp when node ended (milliseconds)
   duration: number;         // Execution duration (milliseconds)
-  input: unknown;           // Input data for the node
   output: unknown;          // Output data from the node
   error?: Error;            // Error object if node failed
 }
 ```
 
+**Note**: The `input` field has been removed. Input context can be derived by building context from history up to the execution index using `getContextForExecution(executionIndex)`.
+
 ### Accessing History
 
 ```typescript
@@ -398,6 +400,31 @@ if (state) {
 }
 ```
 
+### Time-Travel Debugging
+
+You can get the context that was available to a specific execution using `getContextForExecution()`:
+
+```typescript
+// Get context for a specific execution
+const context = api.getContextForExecution(5);
+if (context) {
+  console.log('Context available to execution #5:', context);
+}
+
+// Get a specific execution record
+const record = api.getExecutionByIndex(5);
+if (record) {
+  console.log(`Execution #5: ${record.nodeId} executed at ${record.startTime}`);
+  console.log(`Output:`, record.output);
+  
+  // Get the context that was available to this execution
+  const inputContext = api.getContextForExecution(record.executionIndex);
+  console.log('Input context:', inputContext);
+}
+```
+
+**Note**: Both methods require an active execution with a controller (hooks/breakpoints enabled). They return `null` if no execution is in progress or the index is invalid.
+
 ## Telemetry
 
 Telemetry provides aggregated performance metrics and execution statistics.