mongo.do 0.1.0

package/dist/mcp/adapters/errors.js

@@ -0,0 +1,305 @@
+/**
+ * MCP SDK Adapter Error Types and Utilities
+ *
+ * Provides standardized error handling for SDK adapters following MCP protocol.
+ * Includes:
+ * - MCP-specific error codes (JSON-RPC 2.0 compliant)
+ * - Typed error classes for different failure modes
+ * - Error categorization for retry logic
+ * - Utility functions for error handling
+ */
+// =============================================================================
+// MCP Error Codes (JSON-RPC 2.0 + MCP Extensions)
+// =============================================================================
+/**
+ * Standard JSON-RPC 2.0 error codes used by MCP
+ */
+export const McpErrorCode = {
+    // Standard JSON-RPC 2.0 errors (-32700 to -32600)
+    ParseError: -32700,
+    InvalidRequest: -32600,
+    MethodNotFound: -32601,
+    InvalidParams: -32602,
+    InternalError: -32603,
+    // Server errors (-32099 to -32000)
+    ServerError: -32000,
+    ServerBusy: -32001,
+    ServerShutdown: -32002,
+    // MCP-specific errors (-32899 to -32800)
+    ToolNotFound: -32800,
+    ToolExecutionError: -32801,
+    ResourceNotFound: -32802,
+    ResourceAccessDenied: -32803,
+    PromptNotFound: -32804,
+    InvalidToolResponse: -32805,
+    // Transport errors (-32999 to -32900)
+    ConnectionError: -32900,
+    ConnectionTimeout: -32901,
+    ConnectionClosed: -32902,
+    RateLimited: -32903,
+    AuthenticationFailed: -32904,
+};
+// =============================================================================
+// Base MCP Error Class
+// =============================================================================
+/**
+ * Base error class for all MCP-related errors
+ *
+ * Provides:
+ * - MCP error code mapping
+ * - Retryability information
+ * - Serialization to JSON-RPC format
+ *
+ * @example
+ * ```typescript
+ * throw new McpError(
+ *   McpErrorCode.ToolExecutionError,
+ *   'Failed to execute search tool',
+ *   { originalError: 'Database connection failed', retryable: true }
+ * )
+ * ```
+ */
+export class McpError extends Error {
+    code;
+    data;
+    retryable;
+    timestamp;
+    constructor(code, message, data) {
+        super(message);
+        this.name = 'McpError';
+        this.code = code;
+        if (data) {
+            this.data = data;
+        }
+        this.timestamp = new Date();
+        this.retryable = data?.retryable ?? isTransientErrorCode(code);
+        // Maintain proper stack trace for where error was thrown
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, McpError);
+        }
+    }
+    /**
+     * Convert to JSON-RPC error response format
+     */
+    toResponse() {
+        return {
+            code: this.code,
+            message: this.message,
+            data: {
+                ...this.data,
+                timestamp: this.timestamp.toISOString(),
+                retryable: this.retryable,
+            },
+        };
+    }
+    /**
+     * Create from a standard Error
+     */
+    static fromError(error, code) {
+        if (error instanceof McpError) {
+            return error;
+        }
+        const errorCode = code ?? classifyError(error);
+        const data = {
+            originalError: error.message,
+            retryable: isTransientErrorCode(errorCode),
+        };
+        if (process.env.NODE_ENV === 'development' && error.stack) {
+            data.stack = error.stack;
+        }
+        return new McpError(errorCode, error.message, data);
+    }
+}
+// =============================================================================
+// Specific Error Classes
+// =============================================================================
+/**
+ * Connection error - network or transport layer failures
+ */
+export class ConnectionError extends McpError {
+    constructor(message, data) {
+        super(McpErrorCode.ConnectionError, message, { ...data, retryable: true });
+        this.name = 'ConnectionError';
+    }
+}
+/**
+ * Timeout error - operation exceeded time limit
+ */
+export class TimeoutError extends McpError {
+    timeoutMs;
+    constructor(message, timeoutMs, data) {
+        super(McpErrorCode.ConnectionTimeout, message, { ...data, retryable: true });
+        this.name = 'TimeoutError';
+        this.timeoutMs = timeoutMs;
+    }
+}
+/**
+ * Rate limit error - too many requests
+ */
+export class RateLimitError extends McpError {
+    retryAfterMs;
+    constructor(message, retryAfterMs, data) {
+        super(McpErrorCode.RateLimited, message, {
+            ...data,
+            retryable: true,
+            retryAfter: retryAfterMs,
+        });
+        this.name = 'RateLimitError';
+        this.retryAfterMs = retryAfterMs;
+    }
+}
+/**
+ * Authentication error - invalid or expired credentials
+ */
+export class AuthenticationError extends McpError {
+    constructor(message, data) {
+        super(McpErrorCode.AuthenticationFailed, message, { ...data, retryable: false });
+        this.name = 'AuthenticationError';
+    }
+}
+/**
+ * Tool not found error - requested tool doesn't exist
+ */
+export class ToolNotFoundError extends McpError {
+    toolName;
+    constructor(toolName, data) {
+        super(McpErrorCode.ToolNotFound, `Tool '${toolName}' not found`, {
+            ...data,
+            retryable: false,
+        });
+        this.name = 'ToolNotFoundError';
+        this.toolName = toolName;
+    }
+}
+/**
+ * Tool execution error - tool failed during execution
+ */
+export class ToolExecutionError extends McpError {
+    toolName;
+    constructor(toolName, message, data) {
+        super(McpErrorCode.ToolExecutionError, message, data);
+        this.name = 'ToolExecutionError';
+        this.toolName = toolName;
+    }
+}
+/**
+ * Invalid params error - request parameters are malformed
+ */
+export class InvalidParamsError extends McpError {
+    constructor(message, data) {
+        super(McpErrorCode.InvalidParams, message, { ...data, retryable: false });
+        this.name = 'InvalidParamsError';
+    }
+}
+// =============================================================================
+// Error Classification Utilities
+// =============================================================================
+/**
+ * Check if an error code represents a transient failure that can be retried
+ */
+export function isTransientErrorCode(code) {
+    const transientCodes = [
+        McpErrorCode.ServerError,
+        McpErrorCode.ServerBusy,
+        McpErrorCode.ConnectionError,
+        McpErrorCode.ConnectionTimeout,
+        McpErrorCode.RateLimited,
+    ];
+    return transientCodes.includes(code);
+}
+/**
+ * Classify a standard Error into an MCP error code
+ */
+export function classifyError(error) {
+    const message = error.message.toLowerCase();
+    const name = error.name.toLowerCase();
+    // Network/Connection errors
+    if (name.includes('fetch') ||
+        name.includes('network') ||
+        message.includes('econnrefused') ||
+        message.includes('econnreset') ||
+        message.includes('network') ||
+        message.includes('socket')) {
+        return McpErrorCode.ConnectionError;
+    }
+    // Timeout errors
+    if (name.includes('timeout') ||
+        message.includes('timeout') ||
+        message.includes('etimedout') ||
+        message.includes('timed out')) {
+        return McpErrorCode.ConnectionTimeout;
+    }
+    // Rate limit errors
+    if (message.includes('rate limit') ||
+        message.includes('too many requests') ||
+        message.includes('429')) {
+        return McpErrorCode.RateLimited;
+    }
+    // Authentication errors
+    if (message.includes('unauthorized') ||
+        message.includes('authentication') ||
+        message.includes('401') ||
+        message.includes('403')) {
+        return McpErrorCode.AuthenticationFailed;
+    }
+    // Parse errors
+    if (name.includes('syntaxerror') ||
+        message.includes('json') ||
+        message.includes('parse')) {
+        return McpErrorCode.ParseError;
+    }
+    // Default to internal error
+    return McpErrorCode.InternalError;
+}
+/**
+ * Check if an error is retryable
+ */
+export function isRetryableError(error) {
+    if (error instanceof McpError) {
+        return error.retryable;
+    }
+    return isTransientErrorCode(classifyError(error));
+}
+/**
+ * Get retry delay from error (if rate limited) or use default
+ */
+export function getRetryDelay(error, defaultDelayMs = 1000) {
+    if (error instanceof RateLimitError) {
+        return error.retryAfterMs;
+    }
+    if (error instanceof McpError && error.data?.retryAfter) {
+        return error.data.retryAfter;
+    }
+    return defaultDelayMs;
+}
+// =============================================================================
+// Error Wrapping Utilities
+// =============================================================================
+/**
+ * Wrap an async function with MCP error handling
+ *
+ * @example
+ * ```typescript
+ * const safeFetch = wrapWithMcpError(async () => {
+ *   const response = await fetch(url)
+ *   return response.json()
+ * })
+ * ```
+ */
+export function wrapWithMcpError(fn, defaultCode) {
+    return fn().catch((error) => {
+        throw McpError.fromError(error, defaultCode);
+    });
+}
+/**
+ * Create a JSON-RPC error response from an Error
+ */
+export function createErrorResponse(error, requestId) {
+    const mcpError = McpError.fromError(error);
+    const response = mcpError.toResponse();
+    if (requestId !== undefined) {
+        response.data = { ...response.data, requestId };
+    }
+    return response;
+}
+//# sourceMappingURL=errors.js.map

package/dist/mcp/adapters/errors.js.map

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

package/dist/mcp/adapters/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * MCP SDK Adapters
+ *
+ * Provides adapters for integrating MCP servers with popular AI SDKs:
+ *
+ * - **Anthropic Adapter**: For Claude models via Anthropic's SDK
+ * - **Vercel Adapter**: For Vercel AI SDK (compatible with OpenAI, Anthropic, etc.)
+ *
+ * ## Features
+ *
+ * - **Error Handling**: Proper MCP error responses with retry logic
+ * - **Timeout Handling**: Configurable timeouts with AbortController
+ * - **Streaming Support**: Stream large responses efficiently
+ * - **WebSocket Integration**: Real-time streaming over WebSocket
+ *
+ * ## Quick Start
+ *
+ * ### Anthropic SDK
+ *
+ * ```typescript
+ * import { createMcpServer } from '../server'
+ * import { createAnthropicAdapter } from './adapters'
+ *
+ * const server = createMcpServer({ dbAccess })
+ * const adapter = createAnthropicAdapter({ server })
+ *
+ * await adapter.initialize()
+ * const tools = await adapter.getTools()
+ *
+ * // Use with Anthropic SDK
+ * const response = await anthropic.messages.create({
+ *   model: 'claude-3-opus-20240229',
+ *   tools,
+ *   messages: [{ role: 'user', content: 'Search for documents' }],
+ * })
+ * ```
+ *
+ * ### Vercel AI SDK
+ *
+ * ```typescript
+ * import { generateText } from 'ai'
+ * import { createMcpServer } from '../server'
+ * import { createVercelAdapter } from './adapters'
+ *
+ * const server = createMcpServer({ dbAccess })
+ * const adapter = createVercelAdapter({ server })
+ *
+ * await adapter.initialize()
+ * const tools = await adapter.getTools()
+ *
+ * const result = await generateText({
+ *   model: openai('gpt-4'),
+ *   tools,
+ *   prompt: 'Search for AI documents',
+ * })
+ * ```
+ *
+ * @module mcp/adapters
+ */
+export { McpErrorCode, type McpErrorCodeType, type McpErrorData, type McpErrorResponse, McpError, ConnectionError, TimeoutError, RateLimitError, AuthenticationError, ToolNotFoundError, ToolExecutionError, InvalidParamsError, isTransientErrorCode, classifyError, isRetryableError, getRetryDelay, wrapWithMcpError, createErrorResponse, } from './errors';
+export { BaseAdapter, type RetryConfig, type TimeoutConfig, type LogConfig, type BaseAdapterConfig, type ToolCallResult, type BatchOptions, } from './base-adapter';
+export { type StreamChunk, type StreamProgressCallback, type StreamOptions, type WebSocketMessageType, type WebSocketMessage, streamTextContent, streamFileContent, type SearchStreamOptions, type SearchResultItem, streamSearchResults, type WebSocketStreamConfig, streamToWebSocket, collectStreamToResponse, streamToMcpContent, combineStreams, rateLimitStream, bufferStream, } from './streaming';
+export { AnthropicAdapter, createAnthropicAdapter, type AnthropicAdapterConfig, type AnthropicTool, type AnthropicToolParameter, type AnthropicToolUse, type AnthropicToolResult, type AnthropicToolResultContent, type AnthropicApiError, } from './anthropic-adapter';
+export { VercelAdapter, createVercelAdapter, formatToolResults, type VercelAdapterConfig, type VercelToolParameters, type VercelCoreTool, type VercelToolCall, type VercelToolResult, type VercelStreamable, type VercelStreamOptions, } from './vercel-adapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AAMH,OAAO,EAEL,YAAY,EACZ,KAAK,gBAAgB,EAGrB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EAGrB,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAGlB,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,UAAU,CAAA;AAMjB,OAAO,EACL,WAAW,EAGX,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,iBAAiB,EAGtB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,gBAAgB,CAAA;AAMvB,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EAGrB,iBAAiB,EACjB,iBAAiB,EAGjB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,mBAAmB,EAGnB,KAAK,qBAAqB,EAC1B,iBAAiB,EAGjB,uBAAuB,EACvB,kBAAkB,EAGlB,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,aAAa,CAAA;AAMpB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EAGtB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,GACvB,MAAM,qBAAqB,CAAA;AAM5B,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EAGjB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB,MAAM,kBAAkB,CAAA"}

package/dist/mcp/adapters/index.js

@@ -0,0 +1,92 @@
+/**
+ * MCP SDK Adapters
+ *
+ * Provides adapters for integrating MCP servers with popular AI SDKs:
+ *
+ * - **Anthropic Adapter**: For Claude models via Anthropic's SDK
+ * - **Vercel Adapter**: For Vercel AI SDK (compatible with OpenAI, Anthropic, etc.)
+ *
+ * ## Features
+ *
+ * - **Error Handling**: Proper MCP error responses with retry logic
+ * - **Timeout Handling**: Configurable timeouts with AbortController
+ * - **Streaming Support**: Stream large responses efficiently
+ * - **WebSocket Integration**: Real-time streaming over WebSocket
+ *
+ * ## Quick Start
+ *
+ * ### Anthropic SDK
+ *
+ * ```typescript
+ * import { createMcpServer } from '../server'
+ * import { createAnthropicAdapter } from './adapters'
+ *
+ * const server = createMcpServer({ dbAccess })
+ * const adapter = createAnthropicAdapter({ server })
+ *
+ * await adapter.initialize()
+ * const tools = await adapter.getTools()
+ *
+ * // Use with Anthropic SDK
+ * const response = await anthropic.messages.create({
+ *   model: 'claude-3-opus-20240229',
+ *   tools,
+ *   messages: [{ role: 'user', content: 'Search for documents' }],
+ * })
+ * ```
+ *
+ * ### Vercel AI SDK
+ *
+ * ```typescript
+ * import { generateText } from 'ai'
+ * import { createMcpServer } from '../server'
+ * import { createVercelAdapter } from './adapters'
+ *
+ * const server = createMcpServer({ dbAccess })
+ * const adapter = createVercelAdapter({ server })
+ *
+ * await adapter.initialize()
+ * const tools = await adapter.getTools()
+ *
+ * const result = await generateText({
+ *   model: openai('gpt-4'),
+ *   tools,
+ *   prompt: 'Search for AI documents',
+ * })
+ * ```
+ *
+ * @module mcp/adapters
+ */
+// =============================================================================
+// Error Types and Utilities
+// =============================================================================
+export { 
+// Error codes
+McpErrorCode, 
+// Error classes
+McpError, ConnectionError, TimeoutError, RateLimitError, AuthenticationError, ToolNotFoundError, ToolExecutionError, InvalidParamsError, 
+// Error utilities
+isTransientErrorCode, classifyError, isRetryableError, getRetryDelay, wrapWithMcpError, createErrorResponse, } from './errors';
+// =============================================================================
+// Base Adapter
+// =============================================================================
+export { BaseAdapter, } from './base-adapter';
+// =============================================================================
+// Streaming Utilities
+// =============================================================================
+export { 
+// Content streaming
+streamTextContent, streamFileContent, streamSearchResults, streamToWebSocket, 
+// MCP response streaming
+collectStreamToResponse, streamToMcpContent, 
+// Stream utilities
+combineStreams, rateLimitStream, bufferStream, } from './streaming';
+// =============================================================================
+// Anthropic Adapter
+// =============================================================================
+export { AnthropicAdapter, createAnthropicAdapter, } from './anthropic-adapter';
+// =============================================================================
+// Vercel Adapter
+// =============================================================================
+export { VercelAdapter, createVercelAdapter, formatToolResults, } from './vercel-adapter';
+//# sourceMappingURL=index.js.map

package/dist/mcp/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AAEH,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF,OAAO;AACL,cAAc;AACd,YAAY;AAOZ,gBAAgB;AAChB,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB;AAElB,kBAAkB;AAClB,oBAAoB,EACpB,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,UAAU,CAAA;AAEjB,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF,OAAO,EACL,WAAW,GAWZ,MAAM,gBAAgB,CAAA;AAEvB,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,OAAO;AAQL,oBAAoB;AACpB,iBAAiB,EACjB,iBAAiB,EAKjB,mBAAmB,EAInB,iBAAiB;AAEjB,yBAAyB;AACzB,uBAAuB,EACvB,kBAAkB;AAElB,mBAAmB;AACnB,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,aAAa,CAAA;AAEpB,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GAUvB,MAAM,qBAAqB,CAAA;AAE5B,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,iBAAiB,GAUlB,MAAM,kBAAkB,CAAA"}

package/dist/mcp/adapters/streaming.d.ts

@@ -0,0 +1,200 @@
+/**
+ * Streaming Utilities for MCP SDK Adapters
+ *
+ * Provides streaming support for:
+ * - Large file reads with chunked transfer
+ * - Grep/search results streaming
+ * - WebSocket integration for real-time updates
+ * - Async iterator utilities
+ *
+ * All streaming operations are designed to be memory-efficient
+ * and support backpressure handling.
+ */
+import type { McpToolResponse, McpTextContent } from '../types';
+/**
+ * A chunk of streamed content
+ */
+export interface StreamChunk {
+    /** Chunk index (0-based) */
+    index: number;
+    /** Content of this chunk */
+    content: string;
+    /** Whether this is the final chunk */
+    done: boolean;
+    /** Total size if known */
+    totalSize?: number;
+    /** Bytes transferred so far */
+    bytesTransferred: number;
+}
+/**
+ * Stream progress callback
+ */
+export type StreamProgressCallback = (chunk: StreamChunk) => void;
+/**
+ * Stream options
+ */
+export interface StreamOptions {
+    /** Chunk size in bytes (default: 64KB) */
+    chunkSize?: number;
+    /** Progress callback */
+    onProgress?: StreamProgressCallback;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+    /** Transform each chunk before yielding */
+    transform?: (content: string) => string;
+}
+/**
+ * WebSocket message types
+ */
+export type WebSocketMessageType = 'stream_start' | 'stream_chunk' | 'stream_end' | 'stream_error' | 'tool_result';
+/**
+ * WebSocket message format
+ */
+export interface WebSocketMessage {
+    type: WebSocketMessageType;
+    requestId: string;
+    data: unknown;
+    timestamp: string;
+}
+/**
+ * Create a streaming response from text content
+ *
+ * Splits large text content into chunks for efficient transmission.
+ * Yields chunks as an async iterator.
+ *
+ * @param content - Text content to stream
+ * @param options - Stream options
+ * @yields StreamChunk for each chunk of content
+ *
+ * @example
+ * ```typescript
+ * const content = await readLargeFile()
+ * for await (const chunk of streamTextContent(content, { chunkSize: 32768 })) {
+ *   socket.send(JSON.stringify({ type: 'chunk', data: chunk }))
+ * }
+ * ```
+ */
+export declare function streamTextContent(content: string, options?: StreamOptions): AsyncGenerator<StreamChunk, void, undefined>;
+/**
+ * Stream file content in chunks
+ *
+ * Reads a file and streams its content in chunks suitable for
+ * MCP tool responses.
+ *
+ * @param readFn - Function to read file content (allows dependency injection)
+ * @param filePath - Path to the file
+ * @param options - Stream options
+ * @yields StreamChunk for each chunk of file content
+ */
+export declare function streamFileContent(readFn: (path: string, options?: {
+    offset?: number;
+    length?: number;
+}) => Promise<string>, filePath: string, options?: StreamOptions): AsyncGenerator<StreamChunk, void, undefined>;
+/**
+ * Options for streaming search results
+ */
+export interface SearchStreamOptions extends StreamOptions {
+    /** Maximum results per chunk (default: 100) */
+    resultsPerChunk?: number;
+    /** Include match context (default: true) */
+    includeContext?: boolean;
+}
+/**
+ * A search result item
+ */
+export interface SearchResultItem {
+    /** File or document path */
+    path: string;
+    /** Line number (for text search) */
+    line?: number;
+    /** Match content */
+    content: string;
+    /** Context around match */
+    context?: string;
+}
+/**
+ * Stream search results
+ *
+ * Yields search results in batches as they are found.
+ * Useful for grep-like operations on large codebases.
+ *
+ * @param searchFn - Async generator that yields search results
+ * @param options - Stream options
+ * @yields StreamChunk containing batched search results
+ */
+export declare function streamSearchResults(searchFn: () => AsyncGenerator<SearchResultItem, void, undefined>, options?: SearchStreamOptions): AsyncGenerator<StreamChunk, void, undefined>;
+/**
+ * WebSocket stream handler configuration
+ */
+export interface WebSocketStreamConfig {
+    /** Send function for the WebSocket */
+    send: (message: string) => void;
+    /** Request ID for correlation */
+    requestId: string;
+    /** Idle timeout in ms (default: 30000) */
+    idleTimeout?: number;
+    /** Error handler */
+    onError?: (error: Error) => void;
+}
+/**
+ * Stream content over a WebSocket connection
+ *
+ * Sends stream chunks as WebSocket messages with proper
+ * framing and error handling.
+ *
+ * @param stream - Async iterator of stream chunks
+ * @param config - WebSocket configuration
+ *
+ * @example
+ * ```typescript
+ * const stream = streamTextContent(largeContent)
+ * await streamToWebSocket(stream, {
+ *   send: (msg) => ws.send(msg),
+ *   requestId: 'req-123',
+ * })
+ * ```
+ */
+export declare function streamToWebSocket(stream: AsyncIterable<StreamChunk>, config: WebSocketStreamConfig): Promise<void>;
+/**
+ * Convert stream chunks to MCP tool response
+ *
+ * Collects all stream chunks and creates a single MCP tool response.
+ * Useful when the SDK doesn't support streaming natively.
+ *
+ * @param stream - Async iterator of stream chunks
+ * @returns Complete MCP tool response
+ */
+export declare function collectStreamToResponse(stream: AsyncIterable<StreamChunk>): Promise<McpToolResponse>;
+/**
+ * Create a streaming MCP tool response generator
+ *
+ * Wraps stream chunks as MCP text content for streaming responses.
+ *
+ * @param stream - Async iterator of stream chunks
+ * @yields McpTextContent for each chunk
+ */
+export declare function streamToMcpContent(stream: AsyncIterable<StreamChunk>): AsyncGenerator<McpTextContent, void, undefined>;
+/**
+ * Combine multiple streams into a single stream
+ *
+ * @param streams - Array of async iterables to combine
+ * @yields StreamChunk from each stream in order
+ */
+export declare function combineStreams(...streams: AsyncIterable<StreamChunk>[]): AsyncGenerator<StreamChunk, void, undefined>;
+/**
+ * Limit the rate of stream chunks
+ *
+ * @param stream - Source stream
+ * @param delayMs - Delay between chunks in milliseconds
+ * @yields StreamChunk with rate limiting applied
+ */
+export declare function rateLimitStream(stream: AsyncIterable<StreamChunk>, delayMs: number): AsyncGenerator<StreamChunk, void, undefined>;
+/**
+ * Buffer stream chunks until a minimum size is reached
+ *
+ * @param stream - Source stream
+ * @param minSize - Minimum buffer size before yielding
+ * @yields StreamChunk when buffer reaches minSize or stream ends
+ */
+export declare function bufferStream(stream: AsyncIterable<StreamChunk>, minSize: number): AsyncGenerator<StreamChunk, void, undefined>;
+//# sourceMappingURL=streaming.d.ts.map