@wundr.io/langgraph-orchestrator 1.0.3

package/dist/nodes/tool-node.js

@@ -0,0 +1,373 @@
+"use strict";
+/**
+ * Tool Node - Tool execution node for agent workflows
+ * @module @wundr.io/langgraph-orchestrator
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolNodeConfigSchema = void 0;
+exports.createToolNode = createToolNode;
+exports.createToolRegistry = createToolRegistry;
+exports.createTool = createTool;
+exports.createBatchToolNode = createBatchToolNode;
+const uuid_1 = require("uuid");
+const zod_1 = require("zod");
+/**
+ * Schema for tool node configuration validation
+ */
+exports.ToolNodeConfigSchema = zod_1.z.object({
+    parallel: zod_1.z.boolean().optional(),
+    maxConcurrency: zod_1.z.number().min(1).optional(),
+    toolTimeout: zod_1.z.number().min(0).optional(),
+    continueOnError: zod_1.z.boolean().optional(),
+});
+/**
+ * Create a tool execution node
+ *
+ * @example
+ * ```typescript
+ * const toolNode = createToolNode({
+ *   id: 'tools',
+ *   name: 'Tool Executor',
+ *   config: {
+ *     parallel: true,
+ *     maxConcurrency: 3,
+ *     continueOnError: true
+ *   }
+ * });
+ *
+ * graph.addNode('tools', toolNode);
+ * ```
+ *
+ * @param options - Node creation options
+ * @returns NodeDefinition for use in StateGraph
+ */
+function createToolNode(options) {
+    const { id, name, config = {}, nodeConfig = {} } = options;
+    return {
+        id,
+        name,
+        type: 'tool',
+        config: nodeConfig,
+        execute: async (state, context) => {
+            // Get pending tool calls from state
+            const pendingToolCalls = state.data['pendingToolCalls'];
+            if (!pendingToolCalls || pendingToolCalls.length === 0) {
+                context.services.logger.warn('Tool node executed with no pending tool calls');
+                return { state };
+            }
+            context.services.logger.debug('Executing tool calls', {
+                count: pendingToolCalls.length,
+                tools: pendingToolCalls.map(tc => tc.name),
+            });
+            // Get tools from config or registry
+            const tools = config.tools ?? getToolsFromRegistry(context.services.toolRegistry);
+            const toolMap = new Map(tools.map(t => [t.name, t]));
+            // Execute tool calls
+            const results = await executeToolCalls(pendingToolCalls, toolMap, config, context);
+            // Build tool result messages
+            const toolMessages = results.map(result => ({
+                id: (0, uuid_1.v4)(),
+                role: 'tool',
+                content: result.content,
+                toolResult: result,
+                timestamp: new Date(),
+            }));
+            // Build updated state
+            let newData = { ...state.data };
+            delete newData['pendingToolCalls']; // Clear pending calls
+            // Store results in state
+            newData['lastToolResults'] = results;
+            // Apply post-processing if configured
+            if (config.postProcess) {
+                const processed = config.postProcess(results, state);
+                newData = { ...newData, ...processed };
+            }
+            const newState = {
+                ...state,
+                messages: [...state.messages, ...toolMessages],
+                data: newData,
+            };
+            // Check if all tools succeeded
+            const _allSucceeded = results.every(r => r.success);
+            const hasErrors = results.some(r => !r.success);
+            context.services.logger.debug('Tool execution complete', {
+                total: results.length,
+                succeeded: results.filter(r => r.success).length,
+                failed: results.filter(r => !r.success).length,
+            });
+            return {
+                state: newState,
+                // If there were errors and we're not continuing, route to error handler
+                next: hasErrors && !config.continueOnError ? 'error' : undefined,
+                metadata: {
+                    duration: 0,
+                    toolCalls: pendingToolCalls,
+                },
+            };
+        },
+    };
+}
+/**
+ * Execute tool calls with concurrency control
+ */
+async function executeToolCalls(toolCalls, toolMap, config, context) {
+    if (config.parallel) {
+        return executeParallel(toolCalls, toolMap, config, context);
+    }
+    return executeSequential(toolCalls, toolMap, config, context);
+}
+/**
+ * Execute tool calls sequentially
+ */
+async function executeSequential(toolCalls, toolMap, config, context) {
+    const results = [];
+    for (const toolCall of toolCalls) {
+        const result = await executeSingleTool(toolCall, toolMap, config, context);
+        results.push(result);
+        // Stop if there's an error and we're not continuing on error
+        if (!result.success && !config.continueOnError) {
+            break;
+        }
+    }
+    return results;
+}
+/**
+ * Execute tool calls in parallel with concurrency limit
+ */
+async function executeParallel(toolCalls, toolMap, config, context) {
+    const maxConcurrency = config.maxConcurrency ?? 5;
+    const results = [];
+    const executing = [];
+    for (const toolCall of toolCalls) {
+        const promise = executeSingleTool(toolCall, toolMap, config, context);
+        executing.push(promise);
+        if (executing.length >= maxConcurrency) {
+            const result = await Promise.race(executing);
+            results.push(result);
+            const index = executing.indexOf(promise);
+            if (index > -1) {
+                executing.splice(index, 1);
+            }
+        }
+    }
+    // Wait for remaining executions
+    const remaining = await Promise.all(executing);
+    results.push(...remaining);
+    return results;
+}
+/**
+ * Execute a single tool call
+ */
+async function executeSingleTool(toolCall, toolMap, config, context) {
+    const tool = toolMap.get(toolCall.name);
+    if (!tool) {
+        const error = new Error(`Tool "${toolCall.name}" not found`);
+        if (config.onError) {
+            return config.onError(error, toolCall);
+        }
+        return {
+            toolCallId: toolCall.id,
+            content: `Error: Tool "${toolCall.name}" not found`,
+            success: false,
+            error: error.message,
+        };
+    }
+    try {
+        // Validate input if schema provided
+        if (tool.inputSchema) {
+            tool.inputSchema.parse(toolCall.arguments);
+        }
+        // Execute with timeout if configured
+        const result = config.toolTimeout
+            ? await executeWithTimeout(tool, toolCall.arguments, config.toolTimeout)
+            : await tool.execute(toolCall.arguments);
+        // Validate output if schema provided
+        if (tool.outputSchema) {
+            tool.outputSchema.parse(result);
+        }
+        context.services.logger.debug('Tool executed successfully', {
+            tool: toolCall.name,
+            callId: toolCall.id,
+        });
+        return {
+            toolCallId: toolCall.id,
+            content: typeof result === 'string' ? result : JSON.stringify(result),
+            success: true,
+        };
+    }
+    catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        context.services.logger.error('Tool execution failed', {
+            tool: toolCall.name,
+            callId: toolCall.id,
+            error: err.message,
+        });
+        if (config.onError) {
+            return config.onError(err, toolCall);
+        }
+        return {
+            toolCallId: toolCall.id,
+            content: `Error executing tool "${toolCall.name}": ${err.message}`,
+            success: false,
+            error: err.message,
+        };
+    }
+}
+/**
+ * Execute tool with timeout
+ */
+async function executeWithTimeout(tool, args, timeout) {
+    return Promise.race([
+        tool.execute(args),
+        new Promise((_, reject) => setTimeout(() => reject(new Error(`Tool execution timed out after ${timeout}ms`)), timeout)),
+    ]);
+}
+/**
+ * Get tools from registry
+ */
+function getToolsFromRegistry(registry) {
+    if (!registry) {
+        return [];
+    }
+    return registry.list();
+}
+/**
+ * Create a simple in-memory tool registry
+ *
+ * @example
+ * ```typescript
+ * const registry = createToolRegistry();
+ * registry.register({
+ *   name: 'search',
+ *   description: 'Search the web',
+ *   inputSchema: z.object({ query: z.string() }),
+ *   execute: async ({ query }) => searchWeb(query)
+ * });
+ *
+ * graph.setServices({ toolRegistry: registry });
+ * ```
+ *
+ * @returns ToolRegistry implementation
+ */
+function createToolRegistry() {
+    const tools = new Map();
+    return {
+        get(name) {
+            return tools.get(name);
+        },
+        list() {
+            return Array.from(tools.values());
+        },
+        register(tool) {
+            if (tools.has(tool.name)) {
+                throw new Error(`Tool "${tool.name}" is already registered`);
+            }
+            tools.set(tool.name, tool);
+        },
+        unregister(name) {
+            tools.delete(name);
+        },
+    };
+}
+/**
+ * Create a tool definition with type-safe input/output
+ *
+ * @example
+ * ```typescript
+ * const searchTool = createTool({
+ *   name: 'search',
+ *   description: 'Search the web for information',
+ *   inputSchema: z.object({
+ *     query: z.string(),
+ *     maxResults: z.number().optional()
+ *   }),
+ *   outputSchema: z.array(z.object({
+ *     title: z.string(),
+ *     url: z.string(),
+ *     snippet: z.string()
+ *   })),
+ *   execute: async ({ query, maxResults = 10 }) => {
+ *     return await searchWeb(query, maxResults);
+ *   }
+ * });
+ * ```
+ *
+ * @param options - Tool definition options
+ * @returns Tool definition
+ */
+function createTool(options) {
+    return {
+        name: options.name,
+        description: options.description,
+        inputSchema: options.inputSchema,
+        outputSchema: options.outputSchema,
+        execute: async (input) => {
+            const parsed = options.inputSchema.parse(input);
+            return options.execute(parsed);
+        },
+    };
+}
+/**
+ * Create a batch tool node that groups tool calls
+ *
+ * @example
+ * ```typescript
+ * const batchToolNode = createBatchToolNode({
+ *   id: 'batch-tools',
+ *   name: 'Batch Tool Executor',
+ *   config: {
+ *     batchSize: 5,
+ *     batchTimeout: 1000
+ *   }
+ * });
+ * ```
+ *
+ * @param options - Node creation options
+ * @returns NodeDefinition for use in StateGraph
+ */
+function createBatchToolNode(options) {
+    const { id, name, config = {}, nodeConfig = {} } = options;
+    const batchSize = config.batchSize ?? 10;
+    return {
+        id,
+        name,
+        type: 'tool',
+        config: nodeConfig,
+        execute: async (state, context) => {
+            const pendingToolCalls = state.data['pendingToolCalls'];
+            if (!pendingToolCalls || pendingToolCalls.length === 0) {
+                return { state };
+            }
+            const tools = config.tools ?? getToolsFromRegistry(context.services.toolRegistry);
+            const toolMap = new Map(tools.map(t => [t.name, t]));
+            // Process in batches
+            const batches = [];
+            for (let i = 0; i < pendingToolCalls.length; i += batchSize) {
+                batches.push(pendingToolCalls.slice(i, i + batchSize));
+            }
+            const allResults = [];
+            for (const batch of batches) {
+                const results = await executeParallel(batch, toolMap, config, context);
+                allResults.push(...results);
+            }
+            // Build tool result messages
+            const toolMessages = allResults.map(result => ({
+                id: (0, uuid_1.v4)(),
+                role: 'tool',
+                content: result.content,
+                toolResult: result,
+                timestamp: new Date(),
+            }));
+            const newData = { ...state.data };
+            delete newData['pendingToolCalls'];
+            newData['lastToolResults'] = allResults;
+            const newState = {
+                ...state,
+                messages: [...state.messages, ...toolMessages],
+                data: newData,
+            };
+            return { state: newState };
+        },
+    };
+}
+//# sourceMappingURL=tool-node.js.map

package/dist/nodes/tool-node.js.map

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

package/dist/prebuilt-graphs/plan-execute-refine.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Plan-Execute-Refine Graph - Ready-to-use workflow pattern
+ * @module @wundr.io/langgraph-orchestrator
+ */
+import { z } from 'zod';
+import { StateGraph } from '../state-graph';
+import type { HumanInputHandler } from '../nodes/human-node';
+import type { AgentState, Tool, LLMProvider } from '../types';
+/**
+ * Extended state for plan-execute-refine workflow
+ */
+export interface PlanExecuteState extends AgentState {
+    /** The current plan */
+    readonly data: AgentState['data'] & {
+        /** Original task/goal */
+        task?: string;
+        /** Generated plan steps */
+        plan?: PlanStep[];
+        /** Current step being executed */
+        currentStepIndex?: number;
+        /** Execution results for each step */
+        stepResults?: StepResult[];
+        /** Overall execution status */
+        executionStatus?: 'planning' | 'executing' | 'refining' | 'complete' | 'failed';
+        /** Number of refinement iterations */
+        refinementCount?: number;
+        /** Maximum refinement iterations */
+        maxRefinements?: number;
+        /** Final result */
+        finalResult?: unknown;
+    };
+}
+/**
+ * A step in the plan
+ */
+export interface PlanStep {
+    /** Step identifier */
+    id: string;
+    /** Step description */
+    description: string;
+    /** Tool to use (if any) */
+    tool?: string;
+    /** Tool arguments */
+    toolArgs?: Record<string, unknown>;
+    /** Dependencies on other steps */
+    dependsOn?: string[];
+    /** Expected output description */
+    expectedOutput?: string;
+}
+/**
+ * Result of executing a step
+ */
+export interface StepResult {
+    /** Step ID */
+    stepId: string;
+    /** Whether step succeeded */
+    success: boolean;
+    /** Result data */
+    result?: unknown;
+    /** Error message if failed */
+    error?: string;
+    /** Execution timestamp */
+    timestamp: Date;
+}
+/**
+ * Configuration for plan-execute-refine graph
+ */
+export interface PlanExecuteRefineConfig {
+    /** LLM provider for planning and refinement */
+    llmProvider: LLMProvider;
+    /** Available tools */
+    tools?: Tool[];
+    /** Human input handler for approval steps */
+    humanHandler?: HumanInputHandler;
+    /** Maximum refinement iterations */
+    maxRefinements?: number;
+    /** Whether to require human approval before execution */
+    requireApproval?: boolean;
+    /** Custom planner prompt */
+    plannerPrompt?: string;
+    /** Custom executor prompt */
+    executorPrompt?: string;
+    /** Custom refiner prompt */
+    refinerPrompt?: string;
+    /** Model to use */
+    model?: string;
+}
+/**
+ * Schema for plan validation
+ */
+export declare const PlanSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodString;
+    tool: z.ZodOptional<z.ZodString>;
+    toolArgs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    dependsOn: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    expectedOutput: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    description: string;
+    tool?: string | undefined;
+    toolArgs?: Record<string, unknown> | undefined;
+    dependsOn?: string[] | undefined;
+    expectedOutput?: string | undefined;
+}, {
+    id: string;
+    description: string;
+    tool?: string | undefined;
+    toolArgs?: Record<string, unknown> | undefined;
+    dependsOn?: string[] | undefined;
+    expectedOutput?: string | undefined;
+}>, "many">;
+/**
+ * Create a plan-execute-refine workflow graph
+ *
+ * @example
+ * ```typescript
+ * const graph = createPlanExecuteRefineGraph({
+ *   llmProvider: myLLMProvider,
+ *   tools: [searchTool, calculatorTool],
+ *   maxRefinements: 3,
+ *   requireApproval: true,
+ *   humanHandler: myHumanHandler
+ * });
+ *
+ * const result = await graph.execute({
+ *   initialState: {
+ *     data: { task: 'Research and summarize the latest AI developments' }
+ *   }
+ * });
+ * ```
+ *
+ * @param config - Graph configuration
+ * @returns Configured StateGraph
+ */
+export declare function createPlanExecuteRefineGraph(config: PlanExecuteRefineConfig): StateGraph<PlanExecuteState>;
+/**
+ * Create a simple task executor graph (simplified version)
+ *
+ * @example
+ * ```typescript
+ * const graph = createSimpleTaskGraph({
+ *   llmProvider: myProvider,
+ *   tools: [searchTool]
+ * });
+ * ```
+ */
+export declare function createSimpleTaskGraph(config: Omit<PlanExecuteRefineConfig, 'requireApproval' | 'humanHandler'>): StateGraph<PlanExecuteState>;
+//# sourceMappingURL=plan-execute-refine.d.ts.map

package/dist/prebuilt-graphs/plan-execute-refine.d.ts.map

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