mcpgraph 0.1.15 → 0.1.17

package/examples/api-usage.ts

@@ -70,7 +70,7 @@ async function introspectionExample() {
   if (result.executionHistory) {
     console.log('\nExecution History:');
     for (const record of result.executionHistory) {
-      console.log(`  ${record.nodeId} (${record.nodeType}): ${record.duration}ms`);
+      console.log(`  [${record.executionIndex}] ${record.nodeId} (${record.nodeType}): ${record.duration}ms`);
     }
   }
 
@@ -88,6 +88,57 @@ async function introspectionExample() {
   await api.close();
 }
 
+// Example: Time-travel debugging with getContextForExecution
+async function timeTravelDebuggingExample() {
+  const api = new McpGraphApi('examples/count_files.yaml');
+
+  let executionIndexToInspect: number | null = null;
+  
+  const { promise, controller } = api.executeTool('count_files', {
+    directory: './tests/files',
+  }, {
+    hooks: {
+      onNodeComplete: async (nodeId, node, input, output, duration) => {
+        // When count_files_node completes, inspect the context that was available to list_directory_node
+        if (nodeId === 'count_files_node') {
+          // Find the execution index of list_directory_node
+          const state = api.getExecutionState();
+          if (state) {
+            const listDirRecord = state.executionHistory.find(r => r.nodeId === 'list_directory_node');
+            if (listDirRecord) {
+              executionIndexToInspect = listDirRecord.executionIndex;
+            }
+          }
+        }
+      },
+    },
+  });
+  
+  await promise;
+  
+  if (executionIndexToInspect !== null && controller) {
+    // Get the context that was available to list_directory_node when it executed
+    const context = api.getContextForExecution(executionIndexToInspect);
+    if (context) {
+      console.log('\nTime-Travel Debugging:');
+      console.log(`Context available to execution #${executionIndexToInspect} (list_directory_node):`);
+      console.log(JSON.stringify(context, null, 2));
+    }
+    
+    // Get the execution record itself
+    const record = api.getExecutionByIndex(executionIndexToInspect);
+    if (record) {
+      console.log(`\nExecution Record #${executionIndexToInspect}:`);
+      console.log(`  Node: ${record.nodeId}`);
+      console.log(`  Type: ${record.nodeType}`);
+      console.log(`  Duration: ${record.duration}ms`);
+      console.log(`  Output: ${JSON.stringify(record.output).substring(0, 100)}...`);
+    }
+  }
+  
+  await api.close();
+}
+
 // Example: Validate config without creating an API instance
 function validateConfigExample() {
   const errors = McpGraphApi.validateConfig('examples/count_files.yaml');
@@ -118,6 +169,8 @@ if (import.meta.url === `file://${process.argv[1]}`) {
   
   if (exampleToRun === 'introspection') {
     introspectionExample().catch(console.error);
+  } else if (exampleToRun === 'debugging') {
+    timeTravelDebuggingExample().catch(console.error);
   } else {
     example().catch(console.error);
   }

package/examples/loop_example.yaml

@@ -0,0 +1,84 @@
+version: "1.0"
+
+# MCP Server Metadata
+server:
+  name: "loopExample"
+  version: "1.0.0"
+  description: "Example with a loop using history functions"
+
+# Tool Definitions
+tools:
+  - name: "sum_to_n"
+    description: "Sums numbers from 1 to n using a loop"
+    inputSchema:
+      type: "object"
+      properties:
+        n:
+          type: "number"
+          description: "The number to sum to"
+      required:
+        - n
+    outputSchema:
+      type: "object"
+      properties:
+        sum:
+          type: "number"
+          description: "The sum from 1 to n"
+
+# Graph Nodes
+nodes:
+  # Entry node: Receives tool arguments
+  - id: "entry_sum"
+    type: "entry"
+    tool: "sum_to_n"
+    next: "increment_node"
+  
+  # Increment counter and add to sum
+  # Uses $nodeExecution() to get the previous iteration of this node
+  # First iteration: $executionCount("increment_node") = 0, so we initialize
+  # Subsequent iterations: $nodeExecution("increment_node", -1) gets the last execution
+  - id: "increment_node"
+    type: "transform"
+    transform:
+      expr: |
+        $executionCount("increment_node") = 0
+          ? {
+              "counter": 1,
+              "sum": 1,
+              "target": $.entry_sum.n
+            }
+          : {
+              "counter": $nodeExecution("increment_node", -1).counter + 1,
+              "sum": $nodeExecution("increment_node", -1).sum + $nodeExecution("increment_node", -1).counter + 1,
+              "target": $.entry_sum.n
+            }
+    next: "check_condition"
+  
+  # Check if we should continue looping
+  - id: "check_condition"
+    type: "switch"
+    conditions:
+      - rule:
+          "<": [{"var": "$.increment_node.counter"}, {"var": "$.increment_node.target"}]
+        target: "increment_node"
+      - target: "exit_sum"
+  
+  # Exit node: Extracts the sum from increment_node
+  # Uses $previousNode() to verify it returns the switch node's output (target node ID)
+  # The output matches the tool's outputSchema (just the sum)
+  - id: "exit_sum"
+    type: "transform"
+    transform:
+      expr: |
+        $previousNode() = "exit_sum" ? {
+          "sum": $.increment_node.sum
+        } : {
+          "sum": 0,
+          "error": "previousNode check failed"
+        }
+    next: "exit_sum_final"
+  
+  # Final exit node
+  - id: "exit_sum_final"
+    type: "exit"
+    tool: "sum_to_n"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpgraph",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "MCP server that executes directed graphs of MCP server calls",
   "main": "dist/main.js",
   "type": "module",