@mcpmesh/sdk 0.8.0-beta.1

package/dist/express.js

@@ -0,0 +1,371 @@
+/**
+ * MeshExpress: Express app integration with MCP Mesh.
+ *
+ * Provides automatic registration with mesh registry and dependency injection
+ * for Express route handlers. Uses agent_type: "api" since API services only
+ * consume capabilities, they don't provide them.
+ *
+ * **Note:** For simpler usage, just use `mesh.route()` without `meshExpress()`.
+ * The API runtime auto-initializes when the first `mesh.route()` is called.
+ *
+ * @example Simple usage (recommended)
+ * ```typescript
+ * import express from "express";
+ * import { mesh } from "@mcpmesh/sdk";
+ *
+ * const app = express();
+ * app.use(express.json());
+ *
+ * // mesh.route() auto-initializes the mesh connection
+ * app.post("/compute", mesh.route(
+ *   [{ capability: "calculator" }],
+ *   async (req, res, { calculator }) => {
+ *     res.json({ result: await calculator({ a: req.body.a, b: req.body.b }) });
+ *   }
+ * ));
+ *
+ * app.listen(3000);
+ * ```
+ *
+ * @example Explicit control (advanced)
+ * ```typescript
+ * import express from "express";
+ * import { meshExpress, mesh } from "@mcpmesh/sdk";
+ *
+ * const app = express();
+ * const meshApp = meshExpress(app, { name: "my-api", port: 3000 });
+ *
+ * app.post("/compute", mesh.route(...));
+ *
+ * meshApp.start();
+ * ```
+ */
+import { startAgent, } from "@mcpmesh/core";
+import { resolveConfig, generateAgentIdSuffix } from "./config.js";
+import { createProxy } from "./proxy.js";
+import { RouteRegistry } from "./route.js";
+import { initTracing } from "./tracing.js";
+/**
+ * Build tool specs from registered routes.
+ * Shared helper for consistent tool spec generation.
+ */
+function buildToolSpecs(routes) {
+    return routes
+        .filter((route) => route.dependencies.length > 0)
+        .map((route) => ({
+        functionName: route.routeId,
+        capability: "", // Routes don't provide capabilities, they consume them
+        version: "1.0.0",
+        tags: [],
+        description: "",
+        dependencies: route.dependencies.map((dep) => ({
+            capability: dep.capability,
+            tags: dep.tags,
+            version: dep.version,
+        })),
+        inputSchema: undefined,
+    }));
+}
+/**
+ * MeshExpress wraps an Express app with MCP Mesh capabilities.
+ *
+ * Provides:
+ * - Registration with mesh registry via Rust core
+ * - Heartbeat management
+ * - Dependency resolution for route handlers
+ * - Distributed tracing
+ */
+export class MeshExpress {
+    app;
+    config;
+    serviceId;
+    handle = null;
+    server = null;
+    started = false;
+    constructor(app, config) {
+        this.app = app;
+        // Resolve config with env var precedence: ENV > config > defaults
+        this.config = resolveConfig(config);
+        // Generate unique service ID with suffix (e.g., "my-api-a1b2c3d4")
+        this.serviceId = `${this.config.name}-${generateAgentIdSuffix()}`;
+        // Add health check endpoint
+        this.setupHealthEndpoints();
+        // Auto-start if configured (but default is false for Express)
+        if (config.autoStart) {
+            process.nextTick(() => {
+                this.start().catch((err) => {
+                    console.error("MeshExpress auto-start failed:", err);
+                    process.exit(1);
+                });
+            });
+        }
+    }
+    /**
+     * Setup health check endpoints for the registry.
+     */
+    setupHealthEndpoints() {
+        // Health check endpoint for registry
+        this.app.get("/health", (_req, res) => {
+            res.json({ status: "healthy", serviceId: this.serviceId });
+        });
+        // Ready check endpoint
+        this.app.get("/ready", (_req, res) => {
+            const isReady = this.handle !== null;
+            res.status(isReady ? 200 : 503).json({
+                ready: isReady,
+                serviceId: this.serviceId,
+            });
+        });
+    }
+    /**
+     * Start the Express server and register with mesh.
+     */
+    async start() {
+        if (this.started)
+            return;
+        this.started = true;
+        console.log(`Starting MeshExpress service: ${this.serviceId}`);
+        // 0. Initialize distributed tracing
+        const agentMetadata = {
+            agentId: this.serviceId,
+            agentName: this.config.name,
+            agentNamespace: this.config.namespace,
+            agentHostname: this.config.host,
+            agentIp: this.config.host,
+            agentPort: this.config.port,
+            agentEndpoint: `http://${this.config.host}:${this.config.port}`,
+        };
+        await initTracing(agentMetadata);
+        // 1. Start HTTP server
+        await this.startServer();
+        // 2. Start heartbeat to registry via Rust core
+        await this.startHeartbeat();
+        // 3. Install signal handlers for graceful shutdown
+        this.installSignalHandlers();
+    }
+    /**
+     * Start the Express HTTP server.
+     */
+    startServer() {
+        return new Promise((resolve, reject) => {
+            try {
+                this.server = this.app.listen(this.config.port, "0.0.0.0", () => {
+                    console.log(`Service listening on port ${this.config.port}`);
+                    resolve();
+                });
+                this.server.on("error", (err) => {
+                    reject(err);
+                });
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+    }
+    /**
+     * Start the Rust core heartbeat loop.
+     */
+    async startHeartbeat() {
+        const registry = RouteRegistry.getInstance();
+        const routes = registry.getRoutes();
+        const tools = buildToolSpecs(routes);
+        const spec = {
+            name: this.serviceId,
+            version: this.config.version,
+            description: this.config.description,
+            registryUrl: this.config.registryUrl,
+            httpPort: this.config.port,
+            httpHost: this.config.host,
+            namespace: this.config.namespace,
+            agentType: "api", // API services only consume capabilities, not provide them
+            tools,
+            heartbeatInterval: this.config.heartbeatInterval,
+        };
+        // Start the agent via Rust core
+        this.handle = startAgent(spec);
+        // Count total dependencies
+        const totalDeps = routes.reduce((sum, r) => sum + r.dependencies.length, 0);
+        console.log(`Registered ${routes.length} routes with registry (${totalDeps} dependencies)`);
+        // Start event loop (runs in background)
+        this.runEventLoop();
+    }
+    /**
+     * Run the event loop to handle mesh events.
+     */
+    async runEventLoop() {
+        if (!this.handle)
+            return;
+        const registry = RouteRegistry.getInstance();
+        while (true) {
+            try {
+                const event = await this.handle.nextEvent();
+                switch (event.eventType) {
+                    case "agent_registered":
+                        console.log(`Service registered with ID: ${event.agentId}`);
+                        break;
+                    case "registration_failed":
+                        console.error(`Registration failed: ${event.error}`);
+                        break;
+                    case "dependency_available":
+                        this.handleDependencyAvailable(registry, event.capability, event.endpoint, event.functionName, event.agentId, event.requestingFunction, event.depIndex);
+                        break;
+                    case "dependency_unavailable":
+                        this.handleDependencyUnavailable(registry, event.capability, event.requestingFunction, event.depIndex);
+                        break;
+                    case "dependency_changed":
+                        this.handleDependencyAvailable(registry, event.capability, event.endpoint, event.functionName, event.agentId, event.requestingFunction, event.depIndex);
+                        break;
+                    case "registry_connected":
+                        console.log("Connected to registry");
+                        break;
+                    case "registry_disconnected":
+                        console.warn(`Disconnected from registry: ${event.reason}`);
+                        registry.clearAllDependencies();
+                        break;
+                    case "shutdown":
+                        console.log("Service shutting down");
+                        return;
+                    default:
+                        break;
+                }
+            }
+            catch (err) {
+                console.error("Event loop error:", err);
+                break;
+            }
+        }
+    }
+    /**
+     * Handle dependency_available event.
+     */
+    handleDependencyAvailable(registry, capability, endpoint, functionName, agentId, requestingFunction, depIndex) {
+        // If we have position info, use it directly
+        if (requestingFunction !== undefined && depIndex !== undefined) {
+            const route = registry.getRoute(requestingFunction);
+            const kwargs = route?.dependencyKwargs?.[depIndex];
+            const proxy = createProxy(endpoint, capability, functionName, kwargs);
+            registry.setDependency(requestingFunction, depIndex, proxy);
+            console.log(`Dependency available: ${capability} at ${endpoint} (route: ${requestingFunction}, index: ${depIndex}, agent: ${agentId})`);
+            return;
+        }
+        // Fallback: match by capability across all routes
+        let matchCount = 0;
+        for (const route of registry.getRoutes()) {
+            route.dependencies.forEach((dep, idx) => {
+                if (dep.capability === capability) {
+                    const kwargs = route.dependencyKwargs?.[idx];
+                    const proxy = createProxy(endpoint, capability, functionName, kwargs);
+                    registry.setDependency(route.routeId, idx, proxy);
+                    matchCount++;
+                }
+            });
+        }
+        console.log(`Dependency available: ${capability} at ${endpoint} (agent: ${agentId}, ${matchCount} route bindings)`);
+    }
+    /**
+     * Handle dependency_unavailable event.
+     */
+    handleDependencyUnavailable(registry, capability, requestingFunction, depIndex) {
+        // If we have position info, use it directly
+        if (requestingFunction !== undefined && depIndex !== undefined) {
+            registry.removeDependency(requestingFunction, depIndex);
+            console.log(`Dependency unavailable: ${capability} (route: ${requestingFunction}, index: ${depIndex})`);
+            return;
+        }
+        // Fallback: match by capability across all routes
+        let removeCount = 0;
+        for (const route of registry.getRoutes()) {
+            route.dependencies.forEach((dep, idx) => {
+                if (dep.capability === capability) {
+                    registry.removeDependency(route.routeId, idx);
+                    removeCount++;
+                }
+            });
+        }
+        console.log(`Dependency unavailable: ${capability} (${removeCount} route bindings removed)`);
+    }
+    /**
+     * Install signal handlers for graceful shutdown.
+     */
+    installSignalHandlers() {
+        let shuttingDown = false;
+        const shutdownHandler = async (signal) => {
+            if (shuttingDown)
+                return;
+            shuttingDown = true;
+            console.log(`\nReceived ${signal}, shutting down service ${this.serviceId}...`);
+            try {
+                await this.shutdown();
+                console.log(`Service ${this.serviceId} unregistered from registry`);
+            }
+            catch (err) {
+                console.error("Error during shutdown:", err);
+            }
+            process.exit(0);
+        };
+        process.on("SIGINT", () => void shutdownHandler("SIGINT"));
+        process.on("SIGTERM", () => void shutdownHandler("SIGTERM"));
+    }
+    /**
+     * Get the service ID.
+     */
+    getServiceId() {
+        return this.serviceId;
+    }
+    /**
+     * Get the resolved configuration.
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Get the underlying Express app.
+     */
+    getApp() {
+        return this.app;
+    }
+    /**
+     * Get the HTTP server instance.
+     */
+    getServer() {
+        return this.server;
+    }
+    /**
+     * Get the agent handle for advanced operations.
+     */
+    getHandle() {
+        return this.handle;
+    }
+    /**
+     * Shutdown the service gracefully.
+     */
+    async shutdown() {
+        if (this.handle) {
+            await this.handle.shutdown();
+            this.handle = null;
+        }
+        if (this.server) {
+            await new Promise((resolve) => {
+                this.server.close(() => resolve());
+            });
+            this.server = null;
+        }
+    }
+}
+/**
+ * Create a MeshExpress instance wrapping an Express app.
+ *
+ * @example
+ * ```typescript
+ * const app = express();
+ * const meshApp = meshExpress(app, { name: "my-api", port: 3000 });
+ *
+ * // Define routes with mesh.route()...
+ *
+ * meshApp.start();
+ * ```
+ */
+export function meshExpress(app, config) {
+    return new MeshExpress(app, config);
+}
+//# sourceMappingURL=express.js.map

package/dist/express.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @mcpmesh/sdk - MCP Mesh SDK for TypeScript
+ *
+ * Build distributed MCP agents with automatic service discovery and dependency injection.
+ *
+ * @example MCP Agent (fastmcp)
+ * ```typescript
+ * import { FastMCP } from "fastmcp";
+ * import { mesh } from "@mcpmesh/sdk";
+ * import { z } from "zod";
+ *
+ * const server = new FastMCP({ name: "Calculator", version: "1.0.0" });
+ *
+ * const agent = mesh(server, {
+ *   name: "calculator",
+ *   port: 9002,
+ * });
+ *
+ * agent.addTool({
+ *   name: "add",
+ *   capability: "add",
+ *   tags: ["tools", "math"],
+ *   description: "Add two numbers together",
+ *   parameters: z.object({ a: z.number(), b: z.number() }),
+ *   execute: async ({ a, b }) => String(a + b),
+ * });
+ *
+ * // No server.start() or main function needed!
+ * ```
+ *
+ * @example Express API with mesh dependencies
+ * ```typescript
+ * import express from "express";
+ * import { mesh, meshExpress } from "@mcpmesh/sdk";
+ *
+ * const app = express();
+ * app.use(express.json());
+ *
+ * const meshApp = meshExpress(app, { name: "my-api", port: 3000 });
+ *
+ * app.post("/compute", mesh.route(
+ *   [{ capability: "calculator" }],
+ *   async (req, res, { calculator }) => {
+ *     const result = await calculator({ a: req.body.a, b: req.body.b });
+ *     res.json({ result });
+ *   }
+ * ));
+ *
+ * meshApp.start();
+ * ```
+ */
+import { MeshAgent } from "./agent.js";
+import { route, routeWithConfig } from "./route.js";
+import { bindToExpress } from "./api-runtime.js";
+import { llm } from "./llm.js";
+import { llmProvider } from "./llm-provider.js";
+interface MeshNamespace {
+    (server: import("fastmcp").FastMCP, config: import("./types.js").AgentConfig): MeshAgent;
+    route: typeof route;
+    routeWithConfig: typeof routeWithConfig;
+    /** Optional: Bind to Express for proper route names in logs. Port auto-detected from PORT env. */
+    bind: typeof bindToExpress;
+    /** Create an LLM-powered tool with agentic capabilities */
+    llm: typeof llm;
+    /** Create a zero-code LLM provider tool */
+    llmProvider: typeof llmProvider;
+}
+/**
+ * Main mesh function with route and llm helpers attached.
+ *
+ * - `mesh(server, config)` - Create an MCP agent (wraps fastmcp)
+ * - `mesh.route(deps, handler)` - Create Express route with DI
+ * - `mesh.bind(app, options)` - Bind to Express, introspect routes
+ * - `mesh.llm(config)` - Create LLM-powered tool with agentic loop
+ * - `mesh.llmProvider(config)` - Create zero-code LLM provider
+ */
+declare const mesh: MeshNamespace;
+export { mesh, MeshAgent };
+export { FastMCP } from "fastmcp";
+export { meshExpress, MeshExpress, type MeshExpressConfig } from "./express.js";
+export { getApiRuntime, ApiRuntime, bindToExpress, introspectExpressRoutes, type ApiRuntimeConfig, } from "./api-runtime.js";
+export { route, routeWithConfig, RouteRegistry, type MeshRouteHandler, type MeshRouteHandlerWithNext, type RouteDependencies, type MeshRouteConfig, type RouteMetadata, } from "./route.js";
+export { createProxy, normalizeDependency } from "./proxy.js";
+export { initTracing, isTracingAvailable, generateTraceId, generateSpanId, parseTraceContext, createTraceHeaders, publishTraceSpan, type TraceContext, type AgentMetadata, type SpanData, } from "./tracing.js";
+export { llm, LlmToolRegistry, buildLlmAgentSpecs, handleLlmToolsUpdated, handleLlmProviderAvailable, handleLlmProviderUnavailable, getLlmToolMetadata, isLlmTool, type LlmToolConfig, type ResolvedProvider, type FastMcpToolDef, } from "./llm.js";
+export { MeshLlmAgent, LiteLLMProvider, MeshDelegatedProvider, createLlmToolProxy, type MeshLlmAgentConfig, type AgentRunContext, type LlmProvider, } from "./llm-agent.js";
+export { llmProvider, extractVendorFromModel, extractModelName, isLlmProviderTool, getLlmProviderMeta, } from "./llm-provider.js";
+export { ProviderHandlerRegistry, GenericHandler, ClaudeHandler, OpenAIHandler, type ProviderHandler, type ProviderHandlerConstructor, type VendorCapabilities, type ToolSchema, type OutputSchema, type PreparedRequest, type OutputMode, } from "./provider-handlers/index.js";
+export { MaxIterationsError, ToolExecutionError, LLMAPIError, ResponseParseError as LlmResponseParseError, ProviderUnavailableError, } from "./errors.js";
+export { parseSSEResponse, isSSEResponse, parseSSEStream } from "./sse.js";
+export { debug, createDebug, isAnyDebugEnabled } from "./debug.js";
+export { renderTemplate, clearTemplateCache, registerHelper, registerPartial, isFileTemplate, extractFilePath, } from "./template.js";
+export { ResponseParser, createResponseParser, extractJson, zodSchemaToPromptDescription, formatZodError, } from "./response-parser.js";
+export type { AgentConfig, ResolvedAgentConfig, MeshToolDef, ToolMeta, DependencySpec, NormalizedDependency, ResolvedDependency, DependencyKwargs, McpMeshAgent, JsAgentHandle, JsMeshEvent, JsAgentSpec, JsToolSpec, JsDependencySpec, JsLlmAgentSpec, JsLlmToolInfo, JsLlmProviderInfo, LlmProviderSpec, LlmFilterSpec, LlmFilterMode, LlmMeta, LlmToolCall, LlmMessage, LlmToolCallRequest, LlmToolDefinition, LlmCompletionParams, LlmCompletionResponse, MeshLlmConfig, LlmAgent, LlmCallOptions, LlmToolProxy, LlmMessageInput, LlmContextMode, LlmOutputMode, MeshLlmRequest, MeshLlmUsage, MeshLlmResponse, LlmProviderConfig, } from "./types.js";
+export default mesh;
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,107 @@
+/**
+ * @mcpmesh/sdk - MCP Mesh SDK for TypeScript
+ *
+ * Build distributed MCP agents with automatic service discovery and dependency injection.
+ *
+ * @example MCP Agent (fastmcp)
+ * ```typescript
+ * import { FastMCP } from "fastmcp";
+ * import { mesh } from "@mcpmesh/sdk";
+ * import { z } from "zod";
+ *
+ * const server = new FastMCP({ name: "Calculator", version: "1.0.0" });
+ *
+ * const agent = mesh(server, {
+ *   name: "calculator",
+ *   port: 9002,
+ * });
+ *
+ * agent.addTool({
+ *   name: "add",
+ *   capability: "add",
+ *   tags: ["tools", "math"],
+ *   description: "Add two numbers together",
+ *   parameters: z.object({ a: z.number(), b: z.number() }),
+ *   execute: async ({ a, b }) => String(a + b),
+ * });
+ *
+ * // No server.start() or main function needed!
+ * ```
+ *
+ * @example Express API with mesh dependencies
+ * ```typescript
+ * import express from "express";
+ * import { mesh, meshExpress } from "@mcpmesh/sdk";
+ *
+ * const app = express();
+ * app.use(express.json());
+ *
+ * const meshApp = meshExpress(app, { name: "my-api", port: 3000 });
+ *
+ * app.post("/compute", mesh.route(
+ *   [{ capability: "calculator" }],
+ *   async (req, res, { calculator }) => {
+ *     const result = await calculator({ a: req.body.a, b: req.body.b });
+ *     res.json({ result });
+ *   }
+ * ));
+ *
+ * meshApp.start();
+ * ```
+ */
+import { mesh as meshFn, MeshAgent } from "./agent.js";
+import { route, routeWithConfig } from "./route.js";
+import { bindToExpress } from "./api-runtime.js";
+import { llm } from "./llm.js";
+import { llmProvider } from "./llm-provider.js";
+/**
+ * Main mesh function with route and llm helpers attached.
+ *
+ * - `mesh(server, config)` - Create an MCP agent (wraps fastmcp)
+ * - `mesh.route(deps, handler)` - Create Express route with DI
+ * - `mesh.bind(app, options)` - Bind to Express, introspect routes
+ * - `mesh.llm(config)` - Create LLM-powered tool with agentic loop
+ * - `mesh.llmProvider(config)` - Create zero-code LLM provider
+ */
+const mesh = Object.assign(meshFn, {
+    route,
+    routeWithConfig,
+    bind: bindToExpress,
+    llm,
+    llmProvider,
+});
+// Main API
+export { mesh, MeshAgent };
+// Re-export FastMCP for convenience (so users don't need to install it separately)
+export { FastMCP } from "fastmcp";
+// Express integration
+export { meshExpress, MeshExpress } from "./express.js";
+// API runtime (auto-init for Express routes)
+export { getApiRuntime, ApiRuntime, bindToExpress, introspectExpressRoutes, } from "./api-runtime.js";
+// Route utilities
+export { route, routeWithConfig, RouteRegistry, } from "./route.js";
+// Proxy utilities (for advanced use)
+export { createProxy, normalizeDependency } from "./proxy.js";
+// Tracing utilities (for advanced use)
+export { initTracing, isTracingAvailable, generateTraceId, generateSpanId, parseTraceContext, createTraceHeaders, publishTraceSpan, } from "./tracing.js";
+// LLM utilities
+export { llm, LlmToolRegistry, buildLlmAgentSpecs, handleLlmToolsUpdated, handleLlmProviderAvailable, handleLlmProviderUnavailable, getLlmToolMetadata, isLlmTool, } from "./llm.js";
+// LLM Agent
+export { MeshLlmAgent, LiteLLMProvider, MeshDelegatedProvider, createLlmToolProxy, } from "./llm-agent.js";
+// LLM Provider (Phase 4)
+export { llmProvider, extractVendorFromModel, extractModelName, isLlmProviderTool, getLlmProviderMeta, } from "./llm-provider.js";
+// Provider Handlers (Phase 4)
+export { ProviderHandlerRegistry, GenericHandler, ClaudeHandler, OpenAIHandler, } from "./provider-handlers/index.js";
+// Error classes
+export { MaxIterationsError, ToolExecutionError, LLMAPIError, ResponseParseError as LlmResponseParseError, ProviderUnavailableError, } from "./errors.js";
+// SSE utilities
+export { parseSSEResponse, isSSEResponse, parseSSEStream } from "./sse.js";
+// Debug utilities
+export { debug, createDebug, isAnyDebugEnabled } from "./debug.js";
+// Template utilities
+export { renderTemplate, clearTemplateCache, registerHelper, registerPartial, isFileTemplate, extractFilePath, } from "./template.js";
+// Response parser
+export { ResponseParser, createResponseParser, extractJson, zodSchemaToPromptDescription, formatZodError, } from "./response-parser.js";
+// Default export for convenience
+export default mesh;
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,OAAO,EAAE,IAAI,IAAI,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAehD;;;;;;;;GAQG;AACH,MAAM,IAAI,GAAkB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE;IAChD,KAAK;IACL,eAAe;IACf,IAAI,EAAE,aAAa;IACnB,GAAG;IACH,WAAW;CACZ,CAAC,CAAC;AAEH,WAAW;AACX,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAE3B,mFAAmF;AACnF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,sBAAsB;AACtB,OAAO,EAAE,WAAW,EAAE,WAAW,EAA0B,MAAM,cAAc,CAAC;AAEhF,6CAA6C;AAC7C,OAAO,EACL,aAAa,EACb,UAAU,EACV,aAAa,EACb,uBAAuB,GAExB,MAAM,kBAAkB,CAAC;AAE1B,kBAAkB;AAClB,OAAO,EACL,KAAK,EACL,eAAe,EACf,aAAa,GAMd,MAAM,YAAY,CAAC;AAEpB,qCAAqC;AACrC,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE9D,uCAAuC;AACvC,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,GAIjB,MAAM,cAAc,CAAC;AAEtB,gBAAgB;AAChB,OAAO,EACL,GAAG,EACH,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,0BAA0B,EAC1B,4BAA4B,EAC5B,kBAAkB,EAClB,SAAS,GAIV,MAAM,UAAU,CAAC;AAElB,YAAY;AACZ,OAAO,EACL,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,kBAAkB,GAInB,MAAM,gBAAgB,CAAC;AAExB,yBAAyB;AACzB,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,8BAA8B;AAC9B,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,aAAa,EACb,aAAa,GAQd,MAAM,8BAA8B,CAAC;AAEtC,gBAAgB;AAChB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,IAAI,qBAAqB,EAC3C,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAErB,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE3E,kBAAkB;AAClB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEnE,qBAAqB;AACrB,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,kBAAkB;AAClB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,WAAW,EACX,4BAA4B,EAC5B,cAAc,GACf,MAAM,sBAAsB,CAAC;AA+C9B,iCAAiC;AACjC,eAAe,IAAI,CAAC"}