@cogitator-ai/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Cogitator Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,81 @@
+# @cogitator-ai/mcp
+
+MCP (Model Context Protocol) integration for Cogitator. Connect to external MCP servers or expose Cogitator tools as an MCP server.
+
+## Installation
+
+```bash
+pnpm add @cogitator-ai/mcp
+```
+
+## Usage
+
+### MCP Client
+
+Connect to external MCP servers:
+
+```typescript
+import { MCPClient } from '@cogitator-ai/mcp';
+
+const client = new MCPClient({
+  transport: 'stdio',
+  command: 'npx',
+  args: ['-y', '@anthropic/mcp-server-filesystem'],
+});
+
+await client.connect();
+
+// List available tools
+const tools = await client.listTools();
+
+// Execute a tool
+const result = await client.executeTool('read_file', {
+  path: '/path/to/file.txt',
+});
+
+// Get tools as Cogitator tools
+const cogitatorTools = client.asCogitatorTools();
+```
+
+### MCP Server
+
+Expose Cogitator tools as an MCP server:
+
+```typescript
+import { MCPServer } from '@cogitator-ai/mcp';
+import { builtinTools } from '@cogitator-ai/core';
+
+const server = new MCPServer({
+  name: 'cogitator-tools',
+  version: '1.0.0',
+  tools: builtinTools,
+});
+
+// Start stdio server
+await server.start('stdio');
+
+// Or HTTP server
+await server.start('http', { port: 3001 });
+```
+
+### Tool Adapter
+
+Convert between Cogitator and MCP tool formats:
+
+```typescript
+import { toMCPTool, toCogitatorTool } from '@cogitator-ai/mcp';
+
+// Cogitator → MCP
+const mcpTool = toMCPTool(cogitatorTool);
+
+// MCP → Cogitator
+const cogitatorTool = toCogitatorTool(mcpTool);
+```
+
+## Documentation
+
+See the [Cogitator documentation](https://github.com/eL1fe/cogitator) for full API reference.
+
+## License
+
+MIT

package/dist/adapter/tool-adapter.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Tool Adapter
+ *
+ * Converts between Cogitator Tool format and MCP Tool format.
+ * Enables bidirectional interoperability.
+ */
+import { type ZodTypeAny, type ZodObject, type ZodRawShape } from 'zod';
+import type { Tool, ToolSchema } from '@cogitator-ai/types';
+import type { MCPToolDefinition, MCPToolContent, ToolAdapterOptions } from '../types';
+import type { MCPClient } from '../client/mcp-client';
+/**
+ * Convert a Zod schema to JSON Schema
+ */
+export declare function zodToJsonSchema(schema: ZodTypeAny): {
+    type: 'object';
+    properties: Record<string, unknown>;
+    required?: string[];
+};
+/**
+ * Convert JSON Schema to a Zod schema
+ *
+ * Note: This is a simplified conversion that handles common cases.
+ * Complex schemas may need manual adjustment.
+ */
+export declare function jsonSchemaToZod(schema: {
+    type: string;
+    properties?: Record<string, JsonSchemaProperty>;
+    required?: string[];
+}): ZodObject<ZodRawShape>;
+interface JsonSchemaProperty {
+    type?: string;
+    description?: string;
+    enum?: unknown[];
+    items?: JsonSchemaProperty;
+    properties?: Record<string, JsonSchemaProperty>;
+    required?: string[];
+    default?: unknown;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+    oneOf?: JsonSchemaProperty[];
+    anyOf?: JsonSchemaProperty[];
+    allOf?: JsonSchemaProperty[];
+}
+/**
+ * Convert a Cogitator Tool to MCP tool definition format
+ */
+export declare function cogitatorToMCP(tool: Tool): MCPToolDefinition;
+/**
+ * Convert a Cogitator ToolSchema to MCP tool definition format
+ */
+export declare function toolSchemaToMCP(schema: ToolSchema): MCPToolDefinition;
+/**
+ * Convert an MCP tool definition to a Cogitator Tool
+ *
+ * The resulting tool will execute calls through the provided MCPClient.
+ */
+export declare function mcpToCogitator(mcpTool: MCPToolDefinition, client: MCPClient, options?: ToolAdapterOptions): Tool;
+/**
+ * Wrap all tools from an MCP client as Cogitator tools
+ *
+ * @example
+ * ```typescript
+ * const client = await MCPClient.connect({ ... });
+ * const tools = await wrapMCPTools(client);
+ *
+ * const agent = new Agent({
+ *   tools: [...tools, ...otherTools],
+ * });
+ * ```
+ */
+export declare function wrapMCPTools(client: MCPClient, options?: ToolAdapterOptions): Promise<Tool[]>;
+/**
+ * Convert a tool execution result to MCP content format
+ */
+export declare function resultToMCPContent(result: unknown): MCPToolContent[];
+/**
+ * Convert MCP content to a simple result value
+ */
+export declare function mcpContentToResult(content: MCPToolContent[]): unknown;
+export {};
+//# sourceMappingURL=tool-adapter.d.ts.map

package/dist/adapter/tool-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-adapter.d.ts","sourceRoot":"","sources":["../../src/adapter/tool-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAK,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,KAAK,CAAC;AAE3E,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAe,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG;IACnD,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAcA;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,GAAG,SAAS,CAAC,WAAW,CAAC,CAuBzB;AAED,UAAU,kBAAkB;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AA4ED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,iBAAiB,CAY5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,iBAAiB,CAUrE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,IAAI,CAmCN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,EAAE,CAAC,CAGjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,EAAE,CAqBpE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAwBrE"}

package/dist/adapter/tool-adapter.js

@@ -0,0 +1,239 @@
+/**
+ * Tool Adapter
+ *
+ * Converts between Cogitator Tool format and MCP Tool format.
+ * Enables bidirectional interoperability.
+ */
+import { z } from 'zod';
+import { zodToJsonSchema as zodToJsonSchemaLib } from 'zod-to-json-schema';
+/**
+ * Convert a Zod schema to JSON Schema
+ */
+export function zodToJsonSchema(schema) {
+    const jsonSchema = zodToJsonSchemaLib(schema, {
+        $refStrategy: 'none',
+        target: 'openApi3',
+    });
+    const result = jsonSchema;
+    delete result.$schema;
+    return result;
+}
+/**
+ * Convert JSON Schema to a Zod schema
+ *
+ * Note: This is a simplified conversion that handles common cases.
+ * Complex schemas may need manual adjustment.
+ */
+export function jsonSchemaToZod(schema) {
+    if (schema.type !== 'object' || !schema.properties) {
+        return z.object({});
+    }
+    const shape = {};
+    const required = new Set(schema.required ?? []);
+    for (const [key, prop] of Object.entries(schema.properties)) {
+        let zodType = jsonSchemaPropertyToZod(prop);
+        if (prop.description) {
+            zodType = zodType.describe(prop.description);
+        }
+        if (!required.has(key)) {
+            zodType = zodType.optional();
+        }
+        shape[key] = zodType;
+    }
+    return z.object(shape);
+}
+function jsonSchemaPropertyToZod(prop) {
+    if (prop.enum && Array.isArray(prop.enum)) {
+        if (prop.enum.length >= 2 && prop.enum.every((v) => typeof v === 'string')) {
+            return z.enum(prop.enum);
+        }
+        if (prop.enum.length >= 2) {
+            const literals = prop.enum.map((v) => z.literal(v));
+            return z.union([literals[0], literals[1], ...literals.slice(2)]);
+        }
+        if (prop.enum.length === 1) {
+            return z.literal(prop.enum[0]);
+        }
+    }
+    switch (prop.type) {
+        case 'string': {
+            let schema = z.string();
+            if (prop.minLength !== undefined) {
+                schema = schema.min(prop.minLength);
+            }
+            if (prop.maxLength !== undefined) {
+                schema = schema.max(prop.maxLength);
+            }
+            if (prop.pattern) {
+                schema = schema.regex(new RegExp(prop.pattern));
+            }
+            if (prop.format === 'email') {
+                schema = schema.email();
+            }
+            if (prop.format === 'uri' || prop.format === 'url') {
+                schema = schema.url();
+            }
+            return schema;
+        }
+        case 'number':
+        case 'integer': {
+            let schema = prop.type === 'integer' ? z.number().int() : z.number();
+            if (prop.minimum !== undefined) {
+                schema = schema.min(prop.minimum);
+            }
+            if (prop.maximum !== undefined) {
+                schema = schema.max(prop.maximum);
+            }
+            return schema;
+        }
+        case 'boolean':
+            return z.boolean();
+        case 'array': {
+            const itemSchema = prop.items ? jsonSchemaPropertyToZod(prop.items) : z.unknown();
+            return z.array(itemSchema);
+        }
+        case 'object': {
+            if (prop.properties) {
+                return jsonSchemaToZod({
+                    type: 'object',
+                    properties: prop.properties,
+                    required: prop.required,
+                });
+            }
+            return z.record(z.unknown());
+        }
+        case 'null':
+            return z.null();
+        default:
+            return z.unknown();
+    }
+}
+/**
+ * Convert a Cogitator Tool to MCP tool definition format
+ */
+export function cogitatorToMCP(tool) {
+    const schema = tool.toJSON();
+    return {
+        name: schema.name,
+        description: schema.description,
+        inputSchema: {
+            type: 'object',
+            properties: schema.parameters.properties,
+            required: schema.parameters.required,
+        },
+    };
+}
+/**
+ * Convert a Cogitator ToolSchema to MCP tool definition format
+ */
+export function toolSchemaToMCP(schema) {
+    return {
+        name: schema.name,
+        description: schema.description,
+        inputSchema: {
+            type: 'object',
+            properties: schema.parameters.properties,
+            required: schema.parameters.required,
+        },
+    };
+}
+/**
+ * Convert an MCP tool definition to a Cogitator Tool
+ *
+ * The resulting tool will execute calls through the provided MCPClient.
+ */
+export function mcpToCogitator(mcpTool, client, options) {
+    const name = options?.namePrefix ? `${options.namePrefix}${mcpTool.name}` : mcpTool.name;
+    const description = options?.descriptionTransform
+        ? options.descriptionTransform(mcpTool.description)
+        : mcpTool.description;
+    const inputSchema = {
+        type: 'object',
+        properties: mcpTool.inputSchema.properties,
+        required: mcpTool.inputSchema.required,
+    };
+    const parameters = jsonSchemaToZod(inputSchema);
+    const tool = {
+        name,
+        description,
+        parameters,
+        execute: async (params, _context) => {
+            return client.callTool(mcpTool.name, params);
+        },
+        toJSON: () => ({
+            name,
+            description,
+            parameters: {
+                type: 'object',
+                properties: mcpTool.inputSchema.properties,
+                required: mcpTool.inputSchema.required,
+            },
+        }),
+    };
+    return tool;
+}
+/**
+ * Wrap all tools from an MCP client as Cogitator tools
+ *
+ * @example
+ * ```typescript
+ * const client = await MCPClient.connect({ ... });
+ * const tools = await wrapMCPTools(client);
+ *
+ * const agent = new Agent({
+ *   tools: [...tools, ...otherTools],
+ * });
+ * ```
+ */
+export async function wrapMCPTools(client, options) {
+    const definitions = await client.listToolDefinitions();
+    return definitions.map((def) => mcpToCogitator(def, client, options));
+}
+/**
+ * Convert a tool execution result to MCP content format
+ */
+export function resultToMCPContent(result) {
+    if (result === null || result === undefined) {
+        return [{ type: 'text', text: '' }];
+    }
+    if (typeof result === 'string') {
+        return [{ type: 'text', text: result }];
+    }
+    if (typeof result === 'object') {
+        if (Array.isArray(result) &&
+            result.every((item) => typeof item === 'object' && 'type' in item)) {
+            return result;
+        }
+        return [{ type: 'text', text: JSON.stringify(result, null, 2) }];
+    }
+    return [{ type: 'text', text: String(result) }];
+}
+/**
+ * Convert MCP content to a simple result value
+ */
+export function mcpContentToResult(content) {
+    if (!content || content.length === 0) {
+        return null;
+    }
+    if (content.length === 1 && content[0].type === 'text') {
+        const text = content[0].text;
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    return content.map((item) => {
+        if (item.type === 'text') {
+            try {
+                return JSON.parse(item.text);
+            }
+            catch {
+                return item.text;
+            }
+        }
+        return item;
+    });
+}
+//# sourceMappingURL=tool-adapter.js.map

package/dist/adapter/tool-adapter.js.map

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

package/dist/client/mcp-client.d.ts

@@ -0,0 +1,117 @@
+/**
+ * MCP Client
+ *
+ * Connects to external MCP servers and provides access to their tools,
+ * resources, and prompts.
+ */
+import type { Tool } from '@cogitator-ai/types';
+import type { MCPClientConfig, MCPResource, MCPResourceContent, MCPPrompt, MCPPromptMessage, MCPToolDefinition } from '../types';
+/**
+ * MCP Client for connecting to external MCP servers
+ *
+ * @example
+ * ```typescript
+ * // Connect to a filesystem MCP server
+ * const client = await MCPClient.connect({
+ *   transport: 'stdio',
+ *   command: 'npx',
+ *   args: ['-y', '@anthropic/mcp-server-filesystem', '/allowed/path'],
+ * });
+ *
+ * // Get available tools as Cogitator tools
+ * const tools = await client.getTools();
+ *
+ * // Use them with an agent
+ * const agent = new Agent({
+ *   tools: [...tools],
+ *   ...
+ * });
+ *
+ * // Don't forget to disconnect
+ * await client.close();
+ * ```
+ */
+export declare class MCPClient {
+    private client;
+    private transport;
+    private connected;
+    private serverCapabilities;
+    private constructor();
+    /**
+     * Connect to an MCP server
+     */
+    static connect(config: MCPClientConfig): Promise<MCPClient>;
+    /**
+     * Create transport based on configuration
+     */
+    private static createTransport;
+    /**
+     * Initialize connection and capabilities
+     */
+    private initialize;
+    /**
+     * Check if connected to server
+     */
+    isConnected(): boolean;
+    /**
+     * Get server capabilities
+     */
+    getCapabilities(): typeof this.serverCapabilities;
+    /**
+     * List available tools from the MCP server
+     */
+    listToolDefinitions(): Promise<MCPToolDefinition[]>;
+    /**
+     * Get MCP tools as Cogitator Tool instances
+     *
+     * These tools can be directly used with Cogitator agents.
+     */
+    getTools(): Promise<Tool[]>;
+    /**
+     * Call a tool on the MCP server
+     */
+    callTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+    /**
+     * List available resources from the MCP server
+     */
+    listResources(): Promise<MCPResource[]>;
+    /**
+     * Read a resource from the MCP server
+     */
+    readResource(uri: string): Promise<MCPResourceContent>;
+    /**
+     * List available prompts from the MCP server
+     */
+    listPrompts(): Promise<MCPPrompt[]>;
+    /**
+     * Get a prompt from the MCP server
+     */
+    getPrompt(name: string, args?: Record<string, string>): Promise<MCPPromptMessage[]>;
+    /**
+     * Close the connection to the MCP server
+     */
+    close(): Promise<void>;
+}
+/**
+ * Helper function to connect to an MCP server and get tools in one step
+ *
+ * @example
+ * ```typescript
+ * const { tools, cleanup } = await connectMCPServer({
+ *   transport: 'stdio',
+ *   command: 'npx',
+ *   args: ['-y', '@anthropic/mcp-server-filesystem', '/path'],
+ * });
+ *
+ * const agent = new Agent({ tools });
+ *
+ * // When done
+ * await cleanup();
+ * ```
+ */
+export declare function connectMCPServer(config: MCPClientConfig): Promise<{
+    client: MCPClient;
+    tools: Tool[];
+    cleanup: () => Promise<void>;
+}>;
+//# sourceMappingURL=mcp-client.d.ts.map

package/dist/client/mcp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../../src/client/mcp-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,KAAK,EACV,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAGlB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,kBAAkB,CAInB;IAEP,OAAO;IAKP;;OAEG;WACU,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAajE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IA0B9B;;OAEG;YACW,UAAU;IAyBxB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,eAAe,IAAI,OAAO,IAAI,CAAC,kBAAkB;IAIjD;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAczD;;;;OAIG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAKjC;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB7E;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAe7C;;OAEG;IACG,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgB5D;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAkBzC;;OAEG;IACG,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC5B,OAAO,CAAC,gBAAgB,EAAE,CAAC;IA4B9B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC;IACvE,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B,CAAC,CASD"}