@robota-sdk/agent-core 3.0.0-beta.32 → 3.0.0-beta.34

package/dist/tools/implementations/openapi-tool.js

@@ -1,324 +0,0 @@
-import { AbstractTool } from '../../abstracts/abstract-tool';
-import { ToolExecutionError, ValidationError } from '../../utils/errors';
-/**
- * OpenAPI tool implementation
- * Executes API calls based on OpenAPI 3.0 specifications
- *
- * @extends AbstractTool<ToolParameters, ToolResult>
- */
-export class OpenAPITool extends AbstractTool {
-    schema;
-    apiSpec;
-    operationId;
-    baseURL;
-    config;
-    constructor(config, options = {}) {
-        super(options);
-        this.config = config;
-        this.apiSpec = config.spec;
-        this.operationId = config.operationId;
-        this.baseURL = config.baseURL;
-        this.schema = this.createSchemaFromOpenAPI();
-    }
-    /**
-     * Execute the OpenAPI tool implementation
-     * This method is called by the parent's Template Method Pattern
-     */
-    async executeImpl(parameters, context) {
-        const toolName = this.schema.name;
-        try {
-            // Validate parameters
-            const validation = this.validateParameters(parameters);
-            if (!validation.isValid) {
-                throw new ValidationError(`Invalid parameters for OpenAPI tool "${toolName}": ${validation.errors.join(', ')}`);
-            }
-            this.logger.debug(`Executing OpenAPI tool "${toolName}"`, {
-                toolName,
-                operationId: this.operationId,
-                baseURL: this.baseURL,
-                parametersCount: Object.keys(parameters).length
-            });
-            // Execute the API call
-            const startTime = Date.now();
-            const result = await this.executeAPICall(parameters, context);
-            const executionTime = Date.now() - startTime;
-            this.logger.debug(`OpenAPI tool "${toolName}" executed successfully`, {
-                toolName,
-                executionTime,
-                resultType: typeof result
-            });
-            return {
-                success: true,
-                data: result,
-                metadata: {
-                    executionTime,
-                    toolName,
-                    operationId: this.operationId,
-                    baseURL: this.baseURL
-                }
-            };
-        }
-        catch (error) {
-            const safeError = error instanceof Error ? error : new Error(String(error));
-            this.logger.error(`OpenAPI tool "${toolName}" execution failed`, {
-                toolName,
-                operationId: this.operationId,
-                error: safeError,
-                parameters
-            });
-            if (error instanceof ToolExecutionError || error instanceof ValidationError) {
-                throw error;
-            }
-            throw new ToolExecutionError(`OpenAPI tool execution failed: ${safeError.message}`, toolName, safeError, {
-                operationId: this.operationId,
-                baseURL: this.baseURL,
-                parametersCount: Object.keys(parameters).length
-            });
-        }
-    }
-    /**
-     * Execute the actual API call
-     * @private
-     */
-    async executeAPICall(parameters, _context) {
-        // Find the operation in the OpenAPI spec
-        const operation = this.findOperation();
-        if (!operation) {
-            throw new Error(`Operation ${this.operationId} not found in OpenAPI spec`);
-        }
-        // Build the HTTP request
-        const requestConfig = this.buildRequestConfig(operation, parameters);
-        // TODO: Implement actual HTTP request execution
-        // This would typically use fetch() or axios
-        const result = {
-            message: `OpenAPI tool "${this.schema.name}" executed`,
-            operationId: this.operationId,
-            method: requestConfig.method,
-            url: requestConfig.url,
-            parameters,
-            timestamp: new Date().toISOString()
-        };
-        return result;
-    }
-    /**
-     * Find the operation in the OpenAPI specification
-     */
-    findOperation() {
-        for (const [path, pathItem] of Object.entries(this.apiSpec.paths || {})) {
-            if (!pathItem)
-                continue;
-            for (const method of ['get', 'post', 'put', 'delete', 'patch', 'head', 'options']) {
-                const operation = pathItem[method];
-                if (operation?.operationId === this.operationId) {
-                    return { method, path, operation };
-                }
-            }
-        }
-        return null;
-    }
-    /**
-     * Build HTTP request configuration from OpenAPI operation and parameters
-     */
-    buildRequestConfig(opInfo, parameters) {
-        const { method, path, operation } = opInfo;
-        let url = this.baseURL + path;
-        const headers = {};
-        let body;
-        // Process parameters based on their location
-        const params = operation.parameters || [];
-        for (const param of params) {
-            const value = parameters[param.name];
-            if (value === undefined && param.required) {
-                throw new Error(`Required parameter ${param.name} is missing`);
-            }
-            if (value !== undefined) {
-                switch (param.in) {
-                    case 'path':
-                        url = url.replace(`{${param.name}}`, String(value));
-                        break;
-                    case 'query': {
-                        const separator = url.includes('?') ? '&' : '?';
-                        url += `${separator}${param.name}=${encodeURIComponent(String(value))}`;
-                        break;
-                    }
-                    case 'header':
-                        headers[param.name] = String(value);
-                        break;
-                }
-            }
-        }
-        // Handle request body for POST/PUT/PATCH operations
-        if (['post', 'put', 'patch'].includes(method) && operation.requestBody) {
-            const requestBody = operation.requestBody;
-            const jsonContent = requestBody.content?.['application/json'];
-            if (jsonContent) {
-                headers['Content-Type'] = 'application/json';
-                // Extract body parameters (those not in path/query/header)
-                const bodyParams = {};
-                for (const [key, value] of Object.entries(parameters)) {
-                    const isParamUsed = params.some(p => p.name === key);
-                    if (!isParamUsed) {
-                        bodyParams[key] = value;
-                    }
-                }
-                body = JSON.stringify(bodyParams);
-            }
-        }
-        // Add authentication headers if configured
-        if (this.config.auth) {
-            switch (this.config.auth.type) {
-                case 'bearer':
-                    headers['Authorization'] = `Bearer ${this.config.auth.token}`;
-                    break;
-                case 'apiKey': {
-                    const headerName = this.config.auth.header || 'X-API-Key';
-                    headers[headerName] = this.config.auth.apiKey || '';
-                    break;
-                }
-            }
-        }
-        const result = {
-            method,
-            url,
-            headers
-        };
-        if (body !== undefined) {
-            result.body = body;
-        }
-        return result;
-    }
-    /**
-     * Create tool schema from OpenAPI operation specification
-     */
-    createSchemaFromOpenAPI() {
-        const operation = this.findOperation();
-        if (!operation) {
-            // Fallback schema if operation not found
-            return {
-                name: this.operationId,
-                description: `OpenAPI operation: ${this.operationId}`,
-                parameters: {
-                    type: 'object',
-                    properties: {},
-                    required: []
-                }
-            };
-        }
-        const { operation: opSpec } = operation;
-        const properties = {};
-        const required = [];
-        // Convert OpenAPI parameters to tool schema
-        const params = opSpec.parameters || [];
-        for (const param of params) {
-            properties[param.name] = this.convertOpenAPIParamToSchema(param);
-            if (param.required) {
-                required.push(param.name);
-            }
-        }
-        // Handle request body for POST/PUT/PATCH operations
-        if (opSpec.requestBody) {
-            const requestBody = opSpec.requestBody;
-            const jsonContent = requestBody.content?.['application/json'];
-            if (jsonContent?.schema) {
-                const bodySchema = this.convertOpenAPISchemaToParameterSchema(jsonContent.schema);
-                if (bodySchema.type === 'object' && bodySchema.properties) {
-                    Object.assign(properties, bodySchema.properties);
-                    // Handle required properties for object schemas
-                    const schemaWithRequired = bodySchema;
-                    if (schemaWithRequired.required) {
-                        required.push(...schemaWithRequired.required);
-                    }
-                }
-            }
-        }
-        const schemaParams = {
-            type: 'object',
-            properties
-        };
-        if (required.length > 0) {
-            schemaParams.required = required;
-        }
-        return {
-            name: this.operationId,
-            description: opSpec.summary || opSpec.description || `OpenAPI operation: ${this.operationId}`,
-            parameters: schemaParams
-        };
-    }
-    /**
-     * Convert OpenAPI parameter to tool parameter schema
-     */
-    convertOpenAPIParamToSchema(param) {
-        const schema = param.schema;
-        return this.convertOpenAPISchemaToParameterSchema(schema);
-    }
-    /**
-     * Convert OpenAPI schema to parameter schema
-     */
-    convertOpenAPISchemaToParameterSchema(schema) {
-        // Handle reference objects
-        if ('$ref' in schema) {
-            // For now, treat references as generic objects
-            return { type: 'object' };
-        }
-        const result = {
-            type: this.mapOpenAPIType(schema.type)
-        };
-        if (schema.description) {
-            result.description = schema.description;
-        }
-        if (schema.enum) {
-            result.enum = schema.enum;
-        }
-        if (schema.minimum !== undefined) {
-            result.minimum = schema.minimum;
-        }
-        if (schema.maximum !== undefined) {
-            result.maximum = schema.maximum;
-        }
-        if (schema.pattern) {
-            result.pattern = schema.pattern;
-        }
-        if (schema.format) {
-            result.format = schema.format;
-        }
-        if (schema.default !== undefined) {
-            result.default = schema.default;
-        }
-        // Handle array items
-        if (schema.type === 'array' && schema.items) {
-            result.items = this.convertOpenAPISchemaToParameterSchema(schema.items);
-        }
-        // Handle object properties
-        if (schema.type === 'object' && schema.properties) {
-            result.properties = {};
-            for (const [propName, propSchema] of Object.entries(schema.properties)) {
-                result.properties[propName] = this.convertOpenAPISchemaToParameterSchema(propSchema);
-            }
-            if (schema.required && schema.required.length > 0) {
-                result.required = schema.required;
-            }
-        }
-        return result;
-    }
-    /**
-     * Map OpenAPI type to JSON schema type
-     */
-    mapOpenAPIType(type) {
-        switch (type) {
-            case 'string': return 'string';
-            case 'number': return 'number';
-            case 'integer': return 'integer';
-            case 'boolean': return 'boolean';
-            case 'array': return 'array';
-            case 'object': return 'object';
-            default: return 'string';
-        }
-    }
-}
-/**
- * Factory function to create OpenAPI tools from specification
- */
-export function createOpenAPITool(config) {
-    return new OpenAPITool(config);
-}
-//# sourceMappingURL=openapi-tool.js.map

package/dist/tools/implementations/openapi-tool.js.map

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

package/dist/tools/implementations/relay-mcp-tool.d.ts

@@ -1,38 +0,0 @@
-import type { TToolParameters, IToolResult, IToolExecutionContext } from '../../interfaces/tool';
-import type { IToolSchema } from '../../interfaces/provider';
-import { AbstractTool, type IAbstractToolOptions } from '../../abstracts/abstract-tool';
-import type { IEventService, IOwnerPathSegment } from '../../services/event-service';
-export interface IRelayMcpContext {
-    /** OwnerPath including agent segment appended for this relay execution */
-    ownerPath: IOwnerPathSegment[];
-    /** Tool-bound EventService (already bound to tool by caller) */
-    eventService: IEventService;
-    /** Unbound base EventService (required to bind a new owner for created agent) */
-    baseEventService: IEventService;
-    /** Generated agent identifier for this relay execution */
-    agentId: string;
-}
-export interface IRelayMcpOptions extends IAbstractToolOptions {
-    /** MCP schema describing this relay tool */
-    schema: IToolSchema;
-    /**
-     * Relay executor that performs the actual work (e.g., create Robota agent and run).
-     * Must not perform ownerPath inference; receives the augmented agent ownerPath.
-     */
-    run: (parameters: TToolParameters, ctx: IRelayMcpContext) => Promise<IToolResult>;
-}
-/**
- * RelayMcpTool
- *
- * Minimal relay tool for third-party MCP commands that need to spin up a Robota-based flow.
- * - Caller provides tool-bound EventService and ownerPath (up to tool segment).
- * - This tool appends a single agent segment and forwards control to the provided run() callback.
- * - No prefix injection, no ownerPath inference, no fallback/clone/context creation inside.
- */
-export declare class RelayMcpTool extends AbstractTool<TToolParameters, IToolResult> {
-    readonly schema: IToolSchema;
-    private readonly runImpl;
-    constructor(options: IRelayMcpOptions);
-    protected executeImpl(parameters: TToolParameters, context?: IToolExecutionContext): Promise<IToolResult>;
-}
-//# sourceMappingURL=relay-mcp-tool.d.ts.map

package/dist/tools/implementations/relay-mcp-tool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"relay-mcp-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/implementations/relay-mcp-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACjG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACxF,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGrF,MAAM,WAAW,gBAAgB;IAC7B,0EAA0E;IAC1E,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,gEAAgE;IAChE,YAAY,EAAE,aAAa,CAAC;IAC5B,iFAAiF;IACjF,gBAAgB,EAAE,aAAa,CAAC;IAChC,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAC1D,4CAA4C;IAC5C,MAAM,EAAE,WAAW,CAAC;IACpB;;;OAGG;IACH,GAAG,EAAE,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CACrF;AAED;;;;;;;GAOG;AACH,qBAAa,YAAa,SAAQ,YAAY,CAAC,eAAe,EAAE,WAAW,CAAC;IACxE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;gBAEtC,OAAO,EAAE,gBAAgB;cAMZ,WAAW,CAAC,UAAU,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC;CA8B3H"}

package/dist/tools/implementations/relay-mcp-tool.js

@@ -1,46 +0,0 @@
-import { AbstractTool } from '../../abstracts/abstract-tool';
-import { ToolExecutionError } from '../../utils/errors';
-/**
- * RelayMcpTool
- *
- * Minimal relay tool for third-party MCP commands that need to spin up a Robota-based flow.
- * - Caller provides tool-bound EventService and ownerPath (up to tool segment).
- * - This tool appends a single agent segment and forwards control to the provided run() callback.
- * - No prefix injection, no ownerPath inference, no fallback/clone/context creation inside.
- */
-export class RelayMcpTool extends AbstractTool {
-    schema;
-    runImpl;
-    constructor(options) {
-        super(options);
-        this.schema = options.schema;
-        this.runImpl = options.run;
-    }
-    async executeImpl(parameters, context) {
-        const eventService = context?.eventService;
-        if (!eventService) {
-            throw new ToolExecutionError('RelayMcpTool requires tool-call scoped EventService in ToolExecutionContext', this.schema.name);
-        }
-        const baseEventService = context?.baseEventService;
-        if (!baseEventService) {
-            throw new ToolExecutionError('RelayMcpTool requires baseEventService in ToolExecutionContext', this.schema.name);
-        }
-        const baseOwnerPath = context?.ownerPath;
-        if (!baseOwnerPath || baseOwnerPath.length === 0) {
-            throw new ToolExecutionError('RelayMcpTool requires ownerPath bound to tool segment', this.schema.name);
-        }
-        const agentId = `agent_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
-        const agentOwnerPath = [
-            ...baseOwnerPath.map(segment => ({ ...segment })),
-            { type: 'agent', id: agentId }
-        ];
-        const ctx = {
-            ownerPath: agentOwnerPath,
-            eventService,
-            baseEventService,
-            agentId
-        };
-        return this.runImpl(parameters, ctx);
-    }
-}
-//# sourceMappingURL=relay-mcp-tool.js.map

package/dist/tools/implementations/relay-mcp-tool.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"relay-mcp-tool.js","sourceRoot":"","sources":["../../../src/tools/implementations/relay-mcp-tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAA6B,MAAM,+BAA+B,CAAC;AAExF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAuBxD;;;;;;;GAOG;AACH,MAAM,OAAO,YAAa,SAAQ,YAA0C;IAC/D,MAAM,CAAc;IACZ,OAAO,CAA0B;IAElD,YAAY,OAAyB;QACjC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAC/B,CAAC;IAEkB,KAAK,CAAC,WAAW,CAAC,UAA2B,EAAE,OAA+B;QAC7F,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;QAC3C,IAAI,CAAC,YAAY,EAAE,CAAC;YAChB,MAAM,IAAI,kBAAkB,CAAC,6EAA6E,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClI,CAAC;QACD,MAAM,gBAAgB,GAAG,OAAO,EAAE,gBAAgB,CAAC;QACnD,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACpB,MAAM,IAAI,kBAAkB,CAAC,gEAAgE,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACrH,CAAC;QAED,MAAM,aAAa,GAAG,OAAO,EAAE,SAAS,CAAC;QACzC,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,kBAAkB,CAAC,uDAAuD,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5G,CAAC;QAED,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAChF,MAAM,cAAc,GAAwB;YACxC,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;YACjD,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE;SACjC,CAAC;QAEF,MAAM,GAAG,GAAqB;YAC1B,SAAS,EAAE,cAAc;YACzB,YAAY;YACZ,gBAAgB;YAChB,OAAO;SACV,CAAC;QAEF,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;CACJ"}

package/dist/tools/index.d.ts

@@ -1,3 +0,0 @@
-export * from './registry';
-export * from './implementations';
-//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC"}

package/dist/tools/index.js

@@ -1,4 +0,0 @@
-// Tool system exports
-export * from './registry';
-export * from './implementations';
-//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC"}

package/dist/tools/registry/index.d.ts

@@ -1,2 +0,0 @@
-export * from './tool-registry';
-//# sourceMappingURL=index.d.ts.map

package/dist/tools/registry/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/registry/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAC"}

package/dist/tools/registry/index.js

@@ -1,3 +0,0 @@
-// Tool registry exports
-export * from './tool-registry';
-//# sourceMappingURL=index.js.map

package/dist/tools/registry/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/registry/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,cAAc,iBAAiB,CAAC"}

package/dist/tools/registry/tool-registry.d.ts

@@ -1,54 +0,0 @@
-import type { ITool, IToolRegistry } from '../../interfaces/tool';
-import type { IToolSchema } from '../../interfaces/provider';
-/**
- * Tool registry implementation
- * Manages tool registration, validation, and retrieval
- */
-export declare class ToolRegistry implements IToolRegistry {
-    private tools;
-    /**
-     * Register a tool
-     */
-    register(tool: ITool): void;
-    /**
-     * Unregister a tool
-     */
-    unregister(name: string): void;
-    /**
-     * Get tool by name
-     */
-    get(name: string): ITool | undefined;
-    /**
-     * Get all registered tools
-     */
-    getAll(): ITool[];
-    /**
-     * Get tool schemas
-     */
-    getSchemas(): IToolSchema[];
-    /**
-     * Check if tool exists
-     */
-    has(name: string): boolean;
-    /**
-     * Clear all tools
-     */
-    clear(): void;
-    /**
-     * Get tool names
-     */
-    getToolNames(): string[];
-    /**
-     * Get tools by pattern
-     */
-    getToolsByPattern(pattern: string | RegExp): ITool[];
-    /**
-     * Get tool count
-     */
-    size(): number;
-    /**
-     * Validate tool schema
-     */
-    private validateToolSchema;
-}
-//# sourceMappingURL=tool-registry.d.ts.map

package/dist/tools/registry/tool-registry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../../src/tools/registry/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAI7D;;;GAGG;AACH,qBAAa,YAAa,YAAW,aAAa;IAC9C,OAAO,CAAC,KAAK,CAA4B;IAEzC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IA0B3B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAU9B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAIpC;;OAEG;IACH,MAAM,IAAI,KAAK,EAAE;IAIjB;;OAEG;IACH,UAAU,IAAI,WAAW,EAAE;IAiB3B;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,EAAE;IAKpD;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,OAAO,CAAC,kBAAkB;CA0C7B"}