@illuma-ai/agents 1.1.20 → 1.1.22

package/src/scripts/multi-agent-parallel.js

@@ -1,346 +0,0 @@
-import { config } from 'dotenv';
-config();
-import { HumanMessage } from '@langchain/core/messages';
-import { ChatModelStreamHandler, createContentAggregator } from '@/stream';
-import { ToolEndHandler } from '@/events';
-import { Providers, GraphEvents } from '@/common';
-import { sleep } from '@/utils/run';
-import { Run } from '@/run';
-const conversationHistory = [];
-/**
- * Example of parallel multi-agent system with fan-in/fan-out pattern
- *
- * Graph structure:
- * START -> researcher
- * researcher -> [analyst1, analyst2, analyst3] (fan-out)
- * [analyst1, analyst2, analyst3] -> summarizer (fan-in)
- * summarizer -> END
- */
-async function testParallelMultiAgent() {
-    console.log('Testing Parallel Multi-Agent System (Fan-in/Fan-out)...\n');
-    // Note: You may see "Run ID not found in run map" errors during parallel execution.
-    // This is a known issue with LangGraph's event streaming when nodes run in parallel.
-    // The errors can be safely ignored - the parallel execution still works correctly.
-    // Set up content aggregator
-    const { contentParts, aggregateContent } = createContentAggregator();
-    // Define specialized agents
-    const agents = [
-        {
-            agentId: 'researcher',
-            provider: Providers.ANTHROPIC,
-            clientOptions: {
-                modelName: 'claude-haiku-4-5',
-                apiKey: process.env.ANTHROPIC_API_KEY,
-            },
-            instructions: `You are a research coordinator in a multi-agent analysis workflow. Your sole job is to:
-
-  1. Analyze the incoming request and break it down into exactly 3 distinct research areas
-  2. Create specific, actionable analysis tasks for each specialist team
-  3. Format your output as clear directives (not analysis yourself)
-  4. Keep your response under 200 words - you are NOT doing the analysis, just coordinating it
-
-  Example format:
-  "ANALYSIS COORDINATION:
-  Financial Team: [specific financial analysis task]
-  Technical Team: [specific technical analysis task] 
-  Market Team: [specific market analysis task]
-
-  Proceed with parallel analysis."
-
-  Do NOT provide any actual analysis - your job is purely coordination and task assignment.`,
-        },
-        {
-            agentId: 'analyst1',
-            provider: Providers.ANTHROPIC,
-            clientOptions: {
-                modelName: 'claude-haiku-4-5',
-                apiKey: process.env.ANTHROPIC_API_KEY,
-            },
-            instructions: `You are a FINANCIAL AND ECONOMIC ANALYST in a parallel analysis workflow. 
-
-  CRITICAL: You must provide detailed, substantive financial analysis (minimum 300 words). Focus specifically on:
-
-  • Economic impact metrics (GDP, productivity, employment effects)
-  • Monetary policy implications and inflation considerations  
-  • Investment flows and capital market disruptions
-  • Financial sector transformation and banking impacts
-  • Government fiscal policy and tax revenue effects
-  • International trade and currency implications
-  • Risk assessment and financial stability concerns
-
-  Provide concrete data, projections, and financial reasoning. Never give empty responses, brief acknowledgments, or defer to other analysts. This is your domain expertise - deliver comprehensive financial analysis.
-
-  Start your response with "FINANCIAL ANALYSIS:" and provide detailed insights.`,
-        },
-        {
-            agentId: 'analyst2',
-            provider: Providers.ANTHROPIC,
-            clientOptions: {
-                modelName: 'claude-haiku-4-5',
-                apiKey: process.env.ANTHROPIC_API_KEY,
-            },
-            instructions: `You are a TECHNICAL AND IMPLEMENTATION ANALYST in a parallel analysis workflow.
-
-  CRITICAL: You must provide detailed, substantive technical analysis (minimum 300 words). Focus specifically on:
-
-  • AI infrastructure requirements and scalability challenges
-  • Computing power, data center, and energy demands
-  • Network connectivity and bandwidth requirements
-  • Technical barriers to widespread AI adoption
-  • Implementation timelines and deployment phases
-  • Skills gap analysis and workforce technical requirements
-  • Security vulnerabilities and technical risk mitigation
-  • Integration challenges with existing systems
-
-  Provide concrete technical assessments, infrastructure projections, and implementation roadmaps. Never give empty responses, brief acknowledgments, or defer to other analysts. This is your technical expertise domain.
-
-  Start your response with "TECHNICAL ANALYSIS:" and provide detailed technical insights.`,
-        },
-        {
-            agentId: 'analyst3',
-            provider: Providers.ANTHROPIC,
-            clientOptions: {
-                modelName: 'claude-haiku-4-5',
-                apiKey: process.env.ANTHROPIC_API_KEY,
-            },
-            instructions: `You are a MARKET AND INDUSTRY ANALYST in a parallel analysis workflow.
-
-  CRITICAL: You must provide detailed, substantive market analysis (minimum 300 words). Focus specifically on:
-
-  • Industry disruption patterns and transformation timelines
-  • Competitive landscape shifts and market consolidation
-  • Consumer adoption rates and behavior changes
-  • New business models and market opportunities
-  • Geographic market variations and regional impacts
-  • Regulatory environment and policy implications
-  • Market size projections and growth trajectories
-  • Sector-specific impacts (healthcare, finance, manufacturing, etc.)
-
-  Provide concrete market assessments, competitive analysis, and industry projections. Never give empty responses, brief acknowledgments, or defer to other analysts. This is your market expertise domain.
-
-  Start your response with "MARKET ANALYSIS:" and provide detailed market insights.`,
-        },
-        {
-            agentId: 'summarizer',
-            provider: Providers.ANTHROPIC,
-            clientOptions: {
-                modelName: 'claude-haiku-4-5',
-                apiKey: process.env.ANTHROPIC_API_KEY,
-            },
-            instructions: `You are the SYNTHESIS AND SUMMARY EXPERT in a multi-agent workflow.
-
-  Your job is to:
-  1. Receive and analyze the outputs from all three specialist analysts
-  2. Identify key themes, conflicts, and complementary insights across analyses
-  3. Synthesize findings into a coherent, comprehensive executive summary
-  4. Highlight critical interdependencies between financial, technical, and market factors
-  5. Provide integrated conclusions and strategic recommendations
-
-  Structure your summary as:
-  - EXECUTIVE SUMMARY (key findings)
-  - INTEGRATED INSIGHTS (how the three analyses connect)
-  - CRITICAL INTERDEPENDENCIES (financial-technical-market intersections)
-  - STRATEGIC RECOMMENDATIONS (actionable next steps)
-  - RISK ASSESSMENT (combined risk factors from all domains)
-
-  Minimum 400 words. Create value through integration, not just concatenation of the three analyses.`,
-        },
-    ];
-    // Define direct edges (fan-out and fan-in)
-    const edges = [
-        {
-            from: 'researcher',
-            to: ['analyst1', 'analyst2', 'analyst3'], // Fan-out to multiple analysts
-            description: 'Distribute research to specialist analysts',
-            edgeType: 'sequence', // Explicitly set as direct for automatic transition (enables parallel execution)
-        },
-        {
-            from: ['analyst1', 'analyst2', 'analyst3'], // Fan-in from multiple sources
-            to: 'summarizer',
-            description: 'Aggregate analysis results',
-            edgeType: 'sequence', // Fan-in is also direct
-            // Add prompt when all analysts have provided input
-            // prompt: (messages, runStartIndex) => {
-            //   // Check if we have analysis content from all three analysts
-            //   // Look for the specific headers each analyst uses
-            //   const aiMessages = messages.filter(
-            //     (msg, index) => msg.getType() === 'ai' && index >= runStartIndex
-            //   );
-            //   const messageContent = aiMessages.map((msg) => msg.content).join('\n');
-            //   const hasFinancialAnalysis = messageContent.includes(
-            //     'FINANCIAL ANALYSIS:'
-            //   );
-            //   const hasTechnicalAnalysis = messageContent.includes(
-            //     'TECHNICAL ANALYSIS:'
-            //   );
-            //   const hasMarketAnalysis = messageContent.includes('MARKET ANALYSIS:');
-            //   console.log(
-            //     `Checking for analyses - Financial: ${hasFinancialAnalysis}, Technical: ${hasTechnicalAnalysis}, Market: ${hasMarketAnalysis}`
-            //   );
-            //   if (hasFinancialAnalysis && hasTechnicalAnalysis && hasMarketAnalysis) {
-            //     return 'Based on the comprehensive analyses from all three specialist teams above, please synthesize their insights into a cohesive executive summary. Focus on the key findings, common themes, and strategic implications across the financial, technical, and market perspectives.';
-            //   }
-            //   return undefined; // No prompt if we haven't received all analyst inputs
-            // },
-            prompt: 'Based on the comprehensive analyses from all three specialist teams below, please synthesize their insights into a cohesive executive summary. Focus on the key findings, common themes, and strategic implications across the financial, technical, and market perspectives.\n\n{results}',
-        },
-    ];
-    // Track which agents are active
-    const activeAgents = new Set();
-    const startTime = Date.now();
-    let messageCount = 0;
-    // Create custom handlers with extensive metadata logging
-    const customHandlers = {
-        [GraphEvents.TOOL_END]: new ToolEndHandler(),
-        [GraphEvents.CHAT_MODEL_END]: {
-            handle: (_event, _data, metadata) => {
-                console.log('\n====== CHAT_MODEL_END METADATA ======');
-                console.dir(metadata, { depth: null });
-                const elapsed = Date.now() - startTime;
-                const nodeName = metadata?.langgraph_node;
-                console.log(`⏱️  [${nodeName || 'unknown'}] COMPLETED at ${elapsed}ms`);
-            },
-        },
-        [GraphEvents.CHAT_MODEL_START]: {
-            handle: (_event, _data, metadata) => {
-                console.log('\n====== CHAT_MODEL_START METADATA ======');
-                console.dir(metadata, { depth: null });
-                const elapsed = Date.now() - startTime;
-                const nodeName = metadata?.langgraph_node;
-                console.log(`⏱️  [${nodeName || 'unknown'}] STARTED at ${elapsed}ms`);
-            },
-        },
-        [GraphEvents.CHAT_MODEL_STREAM]: new ChatModelStreamHandler(),
-        [GraphEvents.ON_RUN_STEP_COMPLETED]: {
-            handle: (event, data, metadata) => {
-                console.log('\n====== ON_RUN_STEP_COMPLETED ======');
-                console.log('DATA:');
-                console.dir(data, { depth: null });
-                console.log('METADATA:');
-                console.dir(metadata, { depth: null });
-                const runStepData = data;
-                if (runStepData?.name) {
-                    activeAgents.delete(runStepData.name);
-                    console.log(`[${runStepData.name}] Completed analysis`);
-                }
-                aggregateContent({
-                    event,
-                    data: data,
-                });
-            },
-        },
-        [GraphEvents.ON_RUN_STEP]: {
-            handle: (event, data, metadata) => {
-                console.log('\n====== ON_RUN_STEP ======');
-                console.log('DATA:');
-                console.dir(data, { depth: null });
-                console.log('METADATA:');
-                console.dir(metadata, { depth: null });
-                const runStepData = data;
-                if (runStepData?.name) {
-                    activeAgents.add(runStepData.name);
-                    console.log(`[${runStepData.name}] Starting analysis...`);
-                }
-                aggregateContent({ event, data: data });
-            },
-        },
-        [GraphEvents.ON_RUN_STEP_DELTA]: {
-            handle: (event, data, metadata) => {
-                console.log('\n====== ON_RUN_STEP_DELTA ======');
-                console.log('DATA:');
-                console.dir(data, { depth: null });
-                console.log('METADATA:');
-                console.dir(metadata, { depth: null });
-                aggregateContent({ event, data: data });
-            },
-        },
-        [GraphEvents.ON_MESSAGE_DELTA]: {
-            handle: (event, data, metadata) => {
-                messageCount++;
-                // Only log first few message deltas per agent to avoid spam
-                if (messageCount <= 5) {
-                    console.log('\n====== ON_MESSAGE_DELTA ======');
-                    console.log('DATA:');
-                    console.dir(data, { depth: null });
-                    console.log('METADATA:');
-                    console.dir(metadata, { depth: null });
-                }
-                aggregateContent({ event, data: data });
-            },
-        },
-    };
-    // Create multi-agent run configuration
-    const runConfig = {
-        runId: `parallel-multi-agent-${Date.now()}`,
-        graphConfig: {
-            type: 'multi-agent',
-            agents,
-            edges,
-            // Add compile options to help with parallel execution
-            compileOptions: {
-            // checkpointer: new MemorySaver(), // Uncomment if needed
-            },
-        },
-        customHandlers,
-        returnContent: true,
-        skipCleanup: true,
-    };
-    try {
-        // Create and execute the run
-        const run = await Run.create(runConfig);
-        // Debug: Log the graph structure
-        console.log('=== DEBUG: Graph Structure ===');
-        const graph = run.Graph;
-        console.log('Graph exists:', !!graph);
-        if (graph) {
-            console.log('Graph type:', graph.constructor.name);
-            console.log('AgentContexts exists:', !!graph.agentContexts);
-            if (graph.agentContexts) {
-                console.log('AgentContexts size:', graph.agentContexts.size);
-                for (const [agentId, context] of graph.agentContexts) {
-                    console.log(`\nAgent: ${agentId}`);
-                    console.log(`Tools: ${context.tools?.map((t) => t.name || 'unnamed').join(', ') || 'none'}`);
-                }
-            }
-        }
-        console.log('=== END DEBUG ===\n');
-        const userMessage = `EXECUTE PARALLEL ANALYSIS WORKFLOW:
-
-Step 1: Researcher - identify 3 key analysis areas for AI economic impact
-Step 2: IMMEDIATELY send to ALL THREE analysts simultaneously:
-  - analyst1 (financial): Provide detailed economic impact analysis
-  - analyst2 (technical): Provide detailed technical implementation analysis  
-  - analyst3 (market): Provide detailed market disruption analysis
-Step 3: Summarizer - compile all three analyses
-
-IMPORTANT: Each analyst must produce substantive analysis (200+ words), not just acknowledgments or empty responses. This is a multi-agent workflow test requiring actual parallel execution.`;
-        conversationHistory.push(new HumanMessage(userMessage));
-        console.log('Invoking parallel multi-agent graph...\n');
-        const config = {
-            configurable: {
-                thread_id: 'parallel-conversation-1',
-            },
-            streamMode: 'values',
-            version: 'v2',
-        };
-        // Process with streaming
-        const inputs = {
-            messages: conversationHistory,
-        };
-        const finalContentParts = await run.processStream(inputs, config);
-        const finalMessages = run.getRunMessages();
-        if (finalMessages) {
-            conversationHistory.push(...finalMessages);
-        }
-        console.log('\n\nActive agents during execution:', activeAgents.size);
-        console.log('Final content parts:', contentParts.length, 'parts');
-        console.dir(contentParts, { depth: null });
-        await sleep(3000);
-    }
-    catch (error) {
-        console.error('Error in parallel multi-agent test:', error);
-    }
-}
-// Run the test
-testParallelMultiAgent();
-//# sourceMappingURL=multi-agent-parallel.js.map

package/src/scripts/multi-agent-sequence.js

@@ -1,184 +0,0 @@
-import { config } from 'dotenv';
-config();
-import { HumanMessage } from '@langchain/core/messages';
-import { Run } from '@/run';
-import { Providers, GraphEvents } from '@/common';
-import { ChatModelStreamHandler, createContentAggregator } from '@/stream';
-import { ToolEndHandler, ModelEndHandler } from '@/events';
-const conversationHistory = [];
-/**
- * Example of simple sequential multi-agent system
- *
- * Graph structure:
- * START -> agent_a -> agent_b -> agent_c -> END
- *
- * No conditions, no tools, just automatic sequential flow
- */
-async function testSequentialMultiAgent() {
-    console.log('Testing Sequential Multi-Agent System (A → B → C)...\n');
-    // Set up content aggregator
-    const { contentParts, aggregateContent, stepMap } = createContentAggregator();
-    // Define three simple agents
-    const agents = [
-        {
-            agentId: 'agent_a',
-            provider: Providers.ANTHROPIC,
-            clientOptions: {
-                modelName: 'claude-haiku-4-5',
-                apiKey: process.env.ANTHROPIC_API_KEY,
-            },
-            instructions: `You are Agent A, the first agent in a sequential workflow.
-      Your job is to:
-      1. Receive the initial user request
-      2. Process it and add your perspective (keep it brief, 2-3 sentences)
-      3. Pass it along to Agent B
-      
-      Start your response with "AGENT A:" and end with "Passing to Agent B..."`,
-            maxContextTokens: 8000,
-        },
-        {
-            agentId: 'agent_b',
-            provider: Providers.ANTHROPIC,
-            clientOptions: {
-                modelName: 'claude-haiku-4-5',
-                apiKey: process.env.ANTHROPIC_API_KEY,
-            },
-            instructions: `You are Agent B, the second agent in a sequential workflow.
-      Your job is to:
-      1. Receive the context from Agent A
-      2. Add your own analysis or perspective (keep it brief, 2-3 sentences)
-      3. Pass it along to Agent C
-      
-      Start your response with "AGENT B:" and end with "Passing to Agent C..."`,
-            maxContextTokens: 8000,
-        },
-        {
-            agentId: 'agent_c',
-            provider: Providers.ANTHROPIC,
-            clientOptions: {
-                modelName: 'claude-haiku-4-5',
-                apiKey: process.env.ANTHROPIC_API_KEY,
-            },
-            instructions: `You are Agent C, the final agent in a sequential workflow.
-      Your job is to:
-      1. Receive the context from Agents A and B
-      2. Provide a final summary or conclusion based on all previous inputs
-      3. Complete the workflow
-      
-      Start your response with "AGENT C:" and end with "Workflow complete."`,
-            maxContextTokens: 8000,
-        },
-    ];
-    // Define sequential edges using 'direct' type to avoid tool creation
-    // This creates automatic transitions without requiring agents to call tools
-    const edges = [
-        {
-            from: 'agent_a',
-            to: 'agent_b',
-            edgeType: 'sequence', // This creates direct edges without tools
-            description: 'Automatic transition from A to B',
-        },
-        {
-            from: 'agent_b',
-            to: 'agent_c',
-            edgeType: 'sequence', // This creates direct edges without tools
-            description: 'Automatic transition from B to C',
-        },
-    ];
-    // Track agent progression
-    let currentAgent = '';
-    // Create custom handlers
-    const customHandlers = {
-        [GraphEvents.TOOL_END]: new ToolEndHandler(),
-        [GraphEvents.CHAT_MODEL_END]: new ModelEndHandler(),
-        [GraphEvents.CHAT_MODEL_STREAM]: new ChatModelStreamHandler(),
-        [GraphEvents.ON_RUN_STEP]: {
-            handle: (event, data) => {
-                const runStepData = data;
-                if (runStepData?.name) {
-                    currentAgent = runStepData.name;
-                    console.log(`\n→ ${currentAgent} is processing...`);
-                }
-                aggregateContent({ event, data: data });
-            },
-        },
-        [GraphEvents.ON_RUN_STEP_COMPLETED]: {
-            handle: (event, data) => {
-                const runStepData = data;
-                if (runStepData?.name) {
-                    console.log(`✓ ${runStepData.name} completed`);
-                }
-                aggregateContent({
-                    event,
-                    data: data,
-                });
-            },
-        },
-        [GraphEvents.ON_RUN_STEP_DELTA]: {
-            handle: (event, data) => {
-                aggregateContent({ event, data: data });
-            },
-        },
-        [GraphEvents.ON_MESSAGE_DELTA]: {
-            handle: (event, data) => {
-                aggregateContent({ event, data: data });
-            },
-        },
-    };
-    // Create multi-agent run configuration
-    const runConfig = {
-        runId: `sequential-multi-agent-${Date.now()}`,
-        graphConfig: {
-            type: 'multi-agent',
-            agents,
-            edges,
-        },
-        customHandlers,
-        returnContent: true,
-        skipCleanup: true,
-    };
-    try {
-        // Create and execute the run
-        const run = await Run.create(runConfig);
-        // Test with a simple question
-        const userMessage = 'What are the key considerations for building a recommendation system?';
-        conversationHistory.push(new HumanMessage(userMessage));
-        console.log(`User: "${userMessage}"\n`);
-        console.log('Starting sequential workflow...\n');
-        const config = {
-            configurable: {
-                thread_id: 'sequential-conversation-1',
-            },
-            streamMode: 'values',
-            version: 'v2',
-        };
-        // Process with streaming
-        const inputs = {
-            messages: conversationHistory,
-        };
-        const finalContentParts = await run.processStream(inputs, config);
-        const finalMessages = run.getRunMessages();
-        if (finalMessages) {
-            conversationHistory.push(...finalMessages);
-        }
-        console.log('\n\n=== Final Output ===');
-        console.log('Sequential flow completed successfully!');
-        console.log(`Total content parts: ${contentParts.length}`);
-        console.log('\n=== Content Parts (clean, no metadata) ===');
-        console.dir(contentParts, { depth: null });
-        console.log('\n=== Step Map (separate from content) ===');
-        console.dir(Object.fromEntries(stepMap), { depth: null });
-        // Display the sequential responses
-        const aiMessages = conversationHistory.filter((msg) => msg._getType() === 'ai');
-        aiMessages.forEach((msg, index) => {
-            console.log(`\n--- Response ${index + 1} ---`);
-            console.log(msg.content);
-        });
-    }
-    catch (error) {
-        console.error('Error in sequential multi-agent test:', error);
-    }
-}
-// Run the test
-testSequentialMultiAgent();
-//# sourceMappingURL=multi-agent-sequence.js.map