mongo.do 0.1.0

package/dist/executor/vector-search-executor.d.ts

@@ -0,0 +1,71 @@
+/**
+ * VectorSearchExecutor - Executes vector similarity searches using Cloudflare Vectorize
+ *
+ * This class handles:
+ * 1. Querying Vectorize for similar vectors
+ * 2. Retrieving document data from metadata
+ * 3. Adding similarity scores to results
+ * 4. Managing vector storage (insert, update, delete)
+ */
+import type { VectorizeIndex } from '../types/vectorize';
+/**
+ * Translation parameters for vector search execution
+ */
+export interface VectorSearchTranslation {
+    /** The query vector for similarity search */
+    queryVector: number[];
+    /** Maximum number of results to return */
+    limit: number;
+    /** Field name to store the similarity score */
+    scoreField: string;
+}
+/**
+ * SQL interface for executing queries
+ */
+interface SqlInterface {
+    exec: (query: string, ...params: unknown[]) => {
+        results: unknown[];
+        toArray?: () => unknown[];
+    };
+}
+/**
+ * Executes vector search operations using Cloudflare Vectorize
+ */
+export declare class VectorSearchExecutor {
+    private vectorize?;
+    constructor(_sql: SqlInterface, vectorize?: VectorizeIndex | undefined);
+    /**
+     * Execute a vector search query
+     *
+     * @param translation - The translated vector search parameters
+     * @param collection - The collection name
+     * @returns Array of documents with similarity scores
+     */
+    executeVectorSearch(translation: VectorSearchTranslation, collection: string): Promise<Record<string, unknown>[]>;
+    /**
+     * Upsert a vector for a document
+     *
+     * @param collection - The collection name
+     * @param documentId - The document ID
+     * @param vector - The embedding vector
+     * @param document - The document data to store in metadata
+     */
+    upsertVector(collection: string, documentId: string, vector: number[], document: Record<string, unknown>): Promise<void>;
+    /**
+     * Delete a vector for a document
+     *
+     * @param collection - The collection name
+     * @param documentId - The document ID
+     */
+    deleteVector(collection: string, documentId: string): Promise<void>;
+    /**
+     * Generate a unique vector ID from collection and document ID
+     */
+    private generateVectorId;
+    /**
+     * Extract document from vector match metadata
+     */
+    private extractDocument;
+}
+export {};
+//# sourceMappingURL=vector-search-executor.d.ts.map

package/dist/executor/vector-search-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-search-executor.d.ts","sourceRoot":"","sources":["../../src/executor/vector-search-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAmC,MAAM,oBAAoB,CAAA;AAEzF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,UAAU,YAAY;IACpB,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK;QAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,OAAO,EAAE,CAAA;KAAE,CAAA;CACjG;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAG7B,OAAO,CAAC,SAAS,CAAC;gBADlB,IAAI,EAAE,YAAY,EACV,SAAS,CAAC,EAAE,cAAc,YAAA;IAKpC;;;;;;OAMG;IACG,mBAAmB,CACvB,WAAW,EAAE,uBAAuB,EACpC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAuCrC;;;;;;;OAOG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC;IAoBhB;;;;;OAKG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAShB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;IACH,OAAO,CAAC,eAAe;CAYxB"}

package/dist/executor/vector-search-executor.js

@@ -0,0 +1,113 @@
+/**
+ * VectorSearchExecutor - Executes vector similarity searches using Cloudflare Vectorize
+ *
+ * This class handles:
+ * 1. Querying Vectorize for similar vectors
+ * 2. Retrieving document data from metadata
+ * 3. Adding similarity scores to results
+ * 4. Managing vector storage (insert, update, delete)
+ */
+/**
+ * Executes vector search operations using Cloudflare Vectorize
+ */
+export class VectorSearchExecutor {
+    vectorize;
+    constructor(_sql, vectorize) {
+        this.vectorize = vectorize;
+        // SQL interface available for potential future use
+    }
+    /**
+     * Execute a vector search query
+     *
+     * @param translation - The translated vector search parameters
+     * @param collection - The collection name
+     * @returns Array of documents with similarity scores
+     */
+    async executeVectorSearch(translation, collection) {
+        if (!this.vectorize) {
+            throw new Error('Vectorize is not configured. Add VECTORIZE binding to your worker.');
+        }
+        const { queryVector, limit, scoreField } = translation;
+        // Query Vectorize
+        const queryResult = await this.vectorize.query(queryVector, {
+            topK: limit,
+            returnMetadata: 'all'
+        });
+        // Process results
+        const documents = [];
+        const collectionPrefix = `${collection}:`;
+        for (const match of queryResult.matches) {
+            // Filter by collection prefix
+            if (!match.id.startsWith(collectionPrefix)) {
+                continue;
+            }
+            // Extract document from metadata
+            const doc = this.extractDocument(match);
+            if (doc) {
+                // Add similarity score
+                doc[scoreField] = match.score;
+                documents.push(doc);
+            }
+        }
+        return documents;
+    }
+    /**
+     * Upsert a vector for a document
+     *
+     * @param collection - The collection name
+     * @param documentId - The document ID
+     * @param vector - The embedding vector
+     * @param document - The document data to store in metadata
+     */
+    async upsertVector(collection, documentId, vector, document) {
+        if (!this.vectorize) {
+            throw new Error('Vectorize is not configured. Add VECTORIZE binding to your worker.');
+        }
+        const vectorId = this.generateVectorId(collection, documentId);
+        const vectorData = {
+            id: vectorId,
+            values: vector,
+            metadata: {
+                _data: JSON.stringify(document),
+                _collection: collection,
+                _documentId: documentId
+            }
+        };
+        await this.vectorize.upsert([vectorData]);
+    }
+    /**
+     * Delete a vector for a document
+     *
+     * @param collection - The collection name
+     * @param documentId - The document ID
+     */
+    async deleteVector(collection, documentId) {
+        if (!this.vectorize) {
+            throw new Error('Vectorize is not configured. Add VECTORIZE binding to your worker.');
+        }
+        const vectorId = this.generateVectorId(collection, documentId);
+        await this.vectorize.deleteByIds([vectorId]);
+    }
+    /**
+     * Generate a unique vector ID from collection and document ID
+     */
+    generateVectorId(collection, documentId) {
+        return `${collection}:${documentId}`;
+    }
+    /**
+     * Extract document from vector match metadata
+     */
+    extractDocument(match) {
+        if (!match.metadata || !match.metadata._data) {
+            return null;
+        }
+        try {
+            const dataStr = match.metadata._data;
+            return JSON.parse(dataStr);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=vector-search-executor.js.map

package/dist/executor/vector-search-executor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * mongo.do - MongoDB-compatible database backed by Cloudflare Durable Objects SQLite
+ *
+ * Main entry point for the package.
+ */
+export { ObjectId } from './types/objectid';
+export { MondoDatabase } from './durable-object/mondo-database';
+export { SchemaManager, SCHEMA_VERSION, SCHEMA_TABLES } from './durable-object/schema';
+export { IndexManager, generateIndexName, generateSQLiteIndexName, buildCreateIndexSQL, } from './durable-object/index-manager';
+export type { SQLStorage, SQLStatement } from './durable-object/index-manager';
+export type { IndexSpec, CreateIndexOptions, CreateIndexResult, IndexInfo, DropIndexResult, } from './types';
+export { MongoCollection } from './client/mongo-collection';
+export { ErrorCode, getErrorCodeName, successResponse, errorResponse, legacySuccessResponse, legacyErrorResponse, MessageType, } from './types/rpc';
+export type { DurableObjectNamespace, DurableObjectId, DurableObjectStub, MondoEnv, WorkerLoader, WorkerCode, WorkerStub, WorkerEntrypoint as WorkerEntrypointType, RpcRequest, RpcResponse, BatchResponse, HttpRpcRequest, HttpRpcSuccessResponse, HttpRpcErrorResponse, HttpRpcResponse, LegacyRpcRequest, LegacyRpcResponse, DatabaseRef, CollectionRef, BatchedExecutorOptions, PipelineOp, RpcClientOptions, DeduplicatorOptions, EventHandler, ReconnectEvent, RpcHandler, ErrorCodeValue, } from './types/rpc';
+export { RpcTarget, MondoRpcTarget, newWorkersRpcResponse, BatchedRpcExecutor, PipelineTracker, PipelinedRpcProxy, } from './rpc/rpc-target';
+export type { MondoEnv as RpcMondoEnv } from './types/rpc';
+export { RpcClient, MongoClient, WebSocketRpcTransport, RequestDeduplicator, } from './rpc/rpc-client';
+export { WorkerEntrypoint, MondoEntrypoint, validateEnv, isMondoEnv, DEFAULT_OPTIONS, } from './rpc/worker-entrypoint';
+export type { ExecutionContext, MondoBindings, MondoEntrypointOptions, } from './rpc/worker-entrypoint';
+export { MondoEntrypoint as default } from './rpc/worker-entrypoint';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAG/E,YAAY,EACV,SAAS,EACT,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,eAAe,GAChB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG5D,OAAO,EAEL,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EAEnB,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,YAAY,EAEV,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EAEjB,QAAQ,EAER,YAAY,EACZ,UAAU,EACV,UAAU,EACV,gBAAgB,IAAI,oBAAoB,EAExC,UAAU,EACV,WAAW,EACX,aAAa,EAEb,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EAEf,gBAAgB,EAChB,iBAAiB,EAEjB,WAAW,EACX,aAAa,EAEb,sBAAsB,EACtB,UAAU,EAEV,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EAEd,UAAU,EACV,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,SAAS,EACT,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,QAAQ,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AAG3D,OAAO,EACL,SAAS,EACT,WAAW,EACX,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,UAAU,EACV,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,eAAe,IAAI,OAAO,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+/**
+ * mongo.do - MongoDB-compatible database backed by Cloudflare Durable Objects SQLite
+ *
+ * Main entry point for the package.
+ */
+// Types
+export { ObjectId } from './types/objectid';
+// Durable Object
+export { MondoDatabase } from './durable-object/mondo-database';
+export { SchemaManager, SCHEMA_VERSION, SCHEMA_TABLES } from './durable-object/schema';
+export { IndexManager, generateIndexName, generateSQLiteIndexName, buildCreateIndexSQL, } from './durable-object/index-manager';
+// Client collection with index support
+export { MongoCollection } from './client/mongo-collection';
+// Consolidated RPC Types (from types/rpc.ts)
+export { 
+// Error codes and helpers
+ErrorCode, getErrorCodeName, successResponse, errorResponse, legacySuccessResponse, legacyErrorResponse, 
+// Legacy RPC message types
+MessageType, } from './types/rpc';
+// RPC Server (classes and functions)
+export { RpcTarget, MondoRpcTarget, newWorkersRpcResponse, BatchedRpcExecutor, PipelineTracker, PipelinedRpcProxy, } from './rpc/rpc-target';
+// RPC Client (classes)
+export { RpcClient, MongoClient, WebSocketRpcTransport, RequestDeduplicator, } from './rpc/rpc-client';
+// Worker Entrypoint
+export { WorkerEntrypoint, MondoEntrypoint, validateEnv, isMondoEnv, DEFAULT_OPTIONS, } from './rpc/worker-entrypoint';
+// Default export for Workers
+export { MondoEntrypoint as default } from './rpc/worker-entrypoint';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,QAAQ;AACR,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,gCAAgC,CAAC;AAYxC,uCAAuC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,6CAA6C;AAC7C,OAAO;AACL,0BAA0B;AAC1B,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,qBAAqB,EACrB,mBAAmB;AACnB,2BAA2B;AAC3B,WAAW,GACZ,MAAM,aAAa,CAAC;AA0CrB,qCAAqC;AACrC,OAAO,EACL,SAAS,EACT,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAK1B,uBAAuB;AACvB,OAAO,EACL,SAAS,EACT,WAAW,EACX,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,oBAAoB;AACpB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,UAAU,EACV,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAQjC,6BAA6B;AAC7B,OAAO,EAAE,eAAe,IAAI,OAAO,EAAE,MAAM,yBAAyB,CAAC"}

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

@@ -0,0 +1,256 @@
+/**
+ * Anthropic SDK Adapter for MCP
+ *
+ * Adapts MCP server tools to Anthropic's tool calling format.
+ * Supports Claude models with tool use capabilities.
+ *
+ * Features:
+ * - Converts MCP tool definitions to Anthropic format
+ * - Handles tool call execution with retry and timeout
+ * - Supports streaming responses for large outputs
+ * - Provides proper error mapping to Anthropic error types
+ *
+ * @see https://docs.anthropic.com/claude/docs/tool-use
+ */
+import { BaseAdapter, type BaseAdapterConfig } from './base-adapter';
+import { type WebSocketStreamConfig } from './streaming';
+/**
+ * Anthropic tool parameter definition
+ */
+export interface AnthropicToolParameter {
+    type: string;
+    description?: string;
+    enum?: string[];
+    items?: AnthropicToolParameter;
+    properties?: Record<string, AnthropicToolParameter>;
+    required?: string[];
+}
+/**
+ * Anthropic tool definition format
+ *
+ * @see https://docs.anthropic.com/claude/docs/tool-use#defining-tools
+ */
+export interface AnthropicTool {
+    /** Tool name (alphanumeric and underscores only) */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** JSON Schema for input parameters */
+    input_schema: {
+        type: 'object';
+        properties: Record<string, AnthropicToolParameter>;
+        required?: string[];
+    };
+}
+/**
+ * Anthropic tool use block in assistant message
+ */
+export interface AnthropicToolUse {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+/**
+ * Anthropic tool result block for user message
+ */
+export interface AnthropicToolResult {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string | AnthropicToolResultContent[];
+    is_error?: boolean;
+}
+/**
+ * Content types within tool results
+ */
+export interface AnthropicToolResultContent {
+    type: 'text' | 'image';
+    text?: string;
+    source?: {
+        type: 'base64';
+        media_type: string;
+        data: string;
+    };
+}
+/**
+ * Anthropic API error response structure
+ */
+export interface AnthropicApiError {
+    type: 'error';
+    error: {
+        type: string;
+        message: string;
+    };
+}
+/**
+ * Anthropic adapter configuration
+ */
+export interface AnthropicAdapterConfig extends BaseAdapterConfig {
+    /** Maximum content length before streaming (default: 100KB) */
+    streamingThreshold?: number;
+    /** Whether to include detailed error messages (default: true in dev) */
+    verboseErrors?: boolean;
+    /** Custom tool name transformer */
+    transformToolName?: (name: string) => string;
+}
+/**
+ * Anthropic SDK Adapter
+ *
+ * Converts MCP tools to Anthropic's tool format and handles
+ * tool execution with proper error handling and streaming support.
+ *
+ * @example
+ * ```typescript
+ * const mcpServer = createMcpServer({ dbAccess })
+ * const adapter = new AnthropicAdapter({
+ *   server: mcpServer,
+ *   retry: { maxRetries: 3 },
+ *   timeout: { requestTimeoutMs: 30000 },
+ * })
+ *
+ * await adapter.initialize()
+ *
+ * // Get tools for Anthropic API
+ * const tools = await adapter.getTools()
+ *
+ * // Handle tool use from Claude response
+ * const result = await adapter.handleToolUse(toolUseBlock)
+ * ```
+ */
+export declare class AnthropicAdapter extends BaseAdapter {
+    private readonly streamingThreshold;
+    private readonly verboseErrors;
+    private readonly transformToolName;
+    private toolCache;
+    private initialized;
+    constructor(config: AnthropicAdapterConfig);
+    /**
+     * Adapter name for logging
+     */
+    get adapterName(): string;
+    /**
+     * Initialize the adapter
+     *
+     * Fetches all available tools from the MCP server and converts
+     * them to Anthropic format. Caches the converted tools for reuse.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Cleanup adapter resources
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Default tool name transformation
+     *
+     * Anthropic requires tool names to match [a-zA-Z0-9_]+
+     */
+    private defaultToolNameTransform;
+    /**
+     * Convert MCP tool definition to Anthropic format
+     */
+    private convertTool;
+    /**
+     * Convert MCP JSON Schema to Anthropic input schema format
+     */
+    private convertInputSchema;
+    /**
+     * Convert a single schema property
+     */
+    private convertSchemaProperty;
+    /**
+     * Get all tools in Anthropic format
+     *
+     * Returns an array of tool definitions suitable for use with
+     * the Anthropic API's `tools` parameter.
+     *
+     * @returns Array of Anthropic tool definitions
+     *
+     * @example
+     * ```typescript
+     * const tools = await adapter.getTools()
+     *
+     * const response = await anthropic.messages.create({
+     *   model: 'claude-3-opus-20240229',
+     *   tools,
+     *   messages: [{ role: 'user', content: 'Search for documents' }],
+     * })
+     * ```
+     */
+    getTools(): Promise<AnthropicTool[]>;
+    /**
+     * Handle a tool use block from Claude's response
+     *
+     * Executes the requested tool and returns a tool result block
+     * suitable for inclusion in the next user message.
+     *
+     * @param toolUse - Tool use block from assistant message
+     * @returns Tool result block for user message
+     *
+     * @example
+     * ```typescript
+     * // In message handling loop:
+     * if (block.type === 'tool_use') {
+     *   const result = await adapter.handleToolUse(block)
+     *   userMessage.content.push(result)
+     * }
+     * ```
+     */
+    handleToolUse(toolUse: AnthropicToolUse): Promise<AnthropicToolResult>;
+    /**
+     * Handle multiple tool uses in parallel
+     *
+     * Executes multiple tool calls concurrently with configurable
+     * concurrency limit.
+     *
+     * @param toolUses - Array of tool use blocks
+     * @param concurrency - Maximum concurrent executions (default: 5)
+     * @returns Array of tool result blocks
+     */
+    handleToolUses(toolUses: AnthropicToolUse[], concurrency?: number): Promise<AnthropicToolResult[]>;
+    /**
+     * Execute a tool with streaming response
+     *
+     * For large responses, streams the content through a WebSocket
+     * or returns an async iterator for custom handling.
+     *
+     * @param toolUse - Tool use block
+     * @param wsConfig - Optional WebSocket configuration for streaming
+     * @returns Tool result or stream
+     */
+    handleToolUseStreaming(toolUse: AnthropicToolUse, wsConfig?: WebSocketStreamConfig): Promise<AnthropicToolResult | AsyncIterable<string>>;
+    /**
+     * Find the original MCP tool name from an Anthropic tool name
+     */
+    private findMcpToolName;
+    /**
+     * Convert MCP tool response to Anthropic format
+     */
+    private convertToolResponse;
+    /**
+     * Extract text content from MCP response
+     */
+    private extractTextContent;
+    /**
+     * Format error content for tool result
+     */
+    private formatErrorContent;
+}
+/**
+ * Create an Anthropic adapter for an MCP server
+ *
+ * @param config - Adapter configuration
+ * @returns Configured AnthropicAdapter instance
+ *
+ * @example
+ * ```typescript
+ * const adapter = createAnthropicAdapter({
+ *   server: mcpServer,
+ *   retry: { maxRetries: 3 },
+ * })
+ *
+ * await adapter.initialize()
+ * const tools = await adapter.getTools()
+ * ```
+ */
+export declare function createAnthropicAdapter(config: AnthropicAdapterConfig): AnthropicAdapter;
+//# sourceMappingURL=anthropic-adapter.d.ts.map

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

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