@wundr.io/langgraph-orchestrator 1.0.3

package/dist/index.js

@@ -0,0 +1,269 @@
+"use strict";
+/**
+ * LangGraph Orchestrator - LangGraph-style cyclic, state-driven workflows
+ * @module @wundr.io/langgraph-orchestrator
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   StateGraph,
+ *   createLLMNode,
+ *   createToolNode,
+ *   createDecisionNode,
+ *   MemoryCheckpointer
+ * } from '@wundr.io/langgraph-orchestrator';
+ *
+ * // Create a workflow graph
+ * const graph = new StateGraph('my-workflow')
+ *   .addNode('agent', createLLMNode({
+ *     id: 'agent',
+ *     name: 'Agent',
+ *     config: { model: 'claude-3-sonnet-20240229' }
+ *   }))
+ *   .addNode('tools', createToolNode({
+ *     id: 'tools',
+ *     name: 'Tools'
+ *   }))
+ *   .addEdge('agent', 'tools')
+ *   .addConditionalEdge('tools', 'agent', {
+ *     type: 'exists',
+ *     field: 'data.pendingToolCalls'
+ *   })
+ *   .setEntryPoint('agent')
+ *   .setCheckpointer(new MemoryCheckpointer());
+ *
+ * // Execute the workflow
+ * const result = await graph.execute({
+ *   initialState: {
+ *     data: { task: 'Research AI developments' }
+ *   }
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSimpleTaskGraph = exports.createPlanExecuteRefineGraph = exports.CheckpointValidationSchema = exports.validateCheckpoint = exports.applyRetentionPolicy = exports.createCheckpoint = exports.TimeTravelDebugger = exports.FileCheckpointer = exports.MemoryCheckpointer = exports.validateLoopConfig = exports.LoopConfigSchema = exports.createPaginationLoop = exports.createRetryLoop = exports.createDoWhileLoop = exports.createWhileLoop = exports.createForLoop = exports.loopEdge = exports.LoopEdgeBuilder = exports.validateCondition = exports.EdgeConditionSchema = exports.conditions = exports.createRouter = exports.conditionalEdge = exports.ConditionalEdgeBuilder = exports.HumanNodeConfigSchema = exports.createFeedbackNode = exports.createConfirmationNode = exports.createCallbackInputHandler = exports.createConsoleInputHandler = exports.createHumanNode = exports.DecisionNodeConfigSchema = exports.createMultiConditionNode = exports.createIfElseNode = exports.createThresholdNode = exports.createSwitchNode = exports.createDecisionNode = exports.ToolNodeConfigSchema = exports.createBatchToolNode = exports.createTool = exports.createToolRegistry = exports.createToolNode = exports.LLMNodeConfigSchema = exports.createConversationalLLMNode = exports.createStructuredLLMNode = exports.createLLMRouter = exports.createLLMNode = exports.StateGraph = exports.CheckpointSchema = exports.GraphConfigSchema = exports.MessageSchema = void 0;
+exports.VERSION = exports.PlanSchema = void 0;
+exports.createAgentWorkflow = createAgentWorkflow;
+exports.createChatWorkflow = createChatWorkflow;
+exports.createDecisionTree = createDecisionTree;
+// ============================================================================
+// Core Types
+// ============================================================================
+// ============================================================================
+// Utility Functions
+// ============================================================================
+// Import for internal use in utility functions
+const decision_node_1 = require("./nodes/decision-node");
+const llm_node_1 = require("./nodes/llm-node");
+const tool_node_1 = require("./nodes/tool-node");
+const state_graph_1 = require("./state-graph");
+// Zod schemas
+var types_1 = require("./types");
+Object.defineProperty(exports, "MessageSchema", { enumerable: true, get: function () { return types_1.MessageSchema; } });
+Object.defineProperty(exports, "GraphConfigSchema", { enumerable: true, get: function () { return types_1.GraphConfigSchema; } });
+Object.defineProperty(exports, "CheckpointSchema", { enumerable: true, get: function () { return types_1.CheckpointSchema; } });
+// ============================================================================
+// Core Classes
+// ============================================================================
+var state_graph_2 = require("./state-graph");
+Object.defineProperty(exports, "StateGraph", { enumerable: true, get: function () { return state_graph_2.StateGraph; } });
+// ============================================================================
+// Nodes
+// ============================================================================
+// LLM Node
+var llm_node_2 = require("./nodes/llm-node");
+Object.defineProperty(exports, "createLLMNode", { enumerable: true, get: function () { return llm_node_2.createLLMNode; } });
+Object.defineProperty(exports, "createLLMRouter", { enumerable: true, get: function () { return llm_node_2.createLLMRouter; } });
+Object.defineProperty(exports, "createStructuredLLMNode", { enumerable: true, get: function () { return llm_node_2.createStructuredLLMNode; } });
+Object.defineProperty(exports, "createConversationalLLMNode", { enumerable: true, get: function () { return llm_node_2.createConversationalLLMNode; } });
+Object.defineProperty(exports, "LLMNodeConfigSchema", { enumerable: true, get: function () { return llm_node_2.LLMNodeConfigSchema; } });
+// Tool Node
+var tool_node_2 = require("./nodes/tool-node");
+Object.defineProperty(exports, "createToolNode", { enumerable: true, get: function () { return tool_node_2.createToolNode; } });
+Object.defineProperty(exports, "createToolRegistry", { enumerable: true, get: function () { return tool_node_2.createToolRegistry; } });
+Object.defineProperty(exports, "createTool", { enumerable: true, get: function () { return tool_node_2.createTool; } });
+Object.defineProperty(exports, "createBatchToolNode", { enumerable: true, get: function () { return tool_node_2.createBatchToolNode; } });
+Object.defineProperty(exports, "ToolNodeConfigSchema", { enumerable: true, get: function () { return tool_node_2.ToolNodeConfigSchema; } });
+// Decision Node
+var decision_node_2 = require("./nodes/decision-node");
+Object.defineProperty(exports, "createDecisionNode", { enumerable: true, get: function () { return decision_node_2.createDecisionNode; } });
+Object.defineProperty(exports, "createSwitchNode", { enumerable: true, get: function () { return decision_node_2.createSwitchNode; } });
+Object.defineProperty(exports, "createThresholdNode", { enumerable: true, get: function () { return decision_node_2.createThresholdNode; } });
+Object.defineProperty(exports, "createIfElseNode", { enumerable: true, get: function () { return decision_node_2.createIfElseNode; } });
+Object.defineProperty(exports, "createMultiConditionNode", { enumerable: true, get: function () { return decision_node_2.createMultiConditionNode; } });
+Object.defineProperty(exports, "DecisionNodeConfigSchema", { enumerable: true, get: function () { return decision_node_2.DecisionNodeConfigSchema; } });
+// Human Node
+var human_node_1 = require("./nodes/human-node");
+Object.defineProperty(exports, "createHumanNode", { enumerable: true, get: function () { return human_node_1.createHumanNode; } });
+Object.defineProperty(exports, "createConsoleInputHandler", { enumerable: true, get: function () { return human_node_1.createConsoleInputHandler; } });
+Object.defineProperty(exports, "createCallbackInputHandler", { enumerable: true, get: function () { return human_node_1.createCallbackInputHandler; } });
+Object.defineProperty(exports, "createConfirmationNode", { enumerable: true, get: function () { return human_node_1.createConfirmationNode; } });
+Object.defineProperty(exports, "createFeedbackNode", { enumerable: true, get: function () { return human_node_1.createFeedbackNode; } });
+Object.defineProperty(exports, "HumanNodeConfigSchema", { enumerable: true, get: function () { return human_node_1.HumanNodeConfigSchema; } });
+// ============================================================================
+// Edges
+// ============================================================================
+// Conditional Edge
+var conditional_edge_1 = require("./edges/conditional-edge");
+Object.defineProperty(exports, "ConditionalEdgeBuilder", { enumerable: true, get: function () { return conditional_edge_1.ConditionalEdgeBuilder; } });
+Object.defineProperty(exports, "conditionalEdge", { enumerable: true, get: function () { return conditional_edge_1.conditionalEdge; } });
+Object.defineProperty(exports, "createRouter", { enumerable: true, get: function () { return conditional_edge_1.createRouter; } });
+Object.defineProperty(exports, "conditions", { enumerable: true, get: function () { return conditional_edge_1.conditions; } });
+Object.defineProperty(exports, "EdgeConditionSchema", { enumerable: true, get: function () { return conditional_edge_1.EdgeConditionSchema; } });
+Object.defineProperty(exports, "validateCondition", { enumerable: true, get: function () { return conditional_edge_1.validateCondition; } });
+// Loop Edge
+var loop_edge_1 = require("./edges/loop-edge");
+Object.defineProperty(exports, "LoopEdgeBuilder", { enumerable: true, get: function () { return loop_edge_1.LoopEdgeBuilder; } });
+Object.defineProperty(exports, "loopEdge", { enumerable: true, get: function () { return loop_edge_1.loopEdge; } });
+Object.defineProperty(exports, "createForLoop", { enumerable: true, get: function () { return loop_edge_1.createForLoop; } });
+Object.defineProperty(exports, "createWhileLoop", { enumerable: true, get: function () { return loop_edge_1.createWhileLoop; } });
+Object.defineProperty(exports, "createDoWhileLoop", { enumerable: true, get: function () { return loop_edge_1.createDoWhileLoop; } });
+Object.defineProperty(exports, "createRetryLoop", { enumerable: true, get: function () { return loop_edge_1.createRetryLoop; } });
+Object.defineProperty(exports, "createPaginationLoop", { enumerable: true, get: function () { return loop_edge_1.createPaginationLoop; } });
+Object.defineProperty(exports, "LoopConfigSchema", { enumerable: true, get: function () { return loop_edge_1.LoopConfigSchema; } });
+Object.defineProperty(exports, "validateLoopConfig", { enumerable: true, get: function () { return loop_edge_1.validateLoopConfig; } });
+// ============================================================================
+// Checkpointing
+// ============================================================================
+var checkpointing_1 = require("./checkpointing");
+Object.defineProperty(exports, "MemoryCheckpointer", { enumerable: true, get: function () { return checkpointing_1.MemoryCheckpointer; } });
+Object.defineProperty(exports, "FileCheckpointer", { enumerable: true, get: function () { return checkpointing_1.FileCheckpointer; } });
+Object.defineProperty(exports, "TimeTravelDebugger", { enumerable: true, get: function () { return checkpointing_1.TimeTravelDebugger; } });
+Object.defineProperty(exports, "createCheckpoint", { enumerable: true, get: function () { return checkpointing_1.createCheckpoint; } });
+Object.defineProperty(exports, "applyRetentionPolicy", { enumerable: true, get: function () { return checkpointing_1.applyRetentionPolicy; } });
+Object.defineProperty(exports, "validateCheckpoint", { enumerable: true, get: function () { return checkpointing_1.validateCheckpoint; } });
+Object.defineProperty(exports, "CheckpointValidationSchema", { enumerable: true, get: function () { return checkpointing_1.CheckpointSchema; } });
+// ============================================================================
+// Prebuilt Graphs
+// ============================================================================
+var plan_execute_refine_1 = require("./prebuilt-graphs/plan-execute-refine");
+Object.defineProperty(exports, "createPlanExecuteRefineGraph", { enumerable: true, get: function () { return plan_execute_refine_1.createPlanExecuteRefineGraph; } });
+Object.defineProperty(exports, "createSimpleTaskGraph", { enumerable: true, get: function () { return plan_execute_refine_1.createSimpleTaskGraph; } });
+Object.defineProperty(exports, "PlanSchema", { enumerable: true, get: function () { return plan_execute_refine_1.PlanSchema; } });
+/**
+ * Create a simple agent workflow
+ *
+ * @example
+ * ```typescript
+ * const graph = createAgentWorkflow({
+ *   name: 'research-agent',
+ *   llmProvider: myProvider,
+ *   tools: [searchTool, writeTool],
+ *   systemPrompt: 'You are a helpful research assistant.'
+ * });
+ * ```
+ */
+function createAgentWorkflow(options) {
+    const graph = new state_graph_1.StateGraph(options.name, {
+        maxIterations: options.maxIterations ?? 50,
+    });
+    const registry = (0, tool_node_1.createToolRegistry)();
+    options.tools?.forEach(tool => registry.register(tool));
+    graph.setServices({
+        llmProvider: options.llmProvider,
+        toolRegistry: registry,
+    });
+    // Add agent node
+    graph.addNode('agent', (0, llm_node_1.createLLMNode)({
+        id: 'agent',
+        name: 'Agent',
+        config: {
+            systemPrompt: options.systemPrompt,
+            tools: options.tools,
+        },
+    }));
+    // Add tool node if tools provided
+    if (options.tools?.length) {
+        graph.addNode('tools', (0, tool_node_1.createToolNode)({
+            id: 'tools',
+            name: 'Tool Executor',
+            config: {
+                tools: options.tools,
+                parallel: true,
+            },
+        }));
+        // Add edges
+        graph.addConditionalEdge('agent', 'tools', {
+            type: 'exists',
+            field: 'data.pendingToolCalls',
+        });
+        graph.addEdge('tools', 'agent');
+    }
+    graph.setEntryPoint('agent');
+    return graph;
+}
+/**
+ * Create a chat workflow with conversation history
+ *
+ * @example
+ * ```typescript
+ * const chat = createChatWorkflow({
+ *   name: 'chat-assistant',
+ *   llmProvider: myProvider,
+ *   systemPrompt: 'You are a friendly assistant.',
+ *   maxHistory: 20
+ * });
+ * ```
+ */
+function createChatWorkflow(options) {
+    const graph = new state_graph_1.StateGraph(options.name);
+    graph.setServices({
+        llmProvider: options.llmProvider,
+    });
+    graph.addNode('chat', (0, llm_node_1.createConversationalLLMNode)({
+        id: 'chat',
+        name: 'Chat',
+        config: {
+            systemPrompt: options.systemPrompt,
+        },
+        maxHistoryLength: options.maxHistory ?? 50,
+    }));
+    graph.setEntryPoint('chat');
+    return graph;
+}
+/**
+ * Create a decision tree workflow
+ *
+ * @example
+ * ```typescript
+ * const tree = createDecisionTree({
+ *   name: 'support-router',
+ *   decisions: [
+ *     {
+ *       field: 'data.category',
+ *       branches: {
+ *         'billing': 'billing-handler',
+ *         'technical': 'tech-handler',
+ *         'general': 'general-handler'
+ *       },
+ *       default: 'general-handler'
+ *     }
+ *   ]
+ * });
+ * ```
+ */
+function createDecisionTree(options) {
+    const graph = new state_graph_1.StateGraph(options.name);
+    options.decisions.forEach((decision, index) => {
+        const nodeId = decision.id ?? `decision-${index}`;
+        graph.addNode(nodeId, (0, decision_node_1.createSwitchNode)({
+            id: nodeId,
+            name: nodeId,
+            field: decision.field,
+            cases: decision.branches,
+            default: decision.default,
+        }));
+    });
+    if (options.decisions.length > 0) {
+        const firstDecision = options.decisions[0];
+        if (firstDecision) {
+            graph.setEntryPoint(firstDecision.id ?? 'decision-0');
+        }
+    }
+    return graph;
+}
+// ============================================================================
+// Version
+// ============================================================================
+exports.VERSION = '1.0.3';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/nodes/decision-node.d.ts

@@ -0,0 +1,276 @@
+/**
+ * Decision Node - Conditional branching node for workflow control flow
+ * @module @wundr.io/langgraph-orchestrator
+ */
+import { z } from 'zod';
+import type { AgentState, NodeDefinition, EdgeCondition } from '../types';
+/**
+ * Configuration for decision node
+ */
+export interface DecisionNodeConfig {
+    /** Decision branches */
+    readonly branches: DecisionBranch[];
+    /** Default branch if no conditions match */
+    readonly defaultBranch?: string;
+    /** Whether to throw error if no branch matches and no default */
+    readonly throwOnNoMatch?: boolean;
+    /** Custom decision function */
+    readonly decide?: (state: AgentState) => string | Promise<string>;
+}
+/**
+ * Decision branch definition
+ */
+export interface DecisionBranch {
+    /** Name/ID of this branch */
+    readonly name: string;
+    /** Target node for this branch */
+    readonly target: string;
+    /** Condition for taking this branch */
+    readonly condition: EdgeCondition;
+    /** Priority (higher = checked first) */
+    readonly priority?: number;
+}
+/**
+ * Schema for decision node configuration validation
+ */
+export declare const DecisionNodeConfigSchema: z.ZodObject<{
+    branches: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        target: z.ZodString;
+        condition: z.ZodObject<{
+            type: z.ZodEnum<["equals", "not_equals", "contains", "greater_than", "less_than", "exists", "not_exists", "custom"]>;
+            field: z.ZodOptional<z.ZodString>;
+            value: z.ZodOptional<z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            type: "equals" | "not_equals" | "contains" | "greater_than" | "less_than" | "exists" | "not_exists" | "custom";
+            value?: unknown;
+            field?: string | undefined;
+        }, {
+            type: "equals" | "not_equals" | "contains" | "greater_than" | "less_than" | "exists" | "not_exists" | "custom";
+            value?: unknown;
+            field?: string | undefined;
+        }>;
+        priority: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        target: string;
+        condition: {
+            type: "equals" | "not_equals" | "contains" | "greater_than" | "less_than" | "exists" | "not_exists" | "custom";
+            value?: unknown;
+            field?: string | undefined;
+        };
+        priority?: number | undefined;
+    }, {
+        name: string;
+        target: string;
+        condition: {
+            type: "equals" | "not_equals" | "contains" | "greater_than" | "less_than" | "exists" | "not_exists" | "custom";
+            value?: unknown;
+            field?: string | undefined;
+        };
+        priority?: number | undefined;
+    }>, "many">;
+    defaultBranch: z.ZodOptional<z.ZodString>;
+    throwOnNoMatch: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    branches: {
+        name: string;
+        target: string;
+        condition: {
+            type: "equals" | "not_equals" | "contains" | "greater_than" | "less_than" | "exists" | "not_exists" | "custom";
+            value?: unknown;
+            field?: string | undefined;
+        };
+        priority?: number | undefined;
+    }[];
+    defaultBranch?: string | undefined;
+    throwOnNoMatch?: boolean | undefined;
+}, {
+    branches: {
+        name: string;
+        target: string;
+        condition: {
+            type: "equals" | "not_equals" | "contains" | "greater_than" | "less_than" | "exists" | "not_exists" | "custom";
+            value?: unknown;
+            field?: string | undefined;
+        };
+        priority?: number | undefined;
+    }[];
+    defaultBranch?: string | undefined;
+    throwOnNoMatch?: boolean | undefined;
+}>;
+/**
+ * Create a decision node for conditional branching
+ *
+ * @example
+ * ```typescript
+ * const decisionNode = createDecisionNode({
+ *   id: 'router',
+ *   name: 'Task Router',
+ *   config: {
+ *     branches: [
+ *       {
+ *         name: 'search',
+ *         target: 'search-node',
+ *         condition: { type: 'equals', field: 'data.action', value: 'search' }
+ *       },
+ *       {
+ *         name: 'answer',
+ *         target: 'answer-node',
+ *         condition: { type: 'equals', field: 'data.action', value: 'answer' }
+ *       }
+ *     ],
+ *     defaultBranch: 'fallback-node'
+ *   }
+ * });
+ *
+ * graph.addNode('router', decisionNode);
+ * ```
+ *
+ * @param options - Node creation options
+ * @returns NodeDefinition for use in StateGraph
+ */
+export declare function createDecisionNode<TState extends AgentState = AgentState>(options: {
+    id: string;
+    name: string;
+    config: DecisionNodeConfig;
+    nodeConfig?: NodeDefinition<TState>['config'];
+}): NodeDefinition<TState>;
+/**
+ * Create a switch-case style decision node
+ *
+ * @example
+ * ```typescript
+ * const switchNode = createSwitchNode({
+ *   id: 'type-switch',
+ *   name: 'Type Switch',
+ *   field: 'data.messageType',
+ *   cases: {
+ *     'question': 'question-handler',
+ *     'command': 'command-handler',
+ *     'feedback': 'feedback-handler'
+ *   },
+ *   default: 'unknown-handler'
+ * });
+ * ```
+ *
+ * @param options - Switch node options
+ * @returns NodeDefinition for use in StateGraph
+ */
+export declare function createSwitchNode<TState extends AgentState = AgentState>(options: {
+    id: string;
+    name: string;
+    field: string;
+    cases: Record<string, string>;
+    default?: string;
+    nodeConfig?: NodeDefinition<TState>['config'];
+}): NodeDefinition<TState>;
+/**
+ * Create a threshold-based decision node
+ *
+ * @example
+ * ```typescript
+ * const confidenceRouter = createThresholdNode({
+ *   id: 'confidence-router',
+ *   name: 'Confidence Router',
+ *   field: 'data.confidence',
+ *   thresholds: [
+ *     { value: 0.9, target: 'high-confidence' },
+ *     { value: 0.7, target: 'medium-confidence' },
+ *     { value: 0.5, target: 'low-confidence' }
+ *   ],
+ *   default: 'very-low-confidence'
+ * });
+ * ```
+ *
+ * @param options - Threshold node options
+ * @returns NodeDefinition for use in StateGraph
+ */
+export declare function createThresholdNode<TState extends AgentState = AgentState>(options: {
+    id: string;
+    name: string;
+    field: string;
+    thresholds: Array<{
+        value: number;
+        target: string;
+    }>;
+    default?: string;
+    nodeConfig?: NodeDefinition<TState>['config'];
+}): NodeDefinition<TState>;
+/**
+ * Create a boolean decision node (if-else)
+ *
+ * @example
+ * ```typescript
+ * const ifElseNode = createIfElseNode({
+ *   id: 'has-error',
+ *   name: 'Error Check',
+ *   condition: {
+ *     type: 'exists',
+ *     field: 'error'
+ *   },
+ *   ifTrue: 'error-handler',
+ *   ifFalse: 'success-handler'
+ * });
+ * ```
+ *
+ * @param options - If-else node options
+ * @returns NodeDefinition for use in StateGraph
+ */
+export declare function createIfElseNode<TState extends AgentState = AgentState>(options: {
+    id: string;
+    name: string;
+    condition: EdgeCondition;
+    ifTrue: string;
+    ifFalse: string;
+    nodeConfig?: NodeDefinition<TState>['config'];
+}): NodeDefinition<TState>;
+/**
+ * Create a multi-condition decision node (AND/OR logic)
+ *
+ * @example
+ * ```typescript
+ * const multiConditionNode = createMultiConditionNode({
+ *   id: 'complex-router',
+ *   name: 'Complex Router',
+ *   branches: [
+ *     {
+ *       name: 'premium-user',
+ *       target: 'premium-flow',
+ *       conditions: [
+ *         { type: 'equals', field: 'data.userType', value: 'premium' },
+ *         { type: 'greater_than', field: 'data.credits', value: 0 }
+ *       ],
+ *       logic: 'AND'
+ *     },
+ *     {
+ *       name: 'needs-upgrade',
+ *       target: 'upgrade-flow',
+ *       conditions: [
+ *         { type: 'equals', field: 'data.userType', value: 'free' },
+ *         { type: 'less_than', field: 'data.credits', value: 1 }
+ *       ],
+ *       logic: 'OR'
+ *     }
+ *   ],
+ *   default: 'standard-flow'
+ * });
+ * ```
+ *
+ * @param options - Multi-condition node options
+ * @returns NodeDefinition for use in StateGraph
+ */
+export declare function createMultiConditionNode<TState extends AgentState = AgentState>(options: {
+    id: string;
+    name: string;
+    branches: Array<{
+        name: string;
+        target: string;
+        conditions: EdgeCondition[];
+        logic: 'AND' | 'OR';
+        priority?: number;
+    }>;
+    default?: string;
+    nodeConfig?: NodeDefinition<TState>['config'];
+}): NodeDefinition<TState>;
+//# sourceMappingURL=decision-node.d.ts.map

package/dist/nodes/decision-node.d.ts.map

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