@modyo/mcp 0.1.0

package/build/shared/McpServerBase.js

@@ -0,0 +1,175 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { LoggingLevelSchema, SetLevelRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { singlePlatformProvider } from "./providers/SinglePlatformProvider.js";
+export class McpServerBase {
+    #loggingLevel = LoggingLevelSchema.enum.info;
+    #mcpServer;
+    #capabilities = {};
+    #showDeprecated = false;
+    #debugMode = false;
+    constructor() {
+        // Read show deprecated flag from environment variable, default to false
+        this.#showDeprecated = process.env.MODYO_SHOW_DEPRECATED === "true";
+        // Enable debug mode to always log to stderr
+        this.#debugMode = process.env.DEBUG === "true" || process.env.DEBUG === "1";
+    }
+    setupCapabilities() {
+        if (this.prompts.length) {
+            this.#capabilities.prompts = {};
+        }
+        if (this.tools.length) {
+            this.#capabilities.tools = {};
+        }
+        if (this.resources.length) {
+            this.#capabilities.resources = {};
+        }
+        this.#capabilities.logging = {};
+    }
+    setupLoggingHandlers() {
+        this.server?.setRequestHandler(SetLevelRequestSchema, async (request) => {
+            this.#loggingLevel = request.params.level;
+            await this.server?.notification({
+                method: "notifications/message",
+                params: {
+                    level: "debug",
+                    logger: this.name,
+                    data: `Logging level set to: ${this.#loggingLevel}`,
+                },
+            });
+            return {};
+        });
+    }
+    async run() {
+        await this.loadOrganizations();
+        this.setupCapabilities();
+        const fullInstructions = `${this.description}\n\n${this.instructions}`;
+        this.log(fullInstructions);
+        this.log(`Tools available: ${this.availableTools.length}`, {
+            totalTools: this.tools.length,
+            availableTools: this.availableTools.length,
+            showDeprecated: this.#showDeprecated,
+        }, LoggingLevelSchema.enum.info);
+        if (this.#showDeprecated) {
+            this.log("MODYO_SHOW_DEPRECATED=true: Deprecated tools are visible", null, LoggingLevelSchema.enum.warning);
+        }
+        this.#mcpServer = new McpServer({
+            name: this.name,
+            version: this.version,
+        }, {
+            capabilities: this.#capabilities,
+            instructions: fullInstructions,
+        });
+        await this.setupResources();
+        this.setupTools();
+        this.setupPrompts();
+        this.setupLoggingHandlers();
+        // Use stdio transport for local MCP communication
+        const transport = new StdioServerTransport();
+        await this.#mcpServer.connect(transport);
+        this.log("Server initialized successfully (stdio mode)");
+    }
+    get server() {
+        return this.#mcpServer?.server;
+    }
+    get McpServer() {
+        if (!this.#mcpServer) {
+            throw new Error("Register a server before get It");
+        }
+        return this.#mcpServer;
+    }
+    get hasPrivateConfig() {
+        return singlePlatformProvider.isConfigured();
+    }
+    get availableTools() {
+        let filtered = this.hasPrivateConfig
+            ? this.tools
+            : this.tools.filter((tool) => tool.isPublic);
+        // Filter out deprecated tools unless MODYO_SHOW_DEPRECATED=true
+        if (!this.#showDeprecated) {
+            filtered = filtered.filter((tool) => !tool.isDeprecated);
+        }
+        return filtered;
+    }
+    get availablePrompts() {
+        let filtered = this.hasPrivateConfig
+            ? this.prompts
+            : this.prompts.filter((prompt) => prompt.isPublic);
+        // Filter out deprecated prompts unless MODYO_SHOW_DEPRECATED=true
+        if (!this.#showDeprecated) {
+            filtered = filtered.filter((prompt) => !prompt.isDeprecated);
+        }
+        return filtered;
+    }
+    get availableResources() {
+        let filtered = this.hasPrivateConfig
+            ? this.resources
+            : this.resources.filter((resource) => resource.isPublic);
+        // Filter out deprecated resources unless MODYO_SHOW_DEPRECATED=true
+        if (!this.#showDeprecated) {
+            filtered = filtered.filter((resource) => !resource.isDeprecated);
+        }
+        return filtered;
+    }
+    log(message, data, type = LoggingLevelSchema.enum.info) {
+        // In debug mode, always log to stderr
+        if (this.#debugMode) {
+            const timestamp = new Date().toISOString();
+            console.error(`[${timestamp}] [${type.toUpperCase()}] ${message}`, data ?? "");
+        }
+        if (!this.#mcpServer?.isConnected()) {
+            // Only log to stderr if not in debug mode (avoid duplicate logs)
+            if (!this.#debugMode) {
+                console.error({
+                    type,
+                    message,
+                    data,
+                });
+            }
+        }
+        else {
+            this.server?.sendLoggingMessage({
+                level: type,
+                data: data !== undefined
+                    ? {
+                        message,
+                        ...(typeof data === "object" && data !== null
+                            ? data
+                            : {
+                                value: data,
+                            }),
+                    }
+                    : message,
+            });
+        }
+    }
+    async loadOrganizations() {
+        // Check if platform is configured from environment variables
+        const platform = singlePlatformProvider.getPlatform();
+        if (!platform) {
+            this.log("No platform configured. Set MODYO_URL and MODYO_TOKEN environment variables.", null, LoggingLevelSchema.enum.warning);
+        }
+        else {
+            this.log(`Platform configured: ${platform.name}`, {
+                url: platform.url,
+                tokenLength: platform.token.length,
+            }, LoggingLevelSchema.enum.info);
+        }
+    }
+    setupTools() {
+        for (const tool of this.availableTools) {
+            tool.registerTool(this.#mcpServer, this.name, this.log.bind(this));
+        }
+    }
+    setupPrompts() {
+        for (const prompt of this.availablePrompts) {
+            prompt.registerPrompt(this.#mcpServer, this.log.bind(this));
+        }
+    }
+    async setupResources() {
+        for (const resource of this.availableResources) {
+            await resource.registerResource(this.#mcpServer, this.log.bind(this));
+        }
+    }
+}
+//# sourceMappingURL=McpServerBase.js.map

package/build/shared/McpServerBase.js.map

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

package/build/shared/PromptBase.d.ts

@@ -0,0 +1,113 @@
+import type { GetPromptResult } from "@modelcontextprotocol/sdk/types.js";
+import type { z } from "zod";
+import type { Logger } from "./types/Logger.js";
+/**
+ * Prompt configuration metadata
+ */
+export interface PromptConfig {
+    /** Unique prompt identifier (e.g., "modyo-alias-config") */
+    name: string;
+    /** Human-readable description of what the prompt does */
+    description: string;
+    /** Whether this prompt is available without authentication */
+    isPublic?: boolean;
+    /** If true, catches errors and returns them in messages instead of throwing */
+    catchErrors?: boolean;
+}
+/**
+ * Abstract base class for MCP prompts
+ *
+ * Provides a structured, class-based approach to creating prompts with:
+ * - Type-safe parameter validation via Zod schemas
+ * - Consistent error handling patterns
+ * - Logging integration
+ * - Organization access helpers
+ *
+ * @example
+ * ```typescript
+ * class GreetingPrompt extends PromptBase<{ name: string }> {
+ *   protected config: PromptConfig = {
+ *     name: "modyo-greeting",
+ *     description: "Generate a greeting message",
+ *     isPublic: false
+ *   };
+ *
+ *   protected getParamsSchema() {
+ *     return z.object({
+ *       name: z.string().min(2).max(100).describe("User name"),
+ *     });
+ *   }
+ *
+ *   async generate(params: { name: string }): Promise<GetPromptResult> {
+ *     return this.success(`Hello ${params.name}, welcome to Modyo!`);
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class PromptBase<TParams = unknown> {
+    protected server: any;
+    protected logger: Logger;
+    /**
+     * Prompt configuration - must be defined by subclasses
+     */
+    protected abstract config: PromptConfig;
+    /**
+     * Returns the Zod schema for validating prompt arguments
+     * Override to provide custom validation
+     */
+    protected abstract getParamsSchema(): z.ZodType<TParams>;
+    /**
+     * Generates the prompt messages
+     * @param params - Validated parameters
+     * @returns MCP GetPromptResult with messages array
+     */
+    protected abstract generate(params: TParams): Promise<GetPromptResult>;
+    /**
+     * Initializes the prompt with MCP server context
+     * Called automatically during registration
+     */
+    private initialize;
+    /**
+     * Registers this prompt with the MCP server
+     * Called by McpServerBase during setup
+     */
+    registerPrompt(server: any, logger: Logger): void;
+    /**
+     * Returns whether this prompt requires authentication
+     */
+    get isPublic(): boolean;
+    /**
+     * Helper: Creates a success response with a simple text message
+     */
+    protected success(text: string, role?: "user" | "assistant"): GetPromptResult;
+    /**
+     * Helper: Creates a multi-message response
+     */
+    protected messages(messages: Array<{
+        role: "user" | "assistant";
+        text: string;
+    }>): GetPromptResult;
+    /**
+     * Helper: Formats error response as prompt messages
+     * Returns a properly formatted error response without throwing
+     */
+    protected errorResponse(error: unknown, context?: Record<string, unknown>): GetPromptResult;
+    /**
+     * Helper: Logs debug information
+     */
+    protected debug(message: string, data?: unknown): void;
+    /**
+     * Helper: Logs info
+     */
+    protected info(message: string, data?: unknown): void;
+    /**
+     * Helper: Logs error
+     */
+    protected logError(message: string, data?: unknown): void;
+    /**
+     * Extracts raw schema shape for MCP registration
+     * Handles Zod object schemas
+     */
+    private extractRawSchema;
+}
+//# sourceMappingURL=PromptBase.d.ts.map

package/build/shared/PromptBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptBase.d.ts","sourceRoot":"","sources":["../../src/shared/PromptBase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,8BAAsB,UAAU,CAAC,OAAO,GAAG,OAAO;IAChD,SAAS,CAAC,MAAM,EAAG,GAAG,CAAC;IACvB,SAAS,CAAC,MAAM,EAAG,MAAM,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAExC;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IAExD;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAEtE;;;OAGG;IACH,OAAO,CAAC,UAAU;IAKlB;;;OAGG;IACI,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAuCxD;;OAEG;IACH,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED;;OAEG;IACH,SAAS,CAAC,OAAO,CACf,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,GAAG,WAAoB,GAClC,eAAe;IAclB;;OAEG;IACH,SAAS,CAAC,QAAQ,CAChB,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAC3B,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,GACD,eAAe;IAYlB;;;OAGG;IACH,SAAS,CAAC,aAAa,CACrB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,eAAe;IA2BlB;;OAEG;IACH,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAItD;;OAEG;IACH,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAIrD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAIzD;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CAQzB"}

package/build/shared/PromptBase.js

@@ -0,0 +1,169 @@
+/**
+ * Abstract base class for MCP prompts
+ *
+ * Provides a structured, class-based approach to creating prompts with:
+ * - Type-safe parameter validation via Zod schemas
+ * - Consistent error handling patterns
+ * - Logging integration
+ * - Organization access helpers
+ *
+ * @example
+ * ```typescript
+ * class GreetingPrompt extends PromptBase<{ name: string }> {
+ *   protected config: PromptConfig = {
+ *     name: "modyo-greeting",
+ *     description: "Generate a greeting message",
+ *     isPublic: false
+ *   };
+ *
+ *   protected getParamsSchema() {
+ *     return z.object({
+ *       name: z.string().min(2).max(100).describe("User name"),
+ *     });
+ *   }
+ *
+ *   async generate(params: { name: string }): Promise<GetPromptResult> {
+ *     return this.success(`Hello ${params.name}, welcome to Modyo!`);
+ *   }
+ * }
+ * ```
+ */
+export class PromptBase {
+    server;
+    logger;
+    /**
+     * Initializes the prompt with MCP server context
+     * Called automatically during registration
+     */
+    initialize(server, logger) {
+        this.server = server;
+        this.logger = logger;
+    }
+    /**
+     * Registers this prompt with the MCP server
+     * Called by McpServerBase during setup
+     */
+    registerPrompt(server, logger) {
+        this.initialize(server, logger);
+        const schema = this.getParamsSchema();
+        const rawInputSchema = this.extractRawSchema(schema);
+        server.registerPrompt(this.config.name, {
+            description: this.config.description,
+            argsSchema: rawInputSchema,
+        }, async (params) => {
+            try {
+                const validatedParams = schema.parse(params);
+                return await this.generate(validatedParams);
+            }
+            catch (error) {
+                // If catchErrors is enabled, return error as message
+                if (this.config.catchErrors) {
+                    return this.errorResponse(error, {
+                        params,
+                    });
+                }
+                // Otherwise, log and re-throw (default behavior)
+                this.logger(`Prompt ${this.config.name} failed`, {
+                    params,
+                    error,
+                }, "error");
+                throw error;
+            }
+        });
+    }
+    /**
+     * Returns whether this prompt requires authentication
+     */
+    get isPublic() {
+        return this.config.isPublic ?? false;
+    }
+    /**
+     * Helper: Creates a success response with a simple text message
+     */
+    success(text, role = "user") {
+        return {
+            messages: [
+                {
+                    role,
+                    content: {
+                        type: "text",
+                        text,
+                    },
+                },
+            ],
+        };
+    }
+    /**
+     * Helper: Creates a multi-message response
+     */
+    messages(messages) {
+        return {
+            messages: messages.map((msg) => ({
+                role: msg.role,
+                content: {
+                    type: "text",
+                    text: msg.text,
+                },
+            })),
+        };
+    }
+    /**
+     * Helper: Formats error response as prompt messages
+     * Returns a properly formatted error response without throwing
+     */
+    errorResponse(error, context) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorDetails = {
+            error: errorMessage,
+            ...(error instanceof Error && error.stack
+                ? {
+                    stack: error.stack,
+                }
+                : {}),
+            ...context,
+        };
+        this.logger("Prompt generation failed", errorDetails, "error");
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: `Error generating prompt: ${errorMessage}\n\nDetails:\n${JSON.stringify(errorDetails, null, 2)}`,
+                    },
+                },
+            ],
+        };
+    }
+    /**
+     * Helper: Logs debug information
+     */
+    debug(message, data) {
+        this.logger(message, data, "debug");
+    }
+    /**
+     * Helper: Logs info
+     */
+    info(message, data) {
+        this.logger(message, data, "info");
+    }
+    /**
+     * Helper: Logs error
+     */
+    logError(message, data) {
+        this.logger(message, data, "error");
+    }
+    /**
+     * Extracts raw schema shape for MCP registration
+     * Handles Zod object schemas
+     */
+    extractRawSchema(schema) {
+        // For ZodObject, extract the shape
+        if ("shape" in schema && typeof schema.shape === "object") {
+            return schema.shape;
+        }
+        // Fallback: return empty object (MCP will infer from runtime)
+        return {};
+    }
+}
+//# sourceMappingURL=PromptBase.js.map

package/build/shared/PromptBase.js.map

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

package/build/shared/ResourceBase.d.ts

@@ -0,0 +1,160 @@
+import type { ReadResourceResult } from "@modelcontextprotocol/sdk/types.js";
+import type { z } from "zod";
+import type { Logger } from "./types/Logger.js";
+/**
+ * Resource configuration metadata
+ */
+export interface ResourceConfig {
+    /** Unique resource identifier (e.g., "modyo-spaces-list") */
+    name: string;
+    /** URI template for the resource (e.g., "modyo-spaces://list") */
+    uriTemplate: string;
+    /** Human-readable description of what the resource provides */
+    description: string;
+    /** MIME type of the resource content (e.g., "application/json", "text/markdown") */
+    mimeType?: string;
+    /** MCP annotations for the resource */
+    annotations?: {
+        readOnlyHint?: boolean;
+        idempotentHint?: boolean;
+        destructiveHint?: boolean;
+    };
+    /** Whether this resource is available without authentication */
+    isPublic?: boolean;
+    /** If true, catches errors and returns them in content instead of throwing */
+    catchErrors?: boolean;
+}
+/**
+ * Abstract base class for MCP resources
+ *
+ * Provides a structured, class-based approach to creating resources with:
+ * - Type-safe parameter validation via Zod schemas
+ * - Consistent error handling patterns
+ * - Logging integration
+ * - Repository access helpers
+ * - Support for both dynamic (API-based) and static (file-based) resources
+ *
+ * @example Dynamic Resource (API Data)
+ * ```typescript
+ * class ListSpacesResource extends ResourceBase<{ spaceId: number }> {
+ *   protected config: ResourceConfig = {
+ *     name: "modyo-spaces-list",
+ *     uriTemplate: "modyo-spaces://{spaceId}",
+ *     description: "Fetches spaces from Modyo platform",
+ *     mimeType: "application/json",
+ *     annotations: { readOnlyHint: true }
+ *   };
+ *
+ *   protected getParamsSchema() {
+ *     return z.object({ spaceId: z.number() });
+ *   }
+ *
+ *   async read(uri: URL, params: { spaceId: number }): Promise<ReadResourceResult> {
+ *     const repo = await this.getRepository(SpacesRepository);
+ *     const response = await repo.getSpace(params.spaceId);
+ *     return this.success(uri, response);
+ *   }
+ * }
+ * ```
+ *
+ * @example Static Resource (File Content)
+ * ```typescript
+ * class DocResource extends ResourceBase<void> {
+ *   protected config: ResourceConfig = {
+ *     name: "docs-site-create",
+ *     uriTemplate: "docs://tools/site-create",  // No parameters
+ *     description: "Documentation for site-create tool",
+ *     mimeType: "text/markdown",
+ *     annotations: { readOnlyHint: true }
+ *   };
+ *
+ *   protected getParamsSchema() {
+ *     return z.void();  // No parameters
+ *   }
+ *
+ *   async read(uri: URL): Promise<ReadResourceResult> {
+ *     const content = readFileSync("docs/site-create.md", "utf-8");
+ *     return this.successText(uri, content, "text/markdown");
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class ResourceBase<TParams = unknown> {
+    protected server: any;
+    protected logger: Logger;
+    /**
+     * Resource configuration - must be defined by subclasses
+     */
+    protected abstract config: ResourceConfig;
+    /**
+     * Returns the Zod schema for validating resource parameters
+     * Override to provide custom validation
+     *
+     * For static resources with no parameters, return z.void()
+     */
+    protected abstract getParamsSchema(): z.ZodType<TParams>;
+    /**
+     * Reads and returns the resource content
+     * @param uri - The resource URI that was requested
+     * @param params - Validated parameters (may be void for static resources)
+     * @returns MCP ReadResourceResult
+     */
+    protected abstract read(uri: URL, params: TParams): Promise<ReadResourceResult>;
+    /**
+     * Initializes the resource with MCP server context
+     * Called automatically during registration
+     */
+    private initialize;
+    /**
+     * Registers this resource with the MCP server
+     * Called by McpServerBase during setup
+     * Can be overridden by subclasses to support async initialization (e.g., filesystem discovery)
+     */
+    registerResource(server: any, logger: Logger): void | Promise<void>;
+    /**
+     * Returns whether this resource requires authentication
+     */
+    get isPublic(): boolean;
+    /**
+     * Helper: Gets a repository instance using the configured platform
+     * Uses SinglePlatformProvider to get platform config from environment variables
+     *
+     * @param RepositoryClass - Repository constructor
+     * @returns Repository instance
+     * @throws Error if platform not configured
+     */
+    protected getRepository<T>(RepositoryClass: new (url: string, token: string, logger: Logger) => T): Promise<T>;
+    /**
+     * Helper: Formats successful JSON response
+     * Use for API-based resources that return JSON data
+     */
+    protected success(uri: URL, data: unknown): ReadResourceResult;
+    /**
+     * Helper: Formats successful text response
+     * Use for file-based resources like markdown docs
+     */
+    protected successText(uri: URL, text: string, mimeType?: string): ReadResourceResult;
+    /**
+     * Helper: Formats error response as resource content
+     * Returns a properly formatted error response without throwing
+     */
+    protected errorResponse(uri: URL, error: unknown, context?: Record<string, unknown>): ReadResourceResult;
+    /**
+     * Helper: Logs debug information
+     */
+    protected debug(message: string, data?: unknown): void;
+    /**
+     * Helper: Logs info
+     */
+    protected info(message: string, data?: unknown): void;
+    /**
+     * Helper: Logs error
+     */
+    protected logError(message: string, data?: unknown): void;
+    /**
+     * Extracts raw schema shape for MCP registration
+     * Handles Zod object schemas
+     */
+    private extractRawSchema;
+}
+//# sourceMappingURL=ResourceBase.d.ts.map

package/build/shared/ResourceBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceBase.d.ts","sourceRoot":"","sources":["../../src/shared/ResourceBase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,WAAW,CAAC,EAAE;QACZ,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;IACF,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,8BAAsB,YAAY,CAAC,OAAO,GAAG,OAAO;IAClD,SAAS,CAAC,MAAM,EAAG,GAAG,CAAC;IACvB,SAAS,CAAC,MAAM,EAAG,MAAM,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAE1C;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,eAAe,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IAExD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,CAAC,IAAI,CACrB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,kBAAkB,CAAC;IAE9B;;;OAGG;IACH,OAAO,CAAC,UAAU;IAKlB;;;;OAIG;IACI,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAgF1E;;OAEG;IACH,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED;;;;;;;OAOG;cACa,aAAa,CAAC,CAAC,EAC7B,eAAe,EAAE,KAAK,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC,GACrE,OAAO,CAAC,CAAC,CAAC;IAIb;;;OAGG;IACH,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,GAAG,kBAAkB;IAY9D;;;OAGG;IACH,SAAS,CAAC,WAAW,CACnB,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GAChB,kBAAkB;IAYrB;;;OAGG;IACH,SAAS,CAAC,aAAa,CACrB,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,kBAAkB;IAyBrB;;OAEG;IACH,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAItD;;OAEG;IACH,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAIrD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAIzD;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CAQzB"}