@riktajs/mcp 0.1.0

package/dist/plugin/mcp.plugin.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @riktajs/mcp - MCP Plugin
+ *
+ * Main plugin that integrates @platformatic/mcp with Rikta Framework.
+ * Provides registerMCPServer function for easy MCP setup.
+ */
+import type { FastifyInstance } from 'fastify';
+import type { MCPServerOptions, RiktaApplication } from '../types.js';
+import '@platformatic/mcp';
+type Constructor<T = unknown> = new (...args: unknown[]) => T;
+interface Container {
+    resolve<T>(target: Constructor<T>): T;
+}
+/**
+ * MCP plugin implementation for Fastify
+ *
+ * Registers @platformatic/mcp and auto-discovers MCP handlers from Rikta services.
+ */
+declare function mcpPluginImpl(fastify: FastifyInstance, options: MCPServerOptions & {
+    container?: Container;
+}): Promise<void>;
+/**
+ * Wrapped Fastify plugin with proper encapsulation
+ */
+export declare const mcpServerPlugin: typeof mcpPluginImpl;
+/**
+ * Register MCP server with a Rikta application
+ *
+ * This is the main entry point for integrating MCP with Rikta.
+ * It decorates the Fastify instance with @platformatic/mcp and
+ * auto-discovers MCP handlers from @Injectable classes.
+ *
+ * @param app - Rikta application instance
+ * @param options - MCP server options
+ *
+ * @example
+ * ```typescript
+ * import { Rikta } from '@riktajs/core';
+ * import { registerMCPServer } from '@riktajs/mcp';
+ *
+ * const app = await Rikta.create({ port: 3000 });
+ *
+ * await registerMCPServer(app, {
+ *   serverInfo: { name: 'my-mcp-server', version: '1.0.0' },
+ *   instructions: 'This server provides file system tools',
+ *   enableSSE: true,
+ * });
+ *
+ * await app.listen();
+ * // MCP available at http://localhost:3000/mcp
+ * ```
+ */
+export declare function registerMCPServer(app: RiktaApplication, options?: MCPServerOptions): Promise<void>;
+/**
+ * Create MCP configuration object
+ *
+ * Helper function to create type-safe MCP configuration.
+ *
+ * @param options - MCP server options
+ * @returns Validated MCP configuration
+ *
+ * @example
+ * ```typescript
+ * const mcpConfig = createMCPConfig({
+ *   serverInfo: { name: 'my-server', version: '1.0.0' },
+ *   redis: { host: 'localhost', port: 6379 },
+ * });
+ * ```
+ */
+export declare function createMCPConfig(options: MCPServerOptions): MCPServerOptions;
+export {};
+//# sourceMappingURL=mcp.plugin.d.ts.map

package/dist/plugin/mcp.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.plugin.d.ts","sourceRoot":"","sources":["../../src/plugin/mcp.plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAS/C,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAEjB,MAAM,aAAa,CAAC;AAGrB,OAAO,mBAAmB,CAAC;AAG3B,KAAK,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAG9D,UAAU,SAAS;IACjB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;CACvC;AAaD;;;;GAIG;AACH,iBAAe,aAAa,CAC1B,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,gBAAgB,GAAG;IAAE,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GACpD,OAAO,CAAC,IAAI,CAAC,CAkIf;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,sBAG1B,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,gBAAgB,EACrB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAK3E"}

package/dist/plugin/mcp.plugin.js

@@ -0,0 +1,198 @@
+import fp from 'fastify-plugin';
+import mcpPlugin from '@platformatic/mcp';
+import { registry } from '@riktajs/core';
+import { mcpRegistry } from '../discovery/mcp-registry.js';
+import { toMCPSchema } from '../utils/zod-to-schema.js';
+import { DEFAULT_MCP_PATH, DEFAULT_SERVER_INFO, MCP_HANDLERS_METADATA } from '../constants.js';
+// Re-export types from @platformatic/mcp for module augmentation
+import '@platformatic/mcp';
+/**
+ * Default options for MCP server
+ */
+const DEFAULT_OPTIONS = {
+    enableSSE: true,
+    path: DEFAULT_MCP_PATH,
+    heartbeat: true,
+    heartbeatInterval: 30000,
+    sessionTTL: 3600,
+};
+/**
+ * MCP plugin implementation for Fastify
+ *
+ * Registers @platformatic/mcp and auto-discovers MCP handlers from Rikta services.
+ */
+async function mcpPluginImpl(fastify, options) {
+    const mergedOptions = { ...DEFAULT_OPTIONS, ...options };
+    const { serverInfo, capabilities, instructions, enableSSE, redis, container } = mergedOptions;
+    // Build capabilities based on registered handlers
+    const effectiveCapabilities = capabilities || {};
+    // We'll populate capabilities after scanning
+    // Build MCP plugin options
+    const mcpOptions = {
+        serverInfo: serverInfo || DEFAULT_SERVER_INFO,
+        capabilities: effectiveCapabilities,
+        enableSSE,
+    };
+    // Add instructions if provided
+    if (instructions) {
+        mcpOptions.instructions = instructions;
+    }
+    // Add Redis config if provided
+    if (redis) {
+        mcpOptions.redis = {
+            host: redis.host,
+            port: redis.port || 6379,
+            password: redis.password,
+            db: redis.db || 0,
+        };
+    }
+    // Register @platformatic/mcp plugin
+    await fastify.register(mcpPlugin, mcpOptions);
+    // Scan all providers from Rikta registry for MCP handlers
+    if (container) {
+        const providers = registry.getProviders();
+        for (const providerClass of providers) {
+            // Check if this provider has MCP handlers
+            const handlers = Reflect.getMetadata(MCP_HANDLERS_METADATA, providerClass);
+            if (handlers && handlers.length > 0) {
+                // Resolve the provider instance from the container
+                const instance = container.resolve(providerClass);
+                mcpRegistry.scanClass(providerClass, instance);
+            }
+        }
+    }
+    // Register all discovered tools
+    const tools = mcpRegistry.getTools();
+    for (const tool of tools) {
+        // Convert Zod schema to JSON Schema for MCP
+        const inputSchema = toMCPSchema(tool.inputSchema);
+        const handler = async (params, context) => {
+            const result = await tool.handler(params, context);
+            return result;
+        };
+        fastify.mcpAddTool({
+            name: tool.name,
+            description: tool.description,
+            inputSchema,
+        }, handler);
+    }
+    // Register all discovered resources
+    const resources = mcpRegistry.getResources();
+    for (const resource of resources) {
+        // Convert Zod schema to JSON Schema for MCP (uriSchema is not needed for resources)
+        const handler = async (uri, context) => {
+            const result = await resource.handler(uri, context);
+            return result;
+        };
+        fastify.mcpAddResource({
+            uriPattern: resource.uriPattern,
+            name: resource.name,
+            description: resource.description,
+            mimeType: resource.mimeType,
+        }, handler);
+    }
+    // Register all discovered prompts
+    const prompts = mcpRegistry.getPrompts();
+    for (const prompt of prompts) {
+        const handler = async (name, args, context) => {
+            const result = await prompt.handler(args, context);
+            return result;
+        };
+        fastify.mcpAddPrompt({
+            name: prompt.name,
+            description: prompt.description,
+        }, handler);
+    }
+    // Update capabilities based on what was registered
+    if (tools.length > 0) {
+        effectiveCapabilities.tools = {};
+    }
+    if (resources.length > 0) {
+        effectiveCapabilities.resources = {};
+    }
+    if (prompts.length > 0) {
+        effectiveCapabilities.prompts = {};
+    }
+    // Log registration summary
+    const stats = mcpRegistry.getStats();
+    if (stats.tools > 0 || stats.resources > 0 || stats.prompts > 0) {
+        console.log(`\n🤖 MCP Server registered:`);
+        console.log(`   📍 Endpoint: ${mergedOptions.path}`);
+        if (stats.tools > 0)
+            console.log(`   🔧 Tools: ${stats.tools}`);
+        if (stats.resources > 0)
+            console.log(`   📁 Resources: ${stats.resources}`);
+        if (stats.prompts > 0)
+            console.log(`   💬 Prompts: ${stats.prompts}`);
+        if (redis)
+            console.log(`   📡 Redis: ${redis.host}:${redis.port || 6379}`);
+        console.log('');
+    }
+}
+/**
+ * Wrapped Fastify plugin with proper encapsulation
+ */
+export const mcpServerPlugin = fp(mcpPluginImpl, {
+    name: '@riktajs/mcp',
+    fastify: '5.x',
+});
+/**
+ * Register MCP server with a Rikta application
+ *
+ * This is the main entry point for integrating MCP with Rikta.
+ * It decorates the Fastify instance with @platformatic/mcp and
+ * auto-discovers MCP handlers from @Injectable classes.
+ *
+ * @param app - Rikta application instance
+ * @param options - MCP server options
+ *
+ * @example
+ * ```typescript
+ * import { Rikta } from '@riktajs/core';
+ * import { registerMCPServer } from '@riktajs/mcp';
+ *
+ * const app = await Rikta.create({ port: 3000 });
+ *
+ * await registerMCPServer(app, {
+ *   serverInfo: { name: 'my-mcp-server', version: '1.0.0' },
+ *   instructions: 'This server provides file system tools',
+ *   enableSSE: true,
+ * });
+ *
+ * await app.listen();
+ * // MCP available at http://localhost:3000/mcp
+ * ```
+ */
+export async function registerMCPServer(app, options = {}) {
+    // Get the container from the app using getContainer method
+    const container = 'getContainer' in app
+        ? app.getContainer()
+        : undefined;
+    await app.server.register(mcpServerPlugin, {
+        ...options,
+        container,
+    });
+}
+/**
+ * Create MCP configuration object
+ *
+ * Helper function to create type-safe MCP configuration.
+ *
+ * @param options - MCP server options
+ * @returns Validated MCP configuration
+ *
+ * @example
+ * ```typescript
+ * const mcpConfig = createMCPConfig({
+ *   serverInfo: { name: 'my-server', version: '1.0.0' },
+ *   redis: { host: 'localhost', port: 6379 },
+ * });
+ * ```
+ */
+export function createMCPConfig(options) {
+    return {
+        ...DEFAULT_OPTIONS,
+        ...options,
+    };
+}
+//# sourceMappingURL=mcp.plugin.js.map

package/dist/plugin/mcp.plugin.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,337 @@
+/**
+ * @riktajs/mcp - Type Definitions
+ *
+ * TypeScript interfaces and types for MCP integration.
+ */
+import type { ZodType, ZodTypeDef } from 'zod';
+/**
+ * Generic Zod schema type
+ */
+export type ZodSchema = ZodType<unknown, ZodTypeDef, unknown>;
+/**
+ * Options for @MCPTool decorator
+ */
+export interface MCPToolOptions {
+    /**
+     * Unique name for the tool
+     */
+    name: string;
+    /**
+     * Human-readable description of what the tool does
+     */
+    description: string;
+    /**
+     * Zod schema for input validation (optional)
+     * If not provided, the tool accepts no arguments
+     */
+    inputSchema?: ZodSchema;
+}
+/**
+ * MCP Tool handler function signature
+ */
+export type MCPToolHandler<TParams = unknown> = (params: TParams, context?: MCPHandlerContext) => Promise<MCPToolResult> | MCPToolResult;
+/**
+ * Result returned from an MCP tool
+ */
+export interface MCPToolResult {
+    content: MCPContent[];
+    isError?: boolean;
+}
+/**
+ * Options for @MCPResource decorator
+ */
+export interface MCPResourceOptions {
+    /**
+     * URI pattern for the resource (e.g., 'file://read', 'db://users')
+     */
+    uriPattern: string;
+    /**
+     * Human-readable name for the resource
+     */
+    name: string;
+    /**
+     * Description of the resource
+     */
+    description: string;
+    /**
+     * MIME type of the resource content
+     * @default 'text/plain'
+     */
+    mimeType?: string;
+    /**
+     * Zod schema for URI validation (optional)
+     */
+    uriSchema?: ZodSchema;
+}
+/**
+ * MCP Resource handler function signature
+ */
+export type MCPResourceHandler = (uri: string, context?: MCPHandlerContext) => Promise<MCPResourceResult> | MCPResourceResult;
+/**
+ * Result returned from an MCP resource
+ */
+export interface MCPResourceResult {
+    contents: MCPResourceContent[];
+}
+/**
+ * Content item in a resource result
+ */
+export interface MCPResourceContent {
+    uri: string;
+    text?: string;
+    blob?: string;
+    mimeType: string;
+}
+/**
+ * Options for @MCPPrompt decorator
+ */
+export interface MCPPromptOptions {
+    /**
+     * Unique name for the prompt
+     */
+    name: string;
+    /**
+     * Human-readable description of the prompt
+     */
+    description: string;
+    /**
+     * Arguments the prompt accepts
+     */
+    arguments?: MCPPromptArgument[];
+}
+/**
+ * Prompt argument definition
+ */
+export interface MCPPromptArgument {
+    /**
+     * Argument name
+     */
+    name: string;
+    /**
+     * Argument description
+     */
+    description?: string;
+    /**
+     * Whether the argument is required
+     * @default false
+     */
+    required?: boolean;
+}
+/**
+ * MCP Prompt handler function signature
+ */
+export type MCPPromptHandler<TArgs = Record<string, string>> = (args: TArgs, context?: MCPHandlerContext) => Promise<MCPPromptResult> | MCPPromptResult;
+/**
+ * Result returned from an MCP prompt
+ */
+export interface MCPPromptResult {
+    messages: MCPPromptMessage[];
+    description?: string;
+}
+/**
+ * Message in a prompt result
+ */
+export interface MCPPromptMessage {
+    role: 'user' | 'assistant';
+    content: MCPContent;
+}
+/**
+ * Content types supported by MCP
+ */
+export type MCPContent = MCPTextContent | MCPImageContent | MCPAudioContent | MCPEmbeddedResource;
+/**
+ * Text content
+ */
+export interface MCPTextContent {
+    type: 'text';
+    text: string;
+}
+/**
+ * Image content
+ */
+export interface MCPImageContent {
+    type: 'image';
+    data: string;
+    mimeType: string;
+}
+/**
+ * Audio content
+ */
+export interface MCPAudioContent {
+    type: 'audio';
+    data: string;
+    mimeType: string;
+}
+/**
+ * Embedded resource content
+ */
+export interface MCPEmbeddedResource {
+    type: 'resource';
+    resource: {
+        uri: string;
+        text?: string;
+        blob?: string;
+        mimeType?: string;
+    };
+}
+/**
+ * Context passed to MCP handlers
+ */
+export interface MCPHandlerContext {
+    /**
+     * Session ID for SSE connections
+     */
+    sessionId?: string;
+    /**
+     * Send a notification to the current session
+     */
+    sendNotification?: (method: string, params: unknown) => void;
+}
+/**
+ * Redis configuration for horizontal scaling
+ */
+export interface MCPRedisConfig {
+    /**
+     * Redis host
+     */
+    host: string;
+    /**
+     * Redis port
+     * @default 6379
+     */
+    port?: number;
+    /**
+     * Redis password (optional)
+     */
+    password?: string;
+    /**
+     * Redis database number
+     * @default 0
+     */
+    db?: number;
+}
+/**
+ * Server info for MCP protocol
+ */
+export interface MCPServerInfo {
+    /**
+     * Server name
+     */
+    name: string;
+    /**
+     * Server version
+     */
+    version: string;
+}
+/**
+ * MCP server capabilities
+ */
+export interface MCPCapabilities {
+    /**
+     * Enable tools capability
+     */
+    tools?: Record<string, unknown>;
+    /**
+     * Enable resources capability
+     */
+    resources?: Record<string, unknown>;
+    /**
+     * Enable prompts capability
+     */
+    prompts?: Record<string, unknown>;
+    /**
+     * Enable logging capability
+     */
+    logging?: Record<string, unknown>;
+}
+/**
+ * Options for registerMCPServer function
+ */
+export interface MCPServerOptions {
+    /**
+     * Server info for MCP protocol
+     */
+    serverInfo?: MCPServerInfo;
+    /**
+     * Server capabilities
+     */
+    capabilities?: MCPCapabilities;
+    /**
+     * Instructions for AI assistants
+     */
+    instructions?: string;
+    /**
+     * Enable SSE (Server-Sent Events) transport
+     * @default true
+     */
+    enableSSE?: boolean;
+    /**
+     * Redis configuration for horizontal scaling
+     * When provided, enables cross-instance session management
+     */
+    redis?: MCPRedisConfig;
+    /**
+     * Custom MCP endpoint path
+     * @default '/mcp'
+     */
+    path?: string;
+    /**
+     * Session TTL in seconds
+     * @default 3600
+     */
+    sessionTTL?: number;
+    /**
+     * Enable heartbeat for SSE connections
+     * @default true
+     */
+    heartbeat?: boolean;
+    /**
+     * Heartbeat interval in milliseconds
+     * @default 30000
+     */
+    heartbeatInterval?: number;
+}
+/**
+ * Registered MCP tool metadata
+ */
+export interface RegisteredMCPTool {
+    name: string;
+    description: string;
+    inputSchema?: ZodSchema;
+    handler: MCPToolHandler;
+    targetClass: Function;
+    methodName: string | symbol;
+}
+/**
+ * Registered MCP resource metadata
+ */
+export interface RegisteredMCPResource {
+    uriPattern: string;
+    name: string;
+    description: string;
+    mimeType: string;
+    uriSchema?: ZodSchema;
+    handler: MCPResourceHandler;
+    targetClass: Function;
+    methodName: string | symbol;
+}
+/**
+ * Registered MCP prompt metadata
+ */
+export interface RegisteredMCPPrompt {
+    name: string;
+    description: string;
+    arguments?: MCPPromptArgument[];
+    handler: MCPPromptHandler;
+    targetClass: Function;
+    methodName: string | symbol;
+}
+/**
+ * Rikta Application type (minimal interface for type safety)
+ * Uses a generic server type to avoid strict FastifyInstance compatibility issues
+ * between different packages that may extend FastifyInstance differently.
+ */
+export interface RiktaApplication {
+    server: any;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAO/C;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAM9D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,WAAW,CAAC,EAAE,SAAS,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,OAAO,GAAG,OAAO,IAAI,CAC9C,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,iBAAiB,KACxB,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAMD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,iBAAiB,KACxB,OAAO,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAC7D,IAAI,EAAE,KAAK,EACX,OAAO,CAAC,EAAE,iBAAiB,KACxB,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,UAAU,CAAC;CACrB;AAMD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,eAAe,GAAG,eAAe,GAAG,mBAAmB,CAAC;AAElG;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CAC9D;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEhC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEpC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;IAE3B;;OAEG;IACH,YAAY,CAAC,EAAE,eAAe,CAAC;IAE/B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,KAAK,CAAC,EAAE,cAAc,CAAC;IAEvB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,EAAE,QAAQ,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,WAAW,EAAE,QAAQ,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAChC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,WAAW,EAAE,QAAQ,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAMD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAE/B,MAAM,EAAE,GAAG,CAAC;CACb"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * @riktajs/mcp - Type Definitions
+ *
+ * TypeScript interfaces and types for MCP integration.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @riktajs/mcp - Utilities
+ *
+ * Export utility functions.
+ */
+export { zodToMCPSchema, toMCPSchema, isZodSchema } from './zod-to-schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,7 @@
+/**
+ * @riktajs/mcp - Utilities
+ *
+ * Export utility functions.
+ */
+export { zodToMCPSchema, toMCPSchema, isZodSchema } from './zod-to-schema.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}