@sparkleideas/swarm 3.0.0-alpha.6-patch.25 → 3.0.0-alpha.6-patch.27

package/dist/domain/entities/task.js

@@ -0,0 +1,261 @@
+/**
+ * Task Entity - Domain Layer
+ *
+ * Core domain entity representing a task in the swarm.
+ * Tasks are units of work assigned to agents.
+ *
+ * @module v3/swarm/domain/entities
+ */
+import { randomUUID } from 'crypto';
+/**
+ * Task - Entity
+ *
+ * Represents a unit of work with lifecycle management,
+ * dependency tracking, and result storage.
+ */
+export class Task {
+    _id;
+    _title;
+    _description;
+    _type;
+    _priority;
+    _status;
+    _assignedAgentId;
+    _dependencies;
+    _metadata;
+    _input;
+    _output;
+    _error;
+    _retryCount;
+    _maxRetries;
+    _timeout;
+    _createdAt;
+    _startedAt;
+    _completedAt;
+    constructor(props) {
+        const now = new Date();
+        this._id = props.id ?? randomUUID();
+        this._title = props.title;
+        this._description = props.description;
+        this._type = props.type;
+        this._priority = props.priority ?? 'normal';
+        this._status = props.status ?? 'pending';
+        this._assignedAgentId = props.assignedAgentId;
+        this._dependencies = new Set(props.dependencies ?? []);
+        this._metadata = props.metadata ?? {};
+        this._input = props.input;
+        this._output = props.output;
+        this._error = props.error;
+        this._retryCount = props.retryCount ?? 0;
+        this._maxRetries = props.maxRetries ?? 3;
+        this._timeout = props.timeout ?? 300000; // 5 minutes default
+        this._createdAt = props.createdAt ?? now;
+        this._startedAt = props.startedAt;
+        this._completedAt = props.completedAt;
+    }
+    static create(props) {
+        return new Task(props);
+    }
+    static fromPersistence(props) {
+        return new Task(props);
+    }
+    // Getters
+    get id() {
+        return this._id;
+    }
+    get title() {
+        return this._title;
+    }
+    get description() {
+        return this._description;
+    }
+    get type() {
+        return this._type;
+    }
+    get priority() {
+        return this._priority;
+    }
+    get status() {
+        return this._status;
+    }
+    get assignedAgentId() {
+        return this._assignedAgentId;
+    }
+    get dependencies() {
+        return Array.from(this._dependencies);
+    }
+    get metadata() {
+        return { ...this._metadata };
+    }
+    get input() {
+        return this._input;
+    }
+    get output() {
+        return this._output;
+    }
+    get error() {
+        return this._error;
+    }
+    get retryCount() {
+        return this._retryCount;
+    }
+    get maxRetries() {
+        return this._maxRetries;
+    }
+    get timeout() {
+        return this._timeout;
+    }
+    get createdAt() {
+        return new Date(this._createdAt);
+    }
+    get startedAt() {
+        return this._startedAt ? new Date(this._startedAt) : undefined;
+    }
+    get completedAt() {
+        return this._completedAt ? new Date(this._completedAt) : undefined;
+    }
+    // ============================================================================
+    // Business Logic
+    // ============================================================================
+    /**
+     * Queue the task for execution
+     */
+    queue() {
+        if (this._status !== 'pending') {
+            throw new Error('Can only queue pending tasks');
+        }
+        this._status = 'queued';
+    }
+    /**
+     * Assign task to an agent
+     */
+    assign(agentId) {
+        if (this._status !== 'queued' && this._status !== 'pending') {
+            throw new Error('Can only assign queued or pending tasks');
+        }
+        this._assignedAgentId = agentId;
+        this._status = 'assigned';
+    }
+    /**
+     * Start task execution
+     */
+    start() {
+        if (this._status !== 'assigned') {
+            throw new Error('Can only start assigned tasks');
+        }
+        this._status = 'running';
+        this._startedAt = new Date();
+    }
+    /**
+     * Complete the task successfully
+     */
+    complete(output) {
+        if (this._status !== 'running') {
+            throw new Error('Can only complete running tasks');
+        }
+        this._status = 'completed';
+        this._output = output;
+        this._completedAt = new Date();
+    }
+    /**
+     * Mark task as failed
+     */
+    fail(error) {
+        if (this._status !== 'running' && this._status !== 'assigned') {
+            throw new Error('Can only fail running or assigned tasks');
+        }
+        this._error = error;
+        this._retryCount++;
+        if (this._retryCount >= this._maxRetries) {
+            this._status = 'failed';
+            this._completedAt = new Date();
+        }
+        else {
+            // Reset for retry
+            this._status = 'queued';
+            this._assignedAgentId = undefined;
+        }
+    }
+    /**
+     * Cancel the task
+     */
+    cancel() {
+        if (this._status === 'completed' || this._status === 'failed') {
+            throw new Error('Cannot cancel finished tasks');
+        }
+        this._status = 'cancelled';
+        this._completedAt = new Date();
+    }
+    /**
+     * Check if all dependencies are satisfied
+     */
+    areDependenciesSatisfied(completedTaskIds) {
+        for (const depId of this._dependencies) {
+            if (!completedTaskIds.has(depId)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Check if task can be retried
+     */
+    canRetry() {
+        return this._retryCount < this._maxRetries;
+    }
+    /**
+     * Get execution duration in milliseconds
+     */
+    getExecutionDuration() {
+        if (!this._startedAt)
+            return null;
+        const endTime = this._completedAt ?? new Date();
+        return endTime.getTime() - this._startedAt.getTime();
+    }
+    /**
+     * Check if task is timed out
+     */
+    isTimedOut() {
+        if (this._status !== 'running' || !this._startedAt)
+            return false;
+        return Date.now() - this._startedAt.getTime() > this._timeout;
+    }
+    /**
+     * Priority comparison (for sorting)
+     */
+    comparePriority(other) {
+        const priorityOrder = {
+            critical: 0,
+            high: 1,
+            normal: 2,
+            low: 3,
+        };
+        return priorityOrder[this._priority] - priorityOrder[other.priority];
+    }
+    toPersistence() {
+        return {
+            id: this._id,
+            title: this._title,
+            description: this._description,
+            type: this._type,
+            priority: this._priority,
+            status: this._status,
+            assignedAgentId: this._assignedAgentId,
+            dependencies: Array.from(this._dependencies),
+            metadata: this._metadata,
+            input: this._input,
+            output: this._output,
+            error: this._error,
+            retryCount: this._retryCount,
+            maxRetries: this._maxRetries,
+            timeout: this._timeout,
+            createdAt: this._createdAt.toISOString(),
+            startedAt: this._startedAt?.toISOString(),
+            completedAt: this._completedAt?.toISOString(),
+        };
+    }
+    toJSON() {
+        return this.toPersistence();
+    }
+}
+//# sourceMappingURL=task.js.map

package/dist/domain/entities/task.js.map

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

package/dist/domain/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Swarm Domain Layer - Public Exports
+ *
+ * @module v3/swarm/domain
+ */
+export { Agent, type AgentStatus, type AgentRole, type AgentProps, } from './entities/agent.js';
+export { Task, type TaskStatus, type TaskPriority, type TaskProps, } from './entities/task.js';
+export { type IAgentRepository, type AgentQueryOptions, type AgentStatistics, } from './repositories/agent-repository.interface.js';
+export { type ITaskRepository, type TaskQueryOptions, type TaskStatistics, } from './repositories/task-repository.interface.js';
+export { CoordinationService, type LoadBalancingStrategy, type TaskAssignmentResult, type SwarmHealth, } from './services/coordination-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/domain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,KAAK,EACL,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,IAAI,EACJ,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,SAAS,GACf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,8CAA8C,CAAC;AAEtD,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,6CAA6C,CAAC;AAGrD,OAAO,EACL,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,WAAW,GACjB,MAAM,oCAAoC,CAAC"}

package/dist/domain/index.js

@@ -0,0 +1,11 @@
+/**
+ * Swarm Domain Layer - Public Exports
+ *
+ * @module v3/swarm/domain
+ */
+// Entities
+export { Agent, } from './entities/agent.js';
+export { Task, } from './entities/task.js';
+// Domain Services
+export { CoordinationService, } from './services/coordination-service.js';
+//# sourceMappingURL=index.js.map

package/dist/domain/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,WAAW;AACX,OAAO,EACL,KAAK,GAIN,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,IAAI,GAIL,MAAM,oBAAoB,CAAC;AAe5B,kBAAkB;AAClB,OAAO,EACL,mBAAmB,GAIpB,MAAM,oCAAoC,CAAC"}

package/dist/domain/repositories/agent-repository.interface.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Agent Repository Interface - Domain Layer
+ *
+ * Defines the contract for agent persistence.
+ *
+ * @module v3/swarm/domain/repositories
+ */
+import { Agent, AgentStatus, AgentRole } from '../entities/agent.js';
+/**
+ * Agent query options
+ */
+export interface AgentQueryOptions {
+    status?: AgentStatus;
+    role?: AgentRole;
+    domain?: string;
+    parentId?: string;
+    capability?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Agent statistics
+ */
+export interface AgentStatistics {
+    total: number;
+    byStatus: Record<AgentStatus, number>;
+    byRole: Record<string, number>;
+    byDomain: Record<string, number>;
+    totalTasksCompleted: number;
+    averageUtilization: number;
+}
+/**
+ * Agent Repository Interface
+ */
+export interface IAgentRepository {
+    save(agent: Agent): Promise<void>;
+    findById(id: string): Promise<Agent | null>;
+    findByName(name: string): Promise<Agent | null>;
+    delete(id: string): Promise<boolean>;
+    exists(id: string): Promise<boolean>;
+    saveMany(agents: Agent[]): Promise<void>;
+    findByIds(ids: string[]): Promise<Agent[]>;
+    deleteMany(ids: string[]): Promise<number>;
+    findAll(options?: AgentQueryOptions): Promise<Agent[]>;
+    findByStatus(status: AgentStatus): Promise<Agent[]>;
+    findByRole(role: AgentRole): Promise<Agent[]>;
+    findByDomain(domain: string): Promise<Agent[]>;
+    findByParent(parentId: string): Promise<Agent[]>;
+    findByCapability(capability: string): Promise<Agent[]>;
+    findAvailable(): Promise<Agent[]>;
+    getStatistics(): Promise<AgentStatistics>;
+    count(options?: AgentQueryOptions): Promise<number>;
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=agent-repository.interface.d.ts.map

package/dist/domain/repositories/agent-repository.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-repository.interface.d.ts","sourceRoot":"","sources":["../../../src/domain/repositories/agent-repository.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAE/B,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAC5C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAGrC,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAG3C,OAAO,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACvD,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACpD,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACjD,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACvD,aAAa,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAGlC,aAAa,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1C,KAAK,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAGpD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/domain/repositories/agent-repository.interface.js

@@ -0,0 +1,9 @@
+/**
+ * Agent Repository Interface - Domain Layer
+ *
+ * Defines the contract for agent persistence.
+ *
+ * @module v3/swarm/domain/repositories
+ */
+export {};
+//# sourceMappingURL=agent-repository.interface.js.map

package/dist/domain/repositories/agent-repository.interface.js.map

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

package/dist/domain/repositories/task-repository.interface.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Task Repository Interface - Domain Layer
+ *
+ * Defines the contract for task persistence.
+ *
+ * @module v3/swarm/domain/repositories
+ */
+import { Task, TaskStatus, TaskPriority } from '../entities/task.js';
+/**
+ * Task query options
+ */
+export interface TaskQueryOptions {
+    status?: TaskStatus;
+    priority?: TaskPriority;
+    type?: string;
+    assignedAgentId?: string;
+    limit?: number;
+    offset?: number;
+    orderBy?: 'createdAt' | 'priority' | 'startedAt';
+    orderDirection?: 'asc' | 'desc';
+}
+/**
+ * Task statistics
+ */
+export interface TaskStatistics {
+    total: number;
+    byStatus: Record<TaskStatus, number>;
+    byPriority: Record<TaskPriority, number>;
+    byType: Record<string, number>;
+    averageExecutionTime: number;
+    successRate: number;
+    retryRate: number;
+}
+/**
+ * Task Repository Interface
+ */
+export interface ITaskRepository {
+    save(task: Task): Promise<void>;
+    findById(id: string): Promise<Task | null>;
+    delete(id: string): Promise<boolean>;
+    exists(id: string): Promise<boolean>;
+    saveMany(tasks: Task[]): Promise<void>;
+    findByIds(ids: string[]): Promise<Task[]>;
+    deleteMany(ids: string[]): Promise<number>;
+    findAll(options?: TaskQueryOptions): Promise<Task[]>;
+    findByStatus(status: TaskStatus): Promise<Task[]>;
+    findByPriority(priority: TaskPriority): Promise<Task[]>;
+    findByAgent(agentId: string): Promise<Task[]>;
+    findPending(): Promise<Task[]>;
+    findQueued(): Promise<Task[]>;
+    findRunning(): Promise<Task[]>;
+    findTimedOut(): Promise<Task[]>;
+    getNextTask(agentCapabilities?: string[]): Promise<Task | null>;
+    getTaskQueue(limit?: number): Promise<Task[]>;
+    getStatistics(): Promise<TaskStatistics>;
+    count(options?: TaskQueryOptions): Promise<number>;
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=task-repository.interface.d.ts.map

package/dist/domain/repositories/task-repository.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-repository.interface.d.ts","sourceRoot":"","sources":["../../../src/domain/repositories/task-repository.interface.ts"],"names":[],"mappings":"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"}

package/dist/domain/repositories/task-repository.interface.js

@@ -0,0 +1,9 @@
+/**
+ * Task Repository Interface - Domain Layer
+ *
+ * Defines the contract for task persistence.
+ *
+ * @module v3/swarm/domain/repositories
+ */
+export {};
+//# sourceMappingURL=task-repository.interface.js.map

package/dist/domain/repositories/task-repository.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-repository.interface.js","sourceRoot":"","sources":["../../../src/domain/repositories/task-repository.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/domain/services/coordination-service.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Coordination Domain Service - Domain Layer
+ *
+ * Contains coordination logic that spans multiple entities.
+ * Handles task assignment, load balancing, and swarm orchestration.
+ *
+ * @module v3/swarm/domain/services
+ */
+import { IAgentRepository } from '../repositories/agent-repository.interface.js';
+import { ITaskRepository } from '../repositories/task-repository.interface.js';
+/**
+ * Load balancing strategy
+ */
+export type LoadBalancingStrategy = 'round-robin' | 'least-loaded' | 'capability-match' | 'random';
+/**
+ * Task assignment result
+ */
+export interface TaskAssignmentResult {
+    success: boolean;
+    taskId: string;
+    agentId?: string;
+    reason?: string;
+}
+/**
+ * Swarm health status
+ */
+export interface SwarmHealth {
+    healthy: boolean;
+    totalAgents: number;
+    activeAgents: number;
+    errorAgents: number;
+    pendingTasks: number;
+    runningTasks: number;
+    queueDepth: number;
+    averageUtilization: number;
+    issues: string[];
+}
+/**
+ * Coordination Domain Service
+ *
+ * Provides domain-level coordination operations.
+ */
+export declare class CoordinationService {
+    private readonly agentRepository;
+    private readonly taskRepository;
+    constructor(agentRepository: IAgentRepository, taskRepository: ITaskRepository);
+    /**
+     * Assign a task to the best available agent
+     */
+    assignTask(taskId: string, strategy?: LoadBalancingStrategy): Promise<TaskAssignmentResult>;
+    /**
+     * Find the best agent for a task based on strategy
+     */
+    private findBestAgent;
+    private roundRobinSelection;
+    private leastLoadedSelection;
+    private capabilityMatchSelection;
+    private extractRequiredCapabilities;
+    /**
+     * Process completed tasks and release agents
+     */
+    processTaskCompletion(taskId: string, output?: unknown): Promise<void>;
+    /**
+     * Queue tasks whose dependencies are now satisfied
+     */
+    private queueDependentTasks;
+    /**
+     * Handle task failure with retry logic
+     */
+    processTaskFailure(taskId: string, error: string): Promise<boolean>;
+    /**
+     * Get overall swarm health
+     */
+    getSwarmHealth(): Promise<SwarmHealth>;
+    /**
+     * Scale agents based on workload
+     */
+    calculateScalingRecommendation(): Promise<{
+        action: 'scale-up' | 'scale-down' | 'none';
+        count: number;
+        reason: string;
+    }>;
+}
+//# sourceMappingURL=coordination-service.d.ts.map

package/dist/domain/services/coordination-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordination-service.d.ts","sourceRoot":"","sources":["../../../src/domain/services/coordination-service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,+CAA+C,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG,cAAc,GAAG,kBAAkB,GAAG,QAAQ,CAAC;AAEnG;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc;gBADd,eAAe,EAAE,gBAAgB,EACjC,cAAc,EAAE,eAAe;IAGlD;;OAEG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,qBAA0C,GACnD,OAAO,CAAC,oBAAoB,CAAC;IA8BhC;;OAEG;YACW,aAAa;IA0B3B,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,wBAAwB;IA0BhC,OAAO,CAAC,2BAA2B;IAoBnC;;OAEG;IACG,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB5E;;OAEG;YACW,mBAAmB;IAgBjC;;OAEG;IACG,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqBzE;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IAoC5C;;OAEG;IACG,8BAA8B,IAAI,OAAO,CAAC;QAC9C,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,MAAM,CAAC;QAC3C,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CAgCH"}