@mxf-dev/core 1.0.0

package/dist/protocols/mcp/LlmProviders.js

@@ -0,0 +1,45 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * Generic LLM Provider Types
+ *
+ * This enum provides a basic type-safe way to reference different kinds of LLM providers,
+ * but without any hardcoded implementation details to maintain provider-agnosticism.
+ */
+/**
+ * LLM provider type identifiers
+ */
+export var LlmProviderType;
+(function (LlmProviderType) {
+    // Actual provider identifiers used by client implementations
+    LlmProviderType["OPENAI"] = "openai";
+    LlmProviderType["ANTHROPIC"] = "anthropic";
+    LlmProviderType["OPENROUTER"] = "openrouter";
+    LlmProviderType["AZURE_OPENAI"] = "azure-openai";
+    LlmProviderType["XAI"] = "xai";
+    LlmProviderType["GEMINI"] = "gemini";
+    LlmProviderType["OLLAMA"] = "ollama";
+    // Generic provider types that can be used for future implementations
+    LlmProviderType["PROVIDER_TYPE_1"] = "provider_type_1";
+    LlmProviderType["PROVIDER_TYPE_2"] = "provider_type_2";
+    LlmProviderType["PROVIDER_TYPE_3"] = "provider_type_3";
+    LlmProviderType["CUSTOM"] = "custom";
+})(LlmProviderType || (LlmProviderType = {}));
+//# sourceMappingURL=LlmProviders.js.map

package/dist/protocols/mcp/LlmProviders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LlmProviders.js","sourceRoot":"","sources":["../../../src/protocols/mcp/LlmProviders.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,eAcX;AAdD,WAAY,eAAe;IACvB,6DAA6D;IAC7D,oCAAiB,CAAA;IACjB,0CAAuB,CAAA;IACvB,4CAAyB,CAAA;IACzB,gDAA6B,CAAA;IAC7B,8BAAW,CAAA;IACX,oCAAiB,CAAA;IACjB,oCAAiB,CAAA;IACjB,qEAAqE;IACrE,sDAAmC,CAAA;IACnC,sDAAmC,CAAA;IACnC,sDAAmC,CAAA;IACnC,oCAAiB,CAAA;AACrB,CAAC,EAdW,eAAe,KAAf,eAAe,QAc1B"}

package/dist/protocols/mcp/McpClient.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * Generic MCP Client
+ *
+ * This module provides a provider-agnostic client for the Model Context Protocol (MCP).
+ * It delegates to specific provider implementations while presenting a unified interface.
+ */
+import { Observable } from 'rxjs';
+import { IMcpClient, McpClientConfig, McpMessage, McpTool, McpApiResponse, McpTextContent, McpImageContent, McpToolUseContent, McpToolResultContent, McpToolInput, McpResourceOptions, McpResourceContent } from './IMcpClient.js';
+/**
+ * Configuration for the MCP client
+ */
+export interface McpConfig extends McpClientConfig {
+    /**
+     * Implementation class to use for the client
+     * This replaces the provider-specific implementation that was previously used
+     */
+    implementation: new () => IMcpClient;
+}
+/**
+ * Provider-agnostic MCP client
+ */
+export declare class McpClient implements IMcpClient {
+    private client?;
+    private config?;
+    private initialized;
+    /**
+     * Initialize client with configuration
+     * @param config Client configuration
+     */
+    initialize(config: McpClientConfig): Observable<boolean>;
+    /**
+     * Check if the provided configuration is valid for this client
+     * @param config Configuration to validate
+     * @returns True if the configuration is valid
+     */
+    private isValidConfig;
+    /**
+     * Send a message to the LLM
+     * @param messages Messages to send
+     * @param tools Optional tools to make available
+     * @param options Additional options
+     */
+    sendMessage(messages: McpMessage[], tools?: McpTool[], options?: Record<string, any>): Observable<McpApiResponse>;
+    /**
+     * Register a tool with the MCP
+     * @param tool Tool to register
+     */
+    registerTool(tool: McpTool): Observable<boolean>;
+    /**
+     * Get tools registered with this client
+     */
+    getRegisteredTools(): Observable<McpTool[]>;
+    /**
+     * Create a text content object
+     * @param text Text content
+     */
+    createTextContent(text: string): McpTextContent;
+    /**
+     * Create an image content object
+     * @param source Image source
+     */
+    createImageContent(source: McpImageContent['source']): McpImageContent;
+    /**
+     * Create a tool use content object
+     * @param id Tool use ID
+     * @param name Tool name
+     * @param input Tool input
+     */
+    createToolUseContent(id: string, name: string, input: McpToolInput): McpToolUseContent;
+    /**
+     * Create a tool result content object
+     * @param toolCallId The ID of the tool call this is a result for
+     * @param content Result content
+     */
+    createToolResultContent(toolCallId: string, content: McpTextContent | McpImageContent | Array<McpTextContent | McpImageContent>): McpToolResultContent;
+    /**
+     * List available resources
+     * @param options Options for listing resources
+     */
+    listResources(options?: McpResourceOptions): Observable<McpResourceContent[]>;
+    /**
+     * Get a resource by URI
+     * @param uri Resource URI
+     */
+    getResource(uri: string): Observable<McpResourceContent>;
+}
+//# sourceMappingURL=McpClient.d.ts.map

package/dist/protocols/mcp/McpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpClient.d.ts","sourceRoot":"","sources":["../../../src/protocols/mcp/McpClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAwB,MAAM,MAAM,CAAC;AAExD,OAAO,EACH,UAAU,EACV,eAAe,EACf,UAAU,EACV,OAAO,EACP,cAAc,EACd,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EAEZ,kBAAkB,EAClB,kBAAkB,EACrB,MAAM,iBAAiB,CAAC;AAGzB;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,eAAe;IAC9C;;;OAGG;IACH,cAAc,EAAE,UAAU,UAAU,CAAC;CACxC;AAED;;GAEG;AACH,qBAAa,SAAU,YAAW,UAAU;IACxC,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B,OAAO,CAAC,WAAW,CAAS;IAE5B;;;OAGG;IACI,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,UAAU,CAAC,OAAO,CAAC;IAsB/D;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAKrB;;;;;OAKG;IACI,WAAW,CACd,QAAQ,EAAE,UAAU,EAAE,EACtB,KAAK,CAAC,EAAE,OAAO,EAAE,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC9B,UAAU,CAAC,cAAc,CAAC;IAQ7B;;;OAGG;IACI,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;IAQvD;;OAEG;IACI,kBAAkB,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;IAQlD;;;OAGG;IACI,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc;IAQtD;;;OAGG;IACI,kBAAkB,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,eAAe;IAQ7E;;;;;OAKG;IACI,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,iBAAiB;IAQ7F;;;;OAIG;IACI,uBAAuB,CAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,GAAG,eAAe,GAAG,KAAK,CAAC,cAAc,GAAG,eAAe,CAAC,GACpF,oBAAoB;IAQvB;;;OAGG;IACI,aAAa,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,UAAU,CAAC,kBAAkB,EAAE,CAAC;IAQpF;;;OAGG;IACI,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC,kBAAkB,CAAC;CAOlE"}

package/dist/protocols/mcp/McpClient.js

@@ -0,0 +1,159 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * Generic MCP Client
+ *
+ * This module provides a provider-agnostic client for the Model Context Protocol (MCP).
+ * It delegates to specific provider implementations while presenting a unified interface.
+ */
+import { throwError } from 'rxjs';
+import { mergeMap, catchError, tap } from 'rxjs/operators';
+import { McpClientFactory } from './McpClientFactory.js';
+/**
+ * Provider-agnostic MCP client
+ */
+export class McpClient {
+    client;
+    config;
+    initialized = false;
+    /**
+     * Initialize client with configuration
+     * @param config Client configuration
+     */
+    initialize(config) {
+        if (!this.isValidConfig(config)) {
+            return throwError(() => new Error('Invalid MCP configuration'));
+        }
+        const mcpConfig = config;
+        this.config = mcpConfig;
+        return McpClientFactory.createClient(mcpConfig.implementation, config).pipe(mergeMap(client => {
+            this.client = client;
+            return this.client.initialize(config);
+        }), tap(success => {
+            this.initialized = success;
+        }), catchError(error => {
+            return throwError(() => new Error(`Failed to initialize MCP client: ${error}`));
+        }));
+    }
+    /**
+     * Check if the provided configuration is valid for this client
+     * @param config Configuration to validate
+     * @returns True if the configuration is valid
+     */
+    isValidConfig(config) {
+        const mcpConfig = config;
+        return !!mcpConfig.implementation;
+    }
+    /**
+     * Send a message to the LLM
+     * @param messages Messages to send
+     * @param tools Optional tools to make available
+     * @param options Additional options
+     */
+    sendMessage(messages, tools, options) {
+        if (!this.initialized || !this.client) {
+            return throwError(() => new Error('MCP client not initialized'));
+        }
+        return this.client.sendMessage(messages, tools, options);
+    }
+    /**
+     * Register a tool with the MCP
+     * @param tool Tool to register
+     */
+    registerTool(tool) {
+        if (!this.initialized || !this.client) {
+            return throwError(() => new Error('MCP client not initialized'));
+        }
+        return this.client.registerTool(tool);
+    }
+    /**
+     * Get tools registered with this client
+     */
+    getRegisteredTools() {
+        if (!this.initialized || !this.client) {
+            return throwError(() => new Error('MCP client not initialized'));
+        }
+        return this.client.getRegisteredTools();
+    }
+    /**
+     * Create a text content object
+     * @param text Text content
+     */
+    createTextContent(text) {
+        if (!this.client) {
+            throw new Error('MCP client not initialized');
+        }
+        return this.client.createTextContent(text);
+    }
+    /**
+     * Create an image content object
+     * @param source Image source
+     */
+    createImageContent(source) {
+        if (!this.client) {
+            throw new Error('MCP client not initialized');
+        }
+        return this.client.createImageContent(source);
+    }
+    /**
+     * Create a tool use content object
+     * @param id Tool use ID
+     * @param name Tool name
+     * @param input Tool input
+     */
+    createToolUseContent(id, name, input) {
+        if (!this.client) {
+            throw new Error('MCP client not initialized');
+        }
+        return this.client.createToolUseContent(id, name, input);
+    }
+    /**
+     * Create a tool result content object
+     * @param toolCallId The ID of the tool call this is a result for
+     * @param content Result content
+     */
+    createToolResultContent(toolCallId, content) {
+        if (!this.client) {
+            throw new Error('MCP client not initialized');
+        }
+        return this.client.createToolResultContent(toolCallId, content);
+    }
+    /**
+     * List available resources
+     * @param options Options for listing resources
+     */
+    listResources(options) {
+        if (!this.initialized || !this.client) {
+            return throwError(() => new Error('MCP client not initialized'));
+        }
+        return this.client.listResources(options);
+    }
+    /**
+     * Get a resource by URI
+     * @param uri Resource URI
+     */
+    getResource(uri) {
+        if (!this.initialized || !this.client) {
+            return throwError(() => new Error('MCP client not initialized'));
+        }
+        return this.client.getResource(uri);
+    }
+}
+//# sourceMappingURL=McpClient.js.map

package/dist/protocols/mcp/McpClient.js.map

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

package/dist/protocols/mcp/McpClientFactory.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * MCP Client Factory
+ *
+ * This module provides a factory for creating MCP clients.
+ * It's designed to be completely provider-agnostic.
+ */
+import { Observable } from 'rxjs';
+import { IMcpClient, McpClientConfig } from './IMcpClient.js';
+/**
+ * Factory for creating MCP clients
+ */
+export declare class McpClientFactory {
+    /**
+     * Create an MCP client using the provided implementation
+     *
+     * @param clientImplementation - The concrete client implementation class
+     * @param config - Configuration for the client
+     * @returns An observable that emits the client after initialization
+     */
+    static createClient<T extends IMcpClient>(clientImplementation: new () => T, config: McpClientConfig): Observable<IMcpClient>;
+}
+//# sourceMappingURL=McpClientFactory.d.ts.map

package/dist/protocols/mcp/McpClientFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpClientFactory.d.ts","sourceRoot":"","sources":["../../../src/protocols/mcp/McpClientFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAkB,MAAM,MAAM,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE9D;;GAEG;AACH,qBAAa,gBAAgB;IACzB;;;;;;OAMG;WACW,YAAY,CAAC,CAAC,SAAS,UAAU,EAC3C,oBAAoB,EAAE,UAAU,CAAC,EACjC,MAAM,EAAE,eAAe,GACxB,UAAU,CAAC,UAAU,CAAC;CAa5B"}

package/dist/protocols/mcp/McpClientFactory.js

@@ -0,0 +1,51 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * MCP Client Factory
+ *
+ * This module provides a factory for creating MCP clients.
+ * It's designed to be completely provider-agnostic.
+ */
+import { throwError } from 'rxjs';
+import { map } from 'rxjs/operators';
+/**
+ * Factory for creating MCP clients
+ */
+export class McpClientFactory {
+    /**
+     * Create an MCP client using the provided implementation
+     *
+     * @param clientImplementation - The concrete client implementation class
+     * @param config - Configuration for the client
+     * @returns An observable that emits the client after initialization
+     */
+    static createClient(clientImplementation, config) {
+        try {
+            // Create the client using the provided implementation
+            const client = new clientImplementation();
+            // Initialize the client and return it
+            return client.initialize(config).pipe(map(() => client));
+        }
+        catch (error) {
+            return throwError(() => new Error(`Failed to create MCP client: ${error instanceof Error ? error.message : String(error)}`));
+        }
+    }
+}
+//# sourceMappingURL=McpClientFactory.js.map

package/dist/protocols/mcp/McpClientFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpClientFactory.js","sourceRoot":"","sources":["../../../src/protocols/mcp/McpClientFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;GAKG;AAEH,OAAO,EAAkB,UAAU,EAAE,MAAM,MAAM,CAAC;AAClD,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAGrC;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACzB;;;;;;OAMG;IACI,MAAM,CAAC,YAAY,CACtB,oBAAiC,EACjC,MAAuB;QAEvB,IAAI,CAAC;YACD,sDAAsD;YACtD,MAAM,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;YAE1C,sCAAsC;YACtC,OAAO,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,IAAI,CACjC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CACpB,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,KAAK,CAAC,gCAAgC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QACjI,CAAC;IACL,CAAC;CACJ"}

package/dist/protocols/mcp/McpServerTypes.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * MCP Server Types
+ *
+ * This module defines the types and interfaces for the MCP server implementation.
+ * It follows the standard MCP specification while providing integration with the MXF.
+ */
+import { Observable } from 'rxjs';
+import { McpToolInput } from './IMcpClient.js';
+import { McpToolExample } from './McpToolSchema.js';
+/**
+ * MCP Server Configuration
+ */
+export interface McpServerConfig {
+    /** Server name */
+    name: string;
+    /** Server version */
+    version: string;
+    /** Optional description */
+    description?: string;
+    /** Optional base URL */
+    baseUrl?: string;
+}
+/**
+ * MCP Tool Handler Context
+ */
+export interface McpToolHandlerContext {
+    /** Request ID */
+    requestId: string;
+    /** Agent ID that initiated the request */
+    agentId?: string;
+    /** Channel ID where the request originated */
+    channelId?: string;
+    /** Additional context data */
+    data?: Record<string, any>;
+}
+/**
+ * MCP Tool Handler Result
+ */
+export interface McpToolHandlerResult {
+    /** Result content */
+    content: McpToolResultContent;
+    /** Optional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * MCP Tool Result Content
+ */
+export interface McpToolResultContent {
+    /** Content type, can be text, structured data, or binary */
+    type: string;
+    /** Content payload */
+    data: any;
+    /** MIME type for binary content */
+    mimeType?: string;
+}
+/**
+ * MCP Tool Definition
+ */
+export interface McpToolDefinition {
+    /** Tool name */
+    name: string;
+    /** Tool description */
+    description: string;
+    /** JSON schema for tool input */
+    inputSchema: Record<string, any>;
+    /** Handler function for tool execution */
+    handler: (input: McpToolInput, context: McpToolHandlerContext) => Promise<McpToolHandlerResult> | Observable<McpToolHandlerResult>;
+    /** Is the tool currently enabled */
+    enabled: boolean;
+    /** Optional tool metadata */
+    metadata?: Record<string, any>;
+    /** Optional validation function for tool input */
+    validateInput?: (input: McpToolInput) => boolean | Promise<boolean>;
+    /** Optional examples showing how to use the tool */
+    examples?: McpToolExample[];
+    /** Where this tool can execute. 'server' (default), 'client', or 'either' (both sides). */
+    executionSide?: 'server' | 'client' | 'either';
+}
+/**
+ * MCP Resource Definition
+ */
+export interface McpResourceDefinition {
+    /** Resource name */
+    name: string;
+    /** Resource description */
+    description: string;
+    /** Resource URI template */
+    uriTemplate: string;
+    /** Handler function for resource retrieval */
+    handler: (uri: URL, params: Record<string, string>) => Promise<McpResourceResult> | Observable<McpResourceResult>;
+    /** Is the resource currently enabled */
+    enabled: boolean;
+    /** Optional resource metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * MCP Resource Result
+ */
+export interface McpResourceResult {
+    /** Array of content items */
+    contents: McpResourceContent[];
+    /** Optional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * MCP Resource Content
+ */
+export interface McpResourceContent {
+    /** Resource URI */
+    uri: string;
+    /** Resource text content */
+    text: string;
+    /** Optional MIME type */
+    mimeType?: string;
+    /** Optional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * MCP Authorization Request
+ */
+export interface McpAuthorizationRequest {
+    /** Request ID */
+    requestId: string;
+    /** Request type (tool or resource) */
+    type: 'tool' | 'resource';
+    /** Tool or resource name */
+    name: string;
+    /** Operation being requested */
+    operation: 'execute' | 'read' | 'list';
+    /** Agent ID that initiated the request */
+    agentId?: string;
+    /** Channel ID where the request originated */
+    channelId?: string;
+    /** Additional request data */
+    data?: Record<string, any>;
+}
+/**
+ * MCP Authorization Result
+ */
+export interface McpAuthorizationResult {
+    /** Request ID */
+    requestId: string;
+    /** Is the request authorized */
+    authorized: boolean;
+    /** Optional reason for denial */
+    reason?: string;
+    /** Optional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * MCP Server Capabilities
+ */
+export interface McpServerCapabilities {
+    /** Does the server support tools */
+    tools: boolean;
+    /** Does the server support resources */
+    resources: boolean;
+    /** Does the server support authorization */
+    authorization: boolean;
+    /** Does the server support streaming responses */
+    streaming: boolean;
+    /** Additional capabilities */
+    [key: string]: boolean;
+}
+/**
+ * MCP Error Response
+ */
+export interface McpErrorResponse {
+    /** Error message */
+    message: string;
+    /** Error code */
+    code: string;
+    /** Additional error details */
+    details?: Record<string, any>;
+}
+//# sourceMappingURL=McpServerTypes.d.ts.map

package/dist/protocols/mcp/McpServerTypes.d.ts.map

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

package/dist/protocols/mcp/McpServerTypes.js

@@ -0,0 +1,21 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+export {};
+//# sourceMappingURL=McpServerTypes.js.map

package/dist/protocols/mcp/McpServerTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpServerTypes.js","sourceRoot":"","sources":["../../../src/protocols/mcp/McpServerTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}