@nexus-cortex/executors 4.26.0

package/dist/utils/SchemaValidator.js

@@ -0,0 +1,67 @@
+/**
+ * JSON Schema Validator
+ *
+ * Simple validator for tool parameters using JSON Schema
+ */
+/**
+ * Validate parameters against JSON Schema
+ *
+ * @param schema JSON Schema definition
+ * @param params Parameters to validate (mutated in-place for type coercion)
+ * @returns Error message if invalid, null if valid
+ */
+export function validateSchema(schema, params) {
+    // Check required fields
+    if (schema.required) {
+        for (const field of schema.required) {
+            if (!(field in params)) {
+                return `Missing required parameter: ${field}`;
+            }
+        }
+    }
+    // Check parameter types (with automatic coercion for numbers)
+    if (schema.properties) {
+        for (const [key, propSchema] of Object.entries(schema.properties)) {
+            if (key in params) {
+                let value = params[key];
+                const type = propSchema.type;
+                // Auto-coerce string numbers to actual numbers
+                // This handles cases where parameters come in as strings (e.g., from XML parsing)
+                // but the schema expects numeric types
+                if (type === 'number' && typeof value === 'string') {
+                    const numValue = Number(value);
+                    if (!isNaN(numValue)) {
+                        params[key] = numValue;
+                        value = numValue;
+                    }
+                }
+                // Type checking
+                if (type === 'string' && typeof value !== 'string') {
+                    return `Parameter '${key}' must be a string`;
+                }
+                if (type === 'number' && typeof value !== 'number') {
+                    return `Parameter '${key}' must be a number`;
+                }
+                if (type === 'boolean' && typeof value !== 'boolean') {
+                    return `Parameter '${key}' must be a boolean`;
+                }
+                if (type === 'object' && typeof value !== 'object') {
+                    return `Parameter '${key}' must be an object`;
+                }
+                if (type === 'array' && !Array.isArray(value)) {
+                    return `Parameter '${key}' must be an array`;
+                }
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Schema Validator class (Gemini-CLI-compatible validation patterns)
+ */
+export class SchemaValidator {
+    static validate(schema, params) {
+        return validateSchema(schema, params);
+    }
+}
+//# sourceMappingURL=SchemaValidator.js.map

package/dist/utils/SchemaValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaValidator.js","sourceRoot":"","sources":["../../src/utils/SchemaValidator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,MAAkB,EAAE,MAAW;IAC5D,wBAAwB;IACxB,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC,EAAE,CAAC;gBACvB,OAAO,+BAA+B,KAAK,EAAE,CAAC;YAChD,CAAC;QACH,CAAC;IACH,CAAC;IAED,8DAA8D;IAC9D,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YAClE,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;gBAClB,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBACxB,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;gBAE7B,+CAA+C;gBAC/C,kFAAkF;gBAClF,uCAAuC;gBACvC,IAAI,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;oBAC/B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACrB,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;wBACvB,KAAK,GAAG,QAAQ,CAAC;oBACnB,CAAC;gBACH,CAAC;gBAED,gBAAgB;gBAChB,IAAI,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBACnD,OAAO,cAAc,GAAG,oBAAoB,CAAC;gBAC/C,CAAC;gBACD,IAAI,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBACnD,OAAO,cAAc,GAAG,oBAAoB,CAAC;gBAC/C,CAAC;gBACD,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;oBACrD,OAAO,cAAc,GAAG,qBAAqB,CAAC;gBAChD,CAAC;gBACD,IAAI,IAAI,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBACnD,OAAO,cAAc,GAAG,qBAAqB,CAAC;gBAChD,CAAC;gBACD,IAAI,IAAI,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC9C,OAAO,cAAc,GAAG,oBAAoB,CAAC;gBAC/C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,eAAe;IAC1B,MAAM,CAAC,QAAQ,CAAC,MAAkB,EAAE,MAAW;QAC7C,OAAO,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/utils/SessionLock.d.ts

@@ -0,0 +1,96 @@
+/**
+ * SessionLock - Manage exclusive access to tmux sessions
+ *
+ * Prevents conflicts when multiple agents/users try to access
+ * the same tmux session simultaneously.
+ *
+ * Features:
+ * - File-based locking mechanism
+ * - Automatic lock expiration (prevents deadlocks)
+ * - Lock ownership tracking
+ * - Shared vs exclusive locks
+ */
+export interface LockInfo {
+    sessionId: string;
+    owner: string;
+    acquired: Date;
+    expires: Date;
+    type: 'exclusive' | 'shared';
+}
+export interface LockOptions {
+    timeout?: number;
+    retryInterval?: number;
+    maxRetries?: number;
+    type?: 'exclusive' | 'shared';
+}
+/**
+ * SessionLock - Distributed locking for tmux sessions
+ *
+ * Uses file-based locks stored in .cortex/tmux-sessions/locks/
+ * Handles lock acquisition, release, and automatic expiration.
+ */
+export declare class SessionLock {
+    private lockDir;
+    private defaultTimeout;
+    constructor(projectPath?: string);
+    /**
+     * Ensure lock directory exists
+     */
+    private ensureLockDir;
+    /**
+     * Get lock file path for a session
+     */
+    private getLockPath;
+    /**
+     * Acquire lock on a session
+     *
+     * @param sessionId Session to lock
+     * @param owner Identifier for lock owner (e.g., agent ID, user ID)
+     * @param options Lock options
+     * @returns true if lock acquired, false otherwise
+     */
+    acquireLock(sessionId: string, owner: string, options?: LockOptions): Promise<boolean>;
+    /**
+     * Release lock on a session
+     *
+     * @param sessionId Session to unlock
+     * @param owner Lock owner (must match to release)
+     * @returns true if lock released, false if not owned by this owner
+     */
+    releaseLock(sessionId: string, owner: string): Promise<boolean>;
+    /**
+     * Check if session is locked
+     *
+     * @param sessionId Session to check
+     * @returns Lock info if locked, null otherwise
+     */
+    isLocked(sessionId: string): LockInfo | null;
+    /**
+     * Read lock information from file
+     */
+    private readLock;
+    /**
+     * Extend lock expiration time
+     *
+     * @param sessionId Session to extend lock for
+     * @param owner Lock owner (must match)
+     * @param additionalTime Additional time in ms
+     * @returns true if extended, false otherwise
+     */
+    extendLock(sessionId: string, owner: string, additionalTime?: number): Promise<boolean>;
+    /**
+     * Force release all locks (admin operation)
+     * Use with caution!
+     */
+    forceReleaseAll(): Promise<number>;
+    /**
+     * Clean up expired locks
+     * Should be called periodically
+     */
+    cleanupExpiredLocks(): Promise<number>;
+    /**
+     * Get all active locks
+     */
+    getActiveLocks(): Promise<LockInfo[]>;
+}
+//# sourceMappingURL=SessionLock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionLock.d.ts","sourceRoot":"","sources":["../../src/utils/SessionLock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,IAAI,CAAC;IACf,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,WAAW,GAAG,QAAQ,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;CAC/B;AAED;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAiB;gBAE3B,WAAW,CAAC,EAAE,MAAM;IAMhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;;;;;;OAOG;IACU,WAAW,CACtB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,OAAO,CAAC;IAqDnB;;;;;;OAMG;IACU,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAyB5E;;;;;OAKG;IACI,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAsBnD;;OAEG;IACH,OAAO,CAAC,QAAQ;IAoBhB;;;;;;;OAOG;IACU,UAAU,CACrB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,cAAc,GAAE,MAAc,GAC7B,OAAO,CAAC,OAAO,CAAC;IAmBnB;;;OAGG;IACU,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC;IAuB/C;;;OAGG;IACU,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;IA4BnD;;OAEG;IACU,cAAc,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;CAsBnD"}

package/dist/utils/SessionLock.js

@@ -0,0 +1,276 @@
+/**
+ * SessionLock - Manage exclusive access to tmux sessions
+ *
+ * Prevents conflicts when multiple agents/users try to access
+ * the same tmux session simultaneously.
+ *
+ * Features:
+ * - File-based locking mechanism
+ * - Automatic lock expiration (prevents deadlocks)
+ * - Lock ownership tracking
+ * - Shared vs exclusive locks
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * SessionLock - Distributed locking for tmux sessions
+ *
+ * Uses file-based locks stored in .cortex/tmux-sessions/locks/
+ * Handles lock acquisition, release, and automatic expiration.
+ */
+export class SessionLock {
+    lockDir;
+    defaultTimeout = 30000; // 30 seconds
+    constructor(projectPath) {
+        const basePath = projectPath || process.cwd();
+        this.lockDir = path.join(basePath, '.cortex', 'tmux-sessions', 'locks');
+        this.ensureLockDir();
+    }
+    /**
+     * Ensure lock directory exists
+     */
+    ensureLockDir() {
+        if (!fs.existsSync(this.lockDir)) {
+            fs.mkdirSync(this.lockDir, { recursive: true });
+        }
+    }
+    /**
+     * Get lock file path for a session
+     */
+    getLockPath(sessionId) {
+        return path.join(this.lockDir, `${sessionId}.lock`);
+    }
+    /**
+     * Acquire lock on a session
+     *
+     * @param sessionId Session to lock
+     * @param owner Identifier for lock owner (e.g., agent ID, user ID)
+     * @param options Lock options
+     * @returns true if lock acquired, false otherwise
+     */
+    async acquireLock(sessionId, owner, options = {}) {
+        const timeout = options.timeout || this.defaultTimeout;
+        const retryInterval = options.retryInterval || 100;
+        const maxRetries = options.maxRetries || Math.floor(timeout / retryInterval);
+        const lockType = options.type || 'exclusive';
+        const lockPath = this.getLockPath(sessionId);
+        const lockInfo = {
+            sessionId,
+            owner,
+            acquired: new Date(),
+            expires: new Date(Date.now() + timeout),
+            type: lockType
+        };
+        for (let i = 0; i < maxRetries; i++) {
+            try {
+                // Check if lock exists
+                if (fs.existsSync(lockPath)) {
+                    const existingLock = this.readLock(sessionId);
+                    if (existingLock) {
+                        // Check if lock has expired
+                        if (new Date() > existingLock.expires) {
+                            // Lock expired, remove it
+                            fs.unlinkSync(lockPath);
+                        }
+                        else if (existingLock.type === 'shared' && lockType === 'shared') {
+                            // Both are shared locks, allow access
+                            return true;
+                        }
+                        else {
+                            // Lock is still valid, wait and retry
+                            await new Promise(resolve => setTimeout(resolve, retryInterval));
+                            continue;
+                        }
+                    }
+                }
+                // Try to acquire lock (atomic write)
+                fs.writeFileSync(lockPath, JSON.stringify(lockInfo, null, 2), { flag: 'wx' });
+                return true;
+            }
+            catch (error) {
+                if (error.code === 'EEXIST') {
+                    // File was created by another process, retry
+                    await new Promise(resolve => setTimeout(resolve, retryInterval));
+                    continue;
+                }
+                throw error;
+            }
+        }
+        return false; // Failed to acquire lock
+    }
+    /**
+     * Release lock on a session
+     *
+     * @param sessionId Session to unlock
+     * @param owner Lock owner (must match to release)
+     * @returns true if lock released, false if not owned by this owner
+     */
+    async releaseLock(sessionId, owner) {
+        const lockPath = this.getLockPath(sessionId);
+        if (!fs.existsSync(lockPath)) {
+            return true; // No lock exists
+        }
+        const lock = this.readLock(sessionId);
+        if (!lock) {
+            return true; // Invalid lock file
+        }
+        // Only owner can release the lock
+        if (lock.owner !== owner) {
+            return false;
+        }
+        try {
+            fs.unlinkSync(lockPath);
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * Check if session is locked
+     *
+     * @param sessionId Session to check
+     * @returns Lock info if locked, null otherwise
+     */
+    isLocked(sessionId) {
+        const lock = this.readLock(sessionId);
+        if (!lock) {
+            return null;
+        }
+        // Check if lock has expired
+        if (new Date() > lock.expires) {
+            // Clean up expired lock
+            const lockPath = this.getLockPath(sessionId);
+            try {
+                fs.unlinkSync(lockPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            return null;
+        }
+        return lock;
+    }
+    /**
+     * Read lock information from file
+     */
+    readLock(sessionId) {
+        const lockPath = this.getLockPath(sessionId);
+        if (!fs.existsSync(lockPath)) {
+            return null;
+        }
+        try {
+            const data = fs.readFileSync(lockPath, 'utf-8');
+            const lock = JSON.parse(data);
+            return {
+                ...lock,
+                acquired: new Date(lock.acquired),
+                expires: new Date(lock.expires)
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Extend lock expiration time
+     *
+     * @param sessionId Session to extend lock for
+     * @param owner Lock owner (must match)
+     * @param additionalTime Additional time in ms
+     * @returns true if extended, false otherwise
+     */
+    async extendLock(sessionId, owner, additionalTime = 30000) {
+        const lock = this.readLock(sessionId);
+        if (!lock || lock.owner !== owner) {
+            return false;
+        }
+        // Extend expiration
+        lock.expires = new Date(lock.expires.getTime() + additionalTime);
+        const lockPath = this.getLockPath(sessionId);
+        try {
+            fs.writeFileSync(lockPath, JSON.stringify(lock, null, 2));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Force release all locks (admin operation)
+     * Use with caution!
+     */
+    async forceReleaseAll() {
+        let released = 0;
+        try {
+            const files = fs.readdirSync(this.lockDir);
+            for (const file of files) {
+                if (file.endsWith('.lock')) {
+                    try {
+                        fs.unlinkSync(path.join(this.lockDir, file));
+                        released++;
+                    }
+                    catch {
+                        // Ignore errors
+                    }
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist or not readable
+        }
+        return released;
+    }
+    /**
+     * Clean up expired locks
+     * Should be called periodically
+     */
+    async cleanupExpiredLocks() {
+        let cleaned = 0;
+        try {
+            const files = fs.readdirSync(this.lockDir);
+            for (const file of files) {
+                if (file.endsWith('.lock')) {
+                    const sessionId = file.replace('.lock', '');
+                    const lock = this.readLock(sessionId);
+                    if (lock && new Date() > lock.expires) {
+                        try {
+                            fs.unlinkSync(path.join(this.lockDir, file));
+                            cleaned++;
+                        }
+                        catch {
+                            // Ignore errors
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist or not readable
+        }
+        return cleaned;
+    }
+    /**
+     * Get all active locks
+     */
+    async getActiveLocks() {
+        const locks = [];
+        try {
+            const files = fs.readdirSync(this.lockDir);
+            for (const file of files) {
+                if (file.endsWith('.lock')) {
+                    const sessionId = file.replace('.lock', '');
+                    const lock = this.readLock(sessionId);
+                    if (lock && new Date() <= lock.expires) {
+                        locks.push(lock);
+                    }
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist or not readable
+        }
+        return locks;
+    }
+}
+//# sourceMappingURL=SessionLock.js.map

package/dist/utils/SessionLock.js.map

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

package/dist/utils/SessionPersistence.d.ts

@@ -0,0 +1,89 @@
+import { TmuxSessionMetadata } from './TmuxManager.js';
+export declare class SessionPersistence {
+    private metadataDir;
+    constructor(projectPath?: string);
+    /**
+     * Ensure the metadata directory exists
+     */
+    private ensureMetadataDir;
+    /**
+     * Get the file path for a session's metadata
+     */
+    private getMetadataPath;
+    /**
+     * Save session metadata to disk
+     * @param metadata Session metadata to save
+     */
+    saveSession(metadata: TmuxSessionMetadata): Promise<void>;
+    /**
+     * Load session metadata from disk
+     * @param sessionId Session identifier
+     * @returns Session metadata or null if not found
+     */
+    loadSession(sessionId: string): Promise<TmuxSessionMetadata | null>;
+    /**
+     * Update lastUsed timestamp for a session
+     * @param sessionId Session identifier
+     */
+    touchSession(sessionId: string): Promise<void>;
+    /**
+     * Delete session metadata from disk
+     * @param sessionId Session identifier
+     */
+    deleteSession(sessionId: string): Promise<void>;
+    /**
+     * List all stored session metadata
+     * @returns Array of session metadata
+     */
+    listSessions(): Promise<TmuxSessionMetadata[]>;
+    /**
+     * Clean up metadata for sessions that no longer exist in tmux
+     * @param activeSessions Array of active session IDs from tmux
+     */
+    cleanupOrphaned(activeSessions: string[]): Promise<number>;
+    /**
+     * Clean up sessions that haven't been used in a specified time period
+     * @param maxAgeMs Maximum age in milliseconds
+     */
+    cleanupStale(maxAgeMs: number): Promise<number>;
+    /**
+     * Get metadata directory path
+     */
+    getMetadataDirectory(): string;
+    /**
+     * Recover sessions on startup
+     * Checks which persisted sessions still exist in tmux
+     * and cleans up metadata for sessions that no longer exist
+     *
+     * @param activeSessions Array of currently active tmux session IDs
+     * @returns Object with recovered and cleaned session counts
+     */
+    recoverSessions(activeSessions: string[]): Promise<{
+        recovered: number;
+        cleaned: number;
+        total: number;
+    }>;
+    /**
+     * Auto-cleanup stale and orphaned sessions
+     * Should be called periodically (e.g., every hour)
+     *
+     * @param activeSessions Current active tmux sessions
+     * @param maxAgeHours Maximum age in hours before session is considered stale
+     * @returns Cleanup statistics
+     */
+    autoCleanup(activeSessions: string[], maxAgeHours?: number): Promise<{
+        orphaned: number;
+        stale: number;
+        total: number;
+    }>;
+    /**
+     * Get session statistics
+     */
+    getStats(): Promise<{
+        totalSessions: number;
+        oldestSession: Date | null;
+        newestSession: Date | null;
+        averageAge: number;
+    }>;
+}
+//# sourceMappingURL=SessionPersistence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionPersistence.d.ts","sourceRoot":"","sources":["../../src/utils/SessionPersistence.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,CAAC,EAAE,MAAM;IAMhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;;OAGG;IACU,WAAW,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBtE;;;;OAIG;IACU,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAqBhF;;;OAGG;IACU,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3D;;;OAGG;IACU,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW5D;;;OAGG;IACU,YAAY,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAyB3D;;;OAGG;IACU,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBvE;;;OAGG;IACU,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB5D;;OAEG;IACI,oBAAoB,IAAI,MAAM;IAIrC;;;;;;;OAOG;IACU,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAC9D,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IA0BF;;;;;;;OAOG;IACU,WAAW,CACtB,cAAc,EAAE,MAAM,EAAE,EACxB,WAAW,GAAE,MAAW,GACvB,OAAO,CAAC;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IAYF;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC;QAC/B,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;QAC3B,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;QAC3B,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CAyBH"}