snow-flow 1.1.0

package/dist/utils/flow-xml-generator.d.ts

@@ -0,0 +1,41 @@
+/**
+ * ServiceNow Flow XML Generator
+ * Generates proper XML for flows that can be imported via Update Sets
+ */
+export interface FlowDefinition {
+    name: string;
+    description: string;
+    table?: string;
+    trigger_type?: string;
+    condition?: string;
+    active?: boolean;
+    actions?: FlowAction[];
+}
+export interface FlowAction {
+    name: string;
+    type: string;
+    order: number;
+    inputs?: Record<string, any>;
+    outputs?: Record<string, any>;
+}
+export declare class FlowXMLGenerator {
+    private logger;
+    constructor();
+    /**
+     * Generate complete flow XML for Update Set
+     */
+    generateFlowXML(flow: FlowDefinition): string;
+    /**
+     * Generate flow from natural language (simplified version)
+     */
+    generateFlowFromDescription(description: string): FlowDefinition;
+    private extractFlowName;
+    private extractActions;
+    private sanitizeInternalName;
+    private escapeXML;
+    private generateSysId;
+    private getCurrentTimestamp;
+    private getTriggerTypeId;
+    private getActionTypeId;
+}
+//# sourceMappingURL=flow-xml-generator.d.ts.map

package/dist/utils/flow-xml-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-xml-generator.d.ts","sourceRoot":"","sources":["../../src/utils/flow-xml-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAS;;IAMvB;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM;IAyG7C;;OAEG;IACH,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc;IA+BhE,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,cAAc;IAyDtB,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,eAAe;CAWxB"}

package/dist/utils/flow-xml-generator.js

@@ -0,0 +1,258 @@
+"use strict";
+/**
+ * ServiceNow Flow XML Generator
+ * Generates proper XML for flows that can be imported via Update Sets
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowXMLGenerator = void 0;
+const logger_js_1 = require("./logger.js");
+class FlowXMLGenerator {
+    constructor() {
+        this.logger = new logger_js_1.Logger('FlowXMLGenerator');
+    }
+    /**
+     * Generate complete flow XML for Update Set
+     */
+    generateFlowXML(flow) {
+        const flowId = this.generateSysId();
+        const timestamp = this.getCurrentTimestamp();
+        const internalName = this.sanitizeInternalName(flow.name);
+        // Generate the main flow record
+        let xml = `<?xml version="1.0" encoding="UTF-8"?>
+<record_update sys_domain="global" table="sys_hub_flow">
+  <sys_hub_flow action="INSERT_OR_UPDATE">
+    <access>public</access>
+    <active>${flow.active !== false ? 'true' : 'false'}</active>
+    <category>custom</category>
+    <description>${this.escapeXML(flow.description || flow.name)}</description>
+    <internal_name>${internalName}</internal_name>
+    <name>${this.escapeXML(flow.name)}</name>
+    <run_as>user_who_triggers</run_as>
+    <status>published</status>
+    <sys_class_name>sys_hub_flow</sys_class_name>
+    <sys_created_by>admin</sys_created_by>
+    <sys_created_on>${timestamp}</sys_created_on>
+    <sys_id>${flowId}</sys_id>
+    <sys_mod_count>0</sys_mod_count>
+    <sys_scope display_value="Global">global</sys_scope>
+    <type>flow</type>
+  </sys_hub_flow>`;
+        // Add trigger instance if specified
+        if (flow.trigger_type) {
+            const triggerId = this.generateSysId();
+            const triggerLogicId = this.generateSysId();
+            xml += `
+  
+  <!-- Flow Trigger Instance -->
+  <sys_hub_trigger_instance action="INSERT_OR_UPDATE">
+    <active>true</active>
+    <flow>${flowId}</flow>
+    <sys_id>${triggerId}</sys_id>
+    <table_name>${flow.table || 'sc_request'}</table_name>
+    <trigger_type>${this.getTriggerTypeId(flow.trigger_type)}</trigger_type>
+    ${flow.condition ? `<condition>${this.escapeXML(flow.condition)}</condition>` : ''}
+  </sys_hub_trigger_instance>
+  
+  <!-- Trigger Logic -->
+  <sys_hub_flow_logic action="INSERT_OR_UPDATE">
+    <active>true</active>
+    <flow>${flowId}</flow>
+    <instance>${triggerId}</instance>
+    <name>Trigger</name>
+    <order>0</order>
+    <sys_id>${triggerLogicId}</sys_id>
+    <type>trigger</type>
+  </sys_hub_flow_logic>`;
+            // Add actions if specified
+            if (flow.actions && flow.actions.length > 0) {
+                let previousLogicId = triggerLogicId;
+                const actions = flow.actions; // TypeScript type narrowing
+                actions.forEach((action, index) => {
+                    const actionId = this.generateSysId();
+                    const actionLogicId = this.generateSysId();
+                    xml += `
+  
+  <!-- Action ${index + 1}: ${action.name} -->
+  <sys_hub_action_instance action="INSERT_OR_UPDATE">
+    <action_name>${this.escapeXML(action.name)}</action_name>
+    <action_type>${this.getActionTypeId(action.type)}</action_type>
+    <active>true</active>
+    <flow>${flowId}</flow>
+    <inputs>${this.escapeXML(JSON.stringify(action.inputs || {}))}</inputs>
+    <order>${action.order}</order>
+    <sys_id>${actionId}</sys_id>
+  </sys_hub_action_instance>
+  
+  <!-- Action Logic -->
+  <sys_hub_flow_logic action="INSERT_OR_UPDATE">
+    <active>true</active>
+    <flow>${flowId}</flow>
+    <instance>${actionId}</instance>
+    <name>${this.escapeXML(action.name)}</name>
+    <next>${index < actions.length - 1 ? 'NEXT_LOGIC_ID' : ''}</next>
+    <order>${action.order}</order>
+    <sys_id>${actionLogicId}</sys_id>
+    <type>action</type>
+  </sys_hub_flow_logic>`;
+                    // Update previous logic to point to this one
+                    xml = xml.replace(`<sys_id>${previousLogicId}</sys_id>
+    <type>`, `<sys_id>${previousLogicId}</sys_id>
+    <next>${actionLogicId}</next>
+    <type>`);
+                    previousLogicId = actionLogicId;
+                });
+            }
+        }
+        xml += `
+</record_update>`;
+        return xml;
+    }
+    /**
+     * Generate flow from natural language (simplified version)
+     */
+    generateFlowFromDescription(description) {
+        const flow = {
+            name: this.extractFlowName(description),
+            description: description,
+            active: true,
+            actions: []
+        };
+        // Extract trigger information
+        if (description.toLowerCase().includes('when') || description.toLowerCase().includes('trigger')) {
+            flow.trigger_type = 'record_created';
+            if (description.toLowerCase().includes('catalog') || description.toLowerCase().includes('request')) {
+                flow.table = 'sc_request';
+            }
+            else if (description.toLowerCase().includes('incident')) {
+                flow.table = 'incident';
+            }
+            else {
+                flow.table = 'task';
+            }
+        }
+        // Extract actions
+        const actions = this.extractActions(description);
+        flow.actions = actions.map((action, index) => ({
+            ...action,
+            order: (index + 1) * 100
+        }));
+        return flow;
+    }
+    extractFlowName(description) {
+        // Look for explicit flow name in quotes
+        const quotedMatch = description.match(/["']([^"']+)["']/);
+        if (quotedMatch) {
+            return quotedMatch[1];
+        }
+        // Extract from "Create a flow named X" or "flow for X"
+        const namedMatch = description.match(/flow\s+(?:named|called|for)\s+([^.!?,]+)/i);
+        if (namedMatch) {
+            return namedMatch[1].trim();
+        }
+        // Generate from first part of description
+        const words = description.split(' ').slice(0, 5);
+        return words.join(' ') + ' Flow';
+    }
+    extractActions(description) {
+        const actions = [];
+        const lowerDesc = description.toLowerCase();
+        // Check for approval
+        if (lowerDesc.includes('approval') || lowerDesc.includes('approve')) {
+            actions.push({
+                name: 'Request Approval',
+                type: 'approval',
+                inputs: {
+                    approvers: lowerDesc.includes('admin') ? 'admin' : 'assignment_group.manager'
+                }
+            });
+        }
+        // Check for notifications
+        if (lowerDesc.includes('notify') || lowerDesc.includes('email') || lowerDesc.includes('send')) {
+            actions.push({
+                name: 'Send Notification',
+                type: 'notification',
+                inputs: {
+                    to: 'requested_for',
+                    subject: 'Request Update',
+                    message: 'Your request has been processed'
+                }
+            });
+        }
+        // Check for state updates
+        if (lowerDesc.includes('set') && (lowerDesc.includes('state') || lowerDesc.includes('status'))) {
+            const stateMatch = lowerDesc.match(/set\s+(?:state|status)\s+to\s+(\w+)/);
+            if (stateMatch) {
+                actions.push({
+                    name: `Set State to ${stateMatch[1]}`,
+                    type: 'field_update',
+                    inputs: {
+                        field: 'state',
+                        value: stateMatch[1]
+                    }
+                });
+            }
+        }
+        // Check for conditions
+        if (lowerDesc.includes('if') && lowerDesc.includes('check')) {
+            actions.push({
+                name: 'Check Condition',
+                type: 'condition',
+                inputs: {
+                    condition: 'current.item_name.indexOf("iPhone 6") > -1'
+                }
+            });
+        }
+        return actions;
+    }
+    sanitizeInternalName(name) {
+        return name
+            .toLowerCase()
+            .replace(/[^a-z0-9_]/g, '_')
+            .replace(/_+/g, '_')
+            .replace(/^_|_$/g, '')
+            .substring(0, 80);
+    }
+    escapeXML(str) {
+        return str
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&apos;');
+    }
+    generateSysId() {
+        // Generate a realistic looking sys_id (32 char hex)
+        const chars = '0123456789abcdef';
+        let sysId = '';
+        for (let i = 0; i < 32; i++) {
+            sysId += chars[Math.floor(Math.random() * 16)];
+        }
+        return sysId;
+    }
+    getCurrentTimestamp() {
+        const now = new Date();
+        return now.toISOString().replace('T', ' ').substring(0, 19);
+    }
+    getTriggerTypeId(type) {
+        // Map common trigger types to IDs (these should be fetched dynamically in production)
+        const triggerMap = {
+            'record_created': '8046eb1537201210075d647c24924bd7',
+            'record_updated': 'f0b6a35537201210075d647c24924b4f',
+            'created_or_updated': '5d07ab5537201210075d647c24924b13'
+        };
+        return triggerMap[type] || triggerMap['record_created'];
+    }
+    getActionTypeId(type) {
+        // Map common action types to IDs (these should be fetched dynamically in production)
+        const actionMap = {
+            'approval': '280065eb734310108ef62d2b04f6a751',
+            'notification': '716281160b100300d97d8bf637673ac7',
+            'field_update': 'baf174c8c3c232002841b63b12d3aee4',
+            'condition': '15cd22b8c3c232002841b63b12d3ae87',
+            'create_record': '02f0b88cc3c632002841b63b12d3aeff'
+        };
+        return actionMap[type] || '6d8e9c40c32213001d7db7f8c0d5f766'; // Default to log action
+    }
+}
+exports.FlowXMLGenerator = FlowXMLGenerator;
+//# sourceMappingURL=flow-xml-generator.js.map

package/dist/utils/flow-xml-generator.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Logger utility for ServiceNow agents
+ */
+export declare class Logger {
+    private logger;
+    constructor(agentName: string);
+    info(message: string, meta?: any): void;
+    error(message: string, meta?: any): void;
+    warn(message: string, meta?: any): void;
+    debug(message: string, meta?: any): void;
+}
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAiB;gBAEnB,SAAS,EAAE,MAAM;IA+B7B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIvC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIxC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAIvC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;CAGzC;AAGD,eAAO,MAAM,MAAM,QAA0B,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * Logger utility for ServiceNow agents
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.Logger = void 0;
+const winston_1 = __importDefault(require("winston"));
+const path_1 = __importDefault(require("path"));
+class Logger {
+    constructor(agentName) {
+        const logDir = path_1.default.join(process.cwd(), 'logs');
+        this.logger = winston_1.default.createLogger({
+            level: process.env.LOG_LEVEL || 'info',
+            format: winston_1.default.format.combine(winston_1.default.format.timestamp(), winston_1.default.format.errors({ stack: true }), winston_1.default.format.json()),
+            defaultMeta: { agent: agentName },
+            transports: [
+                // Console transport
+                new winston_1.default.transports.Console({
+                    format: winston_1.default.format.combine(winston_1.default.format.colorize(), winston_1.default.format.simple())
+                }),
+                // File transport
+                new winston_1.default.transports.File({
+                    filename: path_1.default.join(logDir, `${agentName}-error.log`),
+                    level: 'error'
+                }),
+                new winston_1.default.transports.File({
+                    filename: path_1.default.join(logDir, `${agentName}.log`)
+                })
+            ]
+        });
+    }
+    info(message, meta) {
+        this.logger.info(message, meta);
+    }
+    error(message, meta) {
+        this.logger.error(message, meta);
+    }
+    warn(message, meta) {
+        this.logger.warn(message, meta);
+    }
+    debug(message, meta) {
+        this.logger.debug(message, meta);
+    }
+}
+exports.Logger = Logger;
+// Create a default logger instance
+exports.logger = new Logger('snow-flow');
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;AAEH,sDAA8B;AAC9B,gDAAwB;AAExB,MAAa,MAAM;IAGjB,YAAY,SAAiB;QAC3B,MAAM,MAAM,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;QAEhD,IAAI,CAAC,MAAM,GAAG,iBAAO,CAAC,YAAY,CAAC;YACjC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;YACtC,MAAM,EAAE,iBAAO,CAAC,MAAM,CAAC,OAAO,CAC5B,iBAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAC1B,iBAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EACtC,iBAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CACtB;YACD,WAAW,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;YACjC,UAAU,EAAE;gBACV,oBAAoB;gBACpB,IAAI,iBAAO,CAAC,UAAU,CAAC,OAAO,CAAC;oBAC7B,MAAM,EAAE,iBAAO,CAAC,MAAM,CAAC,OAAO,CAC5B,iBAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,EACzB,iBAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CACxB;iBACF,CAAC;gBACF,iBAAiB;gBACjB,IAAI,iBAAO,CAAC,UAAU,CAAC,IAAI,CAAC;oBAC1B,QAAQ,EAAE,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,YAAY,CAAC;oBACrD,KAAK,EAAE,OAAO;iBACf,CAAC;gBACF,IAAI,iBAAO,CAAC,UAAU,CAAC,IAAI,CAAC;oBAC1B,QAAQ,EAAE,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,MAAM,CAAC;iBAChD,CAAC;aACH;SACF,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAU;QAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAU;QAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAU;QAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAU;QAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;CACF;AAjDD,wBAiDC;AAED,mCAAmC;AACtB,QAAA,MAAM,GAAG,IAAI,MAAM,CAAC,WAAW,CAAC,CAAC"}

package/dist/utils/mcp-auth-middleware.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Centralized MCP Authentication Middleware
+ * Handles ServiceNow OAuth authentication across all MCP servers
+ */
+export interface AuthenticationResult {
+    success: boolean;
+    token?: string;
+    error?: string;
+    needsReauth?: boolean;
+}
+export declare class MCPAuthenticationMiddleware {
+    private static instance;
+    private oauth;
+    private logger;
+    private lastAuthCheck;
+    private authCheckInterval;
+    private constructor();
+    static getInstance(): MCPAuthenticationMiddleware;
+    /**
+     * Ensure authentication is valid before MCP operations
+     */
+    ensureAuthenticated(): Promise<AuthenticationResult>;
+    /**
+     * Check if authentication status should be verified
+     */
+    private shouldCheckAuth;
+    /**
+     * Handle authentication errors with automatic retry
+     */
+    handleAuthError(error: any): Promise<AuthenticationResult>;
+    /**
+     * Check if an error is authentication-related
+     */
+    private isAuthError;
+    /**
+     * Get ServiceNow instance information
+     */
+    getInstanceInfo(): Promise<{
+        instance: string;
+        authenticated: boolean;
+    }>;
+    /**
+     * Wrapper for MCP operations with authentication
+     */
+    withAuth<T>(operation: (token: string) => Promise<T>): Promise<T>;
+    /**
+     * Get authentication headers for HTTP requests
+     */
+    getAuthHeaders(): Promise<{
+        [key: string]: string;
+    }>;
+    /**
+     * Force authentication refresh
+     */
+    forceRefresh(): Promise<AuthenticationResult>;
+}
+export declare const mcpAuth: MCPAuthenticationMiddleware;
+//# sourceMappingURL=mcp-auth-middleware.d.ts.map

package/dist/utils/mcp-auth-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-auth-middleware.d.ts","sourceRoot":"","sources":["../../src/utils/mcp-auth-middleware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,2BAA2B;IACtC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA8B;IACrD,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,iBAAiB,CAAyB;IAElD,OAAO;WAKO,WAAW,IAAI,2BAA2B;IAOxD;;OAEG;IACG,mBAAmB,IAAI,OAAO,CAAC,oBAAoB,CAAC;IA4C1D;;OAEG;IACH,OAAO,CAAC,eAAe;IAOvB;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAqChE;;OAEG;IACH,OAAO,CAAC,WAAW;IAyBnB;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IAU9E;;OAEG;IACG,QAAQ,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA2BvE;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAc1D;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAmCpD;AAGD,eAAO,MAAM,OAAO,6BAA4C,CAAC"}