@emcy/openapi-to-mcp 0.2.0

package/dist/generator.js

@@ -0,0 +1,595 @@
+/**
+ * Code Generator - Generates MCP server code from tool definitions
+ */
+/**
+ * Generate a complete MCP server from tool definitions
+ */
+export function generateMcpServer(tools, options, securitySchemes = {}) {
+    const files = {};
+    files["package.json"] = generatePackageJson(options);
+    files["tsconfig.json"] = generateTsConfig();
+    files["src/index.ts"] = generateServerEntry(tools, options, securitySchemes);
+    files["src/transport.ts"] = generateTransport();
+    files[".env.example"] = generateEnvExample(tools, securitySchemes);
+    files["README.md"] = generateReadme(options);
+    return files;
+}
+function generatePackageJson(options) {
+    const pkg = {
+        name: options.name,
+        version: options.version || "1.0.0",
+        description: `MCP Server generated from OpenAPI spec`,
+        type: "module",
+        main: "build/index.js",
+        scripts: {
+            build: "tsc",
+            start: "node build/index.js",
+            "start:http": "node build/index.js --transport=streamable-http",
+            dev: "tsc --watch",
+        },
+        dependencies: {
+            "@modelcontextprotocol/sdk": "^1.10.0",
+            axios: "^1.9.0",
+            dotenv: "^16.4.5",
+            hono: "^4.7.7",
+            "@hono/node-server": "^1.14.1",
+            ...(options.emcyEnabled
+                ? {
+                    "@emcy/sdk": options.localSdkPath
+                        ? `file:${options.localSdkPath}`
+                        : "^0.1.0",
+                }
+                : {}),
+        },
+        devDependencies: {
+            "@types/node": "^22.15.2",
+            typescript: "^5.8.3",
+        },
+        engines: {
+            node: ">=20.0.0",
+        },
+    };
+    return JSON.stringify(pkg, null, 2);
+}
+function generateTsConfig() {
+    const config = {
+        compilerOptions: {
+            target: "ES2022",
+            module: "NodeNext",
+            moduleResolution: "NodeNext",
+            lib: ["ES2022"],
+            outDir: "./build",
+            rootDir: "./src",
+            strict: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+            forceConsistentCasingInFileNames: true,
+            declaration: true,
+            sourceMap: true,
+        },
+        include: ["src/**/*"],
+        exclude: ["node_modules", "build"],
+    };
+    return JSON.stringify(config, null, 2);
+}
+function generateServerEntry(tools, options, securitySchemes) {
+    const toolDefinitions = tools
+        .map((tool) => {
+        return `  ["${tool.name}", {
+    name: "${tool.name}",
+    description: ${JSON.stringify(tool.description)},
+    inputSchema: ${JSON.stringify(tool.inputSchema)},
+    method: "${tool.httpMethod}",
+    pathTemplate: "${tool.pathTemplate}",
+    parameters: ${JSON.stringify(tool.parameters)},
+    requestBodyContentType: ${tool.requestBodyContentType
+            ? `"${tool.requestBodyContentType}"`
+            : "undefined"},
+    securitySchemes: ${JSON.stringify(tool.securitySchemes)},
+  }]`;
+    })
+        .join(",\n");
+    const emcyImport = options.emcyEnabled
+        ? `import { EmcyTelemetry } from '@emcy/sdk';\n`
+        : "";
+    const emcyInit = options.emcyEnabled
+        ? `
+// Initialize Emcy telemetry if API key is provided
+const emcy = process.env.EMCY_API_KEY
+  ? new EmcyTelemetry({
+      apiKey: process.env.EMCY_API_KEY,
+      endpoint: process.env.EMCY_TELEMETRY_URL,
+      mcpServerId: process.env.EMCY_MCP_SERVER_ID,
+      debug: process.env.EMCY_DEBUG === 'true',
+    })
+  : null;
+
+// Set server info for telemetry metadata
+if (emcy) {
+  emcy.setServerInfo(SERVER_NAME, SERVER_VERSION);
+}
+`
+        : "";
+    const emcyTrace = options.emcyEnabled
+        ? `
+    // Wrap with Emcy telemetry if enabled
+    if (emcy) {
+      return emcy.trace(toolName, async () => executeRequest(toolDefinition, toolArgs ?? {}));
+    }
+`
+        : "";
+    return `#!/usr/bin/env node
+/**
+ * MCP Server: ${options.name}
+ * Generated by Emcy OpenAPI-to-MCP Generator
+ */
+
+import dotenv from 'dotenv';
+dotenv.config();
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  type Tool,
+  type CallToolResult,
+  type CallToolRequest
+} from "@modelcontextprotocol/sdk/types.js";
+import axios, { type AxiosRequestConfig, type AxiosError } from 'axios';
+import { setupStreamableHttpServer } from "./transport.js";
+${emcyImport}
+// Configuration
+export const SERVER_NAME = "${options.name}";
+export const SERVER_VERSION = "${options.version || "1.0.0"}";
+export const API_BASE_URL = process.env.API_BASE_URL || "${options.baseUrl}";
+
+// Tool definition interface
+interface McpToolDefinition {
+  name: string;
+  description: string;
+  inputSchema: Record<string, unknown>;
+  method: string;
+  pathTemplate: string;
+  parameters: { name: string; in: string; required: boolean }[];
+  requestBodyContentType?: string;
+  securitySchemes: string[];
+}
+
+// Security schemes
+const securitySchemes: Record<string, unknown> = ${JSON.stringify(securitySchemes, null, 2)};
+${emcyInit}
+// Tool definitions
+const toolDefinitionMap: Map<string, McpToolDefinition> = new Map([
+${toolDefinitions}
+]);
+
+// Create MCP server
+const server = new Server(
+  { name: SERVER_NAME, version: SERVER_VERSION },
+  { capabilities: { tools: {} } }
+);
+
+// List tools handler
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  const toolsForClient: Tool[] = Array.from(toolDefinitionMap.values()).map(def => ({
+    name: def.name,
+    description: def.description,
+    inputSchema: def.inputSchema as Tool['inputSchema'],
+  }));
+  return { tools: toolsForClient };
+});
+
+// Call tool handler
+server.setRequestHandler(CallToolRequestSchema, async (request: CallToolRequest): Promise<CallToolResult> => {
+  const { name: toolName, arguments: toolArgs } = request.params;
+  const toolDefinition = toolDefinitionMap.get(toolName);
+  
+  if (!toolDefinition) {
+    return { content: [{ type: "text", text: \`Error: Unknown tool: \${toolName}\` }] };
+  }
+  
+  try {
+${emcyTrace}
+    return await executeRequest(toolDefinition, toolArgs ?? {});
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return { content: [{ type: "text", text: \`Error: \${message}\` }] };
+  }
+});
+
+// Execute API request
+async function executeRequest(
+  def: McpToolDefinition,
+  args: Record<string, unknown>
+): Promise<CallToolResult> {
+  let url = def.pathTemplate;
+  const queryParams: Record<string, unknown> = {};
+  const headers: Record<string, string> = { 'Accept': 'application/json' };
+  
+  // Apply path and query parameters
+  for (const param of def.parameters) {
+    const value = args[param.name];
+    if (value !== undefined && value !== null) {
+      if (param.in === 'path') {
+        url = url.replace(\`{\${param.name}}\`, encodeURIComponent(String(value)));
+      } else if (param.in === 'query') {
+        queryParams[param.name] = value;
+      } else if (param.in === 'header') {
+        headers[param.name.toLowerCase()] = String(value);
+      }
+    }
+  }
+  
+  // Apply security (API key, Bearer token)
+  applySecurityHeaders(headers, def.securitySchemes);
+  
+  // Build request config
+  const config: AxiosRequestConfig = {
+    method: def.method,
+    url: \`\${API_BASE_URL}\${url}\`,
+    params: queryParams,
+    headers,
+  };
+  
+  // Add request body if present
+  if (def.requestBodyContentType && args.requestBody !== undefined) {
+    config.data = args.requestBody;
+    headers['content-type'] = def.requestBodyContentType;
+  }
+  
+  console.error(\`Executing: \${def.method.toUpperCase()} \${config.url}\`);
+  
+  const response = await axios(config);
+  
+  let responseText: string;
+  if (typeof response.data === 'object') {
+    responseText = JSON.stringify(response.data, null, 2);
+  } else {
+    responseText = String(response.data ?? '');
+  }
+  
+  return {
+    content: [{ type: "text", text: \`Status: \${response.status}\\n\\n\${responseText}\` }]
+  };
+}
+
+// Apply security headers based on environment variables
+function applySecurityHeaders(headers: Record<string, string>, schemeNames: string[]) {
+  for (const schemeName of schemeNames) {
+    const scheme = securitySchemes[schemeName] as Record<string, unknown> | undefined;
+    if (!scheme) continue;
+    
+    const envKey = schemeName.replace(/[^a-zA-Z0-9]/g, '_').toUpperCase();
+    
+    if (scheme.type === 'apiKey') {
+      const apiKey = process.env[\`API_KEY_\${envKey}\`];
+      if (apiKey && scheme.in === 'header' && typeof scheme.name === 'string') {
+        headers[scheme.name.toLowerCase()] = apiKey;
+      }
+    } else if (scheme.type === 'http' && scheme.scheme === 'bearer') {
+      const token = process.env[\`BEARER_TOKEN_\${envKey}\`];
+      if (token) {
+        headers['authorization'] = \`Bearer \${token}\`;
+      }
+    }
+  }
+}
+
+// Main
+async function main() {
+  const args = process.argv.slice(2);
+  const useHttp = args.includes('--transport=streamable-http');
+  
+  if (useHttp) {
+    const port = parseInt(process.env.PORT || '3000', 10);
+    await setupStreamableHttpServer(server, port);
+  } else {
+    // Stdio transport for Claude Desktop, etc.
+    const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(\`\${SERVER_NAME} running on stdio\`);
+  }
+}
+
+main().catch(console.error);
+`;
+}
+function generateTransport() {
+    return `/**
+ * HTTP Transport for MCP
+ * Uses Streamable HTTP transport (MCP specification 2025-03-26)
+ */
+
+import { Hono } from 'hono';
+import { cors } from 'hono/cors';
+import { serve } from '@hono/node-server';
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { SERVER_NAME, SERVER_VERSION } from './index.js';
+
+const { WebStandardStreamableHTTPServerTransport } = await import(
+  "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js"
+);
+
+const transports: Map<string, InstanceType<typeof WebStandardStreamableHTTPServerTransport>> = new Map();
+
+export async function setupStreamableHttpServer(mcpServer: Server, port = 3000) {
+  const app = new Hono();
+  
+  // CORS configuration for browser/client access
+  app.use('*', cors({
+    origin: '*',
+    allowMethods: ['GET', 'POST', 'DELETE', 'OPTIONS'],
+    allowHeaders: ['Content-Type', 'Accept', 'mcp-session-id', 'Last-Event-ID'],
+    exposeHeaders: ['mcp-session-id'],
+  }));
+  
+  // Health check endpoint
+  app.get('/health', (c) => {
+    return c.json({ 
+      status: 'OK', 
+      server: SERVER_NAME, 
+      version: SERVER_VERSION,
+      mcp: {
+        transport: 'streamable-http',
+        endpoints: {
+          mcp: '/mcp',
+          health: '/health'
+        }
+      }
+    });
+  });
+  
+  // Streamable HTTP Transport (MCP spec 2025-03-26)
+  // Supports ChatGPT, Cursor, and other modern MCP clients
+  app.all("/mcp", async (c) => {
+    const sessionId = c.req.header('mcp-session-id');
+    
+    // Existing session
+    if (sessionId && transports.has(sessionId)) {
+      return transports.get(sessionId)!.handleRequest(c.req.raw);
+    }
+    
+    // New session - create transport
+    if (!sessionId) {
+      const transport = new WebStandardStreamableHTTPServerTransport({
+        sessionIdGenerator: () => crypto.randomUUID(),
+        onsessioninitialized: (newSessionId: string) => {
+          transports.set(newSessionId, transport);
+          console.error(\`New MCP session: \${newSessionId}\`);
+        }
+      });
+      
+      transport.onerror = (err: Error) => console.error('Transport error:', err);
+      transport.onclose = () => {
+        const sid = transport.sessionId;
+        if (sid) {
+          transports.delete(sid);
+          console.error(\`Session closed: \${sid}\`);
+        }
+      };
+      
+      await mcpServer.connect(transport);
+      return transport.handleRequest(c.req.raw);
+    }
+    
+    // Session not found
+    return c.json({ 
+      error: 'Session not found',
+      message: 'The specified session ID does not exist. Start a new session by omitting the mcp-session-id header.'
+    }, 404);
+  });
+  
+  // Legacy /sse endpoint - redirect to /mcp with guidance
+  app.get("/sse", (c) => {
+    return c.json({
+      error: 'SSE transport deprecated',
+      message: 'The SSE transport was deprecated in MCP specification 2025-03-26. Please use the Streamable HTTP transport at /mcp instead.',
+      redirect: '/mcp'
+    }, 410);
+  });
+  
+  serve({ fetch: app.fetch, port }, (info) => {
+    console.error('');
+    console.error(\`╔═══════════════════════════════════════════════════════════════╗\`);
+    console.error(\`║  MCP Server: \${SERVER_NAME.padEnd(46)} ║\`);
+    console.error(\`╠═══════════════════════════════════════════════════════════════╣\`);
+    console.error(\`║  Status: Running                                              ║\`);
+    console.error(\`║  Port:   \${String(info.port).padEnd(53)} ║\`);
+    console.error(\`╠═══════════════════════════════════════════════════════════════╣\`);
+    console.error(\`║  Endpoints:                                                   ║\`);
+    console.error(\`║    MCP:    http://localhost:\${info.port}/mcp\`.padEnd(64) + \`║\`);
+    console.error(\`║    Health: http://localhost:\${info.port}/health\`.padEnd(64) + \`║\`);
+    console.error(\`╠═══════════════════════════════════════════════════════════════╣\`);
+    console.error(\`║  For AI Clients:                                              ║\`);
+    console.error(\`║    ChatGPT/Cursor URL: http://localhost:\${info.port}/mcp\`.padEnd(64) + \`║\`);
+    console.error(\`║    Claude Desktop: Use stdio transport (npm start)            ║\`);
+    console.error(\`╚═══════════════════════════════════════════════════════════════╝\`);
+    console.error('');
+  });
+  
+  return app;
+}
+`;
+}
+function generateEnvExample(tools, securitySchemes) {
+    const lines = [
+        "# API Configuration",
+        "API_BASE_URL=http://localhost:5001",
+        "",
+        "# Emcy Telemetry (optional)",
+        "# Set these to enable telemetry to Emcy platform",
+        "# EMCY_API_KEY=your-api-key-from-emcy-dashboard",
+        "# EMCY_TELEMETRY_URL=http://localhost:5140/api/v1/telemetry",
+        "# EMCY_MCP_SERVER_ID=mcp_xxxxxxxxxxxx",
+        "# EMCY_DEBUG=false",
+        "",
+        "# Server Port (for HTTP transport)",
+        "PORT=3000",
+    ];
+    // Collect unique security schemes used by tools
+    const usedSchemes = new Set();
+    for (const tool of tools) {
+        for (const scheme of tool.securitySchemes) {
+            usedSchemes.add(scheme);
+        }
+    }
+    if (usedSchemes.size > 0) {
+        lines.push("", "# Security Credentials");
+        for (const schemeName of usedSchemes) {
+            const scheme = securitySchemes[schemeName];
+            const envKey = schemeName.replace(/[^a-zA-Z0-9]/g, "_").toUpperCase();
+            if (scheme?.type === "apiKey") {
+                lines.push(`API_KEY_${envKey}=your-api-key`);
+            }
+            else if (scheme?.type === "http" && scheme.scheme === "bearer") {
+                lines.push(`BEARER_TOKEN_${envKey}=your-bearer-token`);
+            }
+            else if (scheme?.type === "oauth2") {
+                lines.push(`OAUTH_CLIENT_ID_${envKey}=your-client-id`);
+                lines.push(`OAUTH_CLIENT_SECRET_${envKey}=your-client-secret`);
+            }
+        }
+    }
+    return lines.join("\n");
+}
+function generateReadme(options) {
+    return `# ${options.name}
+
+MCP Server generated from OpenAPI specification by [Emcy](https://emcy.dev).
+
+## Quick Start
+
+\`\`\`bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run with HTTP transport (for ChatGPT, Cursor, web clients)
+npm run start:http
+
+# Or run with stdio transport (for Claude Desktop)
+npm start
+\`\`\`
+
+## Configuration
+
+Copy \`.env.example\` to \`.env\` and configure:
+
+- \`API_BASE_URL\`: Base URL of the API (default: ${options.baseUrl})
+- \`PORT\`: Server port for HTTP transport (default: 3000)
+- Security credentials as needed
+
+---
+
+## 🤖 AI Client Configuration
+
+### ChatGPT (OpenAI)
+
+ChatGPT supports MCP servers via Developer Mode. Use the Streamable HTTP transport:
+
+1. Start the server with HTTP transport:
+   \`\`\`bash
+   npm run start:http
+   \`\`\`
+
+2. In ChatGPT Developer Mode, add your MCP server:
+   - **URL**: \`http://your-server-url:3000/mcp\`
+   - For local development, you'll need to expose via a tunnel (ngrok, cloudflare tunnel, etc.)
+
+### Cursor IDE
+
+Cursor supports both HTTP and stdio transports:
+
+**Option A: HTTP Transport (Recommended)**
+
+Add to your project's \`.cursor/mcp.json\`:
+
+\`\`\`json
+{
+  "mcpServers": {
+    "${options.name}": {
+      "url": "http://localhost:3000/mcp"
+    }
+  }
+}
+\`\`\`
+
+Then start the server: \`npm run start:http\`
+
+**Option B: Stdio Transport**
+
+Add to your project's \`.cursor/mcp.json\`:
+
+\`\`\`json
+{
+  "mcpServers": {
+    "${options.name}": {
+      "command": "node",
+      "args": ["<absolute-path-to>/build/index.js"]
+    }
+  }
+}
+\`\`\`
+
+Restart Cursor after adding the configuration.
+
+### Claude Desktop
+
+Claude Desktop uses stdio transport:
+
+Add to your Claude Desktop config (\`~/Library/Application Support/Claude/claude_desktop_config.json\` on macOS):
+
+\`\`\`json
+{
+  "mcpServers": {
+    "${options.name}": {
+      "command": "node",
+      "args": ["<absolute-path-to>/build/index.js"]
+    }
+  }
+}
+\`\`\`
+
+---
+
+## Transport Endpoints
+
+When running with HTTP transport (\`npm run start:http\`):
+
+| Endpoint | Transport | Description |
+|----------|-----------|-------------|
+| \`/mcp\` | Streamable HTTP | Modern transport (MCP spec 2025-03-26). **Recommended.** |
+| \`/sse\` | Server-Sent Events | Legacy transport for older clients. |
+| \`/health\` | - | Health check endpoint. |
+
+---
+
+## Troubleshooting
+
+### "No Resources Found" in Cursor
+
+1. Make sure the server is running: \`npm run start:http\`
+2. Check the health endpoint: \`curl http://localhost:3000/health\`
+3. Verify your \`mcp.json\` path is correct
+4. Restart Cursor after configuration changes
+5. Try using stdio transport instead of HTTP
+
+### Connection Errors
+
+1. Ensure the API base URL is correct in \`.env\`
+2. Check that required API keys are set in \`.env\`
+3. Verify the target API is accessible from your machine
+
+### TypeScript Build Errors
+
+\`\`\`bash
+# Clean and rebuild
+rm -rf build/
+npm run build
+\`\`\`
+`;
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Emcy OpenAPI to MCP Generator
+ *
+ * Converts OpenAPI specifications to MCP servers with optional Emcy telemetry.
+ */
+export { parseOpenAPI, validateOpenAPI, generateOperationId } from './parser.js';
+export { mapToMcpTools, getEndpointKey, getAllEndpointKeys } from './mapper.js';
+export { generateMcpServer } from './generator.js';
+export type { OpenAPIEndpoint, ParsedOpenAPI, McpToolDefinition, GeneratorOptions, GeneratedFiles, EndpointParameter, SecurityScheme, } from './types.js';
+//# 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;AAEH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,YAAY,EACV,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * Emcy OpenAPI to MCP Generator
+ *
+ * Converts OpenAPI specifications to MCP servers with optional Emcy telemetry.
+ */
+export { parseOpenAPI, validateOpenAPI, generateOperationId } from './parser.js';
+export { mapToMcpTools, getEndpointKey, getAllEndpointKeys } from './mapper.js';
+export { generateMcpServer } from './generator.js';
+//# 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,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/mapper.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Tool Mapper - Maps OpenAPI endpoints to MCP tool definitions
+ */
+import type { OpenAPIEndpoint, McpToolDefinition } from "./types.js";
+/**
+ * Map OpenAPI endpoints to MCP tool definitions
+ */
+export declare function mapToMcpTools(endpoints: OpenAPIEndpoint[], enabledPaths?: Set<string>): McpToolDefinition[];
+/**
+ * Generate a unique key for an endpoint
+ */
+export declare function getEndpointKey(endpoint: OpenAPIEndpoint): string;
+/**
+ * Get all endpoint keys from a list of endpoints
+ */
+export declare function getAllEndpointKeys(endpoints: OpenAPIEndpoint[]): string[];
+//# sourceMappingURL=mapper.d.ts.map

package/dist/mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../src/mapper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,eAAe,EAAE,EAC5B,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACzB,iBAAiB,EAAE,CAQrB;AAgED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,eAAe,EAAE,GAAG,MAAM,EAAE,CAEzE"}