crewly 1.13.0 → 1.14.0

package/dist/cli/backend/src/services/orchestrator/orchestrator-status.service.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Orchestrator Status Service
+ *
+ * Provides utilities to check the status of the orchestrator.
+ * Used by Chat and Slack services to provide appropriate feedback
+ * when the orchestrator is not running.
+ *
+ * @module services/orchestrator/orchestrator-status.service
+ */
+/**
+ * Result of an orchestrator status check
+ */
+export interface OrchestratorStatusResult {
+    /** Whether the orchestrator is active and ready to receive messages */
+    isActive: boolean;
+    /** The current agent status of the orchestrator */
+    agentStatus: string | null;
+    /** Human-readable status message */
+    message: string;
+}
+/**
+ * Check if the orchestrator is currently active and ready to receive messages.
+ *
+ * @returns Promise resolving to true if orchestrator is active
+ *
+ * @example
+ * ```typescript
+ * if (await isOrchestratorActive()) {
+ *   // Safe to send message to orchestrator
+ * } else {
+ *   // Show user-friendly offline message
+ * }
+ * ```
+ */
+export declare function isOrchestratorActive(): Promise<boolean>;
+/**
+ * Get detailed orchestrator status information.
+ *
+ * Uses the storageService.getOrchestratorStatus() method which reads the
+ * orchestrator data directly from storage (not from the teams array).
+ *
+ * @returns Promise resolving to status details including active state and message
+ *
+ * @example
+ * ```typescript
+ * const status = await getOrchestratorStatus();
+ * if (!status.isActive) {
+ *   showError(status.message);
+ * }
+ * ```
+ */
+export declare function getOrchestratorStatus(): Promise<OrchestratorStatusResult>;
+/**
+ * Check if a specific agent is currently active.
+ *
+ * Two liveness paths, checked in order:
+ * 1. **PTY path (unchanged)** — the agent's PTY session exists AND its child
+ *    process (the AI runtime) is alive. This is the ground truth for
+ *    `claude-code`, `gemini-cli` and `codex-cli` runtimes.
+ * 2. **In-process fallback** — in-process Crewly Agent runtimes have no PTY
+ *    session at all, so `sessionExists()` always returns `false` for them.
+ *    When the in-process registry reports a ready runtime for this session
+ *    AND the session's configured runtime type is `crewly-agent`, the agent
+ *    is alive. This mirrors the B0 hot-fix fallback in
+ *    {@link getOrchestratorStatus}.
+ *
+ * The fallback is deliberately narrow: it requires BOTH a ready registry
+ * entry and a `crewly-agent` runtime type. A PTY-less `claude-code` agent
+ * still reports inactive — widening the gate would let dead agents claim
+ * work from the task pool, which is worse than the bug this fixes.
+ *
+ * The registry probe runs before the storage lookup because it is a
+ * synchronous map hit; when it misses (the common case for a genuinely dead
+ * PTY agent) no storage I/O happens at all.
+ *
+ * @param sessionName - The agent's session name to check
+ * @returns Promise resolving to true if the agent's runtime is alive
+ *
+ * @example
+ * ```typescript
+ * // crewly-orc runs in-process with no PTY session
+ * await isAgentActive('crewly-orc'); // true when its runtime is registered and ready
+ * ```
+ */
+export declare function isAgentActive(sessionName: string): Promise<boolean>;
+/**
+ * Get a user-friendly message for when the orchestrator is offline.
+ * Useful for Slack and Chat responses.
+ *
+ * @param includeUrl - Whether to include the dashboard URL in the message
+ * @returns A user-friendly offline message
+ */
+export declare function getOrchestratorOfflineMessage(includeUrl?: boolean): string;
+//# sourceMappingURL=orchestrator-status.service.d.ts.map

package/dist/cli/backend/src/services/orchestrator/orchestrator-status.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-status.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/orchestrator/orchestrator-status.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAG7D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAqJ/E;AAmCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBzE;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,UAAO,GAAG,MAAM,CAMvE"}

package/dist/cli/backend/src/services/orchestrator/orchestrator-status.service.js

@@ -0,0 +1,279 @@
+/**
+ * Orchestrator Status Service
+ *
+ * Provides utilities to check the status of the orchestrator.
+ * Used by Chat and Slack services to provide appropriate feedback
+ * when the orchestrator is not running.
+ *
+ * @module services/orchestrator/orchestrator-status.service
+ */
+import { StorageService } from '../core/storage.service.js';
+import { CREWLY_CONSTANTS, WEB_CONSTANTS } from '../../../../config/index.js';
+import { getSessionBackendSync } from '../session/index.js';
+import { isInProcessRuntimeActive } from '../agent/crewly-agent/in-process-runtime-registry.js';
+import { RUNTIME_TYPES } from '../../constants.js';
+/** Dashboard URL for user-facing messages */
+const DASHBOARD_URL = `http://localhost:${WEB_CONSTANTS.PORTS.FRONTEND}`;
+/**
+ * Check if the orchestrator is currently active and ready to receive messages.
+ *
+ * @returns Promise resolving to true if orchestrator is active
+ *
+ * @example
+ * ```typescript
+ * if (await isOrchestratorActive()) {
+ *   // Safe to send message to orchestrator
+ * } else {
+ *   // Show user-friendly offline message
+ * }
+ * ```
+ */
+export async function isOrchestratorActive() {
+    const status = await getOrchestratorStatus();
+    return status.isActive;
+}
+/**
+ * Get detailed orchestrator status information.
+ *
+ * Uses the storageService.getOrchestratorStatus() method which reads the
+ * orchestrator data directly from storage (not from the teams array).
+ *
+ * @returns Promise resolving to status details including active state and message
+ *
+ * @example
+ * ```typescript
+ * const status = await getOrchestratorStatus();
+ * if (!status.isActive) {
+ *   showError(status.message);
+ * }
+ * ```
+ */
+export async function getOrchestratorStatus() {
+    try {
+        const storageService = StorageService.getInstance();
+        // Use getOrchestratorStatus which reads the orchestrator data directly
+        // The orchestrator is stored separately from the teams array
+        const orchestratorStatus = await storageService.getOrchestratorStatus();
+        // Also check if the PTY session exists - this provides a real-time view
+        // of whether the orchestrator is actually running.
+        // Use the well-known constant as fallback when sessionName isn't stored,
+        // aligning with how the teams controller checks session existence.
+        let sessionExists = false;
+        let sessionCheckPerformed = false;
+        const sessionName = orchestratorStatus?.sessionName || CREWLY_CONSTANTS.SESSIONS.ORCHESTRATOR_NAME;
+        try {
+            const sessionBackend = getSessionBackendSync();
+            if (sessionBackend && sessionName) {
+                sessionExists = sessionBackend.sessionExists(sessionName);
+                sessionCheckPerformed = true;
+            }
+        }
+        catch {
+            // Ignore session check errors - fall back to storage-based status
+        }
+        // Runtime-aware fallback (B0 hot-fix):
+        // The PTY-based `sessionExists()` returns false for in-process Crewly
+        // Agent runtimes because they have no PTY session. Treat the session as
+        // alive when the runtime type is `crewly-agent` AND the in-process
+        // registry confirms a ready runtime is registered. The PTY path is
+        // untouched for `claude-code` / other runtimes.
+        if (!sessionExists
+            && orchestratorStatus?.runtimeType === RUNTIME_TYPES.CREWLY_AGENT
+            && sessionName
+            && isInProcessRuntimeActive(sessionName)) {
+            sessionExists = true;
+            sessionCheckPerformed = true;
+        }
+        if (!orchestratorStatus) {
+            return {
+                isActive: false,
+                agentStatus: null,
+                message: 'Orchestrator not configured. Please set up the orchestrator from the Dashboard.',
+            };
+        }
+        const agentStatus = orchestratorStatus.agentStatus || CREWLY_CONSTANTS.AGENT_STATUSES.INACTIVE;
+        // Orchestrator is active when fully registered via MCP AND the session is
+        // confirmed alive (or the session backend was unavailable to check).
+        // If the session backend confirmed the session is dead, treat as not active.
+        const isRegisteredActive = agentStatus === CREWLY_CONSTANTS.AGENT_STATUSES.ACTIVE
+            && (!sessionCheckPerformed || sessionExists);
+        // Also treat as active when the PTY session exists and the runtime is running
+        // ("started" means Claude Code is running). This aligns with the teams controller
+        // which uses session existence as ground truth for status.
+        const isSessionActive = sessionExists && agentStatus === CREWLY_CONSTANTS.AGENT_STATUSES.STARTED;
+        if (isRegisteredActive || isSessionActive) {
+            return {
+                isActive: true,
+                agentStatus: CREWLY_CONSTANTS.AGENT_STATUSES.ACTIVE,
+                message: 'Orchestrator is active and ready.',
+            };
+        }
+        // Proactive cleanup: if the session backend confirmed the session is dead
+        // but stored status says active, update storage to prevent repeated stale checks
+        // from other callers (QueueProcessor, dashboard).
+        if (sessionCheckPerformed && !sessionExists && agentStatus === CREWLY_CONSTANTS.AGENT_STATUSES.ACTIVE) {
+            try {
+                const storageServiceForCleanup = StorageService.getInstance();
+                await storageServiceForCleanup.updateAgentStatus(sessionName, CREWLY_CONSTANTS.AGENT_STATUSES.INACTIVE);
+            }
+            catch {
+                // Best-effort cleanup — don't let it break the status check
+            }
+        }
+        // Provide context-appropriate message based on status
+        // Note: STARTED without a live session falls here (session died or config is stale)
+        if (agentStatus === CREWLY_CONSTANTS.AGENT_STATUSES.ACTIVATING ||
+            agentStatus === CREWLY_CONSTANTS.AGENT_STATUSES.STARTING ||
+            agentStatus === CREWLY_CONSTANTS.AGENT_STATUSES.STARTED) {
+            return {
+                isActive: false,
+                agentStatus,
+                message: 'Orchestrator is starting up. Please wait a moment and try again.',
+            };
+        }
+        // Self-healing: if the session is alive AND has a running child process
+        // (e.g. claude), but status says inactive, restore to active.
+        // This handles cases where the status got stale due to a transient false
+        // positive in exit detection while the runtime was actually still running.
+        if (sessionExists && sessionCheckPerformed) {
+            let childProcessAlive = false;
+            try {
+                const sessionBackend = getSessionBackendSync();
+                childProcessAlive = !!sessionBackend?.isChildProcessAlive?.(sessionName);
+            }
+            catch {
+                // Ignore check errors
+            }
+            if (childProcessAlive) {
+                // Best-effort: persist the recovered status but return active regardless
+                try {
+                    const storageServiceForRecovery = StorageService.getInstance();
+                    await storageServiceForRecovery.updateAgentStatus(sessionName, CREWLY_CONSTANTS.AGENT_STATUSES.ACTIVE);
+                }
+                catch {
+                    // Best-effort — don't let persist failure block recovery
+                }
+                return {
+                    isActive: true,
+                    agentStatus: CREWLY_CONSTANTS.AGENT_STATUSES.ACTIVE,
+                    message: 'Orchestrator is active and ready (status recovered).',
+                };
+            }
+        }
+        // If session exists but status is not active/started, it may be initializing
+        if (sessionExists) {
+            return {
+                isActive: false,
+                agentStatus,
+                message: 'Orchestrator is starting up. Please wait a moment and try again.',
+            };
+        }
+        return {
+            isActive: false,
+            agentStatus,
+            message: 'Orchestrator is not running. Please start the orchestrator from the Dashboard.',
+        };
+    }
+    catch (error) {
+        return {
+            isActive: false,
+            agentStatus: null,
+            message: `Unable to check orchestrator status: ${error instanceof Error ? error.message : 'Unknown error'}`,
+        };
+    }
+}
+/**
+ * Resolve the configured runtime type for a session name.
+ *
+ * Looks the session up as a team member first, then falls back to the
+ * orchestrator record (the orchestrator lives in its own `orchestrator.json`
+ * and is not part of any team's `members` array).
+ *
+ * Only called on the in-process fallback path in {@link isAgentActive}, so
+ * the extra storage reads never touch the hot PTY path.
+ *
+ * @param sessionName - The session name to resolve a runtime type for
+ * @returns The configured runtime type, or `undefined` when the session is unknown
+ */
+async function resolveRuntimeTypeForSession(sessionName) {
+    const storageService = StorageService.getInstance();
+    const found = await storageService.findMemberBySessionName(sessionName);
+    if (found?.member?.runtimeType) {
+        return found.member.runtimeType;
+    }
+    const orchestrator = await storageService.getOrchestratorStatus();
+    const orchestratorSession = orchestrator?.sessionName || CREWLY_CONSTANTS.SESSIONS.ORCHESTRATOR_NAME;
+    if (orchestrator && orchestratorSession === sessionName) {
+        return orchestrator.runtimeType;
+    }
+    return undefined;
+}
+/**
+ * Check if a specific agent is currently active.
+ *
+ * Two liveness paths, checked in order:
+ * 1. **PTY path (unchanged)** — the agent's PTY session exists AND its child
+ *    process (the AI runtime) is alive. This is the ground truth for
+ *    `claude-code`, `gemini-cli` and `codex-cli` runtimes.
+ * 2. **In-process fallback** — in-process Crewly Agent runtimes have no PTY
+ *    session at all, so `sessionExists()` always returns `false` for them.
+ *    When the in-process registry reports a ready runtime for this session
+ *    AND the session's configured runtime type is `crewly-agent`, the agent
+ *    is alive. This mirrors the B0 hot-fix fallback in
+ *    {@link getOrchestratorStatus}.
+ *
+ * The fallback is deliberately narrow: it requires BOTH a ready registry
+ * entry and a `crewly-agent` runtime type. A PTY-less `claude-code` agent
+ * still reports inactive — widening the gate would let dead agents claim
+ * work from the task pool, which is worse than the bug this fixes.
+ *
+ * The registry probe runs before the storage lookup because it is a
+ * synchronous map hit; when it misses (the common case for a genuinely dead
+ * PTY agent) no storage I/O happens at all.
+ *
+ * @param sessionName - The agent's session name to check
+ * @returns Promise resolving to true if the agent's runtime is alive
+ *
+ * @example
+ * ```typescript
+ * // crewly-orc runs in-process with no PTY session
+ * await isAgentActive('crewly-orc'); // true when its runtime is registered and ready
+ * ```
+ */
+export async function isAgentActive(sessionName) {
+    try {
+        const sessionBackend = getSessionBackendSync();
+        if (sessionBackend && sessionBackend.sessionExists(sessionName)) {
+            // Session exists — check if child process (the AI runtime) is alive
+            if (sessionBackend.isChildProcessAlive?.(sessionName)) {
+                return true;
+            }
+        }
+        // Runtime-aware fallback: in-process Crewly Agent runtimes have no PTY
+        // session. Cheap synchronous registry probe first, storage lookup only
+        // if it hits.
+        if (!isInProcessRuntimeActive(sessionName)) {
+            return false;
+        }
+        const runtimeType = await resolveRuntimeTypeForSession(sessionName);
+        return runtimeType === RUNTIME_TYPES.CREWLY_AGENT;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get a user-friendly message for when the orchestrator is offline.
+ * Useful for Slack and Chat responses.
+ *
+ * @param includeUrl - Whether to include the dashboard URL in the message
+ * @returns A user-friendly offline message
+ */
+export function getOrchestratorOfflineMessage(includeUrl = true) {
+    const baseMessage = 'The orchestrator is currently offline.';
+    if (includeUrl) {
+        return `${baseMessage} Please start it from the Crewly dashboard at ${DASHBOARD_URL}`;
+    }
+    return `${baseMessage} Please start it from the Crewly dashboard.`;
+}
+//# sourceMappingURL=orchestrator-status.service.js.map

package/dist/cli/backend/src/services/orchestrator/orchestrator-status.service.js.map

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

package/dist/cli/backend/src/services/orchestrator/safe-restart.service.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Safe Restart Service
+ *
+ * Manages graceful shutdown and restart of Crewly,
+ * preserving state and enabling seamless recovery.
+ *
+ * @module services/orchestrator/safe-restart
+ */
+import { ResumeInstructions } from '../../types/orchestrator-state.types.js';
+/**
+ * Restart configuration
+ */
+export interface RestartConfig {
+    /** Reason for restart */
+    reason: string;
+    /** Delay before restart in ms */
+    delayMs?: number;
+    /** Skip state save (emergency restart) */
+    skipStateSave?: boolean;
+    /** Command to run after restart */
+    postRestartCommand?: string;
+    /** Notify via Slack */
+    notifySlack?: boolean;
+}
+/**
+ * Restart status
+ */
+export interface RestartStatus {
+    /** Whether a restart is in progress */
+    isRestarting: boolean;
+    /** When restart was scheduled */
+    restartScheduledAt?: string;
+    /** Why restart was scheduled */
+    restartReason?: string;
+    /** Countdown until restart */
+    countdown?: number;
+}
+/**
+ * SafeRestartService class
+ *
+ * Handles graceful shutdown, state preservation, and process restart.
+ * Integrates with state persistence and Slack for notifications.
+ *
+ * @example
+ * ```typescript
+ * const service = getSafeRestartService();
+ *
+ * // Handle startup and resume
+ * const instructions = await service.handleStartup();
+ * if (instructions) {
+ *   // Resume tasks and conversations
+ * }
+ *
+ * // Schedule restart for self-improvement
+ * service.scheduleRestart({
+ *   reason: 'Applying code changes',
+ *   delayMs: 5000,
+ *   notifySlack: true,
+ * });
+ * ```
+ */
+export declare class SafeRestartService {
+    private isRestartingFlag;
+    private restartTimer;
+    private scheduledRestartReason;
+    private scheduledRestartTime;
+    private shutdownCallbacks;
+    private startupCallbacks;
+    private signalHandlersRegistered;
+    private logger;
+    /**
+     * Create a new SafeRestartService
+     *
+     * Note: Does not automatically register signal handlers.
+     * Call registerProcessHandlers() explicitly to enable signal handling.
+     */
+    constructor();
+    /**
+     * Register process signal handlers
+     *
+     * Sets up handlers for SIGTERM, SIGINT, and error events.
+     * Should be called during application initialization.
+     */
+    registerProcessHandlers(): void;
+    /**
+     * Register a callback to run before shutdown
+     *
+     * @param callback - Async function to run during shutdown
+     */
+    onShutdown(callback: () => Promise<void>): void;
+    /**
+     * Register a callback to run after startup
+     *
+     * @param callback - Async function to run with resume instructions
+     */
+    onStartup(callback: (instructions: ResumeInstructions) => Promise<void>): void;
+    /**
+     * Handle application startup
+     *
+     * Initializes state persistence, loads previous state, and runs
+     * startup callbacks with resume instructions.
+     *
+     * @returns Resume instructions if restarting, null for fresh start
+     */
+    handleStartup(): Promise<ResumeInstructions | null>;
+    /**
+     * Initiate graceful shutdown
+     *
+     * Runs all shutdown callbacks and saves state before shutdown.
+     *
+     * @param reason - Reason for shutdown
+     */
+    gracefulShutdown(reason: string): Promise<void>;
+    /**
+     * Emergency shutdown (minimal cleanup)
+     *
+     * Attempts to save state with minimal processing for error scenarios.
+     *
+     * @param reason - Reason for emergency shutdown
+     */
+    emergencyShutdown(reason: string): Promise<void>;
+    /**
+     * Schedule a restart
+     *
+     * Schedules a restart after the specified delay.
+     *
+     * @param config - Restart configuration
+     */
+    scheduleRestart(config: RestartConfig): void;
+    /**
+     * Cancel scheduled restart
+     *
+     * @returns True if a restart was cancelled, false if none scheduled
+     */
+    cancelScheduledRestart(): boolean;
+    /**
+     * Execute restart
+     *
+     * @param config - Restart configuration
+     */
+    private executeRestart;
+    /**
+     * Notify about scheduled restart
+     *
+     * @param reason - Restart reason
+     * @param delayMs - Delay in milliseconds
+     */
+    private notifyRestartScheduled;
+    /**
+     * Get restart status
+     *
+     * @returns Current restart status
+     */
+    getStatus(): RestartStatus;
+    /**
+     * Check if this is a restart (vs fresh start)
+     *
+     * @returns True if this process was started after a restart
+     */
+    isRestart(): boolean;
+    /**
+     * Get restart reason (if restarted)
+     *
+     * @returns Restart reason or undefined for fresh start
+     */
+    getRestartReason(): string | undefined;
+    /**
+     * Check for and execute post-restart command
+     *
+     * Reads the restart marker file and executes any post-restart command.
+     */
+    checkPostRestartCommand(): Promise<void>;
+    /**
+     * Clear shutdown callbacks (for testing)
+     */
+    clearShutdownCallbacks(): void;
+    /**
+     * Clear startup callbacks (for testing)
+     */
+    clearStartupCallbacks(): void;
+}
+/**
+ * Get singleton instance
+ *
+ * @returns SafeRestartService instance
+ */
+export declare function getSafeRestartService(): SafeRestartService;
+/**
+ * Reset instance (for testing)
+ */
+export declare function resetSafeRestartService(): void;
+//# sourceMappingURL=safe-restart.service.d.ts.map

package/dist/cli/backend/src/services/orchestrator/safe-restart.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-restart.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/orchestrator/safe-restart.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAG7E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mCAAmC;IACnC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,YAAY,EAAE,OAAO,CAAC;IACtB,iCAAiC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gCAAgC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAmBD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,sBAAsB,CAAuB;IACrD,OAAO,CAAC,oBAAoB,CAAqB;IACjD,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,gBAAgB,CAEjB;IACP,OAAO,CAAC,wBAAwB,CAAkB;IAClD,OAAO,CAAC,MAAM,CAAqF;IAEnG;;;;;OAKG;;IAKH;;;;;OAKG;IACH,uBAAuB,IAAI,IAAI;IA6B/B;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI/C;;;;OAIG;IACH,SAAS,CACP,QAAQ,EAAE,CAAC,YAAY,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,GAC5D,IAAI;IAIP;;;;;;;OAOG;IACG,aAAa,IAAI,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IA4CzD;;;;;;OAMG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCrD;;;;;;OAMG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWtD;;;;;;OAMG;IACH,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAkB5C;;;;OAIG;IACH,sBAAsB,IAAI,OAAO;IAYjC;;;;OAIG;YACW,cAAc;IAkC5B;;;;;OAKG;YACW,sBAAsB;IAoBpC;;;;OAIG;IACH,SAAS,IAAI,aAAa;IAiB1B;;;;OAIG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAItC;;;;OAIG;IACG,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB9C;;OAEG;IACH,sBAAsB,IAAI,IAAI;IAI9B;;OAEG;IACH,qBAAqB,IAAI,IAAI;CAG9B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CAK1D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAO9C"}