@wundr.io/langgraph-orchestrator 1.0.3

package/dist/nodes/human-node.js

@@ -0,0 +1,394 @@
+"use strict";
+/**
+ * Human Node - Human-in-the-loop interaction node
+ * @module @wundr.io/langgraph-orchestrator
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HumanNodeConfigSchema = void 0;
+exports.createHumanNode = createHumanNode;
+exports.createConsoleInputHandler = createConsoleInputHandler;
+exports.createCallbackInputHandler = createCallbackInputHandler;
+exports.createConfirmationNode = createConfirmationNode;
+exports.createFeedbackNode = createFeedbackNode;
+const uuid_1 = require("uuid");
+const zod_1 = require("zod");
+/**
+ * Schema for human node configuration validation
+ */
+exports.HumanNodeConfigSchema = zod_1.z.object({
+    prompt: zod_1.z.union([zod_1.z.string(), zod_1.z.function()]).optional(),
+    timeout: zod_1.z.number().min(0).optional(),
+    onTimeout: zod_1.z.enum(['error', 'skip', 'default']).optional(),
+    choices: zod_1.z
+        .array(zod_1.z.object({
+        value: zod_1.z.string(),
+        label: zod_1.z.string(),
+        description: zod_1.z.string().optional(),
+        default: zod_1.z.boolean().optional(),
+    }))
+        .optional(),
+    requireConfirmation: zod_1.z.boolean().optional(),
+});
+/**
+ * Create a human-in-the-loop node
+ *
+ * @example
+ * ```typescript
+ * const humanNode = createHumanNode({
+ *   id: 'approval',
+ *   name: 'Human Approval',
+ *   config: {
+ *     prompt: 'Please review and approve the generated content.',
+ *     inputHandler: myInputHandler,
+ *     choices: [
+ *       { value: 'approve', label: 'Approve' },
+ *       { value: 'reject', label: 'Reject' },
+ *       { value: 'modify', label: 'Request Modifications' }
+ *     ],
+ *     timeout: 300000 // 5 minutes
+ *   }
+ * });
+ *
+ * graph.addNode('approval', humanNode);
+ * ```
+ *
+ * @param options - Node creation options
+ * @returns NodeDefinition for use in StateGraph
+ */
+function createHumanNode(options) {
+    const { id, name, config, nodeConfig = {} } = options;
+    return {
+        id,
+        name,
+        type: 'human',
+        config: nodeConfig,
+        execute: async (state, context) => {
+            const requestId = (0, uuid_1.v4)();
+            // Build prompt
+            const prompt = typeof config.prompt === 'function'
+                ? config.prompt(state)
+                : (config.prompt ?? 'Please provide input:');
+            context.services.logger.info('Requesting human input', {
+                requestId,
+                hasChoices: Boolean(config.choices?.length),
+            });
+            // Build input context
+            const inputContext = {
+                requestId,
+                prompt,
+                choices: config.choices,
+                state: sanitizeStateForHuman(state),
+                timeout: config.timeout,
+                metadata: {
+                    nodeId: id,
+                    nodeName: name,
+                    executionId: context.executionId,
+                },
+            };
+            let response;
+            try {
+                // Request input with timeout if configured
+                if (config.timeout) {
+                    response = await Promise.race([
+                        config.inputHandler.request(inputContext),
+                        createTimeoutPromise(config.timeout, requestId),
+                    ]);
+                }
+                else {
+                    response = await config.inputHandler.request(inputContext);
+                }
+            }
+            catch (error) {
+                // Handle timeout
+                if (error.message === 'TIMEOUT') {
+                    response = {
+                        value: config.defaultValue,
+                        type: 'timeout',
+                        timestamp: new Date(),
+                    };
+                    if (config.onTimeout === 'error') {
+                        throw new Error(`Human input timed out after ${config.timeout}ms`);
+                    }
+                    if (config.onTimeout === 'skip') {
+                        context.services.logger.warn('Human input timed out, skipping');
+                        return { state };
+                    }
+                }
+                else {
+                    throw error;
+                }
+            }
+            context.services.logger.debug('Received human response', {
+                requestId,
+                type: response.type,
+            });
+            // Handle cancellation
+            if (response.type === 'cancel') {
+                context.services.logger.info('Human cancelled input');
+                return {
+                    state,
+                    terminate: true,
+                };
+            }
+            // Validate response if schema provided
+            if (config.validation && response.type !== 'timeout') {
+                try {
+                    config.validation.parse(response.value);
+                }
+                catch (validationError) {
+                    throw new Error(`Human input validation failed: ${validationError instanceof Error ? validationError.message : String(validationError)}`);
+                }
+            }
+            // Build human message
+            const humanMessage = {
+                id: (0, uuid_1.v4)(),
+                role: 'user',
+                content: formatResponseContent(response),
+                timestamp: response.timestamp,
+                metadata: {
+                    requestId,
+                    responseType: response.type,
+                    ...response.metadata,
+                },
+            };
+            // Build updated state
+            let newData = { ...state.data };
+            newData['lastHumanResponse'] = response;
+            // Apply custom response processor
+            if (config.processResponse) {
+                const processed = config.processResponse(response, state);
+                newData = { ...newData, ...processed };
+            }
+            const newState = {
+                ...state,
+                messages: [...state.messages, humanMessage],
+                data: newData,
+            };
+            return {
+                state: newState,
+                metadata: {
+                    duration: 0,
+                },
+            };
+        },
+    };
+}
+/**
+ * Sanitize state for human viewing
+ */
+function sanitizeStateForHuman(state) {
+    return {
+        currentStep: state.currentStep,
+        data: state.data,
+        messages: state.messages.slice(-5), // Only show recent messages
+    };
+}
+/**
+ * Create a timeout promise
+ */
+function createTimeoutPromise(timeout, _requestId) {
+    return new Promise((_, reject) => {
+        setTimeout(() => reject(new Error('TIMEOUT')), timeout);
+    });
+}
+/**
+ * Format response content as string
+ */
+function formatResponseContent(response) {
+    if (response.type === 'timeout') {
+        return '[Timed out - using default]';
+    }
+    if (response.type === 'cancel') {
+        return '[Cancelled]';
+    }
+    if (typeof response.value === 'string') {
+        return response.value;
+    }
+    return JSON.stringify(response.value);
+}
+/**
+ * Create a console-based human input handler
+ *
+ * @example
+ * ```typescript
+ * const handler = createConsoleInputHandler();
+ *
+ * const humanNode = createHumanNode({
+ *   id: 'input',
+ *   name: 'User Input',
+ *   config: {
+ *     inputHandler: handler,
+ *     prompt: 'Enter your response:'
+ *   }
+ * });
+ * ```
+ *
+ * @returns HumanInputHandler for console input
+ */
+function createConsoleInputHandler() {
+    // Note: This is a placeholder - actual console input would need readline
+    // In production, use a proper event-based input handler
+    return {
+        async request(_context) {
+            // In a real implementation, this would read from stdin
+            // For now, return a placeholder response
+            return {
+                value: 'placeholder-response',
+                type: 'input',
+                timestamp: new Date(),
+            };
+        },
+    };
+}
+/**
+ * Create a callback-based human input handler
+ *
+ * @example
+ * ```typescript
+ * const pendingRequests = new Map();
+ *
+ * const handler = createCallbackInputHandler({
+ *   onRequest: (context) => {
+ *     pendingRequests.set(context.requestId, context);
+ *     // Notify UI or external system
+ *   },
+ *   onResolve: (requestId) => pendingRequests.delete(requestId)
+ * });
+ *
+ * // External system resolves:
+ * handler.resolve(requestId, { value: 'user input', type: 'input', timestamp: new Date() });
+ * ```
+ *
+ * @param options - Handler options
+ * @returns HumanInputHandler with resolve capability
+ */
+function createCallbackInputHandler(options) {
+    const pending = new Map();
+    return {
+        async request(context) {
+            return new Promise((resolve, reject) => {
+                pending.set(context.requestId, { resolve, reject });
+                options.onRequest?.(context);
+            });
+        },
+        async cancel(requestId) {
+            const handlers = pending.get(requestId);
+            if (handlers) {
+                handlers.resolve({
+                    value: null,
+                    type: 'cancel',
+                    timestamp: new Date(),
+                });
+                pending.delete(requestId);
+                options.onCancel?.(requestId);
+            }
+        },
+        resolve(requestId, response) {
+            const handlers = pending.get(requestId);
+            if (handlers) {
+                handlers.resolve(response);
+                pending.delete(requestId);
+                options.onResolve?.(requestId);
+            }
+        },
+        reject(requestId, error) {
+            const handlers = pending.get(requestId);
+            if (handlers) {
+                handlers.reject(error);
+                pending.delete(requestId);
+            }
+        },
+    };
+}
+/**
+ * Create a confirmation node for human approval
+ *
+ * @example
+ * ```typescript
+ * const confirmNode = createConfirmationNode({
+ *   id: 'confirm-action',
+ *   name: 'Confirm Action',
+ *   inputHandler: myHandler,
+ *   message: (state) => `Are you sure you want to ${state.data.action}?`,
+ *   onConfirm: 'execute-action',
+ *   onReject: 'cancel-action'
+ * });
+ * ```
+ *
+ * @param options - Confirmation node options
+ * @returns NodeDefinition for use in StateGraph
+ */
+function createConfirmationNode(options) {
+    return createHumanNode({
+        id: options.id,
+        name: options.name,
+        config: {
+            prompt: options.message,
+            inputHandler: options.inputHandler,
+            choices: [
+                { value: 'confirm', label: 'Confirm', default: false },
+                { value: 'reject', label: 'Reject', default: false },
+            ],
+            timeout: options.timeout,
+            onTimeout: 'error',
+            processResponse: response => ({
+                confirmationResult: response.value,
+            }),
+        },
+        nodeConfig: options.nodeConfig,
+    });
+}
+/**
+ * Create a feedback collection node
+ *
+ * @example
+ * ```typescript
+ * const feedbackNode = createFeedbackNode({
+ *   id: 'collect-feedback',
+ *   name: 'Collect Feedback',
+ *   inputHandler: myHandler,
+ *   questions: [
+ *     { id: 'rating', prompt: 'Rate this response (1-5):', type: 'number' },
+ *     { id: 'comments', prompt: 'Any additional comments?', type: 'text' }
+ *   ]
+ * });
+ * ```
+ *
+ * @param options - Feedback node options
+ * @returns NodeDefinition for use in StateGraph
+ */
+function createFeedbackNode(options) {
+    return {
+        id: options.id,
+        name: options.name,
+        type: 'human',
+        config: options.nodeConfig ?? {},
+        execute: async (state, _context) => {
+            const feedback = {};
+            for (const question of options.questions) {
+                const requestId = (0, uuid_1.v4)();
+                const inputContext = {
+                    requestId,
+                    prompt: question.prompt,
+                    choices: question.choices?.map(c => ({ value: c, label: c })),
+                    state: sanitizeStateForHuman(state),
+                    timeout: options.timeout,
+                };
+                const response = await options.inputHandler.request(inputContext);
+                if (response.type === 'cancel') {
+                    return { state, terminate: true };
+                }
+                feedback[question.id] = response.value;
+            }
+            const newState = {
+                ...state,
+                data: {
+                    ...state.data,
+                    feedback,
+                },
+            };
+            return { state: newState };
+        },
+    };
+}
+//# sourceMappingURL=human-node.js.map

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

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

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

@@ -0,0 +1,173 @@
+/**
+ * LLM Node - LLM-based decision and generation node
+ * @module @wundr.io/langgraph-orchestrator
+ */
+import { z } from 'zod';
+import type { AgentState, NodeDefinition, LLMResponse, Tool } from '../types';
+/**
+ * Configuration for LLM node
+ */
+export interface LLMNodeConfig {
+    /** Model to use (provider-specific) */
+    readonly model?: string;
+    /** System prompt for the LLM */
+    readonly systemPrompt?: string;
+    /** Temperature for generation */
+    readonly temperature?: number;
+    /** Maximum tokens to generate */
+    readonly maxTokens?: number;
+    /** Stop sequences */
+    readonly stop?: string[];
+    /** Available tools for the LLM */
+    readonly tools?: Tool[];
+    /** Whether to stream the response */
+    readonly stream?: boolean;
+    /** Custom prompt template */
+    readonly promptTemplate?: (state: AgentState) => string;
+    /** Post-processing function for response */
+    readonly postProcess?: (response: LLMResponse, state: AgentState) => Partial<AgentState>;
+    /** Routing function to determine next node based on response */
+    readonly router?: (response: LLMResponse, state: AgentState) => string | undefined;
+}
+/**
+ * Schema for LLM node configuration validation
+ */
+export declare const LLMNodeConfigSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    systemPrompt: z.ZodOptional<z.ZodString>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+    stop: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    stream: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    stop?: string[] | undefined;
+    model?: string | undefined;
+    systemPrompt?: string | undefined;
+    temperature?: number | undefined;
+    maxTokens?: number | undefined;
+    stream?: boolean | undefined;
+}, {
+    stop?: string[] | undefined;
+    model?: string | undefined;
+    systemPrompt?: string | undefined;
+    temperature?: number | undefined;
+    maxTokens?: number | undefined;
+    stream?: boolean | undefined;
+}>;
+/**
+ * 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
+ */
+export declare function createLLMNode<TState extends AgentState = AgentState>(options: {
+    id: string;
+    name: string;
+    config: LLMNodeConfig;
+    nodeConfig?: NodeDefinition<TState>['config'];
+}): NodeDefinition<TState>;
+/**
+ * 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
+ */
+export declare function createLLMRouter<TState extends AgentState = AgentState>(options: {
+    routes: Record<string, string>;
+    defaultRoute?: string;
+    extractDecision: (response: LLMResponse, state: TState) => string;
+}): (response: LLMResponse, state: TState) => string | undefined;
+/**
+ * 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
+ */
+export declare function createStructuredLLMNode<TState extends AgentState = AgentState, TOutput = unknown>(options: {
+    id: string;
+    name: string;
+    config: LLMNodeConfig;
+    outputSchema: z.ZodSchema<TOutput>;
+    stateMapper: (parsed: TOutput) => Partial<TState['data']>;
+    nodeConfig?: NodeDefinition<TState>['config'];
+}): NodeDefinition<TState>;
+/**
+ * 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
+ */
+export declare function createConversationalLLMNode<TState extends AgentState = AgentState>(options: {
+    id: string;
+    name: string;
+    config: LLMNodeConfig;
+    maxHistoryLength?: number;
+    nodeConfig?: NodeDefinition<TState>['config'];
+}): NodeDefinition<TState>;
+//# sourceMappingURL=llm-node.d.ts.map

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

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