@daniel.stefan/metalink 1.3.1

package/packages/core/dist/server/schema-validator.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Schema Validator for MCP Tool Schemas
+ *
+ * Validates tool input schemas and provides helpful hints for:
+ * - Missing required fields
+ * - Type mismatches
+ * - Invalid JSON Schema constructs
+ * - Best practices recommendations
+ */
+import type { Tool } from './types.js';
+import type { ToolInfo } from './manager.js';
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+    hints: string[];
+    suggestions?: string[];
+    inferredRequired?: string[];
+}
+export interface ValidationError {
+    field: string;
+    message: string;
+    severity: 'error';
+}
+export interface ValidationWarning {
+    field: string;
+    message: string;
+    severity: 'warning';
+}
+/**
+ * SchemaValidator - validates tool schemas and provides helpful feedback
+ */
+export declare class SchemaValidator {
+    /**
+     * Validate a tool's schema structure
+     * Works with both Tool and ToolInfo types
+     */
+    validateToolSchema(tool: Tool | ToolInfo): ValidationResult;
+    /**
+     * Validate an input schema structure
+     */
+    private validateInputSchema;
+    /**
+     * Validate input arguments against a schema
+     */
+    validateArguments(args: Record<string, unknown>, schema: unknown): {
+        valid: boolean;
+        errors: string[];
+    };
+}
+//# sourceMappingURL=schema-validator.d.ts.map

package/packages/core/dist/server/schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../src/server/schema-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B;;;OAGG;IACH,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,gBAAgB;IA+C3D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoH3B;;OAEG;IACH,iBAAiB,CACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE,OAAO,GACd;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;CA0CxC"}

package/packages/core/dist/server/schema-validator.js

@@ -0,0 +1,208 @@
+/**
+ * Schema Validator for MCP Tool Schemas
+ *
+ * Validates tool input schemas and provides helpful hints for:
+ * - Missing required fields
+ * - Type mismatches
+ * - Invalid JSON Schema constructs
+ * - Best practices recommendations
+ */
+/**
+ * SchemaValidator - validates tool schemas and provides helpful feedback
+ */
+export class SchemaValidator {
+    /**
+     * Validate a tool's schema structure
+     * Works with both Tool and ToolInfo types
+     */
+    validateToolSchema(tool) {
+        const errors = [];
+        const warnings = [];
+        const hints = [];
+        // Validate required fields
+        if (!tool.name || tool.name.trim() === '') {
+            errors.push({
+                field: 'name',
+                message: 'Tool name is required and cannot be empty',
+                severity: 'error',
+            });
+        }
+        if (!tool.description || tool.description.trim() === '') {
+            warnings.push({
+                field: 'description',
+                message: 'Tool description is missing or empty',
+                severity: 'warning',
+            });
+            hints.push('Add a clear description to help users understand what this tool does');
+        }
+        // Validate inputSchema if present (handle both input_schema and inputSchema)
+        const schema = 'input_schema' in tool ? tool.input_schema : tool.inputSchema;
+        if (schema) {
+            const schemaValidation = this.validateInputSchema(schema);
+            errors.push(...schemaValidation.errors);
+            warnings.push(...schemaValidation.warnings);
+            hints.push(...schemaValidation.hints);
+        }
+        else {
+            warnings.push({
+                field: 'input_schema',
+                message: 'No input schema defined',
+                severity: 'warning',
+            });
+            hints.push('Define an input schema to provide better validation and auto-completion');
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+            hints,
+        };
+    }
+    /**
+     * Validate an input schema structure
+     */
+    validateInputSchema(schema) {
+        const errors = [];
+        const warnings = [];
+        const hints = [];
+        if (typeof schema !== 'object' || schema === null) {
+            errors.push({
+                field: 'input_schema',
+                message: 'Input schema must be an object',
+                severity: 'error',
+            });
+            return { errors, warnings, hints };
+        }
+        const schemaObj = schema;
+        // Check for type field
+        if (!schemaObj.type) {
+            warnings.push({
+                field: 'input_schema.type',
+                message: 'Schema type is not defined',
+                severity: 'warning',
+            });
+            hints.push('Add "type": "object" to your input schema');
+        }
+        // Validate properties if present
+        if (schemaObj.properties) {
+            if (typeof schemaObj.properties !== 'object') {
+                errors.push({
+                    field: 'input_schema.properties',
+                    message: 'Properties must be an object',
+                    severity: 'error',
+                });
+            }
+            else {
+                const props = schemaObj.properties;
+                for (const [key, value] of Object.entries(props)) {
+                    if (typeof value !== 'object' || value === null) {
+                        errors.push({
+                            field: `input_schema.properties.${key}`,
+                            message: `Property "${key}" must be an object`,
+                            severity: 'error',
+                        });
+                        continue;
+                    }
+                    const prop = value;
+                    // Check for type
+                    if (!prop.type) {
+                        warnings.push({
+                            field: `input_schema.properties.${key}`,
+                            message: `Property "${key}" is missing a type`,
+                            severity: 'warning',
+                        });
+                    }
+                    // Check for description
+                    if (!prop.description) {
+                        warnings.push({
+                            field: `input_schema.properties.${key}`,
+                            message: `Property "${key}" is missing a description`,
+                            severity: 'warning',
+                        });
+                        hints.push(`Add a description for property "${key}" to improve usability`);
+                    }
+                    // Check for examples on required fields
+                    const required = schemaObj.required;
+                    if (required && required.includes(key) && !prop.example && !prop.default) {
+                        hints.push(`Consider adding an example or default value for required property "${key}"`);
+                    }
+                }
+            }
+        }
+        // Validate required array if present
+        if (schemaObj.required) {
+            if (!Array.isArray(schemaObj.required)) {
+                errors.push({
+                    field: 'input_schema.required',
+                    message: 'Required field must be an array',
+                    severity: 'error',
+                });
+            }
+            else {
+                const required = schemaObj.required;
+                const props = schemaObj.properties || {};
+                for (const field of required) {
+                    if (typeof field !== 'string') {
+                        errors.push({
+                            field: 'input_schema.required',
+                            message: 'Required array must contain only strings',
+                            severity: 'error',
+                        });
+                    }
+                    else if (!props[field]) {
+                        errors.push({
+                            field: 'input_schema.required',
+                            message: `Required field "${field}" is not defined in properties`,
+                            severity: 'error',
+                        });
+                    }
+                }
+            }
+        }
+        // Check for additionalProperties
+        if (schemaObj.additionalProperties === undefined) {
+            hints.push('Consider setting "additionalProperties": false for stricter validation');
+        }
+        return { errors, warnings, hints };
+    }
+    /**
+     * Validate input arguments against a schema
+     */
+    validateArguments(args, schema) {
+        const errors = [];
+        if (typeof schema !== 'object' || schema === null) {
+            return { valid: true, errors: [] };
+        }
+        const schemaObj = schema;
+        const required = schemaObj.required || [];
+        const properties = schemaObj.properties || {};
+        // Check required fields
+        for (const field of required) {
+            if (!(field in args)) {
+                errors.push(`Missing required field: ${field}`);
+            }
+        }
+        // Check field types
+        for (const [key, value] of Object.entries(args)) {
+            const propSchema = properties[key];
+            if (!propSchema) {
+                if (schemaObj.additionalProperties === false) {
+                    errors.push(`Unknown field: ${key}`);
+                }
+                continue;
+            }
+            const expectedType = propSchema.type;
+            if (expectedType) {
+                const actualType = Array.isArray(value) ? 'array' : typeof value;
+                if (expectedType !== actualType && !(value === null && expectedType === 'null')) {
+                    errors.push(`Field "${key}" has type ${actualType}, expected ${expectedType}`);
+                }
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+}
+//# sourceMappingURL=schema-validator.js.map

package/packages/core/dist/server/schema-validator.js.map

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

package/packages/core/dist/server/token-calculator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Token estimation utilities for MCP tools
+ *
+ * Provides rough token count estimates for tool definitions based on:
+ * - Tool name length
+ * - Description length
+ * - JSON schema complexity
+ *
+ * Estimation uses ~4 characters per token (conservative estimate)
+ */
+import type { Tool } from './types.js';
+import type { ToolInfo } from './manager.js';
+/**
+ * Estimate tokens for a single tool definition
+ *
+ * Formula:
+ * - Name tokens: ceil(name.length / 4)
+ * - Description tokens: ceil(description.length / 4)
+ * - Schema tokens: ceil(JSON.stringify(schema).length / 4)
+ *
+ * @param tool - MCP tool definition (Tool or ToolInfo)
+ * @returns Estimated token count (conservative estimate)
+ */
+export declare function estimateToolTokens(tool: Tool | ToolInfo): number;
+/**
+ * Calculate total tokens for a list of tools
+ *
+ * @param tools - Array of MCP tool definitions (Tool[] or ToolInfo[])
+ * @returns Total estimated token count
+ */
+export declare function calculateTotalTokens(tools: (Tool | ToolInfo)[]): number;
+/**
+ * Format token count with comma separators for readability
+ *
+ * Examples:
+ * - 1247 → "1,247"
+ * - 34630 → "34,630"
+ * - 120 → "120"
+ *
+ * @param tokens - Token count to format
+ * @returns Formatted string with comma separators
+ */
+export declare function formatTokens(tokens: number): string;
+//# sourceMappingURL=token-calculator.d.ts.map

package/packages/core/dist/server/token-calculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-calculator.d.ts","sourceRoot":"","sources":["../../src/server/token-calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,GAAG,MAAM,CAShE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,CAAC,IAAI,GAAG,QAAQ,CAAC,EAAE,GAAG,MAAM,CAEvE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/packages/core/dist/server/token-calculator.js

@@ -0,0 +1,53 @@
+/**
+ * Token estimation utilities for MCP tools
+ *
+ * Provides rough token count estimates for tool definitions based on:
+ * - Tool name length
+ * - Description length
+ * - JSON schema complexity
+ *
+ * Estimation uses ~4 characters per token (conservative estimate)
+ */
+/**
+ * Estimate tokens for a single tool definition
+ *
+ * Formula:
+ * - Name tokens: ceil(name.length / 4)
+ * - Description tokens: ceil(description.length / 4)
+ * - Schema tokens: ceil(JSON.stringify(schema).length / 4)
+ *
+ * @param tool - MCP tool definition (Tool or ToolInfo)
+ * @returns Estimated token count (conservative estimate)
+ */
+export function estimateToolTokens(tool) {
+    const nameTokens = Math.ceil(tool.name.length / 4); // ~4 chars per token
+    const descTokens = Math.ceil((tool.description || '').length / 4);
+    // Handle both input_schema (Tool) and inputSchema (ToolInfo)
+    const schema = 'input_schema' in tool ? tool.input_schema : tool.inputSchema;
+    const schemaTokens = Math.ceil(JSON.stringify(schema || {}).length / 4);
+    return nameTokens + descTokens + schemaTokens;
+}
+/**
+ * Calculate total tokens for a list of tools
+ *
+ * @param tools - Array of MCP tool definitions (Tool[] or ToolInfo[])
+ * @returns Total estimated token count
+ */
+export function calculateTotalTokens(tools) {
+    return tools.reduce((sum, tool) => sum + estimateToolTokens(tool), 0);
+}
+/**
+ * Format token count with comma separators for readability
+ *
+ * Examples:
+ * - 1247 → "1,247"
+ * - 34630 → "34,630"
+ * - 120 → "120"
+ *
+ * @param tokens - Token count to format
+ * @returns Formatted string with comma separators
+ */
+export function formatTokens(tokens) {
+    return tokens.toLocaleString('en-US');
+}
+//# sourceMappingURL=token-calculator.js.map

package/packages/core/dist/server/token-calculator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-calculator.js","sourceRoot":"","sources":["../../src/server/token-calculator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAqB;IACtD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,qBAAqB;IACzE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAElE,6DAA6D;IAC7D,MAAM,MAAM,GAAG,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAE,IAAiB,CAAC,WAAW,CAAC;IAC3F,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAExE,OAAO,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAA0B;IAC7D,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC"}

package/packages/core/dist/server/types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Server management types and interfaces
+ */
+export interface ServerProcess {
+    pid: number;
+    status: 'running' | 'stopped' | 'crashed';
+    uptime: number;
+    lastHealthCheck: number;
+    errorCount: number;
+}
+export interface ServerState {
+    [serverName: string]: ServerProcess;
+}
+export interface Tool {
+    name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+}
+export interface ServerInfo {
+    name: string;
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+    cwd?: string;
+    status: 'running' | 'stopped' | 'crashed';
+    process?: ServerProcess;
+    tools?: Tool[];
+}
+export interface ExecuteToolRequest {
+    serverName: string;
+    toolName: string;
+    arguments: Record<string, unknown>;
+}
+export interface ExecuteToolResponse {
+    success: boolean;
+    result?: unknown;
+    error?: string;
+}
+export interface HealthCheckResult {
+    serverName: string;
+    healthy: boolean;
+    error?: string;
+    timestamp: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/core/dist/server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAAC;CACrC;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1C,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/packages/core/dist/server/types.js

@@ -0,0 +1,5 @@
+/**
+ * Server management types and interfaces
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/core/dist/server/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/packages/core/dist/utils/file-lock.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Advisory file locking utility for atomic file operations.
+ * Ensures that concurrent writes to the same file don't cause corruption.
+ *
+ * Usage:
+ *   const lock = new FileLock('path/to/file.lock');
+ *   await lock.acquire(5000); // 5 second timeout
+ *   try {
+ *     // Perform atomic write operations
+ *     await fs.writeFile('target.json', data);
+ *   } finally {
+ *     await lock.release();
+ *   }
+ */
+export declare class FileLock {
+    private lockPath;
+    private lockFileHandle;
+    private lockTimeout;
+    private isLocked;
+    constructor(filePath: string);
+    /**
+     * Acquire lock with optional timeout.
+     * Throws if lock cannot be acquired within timeout period.
+     *
+     * @param timeoutMs - Maximum time to wait for lock (default: 5000ms)
+     * @throws Error if lock acquisition times out
+     */
+    acquire(timeoutMs?: number): Promise<void>;
+    /**
+     * Release the lock.
+     * Safe to call even if lock is not held.
+     */
+    release(): Promise<void>;
+    /**
+     * Check if lock is currently held by this instance.
+     */
+    isLockHeld(): boolean;
+    /**
+     * Get lock file path.
+     */
+    getLockPath(): string;
+    /**
+     * Register automatic cleanup on process exit.
+     * Ensures lock is released even if exception occurs.
+     */
+    private registerCleanup;
+}
+/**
+ * Helper function for atomic file operations with automatic lock management.
+ *
+ * Usage:
+ *   const result = await withFileLock('path/to/file.json', async () => {
+ *     // Perform operations with lock held
+ *     return await someAsyncOperation();
+ *   });
+ */
+export declare function withFileLock<T>(filePath: string, callback: () => Promise<T>, timeoutMs?: number): Promise<T>;
+/**
+ * Helper function for atomic file write with automatic lock management.
+ *
+ * Usage:
+ *   await atomicWrite('path/to/file.json', JSON.stringify(data, null, 2));
+ */
+export declare function atomicWrite(filePath: string, content: string, options?: {
+    timeout?: number;
+    createBackup?: boolean;
+}): Promise<void>;
+/**
+ * Restore file from backup.
+ * Useful for rollback on write failures.
+ */
+export declare function restoreFromBackup(filePath: string): Promise<void>;
+//# sourceMappingURL=file-lock.d.ts.map

package/packages/core/dist/utils/file-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-lock.d.ts","sourceRoot":"","sources":["../../src/utils/file-lock.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAK5B;;;;;;OAMG;IACG,OAAO,CAAC,SAAS,GAAE,MAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAwEtD;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC9B;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;;OAGG;IACH,OAAO,CAAC,eAAe;CA0BxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC1B,SAAS,GAAE,MAAa,GACvB,OAAO,CAAC,CAAC,CAAC,CASZ;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACzD,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBvE"}