mongo.do 0.1.0

package/dist/mcp/adapters/vercel-adapter.d.ts

@@ -0,0 +1,321 @@
+/**
+ * Vercel AI SDK Adapter for MCP
+ *
+ * Adapts MCP server tools to Vercel AI SDK's tool format.
+ * Compatible with the Vercel AI SDK's `tool` and `generateText` APIs.
+ *
+ * Features:
+ * - Converts MCP tool definitions to Vercel AI SDK format
+ * - Supports both `tool()` and `CoreTool` interfaces
+ * - Handles streaming via Vercel's streaming responses
+ * - Integrates with `ai` package for Next.js compatibility
+ *
+ * @see https://sdk.vercel.ai/docs/ai-sdk-core/tools-and-tool-calling
+ */
+import { BaseAdapter, type BaseAdapterConfig } from './base-adapter';
+import type { McpToolResponse } from '../types';
+import { z } from 'zod';
+/**
+ * Vercel AI SDK tool parameter schema (Zod-based)
+ */
+export type VercelToolParameters = z.ZodObject<Record<string, z.ZodTypeAny>>;
+/**
+ * Vercel AI SDK CoreTool interface
+ *
+ * @see https://sdk.vercel.ai/docs/reference/ai-sdk-core/tool
+ */
+export interface VercelCoreTool<TParams extends VercelToolParameters = VercelToolParameters> {
+    /** Human-readable description */
+    description: string;
+    /** Zod schema for parameters */
+    parameters: TParams;
+    /** Tool execution function */
+    execute: (params: z.infer<TParams>) => Promise<string>;
+}
+/**
+ * Vercel AI SDK tool call from model response
+ */
+export interface VercelToolCall {
+    toolCallId: string;
+    toolName: string;
+    args: Record<string, unknown>;
+}
+/**
+ * Vercel AI SDK tool result
+ */
+export interface VercelToolResult {
+    toolCallId: string;
+    toolName: string;
+    result: string;
+}
+/**
+ * Vercel AI SDK streamable value for streaming responses
+ */
+export interface VercelStreamable {
+    /** Value stream */
+    readonly value: ReadableStream<string>;
+    /** Append to stream */
+    append: (chunk: string) => void;
+    /** Complete the stream */
+    done: () => void;
+    /** Error the stream */
+    error: (error: Error) => void;
+}
+/**
+ * Vercel AI SDK streaming text response options
+ */
+export interface VercelStreamOptions {
+    /** Enable streaming (default: true) */
+    stream?: boolean;
+    /** Chunk size for streaming (default: 1024) */
+    chunkSize?: number;
+    /** Signal for abort */
+    signal?: AbortSignal;
+}
+/**
+ * Vercel adapter configuration
+ */
+export interface VercelAdapterConfig extends BaseAdapterConfig {
+    /** Maximum content length before streaming (default: 50KB) */
+    streamingThreshold?: number;
+    /** Whether to use streaming by default (default: true) */
+    defaultStreaming?: boolean;
+    /** Custom result formatter */
+    formatResult?: (response: McpToolResponse) => string;
+}
+/**
+ * Vercel AI SDK Adapter
+ *
+ * Converts MCP tools to Vercel AI SDK's CoreTool format and handles
+ * tool execution with streaming support.
+ *
+ * @example
+ * ```typescript
+ * import { generateText, tool } from 'ai'
+ *
+ * const mcpServer = createMcpServer({ dbAccess })
+ * const adapter = new VercelAdapter({ server: mcpServer })
+ *
+ * await adapter.initialize()
+ *
+ * // Get tools for Vercel AI SDK
+ * const tools = await adapter.getTools()
+ *
+ * // Use with generateText
+ * const result = await generateText({
+ *   model: openai('gpt-4'),
+ *   tools,
+ *   prompt: 'Search for documents about AI',
+ * })
+ * ```
+ */
+export declare class VercelAdapter extends BaseAdapter {
+    private readonly streamingThreshold;
+    private readonly defaultStreaming;
+    private readonly formatResult;
+    private toolCache;
+    private mcpToolNames;
+    private initialized;
+    constructor(config: VercelAdapterConfig);
+    /**
+     * Adapter name for logging
+     */
+    get adapterName(): string;
+    /**
+     * Initialize the adapter
+     *
+     * Fetches all available tools from the MCP server and converts
+     * them to Vercel AI SDK format.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Cleanup adapter resources
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Convert MCP tool definition to Vercel CoreTool format
+     */
+    private convertTool;
+    /**
+     * Convert JSON Schema to Zod schema
+     *
+     * Creates a Zod schema that validates the same structure as the
+     * original JSON Schema from the MCP tool definition.
+     */
+    private convertToZodSchema;
+    /**
+     * Convert a single JSON Schema property to Zod
+     */
+    private convertPropertyToZod;
+    /**
+     * Default result formatter
+     */
+    private defaultResultFormatter;
+    /**
+     * Extract text content from MCP response
+     */
+    private extractTextContent;
+    /**
+     * Get all tools in Vercel AI SDK format
+     *
+     * Returns a record of tool definitions suitable for use with
+     * the Vercel AI SDK's `generateText` or `streamText` functions.
+     *
+     * @returns Record of tool name to CoreTool
+     *
+     * @example
+     * ```typescript
+     * import { generateText } from 'ai'
+     *
+     * const tools = await adapter.getTools()
+     *
+     * const result = await generateText({
+     *   model: openai('gpt-4'),
+     *   tools,
+     *   prompt: 'Search for users',
+     * })
+     * ```
+     */
+    getTools(): Promise<Record<string, VercelCoreTool>>;
+    /**
+     * Get a single tool by name
+     *
+     * @param name - Tool name
+     * @returns CoreTool or undefined
+     */
+    getTool(name: string): Promise<VercelCoreTool | undefined>;
+    /**
+     * Handle a tool call from model response
+     *
+     * Executes the requested tool and returns a tool result.
+     *
+     * @param toolCall - Tool call from model
+     * @returns Tool result
+     *
+     * @example
+     * ```typescript
+     * for (const toolCall of result.toolCalls) {
+     *   const toolResult = await adapter.handleToolCall(toolCall)
+     *   results.push(toolResult)
+     * }
+     * ```
+     */
+    handleToolCall(toolCall: VercelToolCall): Promise<VercelToolResult>;
+    /**
+     * Handle multiple tool calls in parallel
+     *
+     * @param toolCalls - Array of tool calls
+     * @param concurrency - Maximum concurrent executions (default: 5)
+     * @returns Array of tool results
+     */
+    handleToolCalls(toolCalls: VercelToolCall[], concurrency?: number): Promise<VercelToolResult[]>;
+    /**
+     * Create a streaming tool executor
+     *
+     * Returns a function that executes a tool and streams the response.
+     * Compatible with Vercel AI SDK's streaming patterns.
+     *
+     * @param toolName - Name of the tool
+     * @returns Streaming executor function
+     *
+     * @example
+     * ```typescript
+     * const searchStream = adapter.createStreamingExecutor('search')
+     *
+     * const stream = searchStream({ query: 'AI documents' })
+     *
+     * for await (const chunk of stream) {
+     *   process.stdout.write(chunk)
+     * }
+     * ```
+     */
+    createStreamingExecutor(toolName: string): (args: Record<string, unknown>, options?: VercelStreamOptions) => AsyncIterable<string>;
+    /**
+     * Execute a tool with streaming response
+     *
+     * @param toolName - Tool name
+     * @param args - Tool arguments
+     * @param options - Stream options
+     * @yields String chunks of the response
+     */
+    private executeWithStreaming;
+    /**
+     * Create a ReadableStream for a tool execution
+     *
+     * Returns a Web Streams API ReadableStream that can be used
+     * with Response objects for HTTP streaming.
+     *
+     * @param toolName - Tool name
+     * @param args - Tool arguments
+     * @returns ReadableStream of response chunks
+     *
+     * @example
+     * ```typescript
+     * // In a Next.js API route
+     * export async function POST(req: Request) {
+     *   const { toolName, args } = await req.json()
+     *   const stream = adapter.createReadableStream(toolName, args)
+     *   return new Response(stream)
+     * }
+     * ```
+     */
+    createReadableStream(toolName: string, args: Record<string, unknown>): ReadableStream<Uint8Array>;
+    /**
+     * Create a tool wrapper compatible with Vercel AI SDK's `tool()` helper
+     *
+     * This creates a tool definition that can be used directly with the
+     * `tool()` helper from the `ai` package.
+     *
+     * @param mcpToolName - MCP tool name
+     * @returns Tool configuration object
+     *
+     * @example
+     * ```typescript
+     * import { tool } from 'ai'
+     *
+     * const searchTool = adapter.createToolWrapper('search')
+     *
+     * // Use with generateText
+     * const result = await generateText({
+     *   model: openai('gpt-4'),
+     *   tools: { search: searchTool },
+     *   prompt: 'Find documents',
+     * })
+     * ```
+     */
+    createToolWrapper(mcpToolName: string): VercelCoreTool | undefined;
+}
+/**
+ * Create a Vercel AI SDK adapter for an MCP server
+ *
+ * @param config - Adapter configuration
+ * @returns Configured VercelAdapter instance
+ *
+ * @example
+ * ```typescript
+ * const adapter = createVercelAdapter({
+ *   server: mcpServer,
+ *   retry: { maxRetries: 3 },
+ *   streamingThreshold: 10000,
+ * })
+ *
+ * await adapter.initialize()
+ * const tools = await adapter.getTools()
+ * ```
+ */
+export declare function createVercelAdapter(config: VercelAdapterConfig): VercelAdapter;
+/**
+ * Convert Vercel tool results to continuation messages
+ *
+ * Formats tool results for inclusion in the next model request.
+ *
+ * @param results - Array of tool results
+ * @returns Formatted tool results for API
+ */
+export declare function formatToolResults(results: VercelToolResult[]): Array<{
+    type: 'tool-result';
+    toolCallId: string;
+    toolName: string;
+    result: string;
+}>;
+//# sourceMappingURL=vercel-adapter.d.ts.map

package/dist/mcp/adapters/vercel-adapter.d.ts.map

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