crewly 1.13.0 → 1.14.0

package/dist/cli/backend/src/services/agent/oauth-relogin-monitor.service.js

@@ -0,0 +1,508 @@
+/**
+ * OAuth Relogin Monitor Service
+ *
+ * Monitors PTY session output for OAuth token expiry errors and orchestrates
+ * the full human-in-the-loop OAuth re-authentication flow:
+ *
+ * 1. **Detect**: Watch PTY output for authentication_error + expired token
+ * 2. **Login**: Auto-send `/login` command to trigger OAuth flow
+ * 3. **Capture**: Extract the OAuth URL from PTY output after /login
+ * 4. **Notify**: Emit `agent:oauth_url` event so orchestrator/Slack can forward to user
+ * 5. **Callback**: Accept auth code via API and write it to PTY to complete login
+ *
+ * Follows the PTY subscription pattern from ContextWindowMonitorService and
+ * RuntimeExitMonitorService.
+ *
+ * @module services/agent/oauth-relogin-monitor
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { LoggerService } from '../core/logger.service.js';
+import { getSessionBackendSync, } from '../session/index.js';
+import { stripAnsiCodes } from '../../utils/terminal-output.utils.js';
+import { OAUTH_RELOGIN_CONSTANTS, OAUTH_ERROR_PATTERN_SETS, RUNTIME_TYPES, } from '../../constants.js';
+// =============================================================================
+// Service
+// =============================================================================
+/**
+ * Monitors PTY sessions for OAuth token expiry errors and orchestrates the
+ * full OAuth re-authentication flow including URL capture and event notification.
+ *
+ * @example
+ * ```typescript
+ * const monitor = OAuthReloginMonitorService.getInstance();
+ * monitor.setEventBusService(eventBus);
+ * monitor.startMonitoring('agent-dev-001', 'claude-code');
+ *
+ * // User sends back auth code via API:
+ * OAuthReloginMonitorService.submitOAuthCode('agent-dev-001', 'auth-code-123');
+ * ```
+ */
+export class OAuthReloginMonitorService {
+    static instance = null;
+    logger;
+    /** Per-session monitoring state */
+    sessions = new Map();
+    /** EventBus for publishing oauth_url events */
+    eventBusService = null;
+    /** Callback invoked when an OAuth URL is captured (for orchestrator/Slack integration) */
+    onOAuthUrlCallback = null;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('OAuthReloginMonitor');
+    }
+    /**
+     * Get the singleton instance.
+     *
+     * @returns The OAuthReloginMonitorService singleton
+     */
+    static getInstance() {
+        if (!OAuthReloginMonitorService.instance) {
+            OAuthReloginMonitorService.instance = new OAuthReloginMonitorService();
+        }
+        return OAuthReloginMonitorService.instance;
+    }
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance() {
+        if (OAuthReloginMonitorService.instance) {
+            OAuthReloginMonitorService.instance.destroy();
+        }
+        OAuthReloginMonitorService.instance = null;
+    }
+    /**
+     * Set the EventBus dependency for publishing OAuth URL events.
+     *
+     * @param eventBus - The EventBusService instance
+     */
+    setEventBusService(eventBus) {
+        this.eventBusService = eventBus;
+    }
+    /**
+     * Register a callback invoked when an OAuth URL is captured.
+     * Used for direct notification (e.g., Slack) without going through EventBus subscriptions.
+     *
+     * @param callback - Called with (sessionName, oauthUrl)
+     */
+    setOnOAuthUrlCallback(callback) {
+        this.onOAuthUrlCallback = callback;
+    }
+    /**
+     * Submit an OAuth authorization code to a session's PTY.
+     *
+     * After the user visits the OAuth URL and gets an auth code, this method
+     * writes the code into the agent's PTY session to complete authentication.
+     *
+     * @param sessionName - PTY session name
+     * @param code - OAuth authorization code from the user
+     * @returns True if the code was written successfully
+     */
+    static submitOAuthCode(sessionName, code) {
+        const backend = getSessionBackendSync();
+        if (!backend) {
+            return false;
+        }
+        const session = backend.getSession(sessionName);
+        if (!session) {
+            return false;
+        }
+        // Write the code followed by Enter
+        session.write(code + '\r');
+        const instance = OAuthReloginMonitorService.instance;
+        if (instance) {
+            instance.logger.info('OAuth code submitted to session', { sessionName });
+            // Reset capture mode
+            const state = instance.sessions.get(sessionName);
+            if (state) {
+                state.captureMode = 'idle';
+                state.captureBuffer = '';
+                if (state.captureTimeoutTimer) {
+                    clearTimeout(state.captureTimeoutTimer);
+                    state.captureTimeoutTimer = null;
+                }
+            }
+        }
+        return true;
+    }
+    /**
+     * Start monitoring a PTY session for OAuth token expiry errors.
+     *
+     * Subscribes to the session's PTY onData events and watches for
+     * authentication error patterns in the output.
+     *
+     * @param sessionName - PTY session name
+     * @param runtimeType - Agent runtime type (claude-code, gemini-cli, codex-cli)
+     */
+    startMonitoring(sessionName, runtimeType) {
+        // Stop any existing monitoring for this session
+        if (this.sessions.has(sessionName)) {
+            this.stopMonitoring(sessionName);
+        }
+        const backend = getSessionBackendSync();
+        if (!backend) {
+            this.logger.warn('Cannot start OAuth monitoring: session backend not initialized', { sessionName });
+            return;
+        }
+        const session = backend.getSession(sessionName);
+        if (!session) {
+            this.logger.warn('Cannot start OAuth monitoring: session not found', { sessionName });
+            return;
+        }
+        // Subscribe to PTY data
+        const unsubscribe = session.onData((data) => {
+            this.handleData(sessionName, data);
+        });
+        const state = {
+            sessionName,
+            runtimeType,
+            unsubscribe,
+            buffer: '',
+            startedAt: Date.now(),
+            lastReloginAt: 0,
+            reloginInProgress: false,
+            attemptTimestamps: [],
+            debounceTimer: null,
+            captureMode: 'idle',
+            captureBuffer: '',
+            captureTimeoutTimer: null,
+            lastCapturedUrl: null,
+        };
+        this.sessions.set(sessionName, state);
+        this.logger.info('Started OAuth relogin monitoring', {
+            sessionName,
+            runtimeType,
+        });
+    }
+    /**
+     * Stop monitoring a PTY session.
+     *
+     * @param sessionName - PTY session name
+     */
+    stopMonitoring(sessionName) {
+        const state = this.sessions.get(sessionName);
+        if (!state) {
+            return;
+        }
+        if (state.debounceTimer) {
+            clearTimeout(state.debounceTimer);
+        }
+        if (state.captureTimeoutTimer) {
+            clearTimeout(state.captureTimeoutTimer);
+        }
+        state.unsubscribe();
+        this.sessions.delete(sessionName);
+        this.logger.debug('Stopped OAuth relogin monitoring', { sessionName });
+    }
+    /**
+     * Check if a session is being monitored.
+     *
+     * @param sessionName - PTY session name
+     * @returns True if the session is being monitored
+     */
+    isMonitoring(sessionName) {
+        return this.sessions.has(sessionName);
+    }
+    /**
+     * Get the monitoring state for a session (for testing/debugging).
+     *
+     * @param sessionName - PTY session name
+     * @returns The monitoring state or undefined
+     */
+    getState(sessionName) {
+        return this.sessions.get(sessionName);
+    }
+    /**
+     * Destroy all monitoring subscriptions.
+     */
+    destroy() {
+        const sessionNames = [...this.sessions.keys()];
+        for (const sessionName of sessionNames) {
+            this.stopMonitoring(sessionName);
+        }
+        this.logger.debug('All OAuth relogin monitors destroyed');
+    }
+    /**
+     * Handle incoming PTY data for a monitored session.
+     *
+     * In normal mode: checks for OAuth error patterns.
+     * In capture mode: looks for OAuth URL after /login was sent.
+     *
+     * @param sessionName - PTY session name
+     * @param data - Raw PTY output data
+     */
+    handleData(sessionName, data) {
+        const state = this.sessions.get(sessionName);
+        if (!state) {
+            return;
+        }
+        // Strip ANSI codes
+        const clean = stripAnsiCodes(data);
+        // If in capture mode, look for OAuth URL
+        if (state.captureMode === 'capturing') {
+            this.handleCaptureData(state, clean);
+            return;
+        }
+        // Skip if relogin is in progress
+        if (state.reloginInProgress) {
+            return;
+        }
+        // Append to rolling buffer (kept for URL capture and diagnostics)
+        state.buffer += clean;
+        // Cap buffer size
+        if (state.buffer.length > OAUTH_RELOGIN_CONSTANTS.MAX_BUFFER_SIZE) {
+            state.buffer = state.buffer.slice(-OAUTH_RELOGIN_CONSTANTS.MAX_BUFFER_SIZE);
+        }
+        // Skip during startup grace period
+        if (Date.now() - state.startedAt < OAUTH_RELOGIN_CONSTANTS.STARTUP_GRACE_PERIOD_MS) {
+            return;
+        }
+        // Check ONLY the incoming data chunk for OAuth error patterns.
+        // The real Claude Code auth error contains all pattern strings in a single
+        // output message (e.g. 'API Error: 401 {"type":"error","error":{"type":"authentication_error",...}}').
+        // Checking the entire rolling buffer caused false positives when unrelated text
+        // from different output events (e.g. get-agent-logs, skill output) combined
+        // to match patterns across the buffer.
+        if (!this.detectOAuthError(clean)) {
+            return;
+        }
+        // Pattern matched — debounce before sending /login
+        if (state.debounceTimer) {
+            clearTimeout(state.debounceTimer);
+        }
+        state.debounceTimer = setTimeout(() => {
+            this.triggerRelogin(sessionName).catch((err) => {
+                this.logger.error('Failed to trigger OAuth relogin', {
+                    sessionName,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            });
+        }, OAUTH_RELOGIN_CONSTANTS.DETECTION_DEBOUNCE_MS);
+    }
+    /**
+     * Handle PTY data while in URL capture mode.
+     *
+     * Accumulates output and scans for an HTTPS URL that looks like an OAuth
+     * authorization endpoint.
+     *
+     * @param state - Session monitoring state
+     * @param data - Cleaned PTY output data
+     */
+    handleCaptureData(state, data) {
+        state.captureBuffer += data;
+        // Cap capture buffer
+        if (state.captureBuffer.length > OAUTH_RELOGIN_CONSTANTS.URL_CAPTURE_BUFFER_SIZE) {
+            state.captureBuffer = state.captureBuffer.slice(-OAUTH_RELOGIN_CONSTANTS.URL_CAPTURE_BUFFER_SIZE);
+        }
+        // Try to extract an OAuth URL from the capture buffer.
+        // OAuth URLs typically contain oauth, authorize, login, or auth in the path.
+        // We use a simple approach: find any https:// URL and check for auth-related paths.
+        const url = this.extractOAuthUrl(state.captureBuffer);
+        if (!url) {
+            return;
+        }
+        // URL found — stop capturing
+        state.captureMode = 'idle';
+        state.captureBuffer = '';
+        state.lastCapturedUrl = url;
+        if (state.captureTimeoutTimer) {
+            clearTimeout(state.captureTimeoutTimer);
+            state.captureTimeoutTimer = null;
+        }
+        this.logger.info('Captured OAuth URL from PTY output', {
+            sessionName: state.sessionName,
+            url,
+        });
+        // Emit event and invoke callback
+        this.emitOAuthUrlEvent(state.sessionName, url);
+    }
+    /**
+     * Extract an OAuth URL from terminal output.
+     *
+     * Looks for HTTPS URLs that appear to be OAuth authorization endpoints.
+     * Matches URLs containing common OAuth path segments: /oauth, /authorize,
+     * /login, /auth, /consent.
+     *
+     * @param buffer - Terminal output buffer
+     * @returns The OAuth URL or null if not found
+     */
+    extractOAuthUrl(buffer) {
+        // Match https:// URLs — extract until whitespace or end of string.
+        // Using a simple, non-backtracking pattern to avoid ReDoS.
+        const urlStart = buffer.indexOf('https://');
+        if (urlStart === -1) {
+            return null;
+        }
+        // Extract URL: scan forward from https:// until whitespace or control char
+        let urlEnd = urlStart + 8; // past "https://"
+        while (urlEnd < buffer.length) {
+            const ch = buffer.charCodeAt(urlEnd);
+            // Stop at whitespace, control chars, or common terminal artifacts
+            if (ch <= 32 || ch === 62 /* > */ || ch === 60 /* < */) {
+                break;
+            }
+            urlEnd++;
+        }
+        const url = buffer.slice(urlStart, urlEnd);
+        // Validate: must have a host and look like an OAuth URL
+        if (url.length < 20) {
+            return null;
+        }
+        // Check for common OAuth path segments (case-insensitive)
+        const lowerUrl = url.toLowerCase();
+        const oauthIndicators = ['/oauth', '/authorize', '/login', '/auth', '/consent'];
+        const isOAuthUrl = oauthIndicators.some((indicator) => lowerUrl.includes(indicator));
+        if (!isOAuthUrl) {
+            return null;
+        }
+        return url;
+    }
+    /**
+     * Emit an `agent:oauth_url` event via the EventBus and invoke the callback.
+     *
+     * @param sessionName - PTY session name
+     * @param url - OAuth URL captured from PTY output
+     */
+    emitOAuthUrlEvent(sessionName, url) {
+        // Publish via EventBus (for subscription-based notification)
+        if (this.eventBusService) {
+            const event = {
+                id: uuidv4(),
+                type: 'agent:oauth_url',
+                timestamp: new Date().toISOString(),
+                teamId: '',
+                teamName: '',
+                memberId: '',
+                memberName: '',
+                sessionName,
+                previousValue: '',
+                newValue: url,
+                changedField: 'oauthUrl',
+            };
+            this.eventBusService.publish(event);
+            this.logger.info('Published agent:oauth_url event', {
+                sessionName,
+                url,
+            });
+        }
+        // Invoke direct callback (for Slack/orchestrator integration)
+        if (this.onOAuthUrlCallback) {
+            try {
+                this.onOAuthUrlCallback(sessionName, url);
+            }
+            catch (error) {
+                this.logger.warn('onOAuthUrl callback error', {
+                    sessionName,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+    }
+    /**
+     * Detect OAuth error patterns in the buffer using string matching.
+     *
+     * Uses plain string indexOf (case-insensitive via lowercasing) instead of
+     * regex to prevent ReDoS vulnerabilities. Each pattern set requires ALL
+     * strings in the set to be present (AND logic).
+     *
+     * @param buffer - Terminal output buffer to check
+     * @returns True if an OAuth error pattern is detected
+     */
+    detectOAuthError(buffer) {
+        const lowerBuffer = buffer.toLowerCase();
+        const matchedSet = OAUTH_ERROR_PATTERN_SETS.find((patternSet) => patternSet.every((pattern) => lowerBuffer.includes(pattern.toLowerCase())));
+        if (matchedSet) {
+            this.logger.info('OAuth error pattern detected', {
+                matchedPatterns: matchedSet,
+                bufferTail: buffer.slice(-500),
+            });
+        }
+        return !!matchedSet;
+    }
+    /**
+     * Send the /login command to a PTY session to re-authenticate.
+     *
+     * After sending /login, enters URL capture mode to extract the OAuth URL
+     * from the subsequent PTY output.
+     *
+     * @param sessionName - PTY session name
+     */
+    async triggerRelogin(sessionName) {
+        const state = this.sessions.get(sessionName);
+        if (!state || state.reloginInProgress) {
+            return;
+        }
+        // Check cooldown
+        const now = Date.now();
+        if (now - state.lastReloginAt < OAUTH_RELOGIN_CONSTANTS.RELOGIN_COOLDOWN_MS) {
+            this.logger.debug('OAuth relogin skipped: cooldown active', {
+                sessionName,
+                cooldownRemainingMs: OAUTH_RELOGIN_CONSTANTS.RELOGIN_COOLDOWN_MS - (now - state.lastReloginAt),
+            });
+            return;
+        }
+        // Clean up old attempt timestamps outside the window
+        state.attemptTimestamps = state.attemptTimestamps.filter((ts) => now - ts < OAUTH_RELOGIN_CONSTANTS.ATTEMPT_WINDOW_MS);
+        // Check attempt limit
+        if (state.attemptTimestamps.length >= OAUTH_RELOGIN_CONSTANTS.MAX_ATTEMPTS_PER_WINDOW) {
+            this.logger.warn('OAuth relogin skipped: max attempts reached in window', {
+                sessionName,
+                attempts: state.attemptTimestamps.length,
+                maxAttempts: OAUTH_RELOGIN_CONSTANTS.MAX_ATTEMPTS_PER_WINDOW,
+            });
+            return;
+        }
+        // Get the session to write to
+        const backend = getSessionBackendSync();
+        if (!backend) {
+            this.logger.warn('Cannot send /login: session backend not available', { sessionName });
+            return;
+        }
+        const session = backend.getSession(sessionName);
+        if (!session) {
+            this.logger.warn('Cannot send /login: session not found', { sessionName });
+            return;
+        }
+        state.reloginInProgress = true;
+        try {
+            this.logger.info('Sending /login command for OAuth re-authentication', {
+                sessionName,
+                runtimeType: state.runtimeType,
+                attemptNumber: state.attemptTimestamps.length + 1,
+            });
+            // Send Escape to clear any in-progress input (skip for Gemini — Escape cancels request)
+            if (state.runtimeType !== RUNTIME_TYPES.GEMINI_CLI) {
+                session.write('\x1b');
+                await new Promise(resolve => setTimeout(resolve, OAUTH_RELOGIN_CONSTANTS.PRE_COMMAND_DELAY_MS));
+            }
+            // Write the /login command
+            session.write('/login\r');
+            // Update tracking
+            state.lastReloginAt = now;
+            state.attemptTimestamps.push(now);
+            // Clear error detection buffer
+            state.buffer = '';
+            // Enter URL capture mode to extract the OAuth URL from subsequent output
+            state.captureMode = 'capturing';
+            state.captureBuffer = '';
+            // Set a timeout for URL capture — give up after URL_CAPTURE_TIMEOUT_MS
+            if (state.captureTimeoutTimer) {
+                clearTimeout(state.captureTimeoutTimer);
+            }
+            state.captureTimeoutTimer = setTimeout(() => {
+                if (state.captureMode === 'capturing') {
+                    this.logger.warn('OAuth URL capture timed out', { sessionName });
+                    state.captureMode = 'idle';
+                    state.captureBuffer = '';
+                    state.captureTimeoutTimer = null;
+                }
+            }, OAUTH_RELOGIN_CONSTANTS.URL_CAPTURE_TIMEOUT_MS);
+            this.logger.info('OAuth /login command sent, entering URL capture mode', {
+                sessionName,
+                totalAttempts: state.attemptTimestamps.length,
+            });
+        }
+        finally {
+            state.reloginInProgress = false;
+        }
+    }
+}
+//# sourceMappingURL=oauth-relogin-monitor.service.js.map

package/dist/cli/backend/src/services/agent/oauth-relogin-monitor.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth-relogin-monitor.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/agent/oauth-relogin-monitor.service.ts"],"names":[],"mappings":"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"}

package/dist/cli/backend/src/services/agent/pty-activity-tracker.service.d.ts

@@ -0,0 +1,113 @@
+/**
+ * PTY Activity Tracker Service
+ *
+ * Lightweight singleton that tracks the last PTY output timestamp per session.
+ * Used by IdleDetectionService to determine when agents have been idle
+ * long enough to be suspended.
+ *
+ * @module pty-activity-tracker-service
+ */
+/**
+ * Tracks last PTY output timestamp per session for idle detection.
+ *
+ * This service is intentionally kept simple — it only records timestamps
+ * and answers idle-time queries. It does NOT subscribe to PTY events
+ * itself; the terminal gateway hooks into it via `recordActivity()`.
+ */
+export declare class PtyActivityTrackerService {
+    private static instance;
+    private logger;
+    /** Map of session name to last activity timestamp (epoch ms) — includes both PTY and API */
+    private lastActivityMap;
+    /** Map of session name to last API-only activity timestamp (epoch ms) */
+    private lastApiActivityMap;
+    private constructor();
+    /**
+     * Get the singleton instance.
+     *
+     * @returns The PtyActivityTrackerService singleton
+     */
+    static getInstance(): PtyActivityTrackerService;
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance(): void;
+    /**
+     * Record PTY activity for a session.
+     * Called by the terminal gateway whenever PTY data is received.
+     *
+     * @param sessionName - The session that produced output
+     */
+    recordActivity(sessionName: string): void;
+    /**
+     * Record API-specific activity for a session.
+     * Called by the agent heartbeat middleware when an actual API call is made.
+     * Also records general activity.
+     *
+     * @param sessionName - The session that made an API call
+     */
+    recordApiActivity(sessionName: string): void;
+    /**
+     * Get the API-only idle time in milliseconds for a session.
+     * Unlike getIdleTimeMs(), this only considers API calls — not PTY output.
+     * Used by the heartbeat monitor to distinguish real orchestrator responses
+     * from PTY echo noise (e.g., heartbeat messages echoing back).
+     *
+     * @param sessionName - The session to check
+     * @returns Milliseconds since last API call, or 0 if never recorded
+     */
+    getApiIdleTimeMs(sessionName: string): number;
+    /**
+     * Get the idle time in milliseconds for a session.
+     * Returns 0 if no activity has ever been recorded, treating unknown
+     * sessions as "just started" to prevent premature heartbeat/suspend
+     * actions against agents that haven't produced PTY output yet.
+     *
+     * @param sessionName - The session to check
+     * @returns Milliseconds since last PTY output, or 0 if never recorded
+     */
+    getIdleTimeMs(sessionName: string): number;
+    /**
+     * Check whether a session has been idle for at least the given duration.
+     * Returns false if no activity has ever been recorded for the session,
+     * since "never seen" should not be treated as "idle" — this prevents
+     * newly started agents from being immediately suspended.
+     *
+     * @param sessionName - The session to check
+     * @param durationMs - Required idle duration in milliseconds
+     * @returns True if the session has been idle for at least durationMs
+     */
+    isIdleFor(sessionName: string, durationMs: number): boolean;
+    /**
+     * Check if activity has ever been recorded for a session.
+     *
+     * @param sessionName - The session to check
+     * @returns True if activity has been recorded
+     */
+    hasActivity(sessionName: string): boolean;
+    /**
+     * Record PTY activity only if the output contains meaningful content.
+     * Strips ANSI escape codes (cursor movements, color codes, spinner characters)
+     * and only records activity if the remaining text has sufficient non-whitespace
+     * characters. This prevents TUI noise (spinners, cursor repositioning) from
+     * resetting the idle timer.
+     *
+     * @param sessionName - The session that produced output
+     * @param rawData - Raw PTY output data to evaluate
+     */
+    recordFilteredActivity(sessionName: string, rawData: string): void;
+    /**
+     * Remove tracking data for a session.
+     * Called when a session is terminated or suspended.
+     *
+     * @param sessionName - The session to clear
+     */
+    clearSession(sessionName: string): void;
+    /**
+     * Get the number of tracked sessions.
+     *
+     * @returns Number of sessions with recorded activity
+     */
+    getTrackedSessionCount(): number;
+}
+//# sourceMappingURL=pty-activity-tracker.service.d.ts.map

package/dist/cli/backend/src/services/agent/pty-activity-tracker.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-activity-tracker.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/agent/pty-activity-tracker.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;;;;;GAMG;AACH,qBAAa,yBAAyB;IACrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0C;IACjE,OAAO,CAAC,MAAM,CAAkB;IAEhC,4FAA4F;IAC5F,OAAO,CAAC,eAAe,CAAkC;IAEzD,yEAAyE;IACzE,OAAO,CAAC,kBAAkB,CAAkC;IAE5D,OAAO;IAIP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,yBAAyB;IAO/C;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;OAKG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAIzC;;;;;;OAMG;IACH,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAM5C;;;;;;;;OAQG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAQ7C;;;;;;;;OAQG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAQ1C;;;;;;;;;OASG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAO3D;;;;;OAKG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;;;;;;OASG;IACH,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAOlE;;;;;OAKG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAMvC;;;;OAIG;IACH,sBAAsB,IAAI,MAAM;CAGhC"}