@wundr.io/langgraph-orchestrator 1.0.3

package/dist/state-graph.d.ts

@@ -0,0 +1,158 @@
+/**
+ * StateGraph - Core class for defining workflow graphs with nodes and edges
+ * @module @wundr.io/langgraph-orchestrator
+ */
+import { EventEmitter } from 'eventemitter3';
+import type { AgentState, GraphConfig, GraphGlobalConfig, NodeDefinition, EdgeCondition, ExecutionOptions, ExecutionResult, NodeResult, NodeServices, Checkpoint, WorkflowError, GraphCheckpointer } from './types';
+/**
+ * Events emitted by StateGraph
+ */
+export interface StateGraphEvents {
+    'execution:start': (state: AgentState) => void;
+    'execution:complete': (result: ExecutionResult) => void;
+    'execution:error': (error: WorkflowError) => void;
+    'node:enter': (nodeName: string, state: AgentState) => void;
+    'node:exit': (nodeName: string, result: NodeResult) => void;
+    'checkpoint:created': (checkpoint: Checkpoint) => void;
+    'state:updated': (state: AgentState) => void;
+}
+/**
+ * StateGraph class for defining and executing workflow graphs
+ *
+ * @example
+ * ```typescript
+ * const graph = new StateGraph('my-workflow')
+ *   .addNode('start', {
+ *     id: 'start',
+ *     name: 'Start Node',
+ *     type: 'start',
+ *     config: {},
+ *     execute: async (state) => ({ state, next: 'process' })
+ *   })
+ *   .addNode('process', {
+ *     id: 'process',
+ *     name: 'Process Node',
+ *     type: 'transform',
+ *     config: {},
+ *     execute: async (state) => ({ state, next: 'end' })
+ *   })
+ *   .addEdge('start', 'process')
+ *   .setEntryPoint('start');
+ *
+ * const result = await graph.execute();
+ * ```
+ */
+export declare class StateGraph<TState extends AgentState = AgentState> extends EventEmitter<StateGraphEvents> {
+    private readonly id;
+    private readonly name;
+    private readonly description?;
+    private readonly nodes;
+    private readonly edges;
+    private entryPoint?;
+    private config;
+    private _checkpointer?;
+    private services;
+    private logger;
+    /** Get the checkpointer */
+    get checkpointer(): GraphCheckpointer | undefined;
+    /**
+     * Create a new StateGraph
+     * @param name - Human-readable name for the graph
+     * @param config - Optional configuration overrides
+     */
+    constructor(name: string, config?: Partial<GraphGlobalConfig>);
+    /**
+     * Add a node to the graph
+     * @param name - Unique name for the node
+     * @param definition - Node definition
+     * @returns this for chaining
+     */
+    addNode(name: string, definition: NodeDefinition<TState>): this;
+    /**
+     * Add a direct edge between nodes
+     * @param from - Source node name
+     * @param to - Target node name
+     * @returns this for chaining
+     */
+    addEdge(from: string, to: string): this;
+    /**
+     * Add a conditional edge
+     * @param from - Source node name
+     * @param to - Target node name
+     * @param condition - Condition for traversal
+     * @returns this for chaining
+     */
+    addConditionalEdge(from: string, to: string, condition: EdgeCondition): this;
+    /**
+     * Add a loop edge that can cycle back
+     * @param from - Source node name
+     * @param to - Target node name (can be same as from)
+     * @param condition - Condition to continue looping
+     * @returns this for chaining
+     */
+    addLoopEdge(from: string, to: string, condition: EdgeCondition): this;
+    /**
+     * Add parallel edges to multiple targets
+     * @param from - Source node name
+     * @param targets - Target node names
+     * @returns this for chaining
+     */
+    addParallelEdges(from: string, targets: string[]): this;
+    /**
+     * Set the entry point node
+     * @param nodeName - Name of the entry point node
+     * @returns this for chaining
+     */
+    setEntryPoint(nodeName: string): this;
+    /**
+     * Set the checkpointer for state persistence
+     * @param checkpointer - Checkpointer implementation
+     * @returns this for chaining
+     */
+    setCheckpointer(checkpointer: GraphCheckpointer): this;
+    /**
+     * Set services available to nodes
+     * @param services - Services to provide
+     * @returns this for chaining
+     */
+    setServices(services: Partial<NodeServices>): this;
+    /**
+     * Get the graph configuration
+     * @returns GraphConfig object
+     */
+    getConfig(): GraphConfig;
+    /**
+     * Execute the graph
+     * @param options - Execution options
+     * @returns Execution result
+     */
+    execute(options?: ExecutionOptions): Promise<ExecutionResult>;
+    /**
+     * Compile the graph into an executable form
+     * @returns Compiled graph configuration
+     */
+    compile(): GraphConfig;
+    /**
+     * Create a subgraph from a subset of nodes
+     * @param nodeNames - Names of nodes to include
+     * @returns New StateGraph containing the subgraph
+     */
+    subgraph(nodeNames: string[]): StateGraph<TState>;
+    private validateNodeExists;
+    private validateGraph;
+    private initializeState;
+    private getNodeFromCheckpoint;
+    private executeNodeWithRetry;
+    private updateStateWithHistory;
+    private computeStateChanges;
+    private determineNextNode;
+    private evaluateEdgeCondition;
+    private getFieldValue;
+    private createCheckpoint;
+    private createError;
+    private normalizeError;
+    private isWorkflowError;
+    private getRecoveryHints;
+    private sleep;
+}
+//# sourceMappingURL=state-graph.d.ts.map

package/dist/state-graph.d.ts.map

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