synapse-mcp 1.0.0

package/dist/services/interfaces.d.ts

@@ -0,0 +1,537 @@
+import type { HostConfig, ContainerInfo, ContainerStats, HostStatus, LogEntry, ImageInfo } from "../types.js";
+import type Docker from "dockerode";
+import type { NodeSSH } from "node-ssh";
+import type { HostResources } from "./ssh.js";
+import type { DockerSystemInfo, DockerDiskUsage, PruneResult, ListImagesOptions } from "./docker.js";
+import type { PoolStats } from "./ssh-pool.js";
+import type { ComposeProject } from "./compose.js";
+/**
+ * Docker service interface for managing Docker containers, images, and resources.
+ * Provides operations for container lifecycle management, image operations, system queries,
+ * and Docker daemon interactions across multiple hosts.
+ */
+export interface IDockerService {
+    /**
+     * Get a Docker client instance for the specified host configuration.
+     * Clients are cached per host to reuse connections.
+     *
+     * @param config - Host configuration containing connection details
+     * @returns Docker client instance (dockerode)
+     */
+    getDockerClient(config: HostConfig): Docker;
+    /**
+     * List containers across multiple hosts with optional filtering.
+     *
+     * @param hosts - Array of host configurations to query
+     * @param options - Filtering options
+     * @param options.state - Filter by container state (all, running, stopped, paused)
+     * @param options.nameFilter - Filter by container name (partial match)
+     * @param options.imageFilter - Filter by image name (partial match)
+     * @param options.labelFilter - Filter by label (format: "key=value")
+     * @returns Array of containers with their details and host information
+     */
+    listContainers(hosts: HostConfig[], options?: {
+        state?: "all" | "running" | "stopped" | "paused";
+        nameFilter?: string;
+        imageFilter?: string;
+        labelFilter?: string;
+    }): Promise<ContainerInfo[]>;
+    /**
+     * Perform a lifecycle action on a container.
+     *
+     * @param containerId - Container ID or name
+     * @param action - Action to perform (start, stop, restart, pause, unpause)
+     * @param host - Host configuration where container is located
+     */
+    containerAction(containerId: string, action: "start" | "stop" | "restart" | "pause" | "unpause", host: HostConfig): Promise<void>;
+    /**
+     * Retrieve logs from a container.
+     *
+     * @param containerId - Container ID or name
+     * @param host - Host configuration where container is located
+     * @param options - Log retrieval options
+     * @param options.lines - Number of lines to retrieve (default: 100)
+     * @param options.since - Show logs since timestamp or duration (e.g., "2023-01-01T00:00:00Z" or "10m")
+     * @param options.until - Show logs until timestamp or duration
+     * @param options.stream - Stream to retrieve (all, stdout, stderr)
+     * @returns Array of log entries with timestamps and content
+     */
+    getContainerLogs(containerId: string, host: HostConfig, options?: {
+        lines?: number;
+        since?: string;
+        until?: string;
+        stream?: "all" | "stdout" | "stderr";
+    }): Promise<LogEntry[]>;
+    /**
+     * Get resource usage statistics for a container.
+     *
+     * @param containerId - Container ID or name
+     * @param host - Host configuration where container is located
+     * @returns Resource statistics including CPU, memory, network, and I/O
+     */
+    getContainerStats(containerId: string, host: HostConfig): Promise<ContainerStats>;
+    /**
+     * Find which host a container is running on.
+     * Searches across all provided hosts.
+     *
+     * @param containerId - Container ID or name to find
+     * @param hosts - Array of host configurations to search
+     * @returns Host config and container info if found, null otherwise
+     */
+    findContainerHost(containerId: string, hosts: HostConfig[]): Promise<{
+        host: HostConfig;
+        container: Docker.ContainerInfo;
+    } | null>;
+    /**
+     * Get Docker daemon status and version info for multiple hosts.
+     *
+     * @param hosts - Array of host configurations to check
+     * @returns Array of host statuses with daemon info and reachability
+     */
+    getHostStatus(hosts: HostConfig[]): Promise<HostStatus[]>;
+    /**
+     * List Docker images across multiple hosts with optional filtering.
+     *
+     * @param hosts - Array of host configurations to query
+     * @param options - Filtering options (dangling, reference, etc.)
+     * @returns Array of images with their details and host information
+     */
+    listImages(hosts: HostConfig[], options?: ListImagesOptions): Promise<ImageInfo[]>;
+    /**
+     * Get detailed information about a container.
+     *
+     * @param containerId - Container ID or name
+     * @param host - Host configuration where container is located
+     * @returns Full container inspection data from Docker API
+     */
+    inspectContainer(containerId: string, host: HostConfig): Promise<Docker.ContainerInspectInfo>;
+    /**
+     * Get Docker daemon system information.
+     *
+     * @param host - Host configuration to query
+     * @returns System info including version, OS, architecture, and resource limits
+     */
+    getDockerInfo(host: HostConfig): Promise<DockerSystemInfo>;
+    /**
+     * Get Docker disk usage information.
+     *
+     * @param host - Host configuration to query
+     * @returns Disk usage breakdown for images, containers, volumes, and build cache
+     */
+    getDockerDiskUsage(host: HostConfig): Promise<DockerDiskUsage>;
+    /**
+     * Remove unused Docker resources (prune operation).
+     *
+     * @param host - Host configuration where pruning should occur
+     * @param target - Resource type to prune (containers, images, volumes, networks, buildcache, all)
+     * @returns Array of prune results showing what was removed and space reclaimed
+     */
+    pruneDocker(host: HostConfig, target: "containers" | "images" | "volumes" | "networks" | "buildcache" | "all"): Promise<PruneResult[]>;
+    /**
+     * Pull a Docker image from a registry.
+     *
+     * @param imageName - Image name with optional tag (e.g., "nginx:latest")
+     * @param host - Host configuration where image should be pulled
+     * @returns Operation status
+     */
+    pullImage(imageName: string, host: HostConfig): Promise<{
+        status: string;
+    }>;
+    /**
+     * Recreate a container with the same configuration.
+     * Optionally pulls the latest image before recreating.
+     *
+     * @param containerId - Container ID or name to recreate
+     * @param host - Host configuration where container is located
+     * @param options - Recreate options
+     * @param options.pull - Whether to pull latest image before recreating
+     * @returns Operation status and new container ID
+     */
+    recreateContainer(containerId: string, host: HostConfig, options?: {
+        pull?: boolean;
+    }): Promise<{
+        status: string;
+        containerId: string;
+    }>;
+    /**
+     * Remove a Docker image.
+     *
+     * @param imageId - Image ID or name to remove
+     * @param host - Host configuration where image is located
+     * @param options - Removal options
+     * @param options.force - Force removal even if image is in use
+     * @returns Operation status
+     */
+    removeImage(imageId: string, host: HostConfig, options?: {
+        force?: boolean;
+    }): Promise<{
+        status: string;
+    }>;
+    /**
+     * Build a Docker image from a Dockerfile.
+     *
+     * @param host - Host configuration where build should occur
+     * @param options - Build options
+     * @param options.context - Path to build context directory
+     * @param options.tag - Tag for the built image
+     * @param options.dockerfile - Path to Dockerfile (relative to context, default: "Dockerfile")
+     * @param options.noCache - Disable build cache
+     * @returns Operation status
+     */
+    buildImage(host: HostConfig, options: {
+        context: string;
+        tag: string;
+        dockerfile?: string;
+        noCache?: boolean;
+    }): Promise<{
+        status: string;
+    }>;
+    /**
+     * Clear all cached Docker client connections.
+     * Useful for cleanup during shutdown or when connections need to be reset.
+     */
+    clearClients(): void;
+}
+/**
+ * SSH service interface for executing commands on remote hosts.
+ * Provides secure command execution and resource monitoring via SSH connections.
+ */
+export interface ISSHService {
+    /**
+     * Execute a command on a remote host via SSH.
+     *
+     * @param host - Host configuration containing SSH connection details
+     * @param command - Command to execute (will be sanitized for security)
+     * @param args - Optional command arguments (sanitized separately)
+     * @param options - Execution options
+     * @param options.timeoutMs - Command timeout in milliseconds
+     * @returns Command output as string (stdout)
+     * @throws SSHCommandError if command fails or times out
+     */
+    executeSSHCommand(host: HostConfig, command: string, args?: string[], options?: {
+        timeoutMs?: number;
+    }): Promise<string>;
+    /**
+     * Get system resource information from a remote host.
+     * Retrieves CPU, memory, disk usage, and uptime.
+     *
+     * @param host - Host configuration to query
+     * @returns Resource information including CPU, memory, disk, and uptime
+     */
+    getHostResources(host: HostConfig): Promise<HostResources>;
+}
+/**
+ * Docker Compose service interface for managing multi-container applications.
+ * Provides operations for Compose project lifecycle management, service control,
+ * and log retrieval.
+ */
+export interface IComposeService {
+    /**
+     * Execute a Docker Compose command on a remote host.
+     * Low-level method for running arbitrary Compose actions.
+     *
+     * @param host - Host configuration where project is located
+     * @param project - Compose project name
+     * @param action - Compose action/subcommand (e.g., "up", "down", "ps")
+     * @param extraArgs - Additional arguments to pass to the command
+     * @returns Command output as string
+     */
+    composeExec(host: HostConfig, project: string, action: string, extraArgs?: string[]): Promise<string>;
+    /**
+     * List all Docker Compose projects on a host.
+     *
+     * @param host - Host configuration to query
+     * @returns Array of Compose projects with their status and services
+     */
+    listComposeProjects(host: HostConfig): Promise<ComposeProject[]>;
+    /**
+     * Get detailed status of a specific Compose project.
+     *
+     * @param host - Host configuration where project is located
+     * @param project - Compose project name
+     * @returns Project details including service states and configuration
+     */
+    getComposeStatus(host: HostConfig, project: string): Promise<ComposeProject>;
+    /**
+     * Start a Docker Compose project (bring services up).
+     *
+     * @param host - Host configuration where project is located
+     * @param project - Compose project name
+     * @param detach - Run in detached mode (default: true)
+     * @returns Command output
+     */
+    composeUp(host: HostConfig, project: string, detach?: boolean): Promise<string>;
+    /**
+     * Stop and remove a Docker Compose project (bring services down).
+     *
+     * @param host - Host configuration where project is located
+     * @param project - Compose project name
+     * @param removeVolumes - Also remove named volumes (default: false)
+     * @returns Command output
+     */
+    composeDown(host: HostConfig, project: string, removeVolumes?: boolean): Promise<string>;
+    /**
+     * Restart all services in a Docker Compose project.
+     *
+     * @param host - Host configuration where project is located
+     * @param project - Compose project name
+     * @returns Command output
+     */
+    composeRestart(host: HostConfig, project: string): Promise<string>;
+    /**
+     * Retrieve logs from Docker Compose services.
+     *
+     * @param host - Host configuration where project is located
+     * @param project - Compose project name
+     * @param options - Log retrieval options
+     * @param options.tail - Number of lines to show from end of logs
+     * @param options.follow - Follow log output (stream mode)
+     * @param options.timestamps - Include timestamps in output
+     * @param options.since - Show logs since timestamp or duration
+     * @param options.until - Show logs until timestamp or duration
+     * @param options.services - Filter logs to specific services
+     * @returns Log output as string
+     */
+    composeLogs(host: HostConfig, project: string, options?: {
+        tail?: number;
+        follow?: boolean;
+        timestamps?: boolean;
+        since?: string;
+        until?: string;
+        services?: string[];
+    }): Promise<string>;
+    /**
+     * Build or rebuild Docker Compose services.
+     *
+     * @param host - Host configuration where project is located
+     * @param project - Compose project name
+     * @param options - Build options
+     * @param options.service - Build only specific service
+     * @param options.noCache - Do not use cache when building
+     * @param options.pull - Always pull newer versions of base images
+     * @returns Command output
+     */
+    composeBuild(host: HostConfig, project: string, options?: {
+        service?: string;
+        noCache?: boolean;
+        pull?: boolean;
+    }): Promise<string>;
+    /**
+     * Pull service images defined in Docker Compose file.
+     *
+     * @param host - Host configuration where project is located
+     * @param project - Compose project name
+     * @param options - Pull options
+     * @param options.service - Pull only specific service
+     * @param options.ignorePullFailures - Continue even if some pulls fail
+     * @param options.quiet - Suppress output
+     * @returns Command output
+     */
+    composePull(host: HostConfig, project: string, options?: {
+        service?: string;
+        ignorePullFailures?: boolean;
+        quiet?: boolean;
+    }): Promise<string>;
+    /**
+     * Recreate containers for Docker Compose services.
+     * Useful for applying configuration changes without rebuilding images.
+     *
+     * @param host - Host configuration where project is located
+     * @param project - Compose project name
+     * @param options - Recreate options
+     * @param options.service - Recreate only specific service
+     * @param options.forceRecreate - Force recreation even if config hasn't changed
+     * @param options.noDeps - Don't recreate dependent services
+     * @returns Command output
+     */
+    composeRecreate(host: HostConfig, project: string, options?: {
+        service?: string;
+        forceRecreate?: boolean;
+        noDeps?: boolean;
+    }): Promise<string>;
+}
+/**
+ * SSH connection pool interface for managing reusable SSH connections.
+ * Provides connection pooling to reduce overhead of establishing SSH connections
+ * and improve performance for repeated operations.
+ */
+export interface ISSHConnectionPool {
+    /**
+     * Get an SSH connection from the pool for the specified host.
+     * Creates a new connection if none exists or all are in use.
+     *
+     * @param host - Host configuration for the connection
+     * @returns Active SSH connection ready for use
+     * @throws SSHConnectionError if connection cannot be established
+     */
+    getConnection(host: HostConfig): Promise<NodeSSH>;
+    /**
+     * Return an SSH connection to the pool for reuse.
+     * Connection remains open and available for future requests.
+     *
+     * @param host - Host configuration the connection belongs to
+     * @param connection - SSH connection to release back to pool
+     */
+    releaseConnection(host: HostConfig, connection: NodeSSH): Promise<void>;
+    /**
+     * Close a specific host's connection and remove from pool.
+     * Use when connection is no longer needed or has errors.
+     *
+     * @param host - Host configuration whose connection should be closed
+     */
+    closeConnection(host: HostConfig): Promise<void>;
+    /**
+     * Close all connections in the pool and clear pool state.
+     * Use during shutdown or cleanup.
+     */
+    closeAll(): Promise<void>;
+    /**
+     * Get connection pool statistics.
+     * Useful for monitoring pool health and performance.
+     *
+     * @returns Statistics including active connections, pool size, and usage metrics
+     */
+    getStats(): PoolStats;
+}
+/**
+ * Service factory interface for creating service instances with dependency injection.
+ * Provides centralized creation of all service instances with proper dependency wiring.
+ */
+export interface IServiceFactory {
+    /**
+     * Create a Docker service instance.
+     * Docker service manages Docker API connections and operations.
+     *
+     * @returns Docker service instance
+     */
+    createDockerService(): IDockerService;
+    /**
+     * Create an SSH connection pool instance.
+     *
+     * @param config - Optional pool configuration
+     * @param config.maxConnections - Maximum number of connections per host (default: 5)
+     * @returns SSH connection pool instance
+     */
+    createSSHConnectionPool(config?: Partial<{
+        maxConnections: number;
+    }>): ISSHConnectionPool;
+    /**
+     * Create an SSH service instance.
+     * SSH service requires a connection pool for managing connections.
+     *
+     * @param pool - SSH connection pool to use for managing connections
+     * @returns SSH service instance
+     */
+    createSSHService(pool: ISSHConnectionPool): ISSHService;
+    /**
+     * Create a Docker Compose service instance.
+     * Compose service requires SSH service for executing remote commands.
+     *
+     * @param sshService - SSH service to use for remote command execution
+     * @returns Compose service instance
+     */
+    createComposeService(sshService: ISSHService): IComposeService;
+    /**
+     * Create a File service instance.
+     * File service requires SSH service for remote file operations.
+     *
+     * @param sshService - SSH service to use for remote command execution
+     * @returns File service instance
+     */
+    createFileService(sshService: ISSHService): IFileService;
+}
+/**
+ * File service interface for remote file operations via SSH.
+ * Provides secure file reading, directory listing, command execution,
+ * and file transfer capabilities across hosts.
+ */
+export interface IFileService {
+    /**
+     * Read content from a file on a remote host.
+     *
+     * @param host - Host configuration where the file is located
+     * @param path - Absolute path to the file to read
+     * @param maxSize - Maximum bytes to read (content truncated if exceeded)
+     * @returns Object containing file content, size, and truncation status
+     */
+    readFile(host: HostConfig, path: string, maxSize: number): Promise<{
+        content: string;
+        size: number;
+        truncated: boolean;
+    }>;
+    /**
+     * List contents of a directory on a remote host.
+     *
+     * @param host - Host configuration where the directory is located
+     * @param path - Absolute path to the directory
+     * @param showHidden - Whether to show hidden files (prefixed with .)
+     * @returns Directory listing as string (ls output)
+     */
+    listDirectory(host: HostConfig, path: string, showHidden: boolean): Promise<string>;
+    /**
+     * Get tree representation of a directory structure.
+     *
+     * @param host - Host configuration where the directory is located
+     * @param path - Absolute path to the directory
+     * @param depth - Maximum depth to traverse
+     * @returns Tree output as string
+     */
+    treeDirectory(host: HostConfig, path: string, depth: number): Promise<string>;
+    /**
+     * Execute a command in a working directory on a remote host.
+     * SECURITY: Commands are validated against an allowlist by default.
+     *
+     * @param host - Host configuration where to execute
+     * @param path - Working directory for command execution
+     * @param command - Command to execute (must be in allowlist unless env override)
+     * @param timeout - Command timeout in milliseconds
+     * @returns Object containing stdout and exit code
+     */
+    executeCommand(host: HostConfig, path: string, command: string, timeout: number): Promise<{
+        stdout: string;
+        exitCode: number;
+    }>;
+    /**
+     * Find files matching a pattern on a remote host.
+     *
+     * @param host - Host configuration to search
+     * @param path - Base directory to search from
+     * @param pattern - Glob pattern to match (e.g., "*.log")
+     * @param options - Search options
+     * @param options.type - File type filter (f=file, d=directory, l=symlink)
+     * @param options.maxDepth - Maximum search depth
+     * @param options.limit - Maximum number of results
+     * @returns Newline-separated list of matching paths
+     */
+    findFiles(host: HostConfig, path: string, pattern: string, options: {
+        type?: "f" | "d" | "l";
+        maxDepth?: number;
+        limit?: number;
+    }): Promise<string>;
+    /**
+     * Transfer a file between hosts via SCP.
+     *
+     * @param sourceHost - Source host configuration
+     * @param sourcePath - Path to source file
+     * @param targetHost - Target host configuration
+     * @param targetPath - Destination path
+     * @returns Transfer result with bytes transferred and optional warning
+     */
+    transferFile(sourceHost: HostConfig, sourcePath: string, targetHost: HostConfig, targetPath: string): Promise<{
+        bytesTransferred: number;
+        warning?: string;
+    }>;
+    /**
+     * Compare two files and return diff output.
+     * Supports comparing files on the same host or across different hosts.
+     *
+     * @param host1 - First host configuration
+     * @param path1 - Path to first file
+     * @param host2 - Second host configuration
+     * @param path2 - Path to second file
+     * @param contextLines - Number of context lines in diff output
+     * @returns Unified diff output string
+     */
+    diffFiles(host1: HostConfig, path1: string, host2: HostConfig, path2: string, contextLines: number): Promise<string>;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/services/interfaces.d.ts.map

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

package/dist/services/interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interfaces.js.map

package/dist/services/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/services/interfaces.ts"],"names":[],"mappings":""}

package/dist/services/ssh-pool-exec.d.ts

@@ -0,0 +1,10 @@
+/**
+ * DEPRECATED: This file is deprecated in favor of ssh-service.ts
+ *
+ * This module previously provided a global SSH pool singleton.
+ * Use SSHService class with dependency injection instead.
+ *
+ * @deprecated Use SSHService from ssh-service.ts
+ */
+export type { SSHCommandOptions } from "./ssh-service.js";
+//# sourceMappingURL=ssh-pool-exec.d.ts.map

package/dist/services/ssh-pool-exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh-pool-exec.d.ts","sourceRoot":"","sources":["../../src/services/ssh-pool-exec.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/services/ssh-pool-exec.js

@@ -0,0 +1,10 @@
+/**
+ * DEPRECATED: This file is deprecated in favor of ssh-service.ts
+ *
+ * This module previously provided a global SSH pool singleton.
+ * Use SSHService class with dependency injection instead.
+ *
+ * @deprecated Use SSHService from ssh-service.ts
+ */
+export {};
+//# sourceMappingURL=ssh-pool-exec.js.map

package/dist/services/ssh-pool-exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh-pool-exec.js","sourceRoot":"","sources":["../../src/services/ssh-pool-exec.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/services/ssh-pool.d.ts

@@ -0,0 +1,66 @@
+import { HostConfig } from "../types.js";
+import { NodeSSH } from "node-ssh";
+/**
+ * SSH connection pool configuration
+ */
+export interface SSHPoolConfig {
+    maxConnections: number;
+    idleTimeoutMs: number;
+    connectionTimeoutMs: number;
+    enableHealthChecks: boolean;
+    healthCheckIntervalMs: number;
+}
+/**
+ * Default pool configuration
+ */
+export declare const DEFAULT_POOL_CONFIG: SSHPoolConfig;
+/**
+ * Pool statistics for monitoring
+ */
+export interface PoolStats {
+    poolHits: number;
+    poolMisses: number;
+    activeConnections: number;
+    idleConnections: number;
+    totalConnections: number;
+    healthChecksPassed: number;
+    healthCheckFailures: number;
+}
+/**
+ * SSH Connection Pool interface
+ */
+export interface SSHConnectionPool {
+    getConnection(host: HostConfig): Promise<NodeSSH>;
+    releaseConnection(host: HostConfig, connection: NodeSSH): Promise<void>;
+    closeConnection(host: HostConfig): Promise<void>;
+    closeAll(): Promise<void>;
+    getStats(): PoolStats;
+}
+/**
+ * Generate unique pool key for host
+ * Format: ${host.name}:${port}
+ */
+export declare function generatePoolKey(host: HostConfig): string;
+/**
+ * SSH Connection Pool Implementation
+ */
+export declare class SSHConnectionPoolImpl implements SSHConnectionPool {
+    private config;
+    private pool;
+    private stats;
+    private healthCheckTimer?;
+    constructor(config?: Partial<SSHPoolConfig>);
+    getStats(): PoolStats;
+    private startHealthChecks;
+    private performHealthChecks;
+    private checkConnectionHealth;
+    getConnection(host: HostConfig): Promise<NodeSSH>;
+    private createConnection;
+    private updateConnectionStats;
+    releaseConnection(host: HostConfig, connection: NodeSSH): Promise<void>;
+    private scheduleIdleCleanup;
+    private removeConnection;
+    closeConnection(host: HostConfig): Promise<void>;
+    closeAll(): Promise<void>;
+}
+//# sourceMappingURL=ssh-pool.d.ts.map

package/dist/services/ssh-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssh-pool.d.ts","sourceRoot":"","sources":["../../src/services/ssh-pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGnC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAMjC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAeD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,IAAI,SAAS,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAGxD;AAED;;GAEG;AACH,qBAAa,qBAAsB,YAAW,iBAAiB;IAC7D,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,IAAI,CAAoC;IAChD,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,gBAAgB,CAAC,CAAiB;gBAE9B,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM;IAkB/C,QAAQ,IAAI,SAAS;IAIrB,OAAO,CAAC,iBAAiB;YAMX,mBAAmB;YAenB,qBAAqB;IAkC7B,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;YA6CzC,gBAAgB;IA8B9B,OAAO,CAAC,qBAAqB;IAqBvB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB7E,OAAO,CAAC,mBAAmB;YAYb,gBAAgB;IA8BxB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BhD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAmChC"}