mcp-use 0.1.6 → 0.1.8

package/README.md

@@ -101,6 +101,197 @@ main().catch(console.error)
 
 ---
 
+## 🔧 API Methods
+
+### MCPAgent Methods
+
+The `MCPAgent` class provides several methods for executing queries with different output formats:
+
+#### `run(query: string, maxSteps?: number): Promise<string>`
+
+Executes a query and returns the final result as a string.
+
+```ts
+const result = await agent.run('What tools are available?')
+console.log(result)
+```
+
+#### `stream(query: string, maxSteps?: number): AsyncGenerator<AgentStep, string, void>`
+
+Yields intermediate steps during execution, providing visibility into the agent's reasoning process.
+
+```ts
+const stream = agent.stream('Search for restaurants in Tokyo')
+for await (const step of stream) {
+  console.log(`Tool: ${step.action.tool}, Input: ${step.action.toolInput}`)
+  console.log(`Result: ${step.observation}`)
+}
+```
+
+#### `streamEvents(query: string, maxSteps?: number): AsyncGenerator<StreamEvent, void, void>`
+
+Yields fine-grained LangChain StreamEvent objects, enabling token-by-token streaming and detailed event tracking.
+
+```ts
+const eventStream = agent.streamEvents('What is the weather today?')
+for await (const event of eventStream) {
+  // Handle different event types
+  switch (event.event) {
+    case 'on_chat_model_stream':
+      // Token-by-token streaming from the LLM
+      if (event.data?.chunk?.content) {
+        process.stdout.write(event.data.chunk.content)
+      }
+      break
+    case 'on_tool_start':
+      console.log(`\nTool started: ${event.name}`)
+      break
+    case 'on_tool_end':
+      console.log(`Tool completed: ${event.name}`)
+      break
+  }
+}
+```
+
+### Key Differences
+
+- **`run()`**: Best for simple queries where you only need the final result
+- **`stream()`**: Best for debugging and understanding the agent's tool usage
+- **`streamEvents()`**: Best for real-time UI updates with token-level streaming
+
+## 🔄 AI SDK Integration
+
+The library provides built-in utilities for integrating with [Vercel AI SDK](https://sdk.vercel.ai/), making it easy to build streaming UIs with React hooks like `useCompletion` and `useChat`.
+
+### Installation
+
+```bash
+npm install ai @langchain/anthropic
+```
+
+### Basic Usage
+
+```ts
+import { ChatAnthropic } from '@langchain/anthropic'
+import { LangChainAdapter } from 'ai'
+import { createReadableStreamFromGenerator, MCPAgent, MCPClient, streamEventsToAISDK } from 'mcp-use'
+
+async function createApiHandler() {
+  const config = {
+    mcpServers: {
+      everything: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-everything'] }
+    }
+  }
+
+  const client = new MCPClient(config)
+  const llm = new ChatAnthropic({ model: 'claude-sonnet-4-20250514' })
+  const agent = new MCPAgent({ llm, client, maxSteps: 5 })
+
+  return async (request: { prompt: string }) => {
+    const streamEvents = agent.streamEvents(request.prompt)
+    const aiSDKStream = streamEventsToAISDK(streamEvents)
+    const readableStream = createReadableStreamFromGenerator(aiSDKStream)
+
+    return LangChainAdapter.toDataStreamResponse(readableStream)
+  }
+}
+```
+
+### Enhanced Usage with Tool Visibility
+
+```ts
+import { streamEventsToAISDKWithTools } from 'mcp-use'
+
+async function createEnhancedApiHandler() {
+  const config = {
+    mcpServers: {
+      everything: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-everything'] }
+    }
+  }
+
+  const client = new MCPClient(config)
+  const llm = new ChatAnthropic({ model: 'claude-sonnet-4-20250514' })
+  const agent = new MCPAgent({ llm, client, maxSteps: 8 })
+
+  return async (request: { prompt: string }) => {
+    const streamEvents = agent.streamEvents(request.prompt)
+    // Enhanced stream includes tool usage notifications
+    const enhancedStream = streamEventsToAISDKWithTools(streamEvents)
+    const readableStream = createReadableStreamFromGenerator(enhancedStream)
+
+    return LangChainAdapter.toDataStreamResponse(readableStream)
+  }
+}
+```
+
+### Next.js API Route Example
+
+```ts
+// pages/api/chat.ts or app/api/chat/route.ts
+import { ChatAnthropic } from '@langchain/anthropic'
+import { LangChainAdapter } from 'ai'
+import { createReadableStreamFromGenerator, MCPAgent, MCPClient, streamEventsToAISDK } from 'mcp-use'
+
+export async function POST(req: Request) {
+  const { prompt } = await req.json()
+
+  const config = {
+    mcpServers: {
+      everything: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-everything'] }
+    }
+  }
+
+  const client = new MCPClient(config)
+  const llm = new ChatAnthropic({ model: 'claude-sonnet-4-20250514' })
+  const agent = new MCPAgent({ llm, client, maxSteps: 10 })
+
+  try {
+    const streamEvents = agent.streamEvents(prompt)
+    const aiSDKStream = streamEventsToAISDK(streamEvents)
+    const readableStream = createReadableStreamFromGenerator(aiSDKStream)
+
+    return LangChainAdapter.toDataStreamResponse(readableStream)
+  }
+  finally {
+    await client.closeAllSessions()
+  }
+}
+```
+
+### Frontend Integration
+
+```tsx
+// components/Chat.tsx
+import { useCompletion } from 'ai/react'
+
+export function Chat() {
+  const { completion, input, handleInputChange, handleSubmit } = useCompletion({
+    api: '/api/chat',
+  })
+
+  return (
+    <div>
+      <div>{completion}</div>
+      <form onSubmit={handleSubmit}>
+        <input
+          value={input}
+          onChange={handleInputChange}
+          placeholder="Ask me anything..."
+        />
+      </form>
+    </div>
+  )
+}
+```
+
+### Available AI SDK Utilities
+
+- **`streamEventsToAISDK()`**: Converts streamEvents to basic text stream
+- **`streamEventsToAISDKWithTools()`**: Enhanced stream with tool usage notifications
+- **`createReadableStreamFromGenerator()`**: Converts async generator to ReadableStream
+
+---
+
 ## 📂 Configuration File
 
 You can store servers in a JSON file:
@@ -140,6 +331,9 @@ npm install
 npm run example:airbnb      # Search accommodations with Airbnb
 npm run example:browser     # Browser automation with Playwright
 npm run example:chat        # Interactive chat with memory
+npm run example:stream      # Demonstrate streaming methods (stream & streamEvents)
+npm run example:stream_events # Comprehensive streamEvents() examples
+npm run example:ai_sdk      # AI SDK integration with streaming
 npm run example:filesystem  # File system operations
 npm run example:http        # HTTP server connection
 npm run example:everything  # Test MCP functionalities
@@ -153,6 +347,8 @@ npm run example:multi       # Multiple servers in one session
 - **Multi-Server**: Combine multiple MCP servers (Airbnb + Browser) in a single task
 - **Sandboxed Execution**: Run MCP servers in isolated E2B containers
 - **OAuth Flows**: Authenticate with services like Linear using OAuth2
+- **Streaming Methods**: Demonstrate both step-by-step and token-level streaming
+- **AI SDK Integration**: Build streaming UIs with Vercel AI SDK and React hooks
 
 See the [examples README](./examples/README.md) for detailed documentation and prerequisites.
 

package/dist/examples/ai_sdk_example.d.ts

@@ -0,0 +1,23 @@
+/**
+ * AI SDK Integration Example
+ *
+ * This example demonstrates how to use MCPAgent's streamEvents() method
+ * with Vercel AI SDK's LangChainAdapter for building streaming UIs.
+ *
+ * This pattern is useful for:
+ * - Next.js API routes with useCompletion/useChat hooks
+ * - Real-time streaming applications
+ * - Building chat interfaces with token-by-token updates
+ */
+import type { StreamEvent } from '../index.js';
+declare function streamEventsToAISDK(streamEvents: AsyncGenerator<StreamEvent, void, void>): AsyncGenerator<string, void, void>;
+declare function createReadableStreamFromGenerator(generator: AsyncGenerator<string, void, void>): ReadableStream<string>;
+declare function streamEventsToAISDKWithTools(streamEvents: AsyncGenerator<StreamEvent, void, void>): AsyncGenerator<string, void, void>;
+declare function createApiHandler(): Promise<(request: {
+    prompt: string;
+}) => Promise<Response>>;
+declare function createEnhancedApiHandler(): Promise<(request: {
+    prompt: string;
+}) => Promise<Response>>;
+export { createApiHandler, createEnhancedApiHandler, createReadableStreamFromGenerator, streamEventsToAISDK, streamEventsToAISDKWithTools, };
+//# sourceMappingURL=ai_sdk_example.d.ts.map

package/dist/examples/ai_sdk_example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai_sdk_example.d.ts","sourceRoot":"","sources":["../../examples/ai_sdk_example.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAU9C,iBAAgB,mBAAmB,CACjC,YAAY,EAAE,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,GACpD,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAUpC;AAGD,iBAAS,iCAAiC,CACxC,SAAS,EAAE,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,GAC5C,cAAc,CAAC,MAAM,CAAC,CAcxB;AAGD,iBAAgB,4BAA4B,CAC1C,YAAY,EAAE,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,GACpD,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAqBpC;AAGD,iBAAe,gBAAgB,sBAwBM;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,wBAsBtD;AAGD,iBAAe,wBAAwB,sBAuBM;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,wBAkB9D;AAoFD,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,iCAAiC,EACjC,mBAAmB,EACnB,4BAA4B,GAC7B,CAAA"}

package/dist/examples/ai_sdk_example.js

@@ -0,0 +1,213 @@
+/**
+ * AI SDK Integration Example
+ *
+ * This example demonstrates how to use MCPAgent's streamEvents() method
+ * with Vercel AI SDK's LangChainAdapter for building streaming UIs.
+ *
+ * This pattern is useful for:
+ * - Next.js API routes with useCompletion/useChat hooks
+ * - Real-time streaming applications
+ * - Building chat interfaces with token-by-token updates
+ */
+import { ChatAnthropic } from '@langchain/anthropic';
+import { LangChainAdapter } from 'ai';
+import { config } from 'dotenv';
+import { MCPAgent, MCPClient } from '../index.js';
+// Load environment variables
+config();
+// Utility function to convert streamEvents to AI SDK compatible stream
+async function* streamEventsToAISDK(streamEvents) {
+    for await (const event of streamEvents) {
+        // Only yield the actual content tokens from chat model streams
+        if (event.event === 'on_chat_model_stream' && event.data?.chunk?.text) {
+            const textContent = event.data.chunk.text;
+            if (typeof textContent === 'string' && textContent.length > 0) {
+                yield textContent;
+            }
+        }
+    }
+}
+// Convert async generator to ReadableStream for AI SDK compatibility
+function createReadableStreamFromGenerator(generator) {
+    return new ReadableStream({
+        async start(controller) {
+            try {
+                for await (const chunk of generator) {
+                    controller.enqueue(chunk);
+                }
+                controller.close();
+            }
+            catch (error) {
+                controller.error(error);
+            }
+        },
+    });
+}
+// Enhanced adapter that includes tool information
+async function* streamEventsToAISDKWithTools(streamEvents) {
+    for await (const event of streamEvents) {
+        switch (event.event) {
+            case 'on_chat_model_stream':
+                if (event.data?.chunk?.text) {
+                    const textContent = event.data.chunk.text;
+                    if (typeof textContent === 'string' && textContent.length > 0) {
+                        yield textContent;
+                    }
+                }
+                break;
+            case 'on_tool_start':
+                yield `\n🔧 Using tool: ${event.name}\n`;
+                break;
+            case 'on_tool_end':
+                yield `\n✅ Tool completed: ${event.name}\n`;
+                break;
+        }
+    }
+}
+// Example: Basic AI SDK API route handler
+async function createApiHandler() {
+    const everythingServer = {
+        mcpServers: {
+            everything: {
+                command: 'npx',
+                args: ['-y', '@modelcontextprotocol/server-everything'],
+            },
+        },
+    };
+    const client = new MCPClient(everythingServer);
+    const llm = new ChatAnthropic({
+        model: 'claude-sonnet-4-20250514',
+        temperature: 0.1,
+    });
+    const agent = new MCPAgent({
+        llm,
+        client,
+        maxSteps: 5,
+        verbose: false,
+    });
+    // Simulate an API route handler
+    const apiHandler = async (request) => {
+        try {
+            // Get streamEvents from MCPAgent
+            const streamEvents = agent.streamEvents(request.prompt);
+            // Convert to AI SDK compatible format
+            const aiSDKStream = streamEventsToAISDK(streamEvents);
+            const readableStream = createReadableStreamFromGenerator(aiSDKStream);
+            // Use LangChainAdapter to create a Response compatible with AI SDK
+            return LangChainAdapter.toDataStreamResponse(readableStream);
+        }
+        catch (error) {
+            console.error('Error in API handler:', error);
+            throw error;
+        }
+        finally {
+            await client.closeAllSessions();
+        }
+    };
+    return apiHandler;
+}
+// Example: Enhanced API handler with tool visibility
+async function createEnhancedApiHandler() {
+    const everythingServer = {
+        mcpServers: {
+            everything: {
+                command: 'npx',
+                args: ['-y', '@modelcontextprotocol/server-everything'],
+            },
+        },
+    };
+    const client = new MCPClient(everythingServer);
+    const llm = new ChatAnthropic({
+        model: 'claude-sonnet-4-20250514',
+        temperature: 0.1,
+    });
+    const agent = new MCPAgent({
+        llm,
+        client,
+        maxSteps: 8,
+        verbose: false,
+    });
+    const enhancedApiHandler = async (request) => {
+        try {
+            const streamEvents = agent.streamEvents(request.prompt);
+            const enhancedStream = streamEventsToAISDKWithTools(streamEvents);
+            const readableStream = createReadableStreamFromGenerator(enhancedStream);
+            return LangChainAdapter.toDataStreamResponse(readableStream);
+        }
+        catch (error) {
+            console.error('Error in enhanced API handler:', error);
+            throw error;
+        }
+        finally {
+            await client.closeAllSessions();
+        }
+    };
+    return enhancedApiHandler;
+}
+// Example: Simulated Next.js API route
+async function simulateNextJSApiRoute() {
+    console.log('🚀 Simulating Next.js API Route with AI SDK Integration\n');
+    const apiHandler = await createApiHandler();
+    // Simulate a request
+    const request = {
+        prompt: 'What\'s the current time? Also, list the files in the current directory.',
+    };
+    console.log(`📝 Request: ${request.prompt}\n`);
+    console.log('📡 Streaming response:\n');
+    try {
+        const response = await apiHandler(request);
+        if (response.body) {
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                const chunk = decoder.decode(value);
+                process.stdout.write(chunk);
+            }
+        }
+    }
+    catch (error) {
+        console.error('❌ Error:', error);
+    }
+    console.log('\n\n✅ API Route simulation complete');
+}
+// Example: Enhanced streaming with tool visibility
+async function simulateEnhancedStreaming() {
+    console.log('\n\n🚀 Enhanced Streaming with Tool Visibility\n');
+    const enhancedHandler = await createEnhancedApiHandler();
+    const request = {
+        prompt: 'Check the current time and create a file with a timestamp. Then tell me what tools you used.',
+    };
+    console.log(`📝 Request: ${request.prompt}\n`);
+    console.log('📡 Enhanced streaming response:\n');
+    try {
+        const response = await enhancedHandler(request);
+        if (response.body) {
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                const chunk = decoder.decode(value);
+                process.stdout.write(chunk);
+            }
+        }
+    }
+    catch (error) {
+        console.error('❌ Error:', error);
+    }
+    console.log('\n\n✅ Enhanced streaming complete');
+}
+// Run all examples
+async function runAllExamples() {
+    await simulateNextJSApiRoute();
+    await simulateEnhancedStreaming();
+}
+// Export utilities for reuse
+export { createApiHandler, createEnhancedApiHandler, createReadableStreamFromGenerator, streamEventsToAISDK, streamEventsToAISDKWithTools, };
+if (import.meta.url === `file://${process.argv[1]}`) {
+    runAllExamples().catch(console.error);
+}

package/dist/examples/stream_example.d.ts

@@ -0,0 +1,12 @@
+/**
+ * This example demonstrates how to use the stream method of MCPAgent to get
+ * intermediate steps and observe the agent's reasoning process in real-time.
+ *
+ * The stream method returns an AsyncGenerator that yields AgentStep objects
+ * for each intermediate step, and finally returns the complete result.
+ *
+ * This example also demonstrates the streamEvents method which yields
+ * LangChain StreamEvent objects for more granular, token-level streaming.
+ */
+export {};
+//# sourceMappingURL=stream_example.d.ts.map

package/dist/examples/stream_example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream_example.d.ts","sourceRoot":"","sources":["../../examples/stream_example.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/examples/stream_example.js

@@ -0,0 +1,198 @@
+/**
+ * This example demonstrates how to use the stream method of MCPAgent to get
+ * intermediate steps and observe the agent's reasoning process in real-time.
+ *
+ * The stream method returns an AsyncGenerator that yields AgentStep objects
+ * for each intermediate step, and finally returns the complete result.
+ *
+ * This example also demonstrates the streamEvents method which yields
+ * LangChain StreamEvent objects for more granular, token-level streaming.
+ */
+import { ChatAnthropic } from '@langchain/anthropic';
+import { config } from 'dotenv';
+import { MCPAgent, MCPClient } from '../index.js';
+// Load environment variables from .env file
+config();
+const everythingServer = {
+    mcpServers: { everything: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-everything'] } },
+};
+async function streamingExample() {
+    console.log('🚀 Starting streaming example...\n');
+    // Initialize MCP client and agent
+    const client = new MCPClient(everythingServer);
+    const llm = new ChatAnthropic({ model: 'claude-sonnet-4-20250514', temperature: 0 });
+    const agent = new MCPAgent({
+        llm,
+        client,
+        maxSteps: 10,
+        verbose: true,
+    });
+    const query = `Please help me understand what capabilities you have:
+1. List all available tools
+2. Try using a few different tools to demonstrate their functionality
+3. Show me what resources and prompts are available
+4. Create a simple example to showcase your abilities`;
+    console.log(`📝 Query: ${query}\n`);
+    console.log('🔄 Starting to stream agent steps...\n');
+    try {
+        // Use the stream method to get intermediate steps
+        const stream = agent.stream(query);
+        let stepNumber = 1;
+        // Iterate through the async generator to get intermediate steps
+        for await (const step of stream) {
+            console.log(`\n--- Step ${stepNumber} ---`);
+            console.log(`🔧 Tool: ${step.action.tool}`);
+            console.log(`📥 Input: ${JSON.stringify(step.action.toolInput, null, 2)}`);
+            console.log(`📤 Output: ${step.observation}`);
+            console.log('---\n');
+            stepNumber++;
+        }
+        // The final result is the return value when the generator is done
+        // Note: In the loop above, we don't get the final result directly
+        // To get it, we need to manually handle the generator
+    }
+    catch (error) {
+        console.error('❌ Error during streaming:', error);
+    }
+    console.log('\n🎉 Streaming complete!');
+}
+async function streamingExampleWithFinalResult() {
+    console.log('\n\n🚀 Starting streaming example with final result capture...\n');
+    // Initialize MCP client and agent
+    const client = new MCPClient(everythingServer);
+    const llm = new ChatAnthropic({ model: 'claude-sonnet-4-20250514', temperature: 0 });
+    const agent = new MCPAgent({
+        llm,
+        client,
+        maxSteps: 8,
+        verbose: false, // Less verbose for cleaner output
+    });
+    const query = `What tools do you have access to? Please test 2-3 of them to show me what they can do.`;
+    console.log(`📝 Query: ${query}\n`);
+    console.log('🔄 Processing with intermediate steps...\n');
+    try {
+        // Create the stream generator
+        const stream = agent.stream(query);
+        let stepNumber = 1;
+        let result = '';
+        // Manually iterate through the generator to capture both steps and final result
+        while (true) {
+            const { done, value } = await stream.next();
+            if (done) {
+                // Generator is complete, value contains the final result
+                result = value;
+                break;
+            }
+            else {
+                // value is an AgentStep
+                console.log(`\n🔧 Step ${stepNumber}: ${value.action.tool}`);
+                console.log(`   Input: ${JSON.stringify(value.action.toolInput)}`);
+                console.log(`   Result: ${value.observation.slice(0, 100)}${value.observation.length > 100 ? '...' : ''}`);
+                stepNumber++;
+            }
+        }
+        console.log(`\n${'='.repeat(50)}`);
+        console.log('🎯 FINAL RESULT:');
+        console.log('='.repeat(50));
+        console.log(result);
+    }
+    catch (error) {
+        console.error('❌ Error during streaming:', error);
+    }
+    finally {
+        // Clean up
+        await client.closeAllSessions();
+    }
+    console.log('\n✅ Example complete!');
+}
+async function streamEventsExample() {
+    console.log('\n\n🚀 Starting streamEvents example (token-level streaming)...\n');
+    // Initialize MCP client and agent
+    const client = new MCPClient(everythingServer);
+    const llm = new ChatAnthropic({ model: 'claude-sonnet-4-20250514', temperature: 0 });
+    const agent = new MCPAgent({
+        llm,
+        client,
+        maxSteps: 5,
+        verbose: false,
+    });
+    const query = `What's the current time and date? Also create a simple text file with today's date.`;
+    console.log(`📝 Query: ${query}\n`);
+    console.log('🔄 Streaming fine-grained events...\n');
+    try {
+        // Use streamEvents for token-level streaming
+        const eventStream = agent.streamEvents(query);
+        let eventCount = 0;
+        let currentToolCall = null;
+        for await (const event of eventStream) {
+            eventCount++;
+            // Log different types of events
+            switch (event.event) {
+                case 'on_chain_start':
+                    if (event.name === 'AgentExecutor') {
+                        console.log('🏁 Agent execution started');
+                    }
+                    break;
+                case 'on_tool_start':
+                    currentToolCall = event.name;
+                    console.log(`\n🔧 Tool started: ${event.name}`);
+                    if (event.data?.input) {
+                        console.log(`   Input: ${JSON.stringify(event.data.input)}`);
+                    }
+                    break;
+                case 'on_tool_end':
+                    if (event.name === currentToolCall) {
+                        console.log(`✅ Tool completed: ${event.name}`);
+                        if (event.data?.output) {
+                            const output = typeof event.data.output === 'string'
+                                ? event.data.output
+                                : JSON.stringify(event.data.output);
+                            console.log(`   Output: ${output.slice(0, 100)}${output.length > 100 ? '...' : ''}`);
+                        }
+                        currentToolCall = null;
+                    }
+                    break;
+                case 'on_chat_model_stream':
+                    // This shows token-by-token streaming from the LLM
+                    if (event.data?.chunk?.text) {
+                        const textContent = event.data.chunk.text;
+                        if (typeof textContent === 'string' && textContent.length > 0) {
+                            process.stdout.write(textContent);
+                        }
+                    }
+                    break;
+                case 'on_chain_end':
+                    if (event.name === 'AgentExecutor') {
+                        console.log('\n\n🏁 Agent execution completed');
+                    }
+                    break;
+                // You can handle many more event types:
+                // - on_llm_start, on_llm_end
+                // - on_parser_start, on_parser_end
+                // - on_retriever_start, on_retriever_end
+                // - etc.
+            }
+            // Limit output for demo purposes
+            if (eventCount > 200) {
+                console.log('\n... (truncated for demo)');
+                break;
+            }
+        }
+        console.log(`\n\n📊 Total events emitted: ${eventCount}`);
+    }
+    catch (error) {
+        console.error('❌ Error during event streaming:', error);
+    }
+    finally {
+        await client.closeAllSessions();
+    }
+    console.log('\n✅ StreamEvents example complete!');
+}
+// Run all examples
+async function runAllExamples() {
+    await streamingExample();
+    await streamingExampleWithFinalResult();
+    await streamEventsExample();
+}
+// Run the examples
+runAllExamples().catch(console.error);

package/dist/index.d.ts

@@ -8,8 +8,10 @@ import { WebSocketConnector } from './src/connectors/websocket.js';
 import { Logger, logger } from './src/logging.js';
 import { MCPSession } from './src/session.js';
 export { BaseAdapter, LangChainAdapter } from './src/adapters/index.js';
+export * from './src/agents/utils/index.js';
 export { ServerManager } from './src/managers/server_manager.js';
 export * from './src/managers/tools/index.js';
 export { setTelemetrySource, Telemetry } from './src/telemetry/index.js';
+export type { StreamEvent } from '@langchain/core/tracers/log_stream';
 export { BaseConnector, HttpConnector, loadConfigFile, Logger, logger, MCPAgent, MCPClient, MCPSession, StdioConnector, WebSocketConnector };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAElE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAChE,cAAc,+BAA+B,CAAA;AAG7C,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAExE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAElE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAEvE,cAAc,6BAA6B,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAEhE,cAAc,+BAA+B,CAAA;AAG7C,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAGxE,YAAY,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAA;AAErE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAA"}