mongo.do 0.1.0 → 0.1.1

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

@@ -1,321 +0,0 @@
-/**
- * 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

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