@wundr.io/langgraph-orchestrator 1.0.3

package/dist/nodes/llm-node.js

@@ -0,0 +1,325 @@
+"use strict";
+/**
+ * LLM Node - LLM-based decision and generation node
+ * @module @wundr.io/langgraph-orchestrator
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMNodeConfigSchema = void 0;
+exports.createLLMNode = createLLMNode;
+exports.createLLMRouter = createLLMRouter;
+exports.createStructuredLLMNode = createStructuredLLMNode;
+exports.createConversationalLLMNode = createConversationalLLMNode;
+const uuid_1 = require("uuid");
+const zod_1 = require("zod");
+/**
+ * Schema for LLM node configuration validation
+ */
+exports.LLMNodeConfigSchema = zod_1.z.object({
+    model: zod_1.z.string().optional(),
+    systemPrompt: zod_1.z.string().optional(),
+    temperature: zod_1.z.number().min(0).max(2).optional(),
+    maxTokens: zod_1.z.number().min(1).optional(),
+    stop: zod_1.z.array(zod_1.z.string()).optional(),
+    stream: zod_1.z.boolean().optional(),
+});
+/**
+ * Create an LLM node for the workflow graph
+ *
+ * @example
+ * ```typescript
+ * const llmNode = createLLMNode({
+ *   id: 'agent',
+ *   name: 'Agent Node',
+ *   config: {
+ *     model: 'claude-3-sonnet-20240229',
+ *     systemPrompt: 'You are a helpful assistant.',
+ *     temperature: 0.7
+ *   }
+ * });
+ *
+ * graph.addNode('agent', llmNode);
+ * ```
+ *
+ * @param options - Node creation options
+ * @returns NodeDefinition for use in StateGraph
+ */
+function createLLMNode(options) {
+    const { id, name, config, nodeConfig = {} } = options;
+    return {
+        id,
+        name,
+        type: 'llm',
+        config: nodeConfig,
+        execute: async (state, context) => {
+            const llmProvider = context.services.llmProvider;
+            if (!llmProvider) {
+                throw new Error('LLM provider not configured in node services');
+            }
+            // Build messages for the request
+            const messages = buildMessages(state, config);
+            // Build the request
+            const request = {
+                messages,
+                model: config.model,
+                temperature: config.temperature,
+                maxTokens: config.maxTokens,
+                stop: config.stop,
+                tools: config.tools,
+            };
+            context.services.logger.debug('Sending LLM request', {
+                model: config.model,
+                messageCount: messages.length,
+                hasTools: Boolean(config.tools?.length),
+            });
+            // Execute the request
+            const response = await llmProvider.generate(request);
+            context.services.logger.debug('Received LLM response', {
+                model: response.model,
+                finishReason: response.finishReason,
+                tokensUsed: response.usage.totalTokens,
+            });
+            // Build updated state
+            const newMessages = [...state.messages, response.message];
+            let newData = { ...state.data };
+            // Apply post-processing if configured
+            if (config.postProcess) {
+                const processed = config.postProcess(response, state);
+                newData = { ...newData, ...processed.data };
+            }
+            // Update token count in metadata
+            const tokensUsed = (state.metadata.tokensUsed ?? 0) + response.usage.totalTokens;
+            const newState = {
+                ...state,
+                messages: newMessages,
+                data: newData,
+                metadata: {
+                    ...state.metadata,
+                    tokensUsed,
+                },
+            };
+            // Determine next node
+            let next;
+            // Check if there are tool calls - if so, route to tool node
+            if (response.finishReason === 'tool_calls' &&
+                response.message.toolCalls?.length) {
+                // Store tool calls in state for tool node to process
+                newState.data['pendingToolCalls'] = response.message.toolCalls;
+                next = 'tools'; // Default name for tool node
+            }
+            else if (config.router) {
+                next = config.router(response, state);
+            }
+            return {
+                state: newState,
+                next,
+                metadata: {
+                    duration: 0, // Will be set by executor
+                    tokensUsed: response.usage.totalTokens,
+                    toolCalls: response.message.toolCalls,
+                },
+            };
+        },
+    };
+}
+/**
+ * Build messages array for LLM request
+ */
+function buildMessages(state, config) {
+    const messages = [];
+    // Add system prompt if configured
+    if (config.systemPrompt) {
+        messages.push({
+            id: (0, uuid_1.v4)(),
+            role: 'system',
+            content: config.systemPrompt,
+            timestamp: new Date(),
+        });
+    }
+    // Add existing messages from state
+    messages.push(...state.messages);
+    // If there's a custom prompt template, add it as a user message
+    if (config.promptTemplate) {
+        const prompt = config.promptTemplate(state);
+        messages.push({
+            id: (0, uuid_1.v4)(),
+            role: 'user',
+            content: prompt,
+            timestamp: new Date(),
+        });
+    }
+    return messages;
+}
+/**
+ * Create a router function for LLM decision-making
+ *
+ * @example
+ * ```typescript
+ * const router = createLLMRouter({
+ *   routes: {
+ *     'continue': 'process-node',
+ *     'finish': 'end-node',
+ *     'error': 'error-handler'
+ *   },
+ *   defaultRoute: 'continue',
+ *   extractDecision: (response) => {
+ *     const content = response.message.content;
+ *     if (content.includes('DONE')) return 'finish';
+ *     if (content.includes('ERROR')) return 'error';
+ *     return 'continue';
+ *   }
+ * });
+ * ```
+ *
+ * @param options - Router configuration
+ * @returns Router function for use in LLM node config
+ */
+function createLLMRouter(options) {
+    return (response, state) => {
+        const decision = options.extractDecision(response, state);
+        return options.routes[decision] ?? options.defaultRoute;
+    };
+}
+/**
+ * Create a structured output LLM node that validates responses
+ *
+ * @example
+ * ```typescript
+ * const responseSchema = z.object({
+ *   action: z.enum(['search', 'answer', 'clarify']),
+ *   content: z.string(),
+ *   confidence: z.number()
+ * });
+ *
+ * const structuredNode = createStructuredLLMNode({
+ *   id: 'structured-agent',
+ *   name: 'Structured Agent',
+ *   config: {
+ *     model: 'claude-3-sonnet-20240229',
+ *     systemPrompt: 'Respond in JSON format with action, content, and confidence fields.'
+ *   },
+ *   outputSchema: responseSchema,
+ *   stateMapper: (parsed) => ({ agentDecision: parsed })
+ * });
+ * ```
+ *
+ * @param options - Structured node options
+ * @returns NodeDefinition for use in StateGraph
+ */
+function createStructuredLLMNode(options) {
+    const { id, name, config, outputSchema, stateMapper, nodeConfig = {}, } = options;
+    const baseNode = createLLMNode({
+        id,
+        name,
+        config: {
+            ...config,
+            postProcess: (response, state) => {
+                // Try to parse JSON from response
+                const content = response.message.content;
+                let parsed;
+                try {
+                    // Try to extract JSON from the response
+                    const jsonMatch = content.match(/\{[\s\S]*\}/);
+                    if (jsonMatch) {
+                        const raw = JSON.parse(jsonMatch[0]);
+                        parsed = outputSchema.parse(raw);
+                    }
+                    else {
+                        throw new Error('No JSON object found in response');
+                    }
+                }
+                catch (error) {
+                    throw new Error(`Failed to parse structured output: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                // Map parsed output to state
+                const mappedData = stateMapper(parsed);
+                return { data: { ...state.data, ...mappedData } };
+            },
+        },
+        nodeConfig,
+    });
+    return {
+        ...baseNode,
+        outputSchema,
+    };
+}
+/**
+ * Create a conversational LLM node that maintains chat history
+ *
+ * @example
+ * ```typescript
+ * const chatNode = createConversationalLLMNode({
+ *   id: 'chat',
+ *   name: 'Chat Node',
+ *   config: {
+ *     model: 'claude-3-sonnet-20240229',
+ *     systemPrompt: 'You are a helpful assistant.'
+ *   },
+ *   maxHistoryLength: 10
+ * });
+ * ```
+ *
+ * @param options - Conversational node options
+ * @returns NodeDefinition for use in StateGraph
+ */
+function createConversationalLLMNode(options) {
+    const { id, name, config, maxHistoryLength = 50, nodeConfig = {} } = options;
+    return {
+        id,
+        name,
+        type: 'llm',
+        config: nodeConfig,
+        execute: async (state, context) => {
+            const llmProvider = context.services.llmProvider;
+            if (!llmProvider) {
+                throw new Error('LLM provider not configured in node services');
+            }
+            // Trim history if needed
+            let historyMessages = state.messages;
+            if (historyMessages.length > maxHistoryLength) {
+                // Keep system message if present, then most recent messages
+                const systemMessages = historyMessages.filter(m => m.role === 'system');
+                const nonSystemMessages = historyMessages.filter(m => m.role !== 'system');
+                const trimmedNonSystem = nonSystemMessages.slice(-maxHistoryLength);
+                historyMessages = [...systemMessages, ...trimmedNonSystem];
+            }
+            // Build messages
+            const messages = [];
+            if (config.systemPrompt) {
+                messages.push({
+                    id: (0, uuid_1.v4)(),
+                    role: 'system',
+                    content: config.systemPrompt,
+                    timestamp: new Date(),
+                });
+            }
+            messages.push(...historyMessages.filter(m => m.role !== 'system'));
+            const request = {
+                messages,
+                model: config.model,
+                temperature: config.temperature,
+                maxTokens: config.maxTokens,
+                stop: config.stop,
+                tools: config.tools,
+            };
+            const response = await llmProvider.generate(request);
+            const newMessages = [...state.messages, response.message];
+            const tokensUsed = (state.metadata.tokensUsed ?? 0) + response.usage.totalTokens;
+            const newState = {
+                ...state,
+                messages: newMessages,
+                metadata: {
+                    ...state.metadata,
+                    tokensUsed,
+                },
+            };
+            return {
+                state: newState,
+                metadata: {
+                    duration: 0,
+                    tokensUsed: response.usage.totalTokens,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=llm-node.js.map

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

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

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

@@ -0,0 +1,151 @@
+/**
+ * Tool Node - Tool execution node for agent workflows
+ * @module @wundr.io/langgraph-orchestrator
+ */
+import { z } from 'zod';
+import type { AgentState, NodeDefinition, Tool, ToolCall, ToolResult, ToolRegistry } from '../types';
+/**
+ * Configuration for tool node
+ */
+export interface ToolNodeConfig {
+    /** Available tools (if not using registry) */
+    readonly tools?: Tool[];
+    /** Whether to execute tools in parallel */
+    readonly parallel?: boolean;
+    /** Maximum concurrent tool executions */
+    readonly maxConcurrency?: number;
+    /** Timeout per tool execution in milliseconds */
+    readonly toolTimeout?: number;
+    /** Whether to continue on tool error */
+    readonly continueOnError?: boolean;
+    /** Custom error handler */
+    readonly onError?: (error: Error, toolCall: ToolCall) => ToolResult;
+    /** Post-processing for tool results */
+    readonly postProcess?: (results: ToolResult[], state: AgentState) => Partial<AgentState['data']>;
+}
+/**
+ * Schema for tool node configuration validation
+ */
+export declare const ToolNodeConfigSchema: z.ZodObject<{
+    parallel: z.ZodOptional<z.ZodBoolean>;
+    maxConcurrency: z.ZodOptional<z.ZodNumber>;
+    toolTimeout: z.ZodOptional<z.ZodNumber>;
+    continueOnError: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    parallel?: boolean | undefined;
+    maxConcurrency?: number | undefined;
+    toolTimeout?: number | undefined;
+    continueOnError?: boolean | undefined;
+}, {
+    parallel?: boolean | undefined;
+    maxConcurrency?: number | undefined;
+    toolTimeout?: number | undefined;
+    continueOnError?: boolean | undefined;
+}>;
+/**
+ * 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
+ */
+export declare function createToolNode<TState extends AgentState = AgentState>(options: {
+    id: string;
+    name: string;
+    config?: ToolNodeConfig;
+    nodeConfig?: NodeDefinition<TState>['config'];
+}): NodeDefinition<TState>;
+/**
+ * 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
+ */
+export declare function createToolRegistry(): ToolRegistry;
+/**
+ * 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
+ */
+export declare function createTool<TInput, TOutput = unknown>(options: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodSchema<TInput>;
+    outputSchema?: z.ZodSchema<TOutput>;
+    execute: (input: TInput) => Promise<TOutput>;
+}): Tool;
+/**
+ * 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
+ */
+export declare function createBatchToolNode<TState extends AgentState = AgentState>(options: {
+    id: string;
+    name: string;
+    config?: ToolNodeConfig & {
+        batchSize?: number;
+        batchTimeout?: number;
+    };
+    nodeConfig?: NodeDefinition<TState>['config'];
+}): NodeDefinition<TState>;
+//# sourceMappingURL=tool-node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-node.d.ts","sourceRoot":"","sources":["../../src/nodes/tool-node.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EAId,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,YAAY,EACb,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IACxB,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,iDAAiD;IACjD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,KAAK,UAAU,CAAC;IACpE,uCAAuC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,CACrB,OAAO,EAAE,UAAU,EAAE,EACrB,KAAK,EAAE,UAAU,KACd,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAC5B,MAAM,SAAS,UAAU,GAAG,UAAU,EACtC,OAAO,EAAE;IACT,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,UAAU,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;CAC/C,GAAG,cAAc,CAAC,MAAM,CAAC,CA2FzB;AAgLD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAuBjD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9C,GAAG,IAAI,CAWP;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,SAAS,UAAU,GAAG,UAAU,EACtC,OAAO,EAAE;IACT,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,cAAc,GAAG;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,UAAU,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC;CAC/C,GAAG,cAAc,CAAC,MAAM,CAAC,CA4DzB"}