@measureoneinc/savant 1.0.0

package/dist/controllers/base.controller.js

@@ -0,0 +1,378 @@
+"use strict";
+/**
+ * @fileoverview Base Controller Class - Shared across MeasureOne Services
+ *
+ * Parent Controller class to be extended by all controllers to use common controller methods.
+ * Provides standardized error handling, response formatting, and API response management.
+ *
+ * @author MeasureOne, Inc.
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseController = void 0;
+const app_constants_1 = require("../lib/app-constants");
+const app_exceptions_1 = require("../lib/exceptions/app-exceptions");
+const logger_1 = require("../lib/utils/logger");
+/**
+ * Base Controller Class
+ *
+ * Provides common controller functionality including error handling,
+ * response formatting, and standardized API responses.
+ */
+class BaseController {
+    constructor(service_name = 'BaseService', version = '1.0.0') {
+        this.service_name = service_name;
+        this.version = version;
+        this.logger = (0, logger_1.create_default_logger)(service_name, version);
+    }
+    /**
+     * Helper function to be used as controller route catch blocks.
+     * Performs an instanceof check to see if error is of type BaseAppException.
+     * If matched, sends HTTP response with information contained in error object.
+     * If not found, calls next and lets error proceed to next middleware.
+     *
+     * @param err - Error object to handle
+     * @param res - Express HTTP response object
+     * @param next - Express next callback function
+     */
+    handle_error_response(err, res, next) {
+        if (err instanceof app_exceptions_1.BaseAppException) {
+            const response_obj = {
+                success: false,
+                message: err.message,
+                data: null,
+                timestamp: new Date().toISOString(),
+                version: this.version,
+                error: {
+                    code: err.error_code,
+                    message: err.message,
+                    details: err.details,
+                    timestamp: new Date().toISOString(),
+                    service: this.service_name
+                }
+            };
+            return res.status(err.http_status).json(response_obj);
+        }
+        // If not of type BaseAppException, pass error to next middleware
+        next(err);
+    }
+    /**
+     * Create a standardized success response
+     *
+     * @param res - Express response object
+     * @param data - Data to include in response
+     * @param message - Success message (optional)
+     * @param status - HTTP status code (default: 200)
+     * @returns HTTP response
+     */
+    static send_success_response(res, data, message, status = app_constants_1.HTTP_STATUS.OK) {
+        const response_obj = {
+            success: true,
+            message: message || 'Request completed successfully',
+            data: data || null,
+            timestamp: new Date().toISOString(),
+            version: '1.0.0'
+        };
+        return res.status(status).json(response_obj);
+    }
+    /**
+     * Instance method for success response
+     */
+    send_success_response(res, data, message, status = app_constants_1.HTTP_STATUS.OK) {
+        return BaseController.send_success_response(res, data, message, status);
+    }
+    /**
+     * Create a standardized error response
+     *
+     * @param res - Express response object
+     * @param error - Error object or message
+     * @param status - HTTP status code (default: 500)
+     * @returns HTTP response
+     */
+    static send_error_response(res, error, status = app_constants_1.HTTP_STATUS.INTERNAL_SERVER_ERROR) {
+        let error_code = app_constants_1.ERROR_CODES.INTERNAL_ERROR;
+        let error_message = 'Internal server error occurred';
+        let error_status = status;
+        let error_details = {};
+        if (error instanceof app_exceptions_1.BaseAppException) {
+            error_code = error.error_code;
+            error_message = error.message;
+            error_status = error.http_status;
+            error_details = error.details;
+        }
+        else if (error instanceof Error) {
+            error_message = error.message;
+        }
+        else if (typeof error === 'string') {
+            error_message = error;
+        }
+        const error_info = {
+            success: false,
+            error: {
+                code: error_code,
+                message: error_message,
+                details: error_details,
+                timestamp: new Date().toISOString(),
+                service: 'MeasureOne'
+            },
+            message: error_message,
+            timestamp: new Date().toISOString(),
+            version: '1.0.0'
+        };
+        const response_obj = {
+            success: false,
+            message: error_message,
+            data: null,
+            timestamp: new Date().toISOString(),
+            version: '1.0.0',
+            error: error_info.error
+        };
+        return res.status(error_status).json(response_obj);
+    }
+    /**
+     * Instance method for error response
+     */
+    send_error_response(res, error, status = app_constants_1.HTTP_STATUS.INTERNAL_SERVER_ERROR) {
+        return BaseController.send_error_response(res, error, status);
+    }
+    /**
+     * Create a validation error response
+     *
+     * @param res - Express response object
+     * @param validation_errors - Array of validation error messages
+     * @returns HTTP response
+     */
+    static send_validation_error_response(res, validation_errors) {
+        const error_info = {
+            success: false,
+            error: {
+                code: app_constants_1.ERROR_CODES.VALIDATION_FAILED,
+                message: 'Request validation failed',
+                details: { validation_errors },
+                timestamp: new Date().toISOString(),
+                service: 'MeasureOne'
+            },
+            message: 'Request validation failed',
+            timestamp: new Date().toISOString(),
+            version: '1.0.0'
+        };
+        const response_obj = {
+            success: false,
+            message: 'Request validation failed',
+            data: null,
+            timestamp: new Date().toISOString(),
+            version: '1.0.0',
+            error: error_info.error
+        };
+        return res.status(app_constants_1.HTTP_STATUS.BAD_REQUEST).json(response_obj);
+    }
+    /**
+     * Instance method for validation error response
+     */
+    send_validation_error_response(res, validation_errors) {
+        return BaseController.send_validation_error_response(res, validation_errors);
+    }
+    /**
+     * Create a paginated response
+     *
+     * @param res - Express response object
+     * @param data - Array of data items
+     * @param pagination - Pagination information
+     * @param message - Success message (optional)
+     * @returns HTTP response
+     */
+    static send_paginated_response(res, data, pagination, message) {
+        const response_obj = {
+            success: true,
+            message: message || 'Request completed successfully',
+            data,
+            timestamp: new Date().toISOString(),
+            version: '1.0.0',
+            pagination
+        };
+        return res.status(app_constants_1.HTTP_STATUS.OK).json(response_obj);
+    }
+    /**
+     * Instance method for paginated response
+     */
+    send_paginated_response(res, data, pagination, message) {
+        return BaseController.send_paginated_response(res, data, pagination, message);
+    }
+    /**
+     * Execute an operation with automatic error handling
+     *
+     * @param res - Express response object
+     * @param operation - Async operation to execute
+     * @param success_message - Message for successful response
+     * @param success_status - HTTP status for successful response
+     */
+    async execute_with_error_handling(res, operation, success_message, success_status = app_constants_1.HTTP_STATUS.OK) {
+        try {
+            const result = await operation();
+            this.send_success_response(res, result, success_message, success_status);
+        }
+        catch (error) {
+            if (error instanceof app_exceptions_1.BaseAppException) {
+                this.send_error_response(res, error);
+            }
+            else if (error instanceof Error) {
+                this.send_error_response(res, error, app_constants_1.HTTP_STATUS.INTERNAL_SERVER_ERROR);
+            }
+            else {
+                this.send_error_response(res, 'An unexpected error occurred', app_constants_1.HTTP_STATUS.INTERNAL_SERVER_ERROR);
+            }
+        }
+    }
+    /**
+     * Validate request body exists and is not empty
+     *
+     * @param req - Express request object
+     * @throws ValidationException if body is missing or empty
+     */
+    validate_request_body(req) {
+        if (!req.body || Object.keys(req.body).length === 0) {
+            throw new app_exceptions_1.ValidationException('Request body is required', {
+                field: 'body',
+                received: req.body
+            });
+        }
+    }
+    /**
+     * Extract pagination parameters from request
+     *
+     * @param req - Express request object
+     * @returns Pagination parameters with defaults
+     */
+    extract_pagination_params(req) {
+        const page = Math.max(1, parseInt(req.query['page']) || 1);
+        const limit = Math.min(1000, Math.max(1, parseInt(req.query['limit']) || 50));
+        const offset = (page - 1) * limit;
+        return { page, limit, offset };
+    }
+    /**
+     * Extract sorting parameters from request
+     *
+     * @param req - Express request object
+     * @param allowed_fields - Array of allowed sort fields
+     * @returns Sorting parameters
+     */
+    extract_sorting_params(req, allowed_fields = []) {
+        const sort_by = req.query['sort_by'];
+        const sort_order = req.query['sort_order']?.toLowerCase() === 'desc' ? 'desc' : 'asc';
+        if (sort_by && allowed_fields.length > 0 && !allowed_fields.includes(sort_by)) {
+            throw new app_exceptions_1.ValidationException(`Invalid sort field: ${sort_by}`, {
+                field: 'sort_by',
+                allowed_values: allowed_fields,
+                received: sort_by
+            });
+        }
+        return { sort_by, sort_order };
+    }
+    /**
+     * Calculate pagination metadata
+     *
+     * @param total - Total number of items
+     * @param page - Current page number
+     * @param limit - Items per page
+     * @returns Pagination metadata
+     */
+    calculate_pagination_metadata(total, page, limit) {
+        const total_pages = Math.ceil(total / limit);
+        const has_next = page < total_pages;
+        const has_prev = page > 1;
+        const offset = (page - 1) * limit;
+        return {
+            page,
+            limit,
+            offset,
+            total,
+            total_pages,
+            has_next,
+            has_prev
+        };
+    }
+    // ============================================================================
+    // LOGGING METHODS
+    // ============================================================================
+    /**
+     * Log incoming request details
+     *
+     * @param req - Express request object
+     * @param method_name - Name of the controller method being called
+     */
+    log_request(req, method_name) {
+        this.logger.info(`${method_name} - Request received`, {
+            method: req.method,
+            url: req.url,
+            user_agent: req.get('User-Agent'),
+            ip: req.ip,
+            body_size: req.body ? JSON.stringify(req.body).length : 0,
+            query_params: Object.keys(req.query).length > 0 ? req.query : undefined,
+            headers: {
+                content_type: req.get('Content-Type'),
+                authorization: req.get('Authorization') ? '[REDACTED]' : undefined
+            }
+        });
+    }
+    /**
+     * Log request and response details
+     *
+     * @param req - Express request object
+     * @param res - Express response object
+     * @param method_name - Name of the controller method being called
+     */
+    log_request_response(req, res, method_name) {
+        const start_time = Date.now();
+        const logger = this.logger;
+        // Log request
+        this.log_request(req, method_name);
+        // Hook into response finish event to log response
+        const original_send = res.send;
+        res.send = function (body) {
+            const end_time = Date.now();
+            const duration = end_time - start_time;
+            // Log response details
+            logger.info(`${method_name} - Response sent`, {
+                status_code: res.statusCode,
+                duration_ms: duration,
+                response_size: body ? JSON.stringify(body).length : 0,
+                headers: {
+                    content_type: res.get('Content-Type')
+                }
+            });
+            return original_send.call(this, body);
+        };
+    }
+    /**
+     * Log error details
+     *
+     * @param error - Error object
+     * @param method_name - Name of the controller method where error occurred
+     * @param req - Express request object (optional)
+     */
+    log_error(error, method_name, req) {
+        const error_details = {
+            method: method_name,
+            error_message: error instanceof Error ? error.message : String(error),
+            error_type: error.constructor.name,
+            stack: error instanceof Error ? error.stack : undefined
+        };
+        if (req) {
+            error_details.request = {
+                method: req.method,
+                url: req.url,
+                ip: req.ip,
+                user_agent: req.get('User-Agent')
+            };
+        }
+        if (error instanceof app_exceptions_1.BaseAppException) {
+            error_details.error_code = error.error_code;
+            error_details.http_status = error.http_status;
+            error_details.details = error.details;
+        }
+        this.logger.error(`${method_name} - Error occurred`, error_details);
+    }
+}
+exports.BaseController = BaseController;
+exports.default = BaseController;
+//# sourceMappingURL=base.controller.js.map

package/dist/controllers/base.controller.js.map

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

package/dist/controllers/conversations.controller.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Agent Controller
+ *
+ * Controller for handling agent request operations.
+ * Follows pixie validation pattern.
+ *
+ * @author MeasureOne, Inc.
+ * @version 1.0.0
+ */
+import { Request, Response, NextFunction } from "express";
+import { BaseController } from "./base.controller";
+export declare class ConversationController extends BaseController {
+    private conversation_service;
+    private sdk;
+    constructor();
+    /**
+     * Submit a message to a conversation. Loads conversation history from database and appends new message
+     * Always uses streaming response (NDJSON format)
+     * Follows pixie validation pattern
+     */
+    submit_message(req: Request, res: Response, next: NextFunction): Promise<void>;
+    /**
+     * Validate submit message request data
+     * Checks that agent_request_id, conversation_id exist in DB
+     * Validates conversation belongs to agent_request
+     * If step_id is provided, validates it exists in DB
+     * Returns validation result with error message if validation fails
+     */
+    private validate_incoming_message;
+}
+//# sourceMappingURL=conversations.controller.d.ts.map

package/dist/controllers/conversations.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/conversations.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AASnD,qBAAa,sBAAuB,SAAQ,cAAc;IACtD,OAAO,CAAC,oBAAoB,CAAsB;IAClD,OAAO,CAAC,GAAG,CAAY;;IAQvB;;;;OAIG;IACG,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA4DpF;;;;;;OAMG;YACW,yBAAyB;CAiE1C"}

package/dist/controllers/conversations.controller.js

@@ -0,0 +1,138 @@
+"use strict";
+/**
+ * @fileoverview Agent Controller
+ *
+ * Controller for handling agent request operations.
+ * Follows pixie validation pattern.
+ *
+ * @author MeasureOne, Inc.
+ * @version 1.0.0
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConversationController = void 0;
+const express_validator_1 = require("express-validator");
+const base_controller_1 = require("./base.controller");
+const logger_1 = require("../lib/utils/logger");
+const conversation_service_1 = __importDefault(require("../services/conversation.service"));
+const streaming_utils_1 = require("../lib/streaming-utils");
+const controller_utils_1 = require("../lib/controller-utils");
+const savant_sdk_1 = require("../sdk/savant.sdk");
+const logger = (0, logger_1.create_compact_logger)("agents:conversation-controller");
+class ConversationController extends base_controller_1.BaseController {
+    constructor() {
+        super();
+        this.conversation_service = new conversation_service_1.default();
+        this.sdk = new savant_sdk_1.SavantSDK();
+    }
+    /**
+     * Submit a message to a conversation. Loads conversation history from database and appends new message
+     * Always uses streaming response (NDJSON format)
+     * Follows pixie validation pattern
+     */
+    async submit_message(req, res, next) {
+        try {
+            // Check if there's any validation error (pixie pattern)
+            let err = (0, express_validator_1.validationResult)(req);
+            if (!err.isEmpty()) {
+                return (0, controller_utils_1.handle_error_response)((0, controller_utils_1.get_error)("general", "badRequest", undefined, err.array()), res, next);
+            }
+            this.logger.info('Submitting message to conversation', { request: req.body });
+            // Request body uses conversation_id (maps to Conversation.id) and message (singular)
+            // We adapt it to Conversation structure for type safety
+            const { agent_request_id, conversation_id, message, step_id } = req.body;
+            // Validate request data (agent_request_id, conversation_id, step_id)
+            const validation_result = await this.validate_incoming_message({
+                agent_request_id,
+                conversation_id,
+                step_id
+            });
+            if (!validation_result.isValid) {
+                // Return error response in pixie format
+                return (0, controller_utils_1.handle_error_response)((0, controller_utils_1.get_error)("general", "badRequest", validation_result.errorMessage, validation_result.errorDetails), res, next);
+            }
+            // Always use streaming for submit_message endpoint
+            const streaming_utils = new streaming_utils_1.StreamingUtils(res, req);
+            // Pass the conversation data to the service
+            // Service will load full conversation history from database and append the new message
+            await this.sdk.submit_message({
+                agent_request_id,
+                conversation_id,
+                message,
+                step_id,
+            }, streaming_utils);
+            // The service will emit 'final_response' and then 'end'. Cleanup happens in the callback.
+        }
+        catch (error) {
+            // Handle streaming errors
+            (0, streaming_utils_1.handle_stream_error)(res, error);
+        }
+    }
+    /**
+     * Validate submit message request data
+     * Checks that agent_request_id, conversation_id exist in DB
+     * Validates conversation belongs to agent_request
+     * If step_id is provided, validates it exists in DB
+     * Returns validation result with error message if validation fails
+     */
+    async validate_incoming_message(data) {
+        this.logger.info('🔍 Validating submit message data', {
+            agent_request_id: data.agent_request_id,
+            conversation_id: data.conversation_id,
+            step_id: data.step_id
+        });
+        // Validate that agent_request_id exists in DB
+        const agent_request = await this.conversation_service.find_agent_request(data.agent_request_id);
+        if (!agent_request) {
+            this.logger.warn('❌ Agent request not found', { agent_request_id: data.agent_request_id });
+            return {
+                isValid: false,
+                errorMessage: `Agent request not found: ${data.agent_request_id}`,
+                errorDetails: { agent_request_id: data.agent_request_id, field: 'agent_request_id' }
+            };
+        }
+        // Validate that conversation_id exists in DB
+        const conversation = await this.conversation_service.find_conversation(data.conversation_id);
+        if (!conversation) {
+            this.logger.warn('❌ Conversation not found', { conversation_id: data.conversation_id });
+            return {
+                isValid: false,
+                errorMessage: `Conversation not found: ${data.conversation_id}`,
+                errorDetails: { conversation_id: data.conversation_id, field: 'conversation_id' }
+            };
+        }
+        // Validate that conversation belongs to the agent_request
+        if (conversation.agent_request_id !== data.agent_request_id) {
+            this.logger.warn('❌ Conversation does not belong to agent request', {
+                conversation_id: data.conversation_id,
+                agent_request_id: data.agent_request_id
+            });
+            return {
+                isValid: false,
+                errorMessage: `Conversation ${data.conversation_id} does not belong to agent request ${data.agent_request_id}`,
+                errorDetails: {
+                    conversation_id: data.conversation_id,
+                    agent_request_id: data.agent_request_id,
+                    field: 'conversation_id'
+                }
+            };
+        }
+        // If step_id is provided, validate that it exists in DB
+        if (data.step_id) {
+            const plan_step = await this.conversation_service.find_plan_step(data.step_id);
+            if (!plan_step) {
+                this.logger.warn('❌ Plan step not found', { step_id: data.step_id });
+                return {
+                    isValid: false,
+                    errorMessage: `Plan step not found: ${data.step_id}`,
+                    errorDetails: { step_id: data.step_id, field: 'step_id' }
+                };
+            }
+        }
+        return { isValid: true };
+    }
+}
+exports.ConversationController = ConversationController;
+//# sourceMappingURL=conversations.controller.js.map

package/dist/controllers/conversations.controller.js.map

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

package/dist/controllers/knowledge.controller.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @fileoverview Knowledge Controller
+ *
+ * Controller for handling Knowledge HTTP requests.
+ * Extends BaseController from shared-utils for consistent API patterns.
+ *
+ * @author MeasureOne, Inc.
+ * @version 1.0.0
+ */
+import { Request, Response, NextFunction } from "express";
+import { BaseController } from "./base.controller";
+export declare class KnowledgeController extends BaseController {
+    private knowledge_service;
+    private file_upload_service;
+    private embedding_service;
+    private audit_log_service;
+    private sdk;
+    constructor();
+    /**
+     * Upload file and return file_id
+     * POST /knowledge/upload
+     */
+    upload_file(req: Request, res: Response): Promise<void>;
+    /**
+     * Create a new knowledge
+     * POST /v3/knowledge/new
+     *
+     * Now accepts source_data with array of file IDs:
+     * { source_data: [{ id: "file_id_1" }, { id: "file_id_2" }] }
+     *
+     * IMPORTANT: Domain is NEVER accepted from request body.
+     * Domain is ALWAYS identified using AI (DomainIdentifierService) from the seed content.
+     */
+    create_knowledge(req: Request, res: Response): Promise<void>;
+    /**
+     * Get knowledge by ID
+     * POST /v3/knowledge/get_by_id
+     */
+    get_knowledge_by_id(req: Request, res: Response): Promise<void>;
+    /**
+     * Set content for knowledge
+     * POST /v3/knowledge/set_content
+     */
+    set_content(req: Request, res: Response): Promise<void>;
+    /**
+     * List knowledge
+     * POST /v3/knowledge/list
+     */
+    list_knowledge(req: Request, res: Response): Promise<void>;
+    /**
+     * Update knowledge with revision tracking
+     * POST /knowledge/update
+     * Follows pixie validation pattern
+     */
+    update_knowledge(req: Request, res: Response, next: NextFunction): Promise<void>;
+    /**
+        * Search embeddings by query text
+        * POST /knowledge/search
+        * POST /embeddings/search (alias for MCP server compatibility)
+        */
+    search_knowledge(req: Request, res: Response): Promise<void>;
+}
+//# sourceMappingURL=knowledge.controller.d.ts.map

package/dist/controllers/knowledge.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/knowledge.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAYnD,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,mBAAmB,CAAoB;IAC/C,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,OAAO,CAAC,iBAAiB,CAAkB;IAE3C,OAAO,CAAC,GAAG,CAAY;;IAevB;;;OAGG;IACG,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAgC7D;;;;;;;;;OASG;IACG,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA+ClE;;;OAGG;IACG,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBrE;;;OAGG;IACG,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B7D;;;OAGG;IACG,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAqChE;;;;OAIG;IACG,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAuHtF;;;;UAIM;IACA,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAoCnE"}