olympus-ai 1.0.0

package/dist/features/background-agent/manager.js

@@ -0,0 +1,412 @@
+/**
+ * Background Agent Manager
+ *
+ * Manages background tasks for the Olympus system.
+ * This is a simplified version that tracks tasks launched via Claude Code's
+ * native Task tool with run_in_background: true.
+ *
+ * Adapted from oh-my-opencode's background-agent feature.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { ConcurrencyManager } from './concurrency.js';
+/** Default task timeout: 30 minutes */
+const DEFAULT_TASK_TTL_MS = 30 * 60 * 1000;
+/** Storage directory for task state */
+const BACKGROUND_TASKS_DIR = join(homedir(), '.claude', '.olympus', 'background-tasks');
+/**
+ * Manages background tasks for the Olympus system.
+ */
+export class BackgroundManager {
+    tasks = new Map();
+    notifications = new Map();
+    concurrencyManager;
+    config;
+    pruneInterval;
+    constructor(config) {
+        this.config = config ?? {};
+        this.concurrencyManager = new ConcurrencyManager(config);
+        this.ensureStorageDir();
+        this.loadPersistedTasks();
+        this.startPruning();
+    }
+    /**
+     * Ensure storage directory exists
+     */
+    ensureStorageDir() {
+        if (!existsSync(BACKGROUND_TASKS_DIR)) {
+            mkdirSync(BACKGROUND_TASKS_DIR, { recursive: true });
+        }
+    }
+    /**
+     * Generate a unique task ID
+     */
+    generateTaskId() {
+        const timestamp = Date.now().toString(36);
+        const random = Math.random().toString(36).substring(2, 8);
+        return `bg_${timestamp}${random}`;
+    }
+    /**
+     * Get storage path for a task
+     */
+    getTaskPath(taskId) {
+        return join(BACKGROUND_TASKS_DIR, `${taskId}.json`);
+    }
+    /**
+     * Persist a task to disk
+     */
+    persistTask(task) {
+        const path = this.getTaskPath(task.id);
+        writeFileSync(path, JSON.stringify(task, null, 2));
+    }
+    /**
+     * Remove persisted task from disk
+     */
+    unpersistTask(taskId) {
+        const path = this.getTaskPath(taskId);
+        if (existsSync(path)) {
+            unlinkSync(path);
+        }
+    }
+    /**
+     * Load persisted tasks from disk
+     */
+    loadPersistedTasks() {
+        if (!existsSync(BACKGROUND_TASKS_DIR))
+            return;
+        try {
+            const { readdirSync } = require('fs');
+            const files = readdirSync(BACKGROUND_TASKS_DIR);
+            for (const file of files) {
+                if (!file.endsWith('.json'))
+                    continue;
+                try {
+                    const path = join(BACKGROUND_TASKS_DIR, file);
+                    const content = readFileSync(path, 'utf-8');
+                    const task = JSON.parse(content);
+                    // Restore dates
+                    task.startedAt = new Date(task.startedAt);
+                    if (task.completedAt) {
+                        task.completedAt = new Date(task.completedAt);
+                    }
+                    if (task.progress?.lastUpdate) {
+                        task.progress.lastUpdate = new Date(task.progress.lastUpdate);
+                    }
+                    if (task.progress?.lastMessageAt) {
+                        task.progress.lastMessageAt = new Date(task.progress.lastMessageAt);
+                    }
+                    this.tasks.set(task.id, task);
+                }
+                catch {
+                    // Skip invalid task files
+                }
+            }
+        }
+        catch {
+            // Ignore errors reading directory
+        }
+    }
+    /**
+     * Start periodic pruning of stale tasks
+     */
+    startPruning() {
+        if (this.pruneInterval)
+            return;
+        this.pruneInterval = setInterval(() => {
+            this.pruneStaleTasksAndNotifications();
+        }, 60000); // Every minute
+        // Don't keep the process alive just for pruning
+        if (this.pruneInterval.unref) {
+            this.pruneInterval.unref();
+        }
+    }
+    /**
+     * Stop periodic pruning
+     */
+    stopPruning() {
+        if (this.pruneInterval) {
+            clearInterval(this.pruneInterval);
+            this.pruneInterval = undefined;
+        }
+    }
+    /**
+     * Remove stale tasks that have exceeded their TTL
+     */
+    pruneStaleTasksAndNotifications() {
+        const now = Date.now();
+        const ttl = this.config.taskTimeoutMs ?? DEFAULT_TASK_TTL_MS;
+        for (const [taskId, task] of this.tasks.entries()) {
+            const age = now - task.startedAt.getTime();
+            if (age > ttl && task.status === 'running') {
+                task.status = 'error';
+                task.error = `Task timed out after ${Math.round(ttl / 60000)} minutes`;
+                task.completedAt = new Date();
+                if (task.concurrencyKey) {
+                    this.concurrencyManager.release(task.concurrencyKey);
+                }
+                this.clearNotificationsForTask(taskId);
+                this.unpersistTask(taskId);
+                this.tasks.delete(taskId);
+            }
+        }
+        // Prune old notifications
+        for (const [sessionId, notifications] of this.notifications.entries()) {
+            const validNotifications = notifications.filter((task) => {
+                const age = now - task.startedAt.getTime();
+                return age <= ttl;
+            });
+            if (validNotifications.length === 0) {
+                this.notifications.delete(sessionId);
+            }
+            else if (validNotifications.length !== notifications.length) {
+                this.notifications.set(sessionId, validNotifications);
+            }
+        }
+    }
+    /**
+     * Register a new background task
+     */
+    async launch(input) {
+        const concurrencyKey = input.agent;
+        // Check max total tasks
+        const maxTotal = this.config.maxTotalTasks ?? 10;
+        const runningCount = Array.from(this.tasks.values()).filter((t) => t.status === 'running').length;
+        if (runningCount >= maxTotal) {
+            throw new Error(`Maximum concurrent background tasks (${maxTotal}) reached. Wait for some tasks to complete.`);
+        }
+        // Acquire concurrency slot
+        await this.concurrencyManager.acquire(concurrencyKey);
+        const taskId = this.generateTaskId();
+        const sessionId = `ses_${this.generateTaskId()}`; // Mock session ID
+        const task = {
+            id: taskId,
+            sessionId,
+            parentSessionId: input.parentSessionId,
+            description: input.description,
+            prompt: input.prompt,
+            agent: input.agent,
+            status: 'running',
+            startedAt: new Date(),
+            progress: {
+                toolCalls: 0,
+                lastUpdate: new Date(),
+            },
+            concurrencyKey,
+        };
+        this.tasks.set(taskId, task);
+        this.persistTask(task);
+        return task;
+    }
+    /**
+     * Resume an existing background task
+     */
+    async resume(input) {
+        const existingTask = this.findBySession(input.sessionId);
+        if (!existingTask) {
+            throw new Error(`Task not found for session: ${input.sessionId}`);
+        }
+        existingTask.status = 'running';
+        existingTask.completedAt = undefined;
+        existingTask.error = undefined;
+        existingTask.parentSessionId = input.parentSessionId;
+        if (!existingTask.progress) {
+            existingTask.progress = { toolCalls: 0, lastUpdate: new Date() };
+        }
+        existingTask.progress.lastUpdate = new Date();
+        this.persistTask(existingTask);
+        return existingTask;
+    }
+    /**
+     * Get a task by ID
+     */
+    getTask(id) {
+        return this.tasks.get(id);
+    }
+    /**
+     * Find a task by session ID
+     */
+    findBySession(sessionId) {
+        for (const task of this.tasks.values()) {
+            if (task.sessionId === sessionId) {
+                return task;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Get all tasks for a parent session
+     */
+    getTasksByParentSession(sessionId) {
+        const result = [];
+        for (const task of this.tasks.values()) {
+            if (task.parentSessionId === sessionId) {
+                result.push(task);
+            }
+        }
+        return result;
+    }
+    /**
+     * Get all tasks (including nested)
+     */
+    getAllTasks() {
+        return Array.from(this.tasks.values());
+    }
+    /**
+     * Get all running tasks
+     */
+    getRunningTasks() {
+        return Array.from(this.tasks.values()).filter((t) => t.status === 'running');
+    }
+    /**
+     * Update task status
+     */
+    updateTaskStatus(taskId, status, result, error) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            return;
+        task.status = status;
+        if (result)
+            task.result = result;
+        if (error)
+            task.error = error;
+        if (status === 'completed' || status === 'error' || status === 'cancelled') {
+            task.completedAt = new Date();
+            if (task.concurrencyKey) {
+                this.concurrencyManager.release(task.concurrencyKey);
+            }
+            this.markForNotification(task);
+        }
+        this.persistTask(task);
+    }
+    /**
+     * Update task progress
+     */
+    updateTaskProgress(taskId, progress) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            return;
+        if (!task.progress) {
+            task.progress = { toolCalls: 0, lastUpdate: new Date() };
+        }
+        Object.assign(task.progress, progress, { lastUpdate: new Date() });
+        this.persistTask(task);
+    }
+    /**
+     * Mark a task for notification to parent session
+     */
+    markForNotification(task) {
+        const queue = this.notifications.get(task.parentSessionId) ?? [];
+        queue.push(task);
+        this.notifications.set(task.parentSessionId, queue);
+    }
+    /**
+     * Get pending notifications for a session
+     */
+    getPendingNotifications(sessionId) {
+        return this.notifications.get(sessionId) ?? [];
+    }
+    /**
+     * Clear notifications for a session
+     */
+    clearNotifications(sessionId) {
+        this.notifications.delete(sessionId);
+    }
+    /**
+     * Clear notifications for a specific task
+     */
+    clearNotificationsForTask(taskId) {
+        for (const [sessionId, tasks] of this.notifications.entries()) {
+            const filtered = tasks.filter((t) => t.id !== taskId);
+            if (filtered.length === 0) {
+                this.notifications.delete(sessionId);
+            }
+            else {
+                this.notifications.set(sessionId, filtered);
+            }
+        }
+    }
+    /**
+     * Remove a task completely
+     */
+    removeTask(taskId) {
+        const task = this.tasks.get(taskId);
+        if (task?.concurrencyKey) {
+            this.concurrencyManager.release(task.concurrencyKey);
+        }
+        this.clearNotificationsForTask(taskId);
+        this.unpersistTask(taskId);
+        this.tasks.delete(taskId);
+    }
+    /**
+     * Format duration for display
+     */
+    formatDuration(start, end) {
+        const duration = (end ?? new Date()).getTime() - start.getTime();
+        const seconds = Math.floor(duration / 1000);
+        const minutes = Math.floor(seconds / 60);
+        const hours = Math.floor(minutes / 60);
+        if (hours > 0) {
+            return `${hours}h ${minutes % 60}m ${seconds % 60}s`;
+        }
+        else if (minutes > 0) {
+            return `${minutes}m ${seconds % 60}s`;
+        }
+        return `${seconds}s`;
+    }
+    /**
+     * Generate a status summary for all tasks
+     */
+    getStatusSummary() {
+        const running = this.getRunningTasks();
+        const all = this.getAllTasks();
+        if (all.length === 0) {
+            return 'No background tasks.';
+        }
+        const lines = [
+            `Background Tasks: ${running.length} running, ${all.length} total`,
+            '',
+        ];
+        for (const task of all) {
+            const duration = this.formatDuration(task.startedAt, task.completedAt);
+            const status = task.status.toUpperCase();
+            const progress = task.progress
+                ? ` (${task.progress.toolCalls} tools)`
+                : '';
+            lines.push(`  [${status}] ${task.description} - ${duration}${progress}`);
+            if (task.error) {
+                lines.push(`    Error: ${task.error}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Cleanup manager (stop pruning, clear state)
+     */
+    cleanup() {
+        this.stopPruning();
+        this.tasks.clear();
+        this.notifications.clear();
+    }
+}
+/** Singleton instance */
+let instance;
+/**
+ * Get the singleton background manager instance
+ */
+export function getBackgroundManager(config) {
+    if (!instance) {
+        instance = new BackgroundManager(config);
+    }
+    return instance;
+}
+/**
+ * Reset the singleton (for testing)
+ */
+export function resetBackgroundManager() {
+    if (instance) {
+        instance.cleanup();
+        instance = undefined;
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/features/background-agent/manager.js.map

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

package/dist/features/background-agent/types.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Background Agent Types
+ *
+ * Type definitions for background task management.
+ *
+ * Adapted from oh-my-opencode's background-agent feature.
+ */
+/**
+ * Status of a background task
+ */
+export type BackgroundTaskStatus = 'pending' | 'running' | 'completed' | 'error' | 'cancelled';
+/**
+ * Progress tracking for a background task
+ */
+export interface TaskProgress {
+    /** Number of tool calls made */
+    toolCalls: number;
+    /** Last tool used */
+    lastTool?: string;
+    /** Last update timestamp */
+    lastUpdate: Date;
+    /** Last message content (truncated) */
+    lastMessage?: string;
+    /** Last message timestamp */
+    lastMessageAt?: Date;
+}
+/**
+ * A background task being managed
+ */
+export interface BackgroundTask {
+    /** Unique task identifier */
+    id: string;
+    /** Session ID for this task */
+    sessionId: string;
+    /** Parent session that launched this task */
+    parentSessionId: string;
+    /** Short description of the task */
+    description: string;
+    /** Original prompt for the task */
+    prompt: string;
+    /** Agent handling the task */
+    agent: string;
+    /** Current status */
+    status: BackgroundTaskStatus;
+    /** When the task started */
+    startedAt: Date;
+    /** When the task completed (if completed) */
+    completedAt?: Date;
+    /** Result output (if completed) */
+    result?: string;
+    /** Error message (if failed) */
+    error?: string;
+    /** Progress tracking */
+    progress?: TaskProgress;
+    /** Key for concurrency tracking */
+    concurrencyKey?: string;
+}
+/**
+ * Input for launching a new background task
+ */
+export interface LaunchInput {
+    /** Short description of the task */
+    description: string;
+    /** Prompt for the task */
+    prompt: string;
+    /** Agent to handle the task */
+    agent: string;
+    /** Parent session ID */
+    parentSessionId: string;
+    /** Model configuration (optional) */
+    model?: string;
+}
+/**
+ * Input for resuming a background task
+ */
+export interface ResumeInput {
+    /** Session ID to resume */
+    sessionId: string;
+    /** New prompt to send */
+    prompt: string;
+    /** Parent session ID */
+    parentSessionId: string;
+}
+/**
+ * Configuration for background task concurrency
+ */
+export interface BackgroundTaskConfig {
+    /** Default concurrency limit (0 = unlimited) */
+    defaultConcurrency?: number;
+    /** Per-model concurrency limits */
+    modelConcurrency?: Record<string, number>;
+    /** Per-provider concurrency limits */
+    providerConcurrency?: Record<string, number>;
+    /** Maximum total background tasks */
+    maxTotalTasks?: number;
+    /** Task timeout in milliseconds */
+    taskTimeoutMs?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/features/background-agent/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/background-agent/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,SAAS,GACT,WAAW,GACX,OAAO,GACP,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,UAAU,EAAE,IAAI,CAAC;IACjB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,4BAA4B;IAC5B,SAAS,EAAE,IAAI,CAAC;IAChB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,sCAAsC;IACtC,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/features/background-agent/types.js

@@ -0,0 +1,9 @@
+/**
+ * Background Agent Types
+ *
+ * Type definitions for background task management.
+ *
+ * Adapted from oh-my-opencode's background-agent feature.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/features/background-agent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/background-agent/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/features/background-tasks.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Background Task Management
+ *
+ * Provides utilities for managing background task execution,
+ * similar to oh-my-opencode's Background Task Manager.
+ *
+ * In Claude Code, background execution is controlled via:
+ * - Bash tool's `run_in_background` parameter
+ * - Task tool's `run_in_background` parameter
+ * - TaskOutput tool for retrieving results
+ *
+ * This module provides:
+ * - Decision heuristics for when to use background execution
+ * - Task lifecycle management
+ * - Concurrency limit enforcement
+ * - System prompt guidance for agents
+ */
+import type { BackgroundTask, SessionState, PluginConfig } from '../shared/types.js';
+/**
+ * Default maximum concurrent background tasks
+ */
+export declare const DEFAULT_MAX_BACKGROUND_TASKS = 5;
+/**
+ * Patterns that indicate long-running operations
+ * These should typically run in background
+ */
+export declare const LONG_RUNNING_PATTERNS: RegExp[];
+/**
+ * Patterns that should always run blocking (foreground)
+ * These are quick operations or need immediate feedback
+ */
+export declare const BLOCKING_PATTERNS: RegExp[];
+/**
+ * Result of background execution decision
+ */
+export interface TaskExecutionDecision {
+    /** Whether to run in background */
+    runInBackground: boolean;
+    /** Human-readable reason for the decision */
+    reason: string;
+    /** Estimated duration category */
+    estimatedDuration: 'quick' | 'medium' | 'long' | 'unknown';
+    /** Confidence level of the decision */
+    confidence: 'high' | 'medium' | 'low';
+}
+/**
+ * Determine if a command should run in background
+ *
+ * This is the core heuristic function that decides whether a command
+ * should be executed with `run_in_background: true`.
+ *
+ * @param command - The command to analyze
+ * @param currentBackgroundCount - Number of currently running background tasks
+ * @param maxBackgroundTasks - Maximum allowed concurrent background tasks
+ * @returns Decision object with recommendation and reasoning
+ */
+export declare function shouldRunInBackground(command: string, currentBackgroundCount?: number, maxBackgroundTasks?: number): TaskExecutionDecision;
+/**
+ * BackgroundTaskManager interface
+ *
+ * Manages background task lifecycle, enforces concurrency limits,
+ * and provides utilities for tracking task status.
+ */
+export interface BackgroundTaskManager {
+    /** Register a new background task */
+    registerTask(agentName: string, prompt: string): BackgroundTask;
+    /** Get all background tasks */
+    getTasks(): BackgroundTask[];
+    /** Get tasks by status */
+    getTasksByStatus(status: BackgroundTask['status']): BackgroundTask[];
+    /** Get count of running tasks */
+    getRunningCount(): number;
+    /** Check if we can start a new background task */
+    canStartNewTask(): boolean;
+    /** Update task status */
+    updateTaskStatus(taskId: string, status: BackgroundTask['status'], result?: string, error?: string): void;
+    /** Mark task as completed */
+    completeTask(taskId: string, result: string): void;
+    /** Mark task as failed */
+    failTask(taskId: string, error: string): void;
+    /** Remove completed tasks older than specified age (ms) */
+    pruneCompletedTasks(maxAge?: number): number;
+    /** Get the maximum allowed background tasks */
+    getMaxTasks(): number;
+    /** Check if a command should run in background */
+    shouldRunInBackground(command: string): TaskExecutionDecision;
+}
+/**
+ * Create a BackgroundTaskManager instance
+ */
+export declare function createBackgroundTaskManager(state: SessionState, config: PluginConfig): BackgroundTaskManager;
+/**
+ * System prompt guidance for background task execution
+ *
+ * This text should be appended to the system prompt to guide agents
+ * on when and how to use background execution.
+ */
+export declare function getBackgroundTaskGuidance(maxBackgroundTasks?: number): string;
+//# sourceMappingURL=background-tasks.d.ts.map

package/dist/features/background-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-tasks.d.ts","sourceRoot":"","sources":["../../src/features/background-tasks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAErF;;GAEG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,qBAAqB,UAuCjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,UA0B7B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mCAAmC;IACnC,eAAe,EAAE,OAAO,CAAC;IACzB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,iBAAiB,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3D,uCAAuC;IACvC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,sBAAsB,GAAE,MAAU,EAClC,kBAAkB,GAAE,MAAqC,GACxD,qBAAqB,CAoDvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC;IAEhE,+BAA+B;IAC/B,QAAQ,IAAI,cAAc,EAAE,CAAC;IAE7B,0BAA0B;IAC1B,gBAAgB,CAAC,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,cAAc,EAAE,CAAC;IAErE,iCAAiC;IACjC,eAAe,IAAI,MAAM,CAAC;IAE1B,kDAAkD;IAClD,eAAe,IAAI,OAAO,CAAC;IAE3B,yBAAyB;IACzB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1G,6BAA6B;IAC7B,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnD,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9C,2DAA2D;IAC3D,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE7C,+CAA+C;IAC/C,WAAW,IAAI,MAAM,CAAC;IAEtB,kDAAkD;IAClD,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAAC;CAC/D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,YAAY,GACnB,qBAAqB,CAkEvB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,kBAAkB,GAAE,MAAqC,GAAG,MAAM,CAkD3G"}