@creatoria/miniapp-mcp 0.2.0 → 0.2.2

package/dist/capabilities/registry.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Centralized Tool Registry for MCP Server
+ *
+ * Provides unified tool registration, lookup, and validation.
+ * All capabilities register their tools through this registry.
+ */
+import type { ZodTypeAny } from 'zod';
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { SessionState } from '../types.js';
+/**
+ * Tool handler function signature
+ * Uses 'any' for args to allow typed handlers to be assigned
+ */
+export type ToolHandler = (session: SessionState, args: any) => Promise<any>;
+/**
+ * Complete tool definition including schema and handler
+ */
+export interface ToolDefinition {
+    /** Tool name (must be unique across all capabilities) */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** Capability category (automator, miniprogram, page, element, etc.) */
+    capability: string;
+    /** Zod schema for input validation */
+    inputSchema: ZodTypeAny;
+    /** Optional Zod schema for output validation */
+    outputSchema?: ZodTypeAny;
+    /** Handler function that executes the tool */
+    handler: ToolHandler;
+}
+/**
+ * Capability module that groups related tools
+ */
+export interface CapabilityModule {
+    /** Capability name */
+    name: string;
+    /** Human-readable description */
+    description: string;
+    /** List of tool definitions in this capability */
+    tools: ToolDefinition[];
+}
+/**
+ * Centralized Tool Registry
+ *
+ * Features:
+ * - Unique tool name enforcement
+ * - Capability-based organization
+ * - Schema and handler management
+ * - MCP Tool type conversion
+ */
+export declare class ToolRegistry {
+    private tools;
+    private capabilities;
+    /**
+     * Register a single tool definition
+     */
+    register(definition: ToolDefinition): void;
+    /**
+     * Register a complete capability module
+     */
+    registerCapability(module: CapabilityModule): void;
+    /**
+     * Get a tool definition by name
+     */
+    get(name: string): ToolDefinition | undefined;
+    /**
+     * Get handler for a tool
+     */
+    getHandler(name: string): ToolHandler | undefined;
+    /**
+     * Get all registered tool definitions
+     */
+    getAll(): ToolDefinition[];
+    /**
+     * Get tools by capability name
+     */
+    getByCapability(capabilityName: string): ToolDefinition[];
+    /**
+     * Get all registered capabilities
+     */
+    getCapabilities(): CapabilityModule[];
+    /**
+     * Check if a tool exists
+     */
+    has(name: string): boolean;
+    /**
+     * Get total number of registered tools
+     */
+    get size(): number;
+    /**
+     * JSON Schema type for MCP Tool inputSchema
+     */
+    private createJsonSchema;
+    /**
+     * Convert Zod schema to JSON Schema for MCP Tool format
+     */
+    private zodToJsonSchema;
+    /**
+     * Convert a single Zod field to JSON Schema
+     */
+    private zodFieldToJsonSchema;
+    /**
+     * Convert registered tools to MCP Tool format
+     */
+    toMCPTools(): Tool[];
+    /**
+     * Convert tools for specific capabilities to MCP Tool format
+     */
+    toMCPToolsForCapabilities(capabilityNames: string[]): Tool[];
+    /**
+     * Get handlers map for specific capabilities
+     */
+    getHandlersForCapabilities(capabilityNames: string[]): Map<string, ToolHandler>;
+    /**
+     * Get statistics about registered tools
+     */
+    getStats(): {
+        total: number;
+        byCapability: Record<string, number>;
+    };
+    /**
+     * Validate all registrations
+     */
+    validate(): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Clear all registrations (useful for testing)
+     */
+    clear(): void;
+}
+/**
+ * Global tool registry instance
+ */
+export declare const globalRegistry: ToolRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/capabilities/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/capabilities/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAA;AACrC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;AAE5E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAA;IAClB,sCAAsC;IACtC,WAAW,EAAE,UAAU,CAAA;IACvB,gDAAgD;IAChD,YAAY,CAAC,EAAE,UAAU,CAAA;IACzB,8CAA8C;IAC9C,OAAO,EAAE,WAAW,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,kDAAkD;IAClD,KAAK,EAAE,cAAc,EAAE,CAAA;CACxB;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,YAAY,CAAsC;IAE1D;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI;IAO1C;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAalD;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIjD;;OAEG;IACH,MAAM,IAAI,cAAc,EAAE;IAI1B;;OAEG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,cAAc,EAAE;IAIzD;;OAEG;IACH,eAAe,IAAI,gBAAgB,EAAE;IAIrC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,eAAe;IA+BvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA6C5B;;OAEG;IACH,UAAU,IAAI,IAAI,EAAE;IAQpB;;OAEG;IACH,yBAAyB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE;IAgB5D;;OAEG;IACH,0BAA0B,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC;IAqB/E;;OAEG;IACH,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAA;QACb,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KACrC;IAaD;;OAEG;IACH,QAAQ,IAAI;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAyBhD;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,cAAqB,CAAA"}

package/dist/capabilities/registry.js

@@ -0,0 +1,261 @@
+/**
+ * Centralized Tool Registry for MCP Server
+ *
+ * Provides unified tool registration, lookup, and validation.
+ * All capabilities register their tools through this registry.
+ */
+/**
+ * Centralized Tool Registry
+ *
+ * Features:
+ * - Unique tool name enforcement
+ * - Capability-based organization
+ * - Schema and handler management
+ * - MCP Tool type conversion
+ */
+export class ToolRegistry {
+    tools = new Map();
+    capabilities = new Map();
+    /**
+     * Register a single tool definition
+     */
+    register(definition) {
+        if (this.tools.has(definition.name)) {
+            throw new Error(`Duplicate tool registration: ${definition.name}`);
+        }
+        this.tools.set(definition.name, definition);
+    }
+    /**
+     * Register a complete capability module
+     */
+    registerCapability(module) {
+        if (this.capabilities.has(module.name)) {
+            throw new Error(`Duplicate capability registration: ${module.name}`);
+        }
+        this.capabilities.set(module.name, module);
+        // Register all tools from this capability
+        for (const tool of module.tools) {
+            this.register({ ...tool, capability: module.name });
+        }
+    }
+    /**
+     * Get a tool definition by name
+     */
+    get(name) {
+        return this.tools.get(name);
+    }
+    /**
+     * Get handler for a tool
+     */
+    getHandler(name) {
+        return this.tools.get(name)?.handler;
+    }
+    /**
+     * Get all registered tool definitions
+     */
+    getAll() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * Get tools by capability name
+     */
+    getByCapability(capabilityName) {
+        return Array.from(this.tools.values()).filter((t) => t.capability === capabilityName);
+    }
+    /**
+     * Get all registered capabilities
+     */
+    getCapabilities() {
+        return Array.from(this.capabilities.values());
+    }
+    /**
+     * Check if a tool exists
+     */
+    has(name) {
+        return this.tools.has(name);
+    }
+    /**
+     * Get total number of registered tools
+     */
+    get size() {
+        return this.tools.size;
+    }
+    /**
+     * JSON Schema type for MCP Tool inputSchema
+     */
+    createJsonSchema(properties = {}, required) {
+        return {
+            type: 'object',
+            properties,
+            ...(required && required.length > 0 ? { required } : {}),
+        };
+    }
+    /**
+     * Convert Zod schema to JSON Schema for MCP Tool format
+     */
+    zodToJsonSchema(schema) {
+        // Use zod-to-json-schema or manual conversion
+        // For now, use the shape if available
+        const zodSchema = schema;
+        if (zodSchema._def?.typeName === 'ZodObject') {
+            const shape = zodSchema._def.shape?.();
+            if (shape) {
+                const properties = {};
+                const required = [];
+                for (const [key, value] of Object.entries(shape)) {
+                    const fieldSchema = value;
+                    properties[key] = this.zodFieldToJsonSchema(fieldSchema);
+                    // Check if field is required (not optional)
+                    if (!fieldSchema.isOptional?.()) {
+                        required.push(key);
+                    }
+                }
+                return this.createJsonSchema(properties, required);
+            }
+        }
+        // Fallback for non-object schemas
+        return this.createJsonSchema({});
+    }
+    /**
+     * Convert a single Zod field to JSON Schema
+     */
+    zodFieldToJsonSchema(field) {
+        const typeName = field._def?.typeName;
+        // Handle optional wrapper
+        if (typeName === 'ZodOptional') {
+            return this.zodFieldToJsonSchema(field._def.innerType);
+        }
+        // Handle basic types
+        switch (typeName) {
+            case 'ZodString':
+                return {
+                    type: 'string',
+                    ...(field._def.description ? { description: field._def.description } : {}),
+                };
+            case 'ZodNumber':
+                return {
+                    type: 'number',
+                    ...(field._def.description ? { description: field._def.description } : {}),
+                };
+            case 'ZodBoolean':
+                return {
+                    type: 'boolean',
+                    ...(field._def.description ? { description: field._def.description } : {}),
+                };
+            case 'ZodArray':
+                return {
+                    type: 'array',
+                    items: this.zodFieldToJsonSchema(field._def.type),
+                    ...(field._def.description ? { description: field._def.description } : {}),
+                };
+            case 'ZodEnum':
+                return {
+                    type: 'string',
+                    enum: field._def.values,
+                    ...(field._def.description ? { description: field._def.description } : {}),
+                };
+            case 'ZodObject':
+                return this.zodToJsonSchema(field);
+            default:
+                // Default to any type
+                return { description: field._def?.description };
+        }
+    }
+    /**
+     * Convert registered tools to MCP Tool format
+     */
+    toMCPTools() {
+        return Array.from(this.tools.values()).map((def) => ({
+            name: def.name,
+            description: def.description,
+            inputSchema: this.zodToJsonSchema(def.inputSchema),
+        }));
+    }
+    /**
+     * Convert tools for specific capabilities to MCP Tool format
+     */
+    toMCPToolsForCapabilities(capabilityNames) {
+        // If 'core' is specified, return all tools
+        if (capabilityNames.includes('core')) {
+            return this.toMCPTools();
+        }
+        // Otherwise, filter by capability names
+        return Array.from(this.tools.values())
+            .filter((def) => capabilityNames.includes(def.capability))
+            .map((def) => ({
+            name: def.name,
+            description: def.description,
+            inputSchema: this.zodToJsonSchema(def.inputSchema),
+        }));
+    }
+    /**
+     * Get handlers map for specific capabilities
+     */
+    getHandlersForCapabilities(capabilityNames) {
+        const handlers = new Map();
+        // If 'core' is specified, return all handlers
+        if (capabilityNames.includes('core')) {
+            for (const [name, def] of this.tools) {
+                handlers.set(name, def.handler);
+            }
+            return handlers;
+        }
+        // Otherwise, filter by capability names
+        for (const [name, def] of this.tools) {
+            if (capabilityNames.includes(def.capability)) {
+                handlers.set(name, def.handler);
+            }
+        }
+        return handlers;
+    }
+    /**
+     * Get statistics about registered tools
+     */
+    getStats() {
+        const byCapability = {};
+        for (const def of this.tools.values()) {
+            byCapability[def.capability] = (byCapability[def.capability] || 0) + 1;
+        }
+        return {
+            total: this.tools.size,
+            byCapability,
+        };
+    }
+    /**
+     * Validate all registrations
+     */
+    validate() {
+        const errors = [];
+        for (const def of this.tools.values()) {
+            // Check required fields
+            if (!def.name) {
+                errors.push('Tool missing name');
+            }
+            if (!def.description) {
+                errors.push(`Tool ${def.name} missing description`);
+            }
+            if (!def.handler) {
+                errors.push(`Tool ${def.name} missing handler`);
+            }
+            if (!def.inputSchema) {
+                errors.push(`Tool ${def.name} missing inputSchema`);
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * Clear all registrations (useful for testing)
+     */
+    clear() {
+        this.tools.clear();
+        this.capabilities.clear();
+    }
+}
+/**
+ * Global tool registry instance
+ */
+export const globalRegistry = new ToolRegistry();
+//# sourceMappingURL=registry.js.map

package/dist/capabilities/registry.js.map

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

package/dist/capabilities/snapshot/handlers/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Snapshot handlers exports
+ *
+ * All 3 handlers are now independently implemented in this directory.
+ */
+export { snapshotPage, snapshotFull, snapshotElement, type SnapshotPageArgs, type SnapshotPageResult, type SnapshotFullArgs, type SnapshotFullResult, type SnapshotElementArgs, type SnapshotElementResult, } from './snapshot-handlers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/capabilities/snapshot/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/snapshot/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAA"}

package/dist/capabilities/snapshot/handlers/index.js

@@ -0,0 +1,7 @@
+/**
+ * Snapshot handlers exports
+ *
+ * All 3 handlers are now independently implemented in this directory.
+ */
+export { snapshotPage, snapshotFull, snapshotElement, } from './snapshot-handlers.js';
+//# sourceMappingURL=index.js.map

package/dist/capabilities/snapshot/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/capabilities/snapshot/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,GAOhB,MAAM,wBAAwB,CAAA"}

package/dist/capabilities/snapshot/handlers/snapshot-handlers.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Snapshot handlers - State capture and diagnostic utilities
+ */
+import type { SessionState } from '../../../types.js';
+export interface SnapshotPageArgs {
+    pagePath?: string;
+    filename?: string;
+    includeScreenshot?: boolean;
+    fullPage?: boolean;
+}
+export interface SnapshotPageResult {
+    success: boolean;
+    message: string;
+    snapshotPath: string;
+    screenshotPath?: string;
+    data: {
+        timestamp: string;
+        pagePath: string;
+        pageData: any;
+        pageQuery: Record<string, any>;
+    };
+}
+export declare function snapshotPage(session: SessionState, args: SnapshotPageArgs): Promise<SnapshotPageResult>;
+export interface SnapshotFullArgs {
+    filename?: string;
+    includeScreenshot?: boolean;
+    fullPage?: boolean;
+}
+export interface SnapshotFullResult {
+    success: boolean;
+    message: string;
+    snapshotPath: string;
+    screenshotPath?: string;
+    data: {
+        timestamp: string;
+        systemInfo: any;
+        pageStack: Array<{
+            path: string;
+            query: Record<string, any>;
+        }>;
+        currentPage: {
+            path: string;
+            query: Record<string, any>;
+            data: any;
+        };
+    };
+}
+export declare function snapshotFull(session: SessionState, args: SnapshotFullArgs): Promise<SnapshotFullResult>;
+export interface SnapshotElementArgs {
+    refId: string;
+    filename?: string;
+    includeScreenshot?: boolean;
+}
+export interface SnapshotElementResult {
+    success: boolean;
+    message: string;
+    snapshotPath: string;
+    screenshotPath?: string;
+    data: {
+        timestamp: string;
+        refId: string;
+        text?: string;
+        attributes: Record<string, any>;
+        size: {
+            width: number;
+            height: number;
+        } | null;
+        offset: {
+            left: number;
+            top: number;
+        } | null;
+    };
+}
+export declare function snapshotElement(session: SessionState, args: SnapshotElementArgs): Promise<SnapshotElementResult>;
+//# sourceMappingURL=snapshot-handlers.d.ts.map

package/dist/capabilities/snapshot/handlers/snapshot-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-handlers.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/snapshot/handlers/snapshot-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AASrD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAA;QACjB,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE,GAAG,CAAA;QACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAC/B,CAAA;CACF;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA2E7G;AAMD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAA;QACjB,UAAU,EAAE,GAAG,CAAA;QACf,SAAS,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;SAAE,CAAC,CAAA;QAC9D,WAAW,EAAE;YACX,IAAI,EAAE,MAAM,CAAA;YACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;YAC1B,IAAI,EAAE,GAAG,CAAA;SACV,CAAA;KACF,CAAA;CACF;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAgF7G;AAMD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAA;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QAC/B,IAAI,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;QAC9C,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;KAC7C,CAAA;CACF;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA+EtH"}