synapse-mcp 1.0.0 → 1.0.2

package/dist/services/docker/index.d.ts

@@ -0,0 +1,80 @@
+import type Docker from "dockerode";
+import type { ContainerExecResult, ContainerInfo, ContainerProcessList, ContainerStats, DockerDiskUsage, DockerNetworkInfo, DockerRawContainerInfo, DockerRawContainerInspectInfo, DockerSystemInfo, DockerVolumeInfo, HostConfig, HostStatus, ImageInfo, ListImagesOptions, LogEntry, PruneResult } from "../../types.js";
+import type { ContainerHostMapCache } from "../container-host-map-cache.js";
+import type { IContainerOperations, IDockerClientProvider, IDockerSystemInfo, IImageOperations, IResourceOperations } from "../interfaces.js";
+import type { IDockerClientFactory } from "./utils/client-factory.js";
+/**
+ * Docker service facade that delegates operations to specialized services.
+ * Composes focused Docker operation interfaces.
+ */
+export declare class DockerService implements IContainerOperations, IImageOperations, IResourceOperations, IDockerSystemInfo, IDockerClientProvider {
+    private containerService;
+    private imageService;
+    private systemService;
+    private networkService;
+    private volumeService;
+    private clientManager;
+    constructor(clientFactory?: IDockerClientFactory);
+    getDockerClient(config: HostConfig): Promise<Docker>;
+    clearClients(): void;
+    listContainers(hosts: HostConfig[], options?: {
+        state?: "all" | "running" | "stopped" | "paused";
+        nameFilter?: string;
+        imageFilter?: string;
+        labelFilter?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<ContainerInfo[]>;
+    findContainerHost(containerId: string, hosts: HostConfig[], cache?: ContainerHostMapCache): Promise<{
+        host: HostConfig;
+        container: DockerRawContainerInfo;
+    } | null>;
+    containerAction(containerId: string, action: "start" | "stop" | "restart" | "pause" | "unpause", host: HostConfig): Promise<void>;
+    getContainerLogs(containerId: string, host: HostConfig, options?: {
+        lines?: number;
+        since?: string;
+        until?: string;
+        stream?: "all" | "stdout" | "stderr";
+    }): Promise<LogEntry[]>;
+    getContainerStats(containerId: string, host: HostConfig): Promise<ContainerStats>;
+    execContainer(containerId: string, host: HostConfig, options: {
+        command: string;
+        user?: string;
+        workdir?: string;
+        timeout?: number;
+    }): Promise<ContainerExecResult>;
+    getContainerProcesses(containerId: string, host: HostConfig): Promise<ContainerProcessList>;
+    inspectContainer(containerId: string, host: HostConfig): Promise<DockerRawContainerInspectInfo>;
+    listImages(hosts: HostConfig[], options?: ListImagesOptions): Promise<ImageInfo[]>;
+    pullImage(imageName: string, host: HostConfig): Promise<{
+        status: string;
+    }>;
+    removeImage(imageId: string, host: HostConfig, options?: {
+        force?: boolean;
+    }): Promise<{
+        status: string;
+    }>;
+    buildImage(host: HostConfig, options: {
+        context: string;
+        tag: string;
+        dockerfile?: string;
+        noCache?: boolean;
+    }): Promise<{
+        status: string;
+    }>;
+    recreateContainer(containerId: string, host: HostConfig, options?: {
+        pull?: boolean;
+    }): Promise<{
+        status: string;
+        containerId: string;
+    }>;
+    getHostStatus(hosts: HostConfig[]): Promise<HostStatus[]>;
+    getDockerInfo(host: HostConfig): Promise<DockerSystemInfo>;
+    getDockerDiskUsage(host: HostConfig): Promise<DockerDiskUsage>;
+    pruneDocker(host: HostConfig, target: "containers" | "images" | "volumes" | "networks" | "buildcache" | "all", options?: {
+        force?: boolean;
+    }): Promise<PruneResult[]>;
+    listNetworks(hosts: HostConfig[]): Promise<DockerNetworkInfo[]>;
+    listVolumes(hosts: HostConfig[]): Promise<DockerVolumeInfo[]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/services/docker/index.d.ts.map

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

package/dist/services/docker/index.js

@@ -0,0 +1,103 @@
+import { ContainerService } from "./container-service.js";
+import { ImageService } from "./image-service.js";
+import { NetworkService } from "./network-service.js";
+import { SystemService } from "./system-service.js";
+import { DefaultDockerClientFactory } from "./utils/client-factory.js";
+import { ClientManager } from "./utils/client-manager.js";
+import { VolumeService } from "./volume-service.js";
+/**
+ * Docker service facade that delegates operations to specialized services.
+ * Composes focused Docker operation interfaces.
+ */
+export class DockerService {
+    containerService;
+    imageService;
+    systemService;
+    networkService;
+    volumeService;
+    clientManager;
+    constructor(clientFactory) {
+        const factory = clientFactory || new DefaultDockerClientFactory();
+        this.clientManager = new ClientManager(factory);
+        this.containerService = new ContainerService(this.clientManager);
+        this.imageService = new ImageService(this.clientManager);
+        this.systemService = new SystemService(this.clientManager);
+        this.networkService = new NetworkService(this.clientManager);
+        this.volumeService = new VolumeService(this.clientManager);
+    }
+    // ========== Client Management ==========
+    async getDockerClient(config) {
+        return this.clientManager.getClient(config);
+    }
+    clearClients() {
+        this.clientManager.clearClients();
+    }
+    // ========== Container Operations ==========
+    async listContainers(hosts, options = {}) {
+        return this.containerService.listContainers(hosts, options);
+    }
+    async findContainerHost(containerId, hosts, cache) {
+        // Handle cache at facade level (requires client-provider capability)
+        if (cache) {
+            return await cache.findContainerHost(containerId, hosts, this);
+        }
+        // Delegate to service for non-cached lookup
+        return this.containerService.findContainerHost(containerId, hosts);
+    }
+    async containerAction(containerId, action, host) {
+        return this.containerService.containerAction(containerId, action, host);
+    }
+    async getContainerLogs(containerId, host, options = {}) {
+        return this.containerService.getContainerLogs(containerId, host, options);
+    }
+    async getContainerStats(containerId, host) {
+        return this.containerService.getContainerStats(containerId, host);
+    }
+    async execContainer(containerId, host, options) {
+        return this.containerService.execContainer(containerId, host, options);
+    }
+    async getContainerProcesses(containerId, host) {
+        return this.containerService.getContainerProcesses(containerId, host);
+    }
+    async inspectContainer(containerId, host) {
+        return this.containerService.inspectContainer(containerId, host);
+    }
+    // ========== Image Operations ==========
+    async listImages(hosts, options = {}) {
+        return this.imageService.listImages(hosts, options);
+    }
+    async pullImage(imageName, host) {
+        return this.imageService.pullImage(imageName, host);
+    }
+    async removeImage(imageId, host, options = {}) {
+        return this.imageService.removeImage(imageId, host, options);
+    }
+    async buildImage(host, options) {
+        return this.imageService.buildImage(host, options);
+    }
+    async recreateContainer(containerId, host, options = {}) {
+        return this.imageService.recreateContainer(containerId, host, options);
+    }
+    // ========== System Operations ==========
+    async getHostStatus(hosts) {
+        return this.systemService.getHostStatus(hosts);
+    }
+    async getDockerInfo(host) {
+        return this.systemService.getDockerInfo(host);
+    }
+    async getDockerDiskUsage(host) {
+        return this.systemService.getDockerDiskUsage(host);
+    }
+    async pruneDocker(host, target, options = {}) {
+        return this.systemService.pruneDocker(host, target, options);
+    }
+    // ========== Network Operations ==========
+    async listNetworks(hosts) {
+        return this.networkService.listNetworks(hosts);
+    }
+    // ========== Volume Operations ==========
+    async listVolumes(hosts) {
+        return this.volumeService.listVolumes(hosts);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/services/docker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/docker/index.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;GAGG;AACH,MAAM,OAAO,aAAa;IAQhB,gBAAgB,CAAmB;IACnC,YAAY,CAAe;IAC3B,aAAa,CAAgB;IAC7B,cAAc,CAAiB;IAC/B,aAAa,CAAgB;IAC7B,aAAa,CAAgB;IAErC,YAAY,aAAoC;QAC9C,MAAM,OAAO,GAAG,aAAa,IAAI,IAAI,0BAA0B,EAAE,CAAC;QAClE,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;QAEhD,IAAI,CAAC,gBAAgB,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACjE,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzD,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC3D,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC7D,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC7D,CAAC;IAED,0CAA0C;IAE1C,KAAK,CAAC,eAAe,CAAC,MAAkB;QACtC,OAAO,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED,YAAY;QACV,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC;IACpC,CAAC;IAED,6CAA6C;IAE7C,KAAK,CAAC,cAAc,CAClB,KAAmB,EACnB,UAOI,EAAE;QAEN,OAAO,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,WAAmB,EACnB,KAAmB,EACnB,KAA6B;QAE7B,qEAAqE;QACrE,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,MAAM,KAAK,CAAC,iBAAiB,CAAC,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QACjE,CAAC;QAED,4CAA4C;QAC5C,OAAO,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,WAAmB,EACnB,MAA0D,EAC1D,IAAgB;QAEhB,OAAO,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,WAAmB,EACnB,IAAgB,EAChB,UAKI,EAAE;QAEN,OAAO,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,WAAmB,EAAE,IAAgB;QAC3D,OAAO,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,WAAmB,EACnB,IAAgB,EAChB,OAA+E;QAE/E,OAAO,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,qBAAqB,CACzB,WAAmB,EACnB,IAAgB;QAEhB,OAAO,IAAI,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,WAAmB,EACnB,IAAgB;QAEhB,OAAO,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACnE,CAAC;IAED,yCAAyC;IAEzC,KAAK,CAAC,UAAU,CAAC,KAAmB,EAAE,UAA6B,EAAE;QACnE,OAAO,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,SAAiB,EAAE,IAAgB;QACjD,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,WAAW,CACf,OAAe,EACf,IAAgB,EAChB,UAA+B,EAAE;QAEjC,OAAO,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,UAAU,CACd,IAAgB,EAChB,OAKC;QAED,OAAO,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,WAAmB,EACnB,IAAgB,EAChB,UAA8B,EAAE;QAEhC,OAAO,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAED,0CAA0C;IAE1C,KAAK,CAAC,aAAa,CAAC,KAAmB;QACrC,OAAO,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAAgB;QAClC,OAAO,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,IAAgB;QACvC,OAAO,IAAI,CAAC,aAAa,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,WAAW,CACf,IAAgB,EAChB,MAA+E,EAC/E,UAA+B,EAAE;QAEjC,OAAO,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED,2CAA2C;IAE3C,KAAK,CAAC,YAAY,CAAC,KAAmB;QACpC,OAAO,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,0CAA0C;IAE1C,KAAK,CAAC,WAAW,CAAC,KAAmB;QACnC,OAAO,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/services/docker/network-service.d.ts

@@ -0,0 +1,22 @@
+import type { DockerNetworkInfo, HostConfig } from "../../types.js";
+import type { ClientManager } from "./utils/client-manager.js";
+/**
+ * Service for Docker network operations.
+ * Handles network listing and management.
+ */
+export declare class NetworkService {
+    private clientManager;
+    constructor(clientManager: ClientManager);
+    /**
+     * List Docker networks across multiple hosts in parallel.
+     *
+     * @param hosts - List of Docker hosts to query
+     * @returns Promise resolving to array of network information
+     */
+    listNetworks(hosts: HostConfig[]): Promise<DockerNetworkInfo[]>;
+    /**
+     * List Docker networks from a single host (internal helper).
+     */
+    private listNetworksOnHost;
+}
+//# sourceMappingURL=network-service.d.ts.map

package/dist/services/docker/network-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-service.d.ts","sourceRoot":"","sources":["../../../src/services/docker/network-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D;;;GAGG;AACH,qBAAa,cAAc;IACb,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAEhD;;;;;OAKG;IACG,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAWrE;;OAEG;YACW,kBAAkB;CAgBjC"}

package/dist/services/docker/network-service.js

@@ -0,0 +1,43 @@
+import { narrowToDefaultHost } from "../../utils/host-utils.js";
+/**
+ * Service for Docker network operations.
+ * Handles network listing and management.
+ */
+export class NetworkService {
+    clientManager;
+    constructor(clientManager) {
+        this.clientManager = clientManager;
+    }
+    /**
+     * List Docker networks across multiple hosts in parallel.
+     *
+     * @param hosts - List of Docker hosts to query
+     * @returns Promise resolving to array of network information
+     */
+    async listNetworks(hosts) {
+        const targetHosts = narrowToDefaultHost(hosts);
+        const results = await Promise.allSettled(targetHosts.map((host) => this.listNetworksOnHost(host)));
+        return results
+            .filter((r) => r.status === "fulfilled")
+            .flatMap((r) => r.value);
+    }
+    /**
+     * List Docker networks from a single host (internal helper).
+     */
+    async listNetworksOnHost(host) {
+        const docker = await this.clientManager.getClient(host);
+        const networks = await docker.listNetworks();
+        return networks.map((network) => ({
+            id: network.Id,
+            name: network.Name,
+            driver: network.Driver,
+            scope: network.Scope,
+            created: network.Created,
+            internal: network.Internal,
+            attachable: network.Attachable,
+            ingress: network.Ingress,
+            hostName: host.name,
+        }));
+    }
+}
+//# sourceMappingURL=network-service.js.map

package/dist/services/docker/network-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-service.js","sourceRoot":"","sources":["../../../src/services/docker/network-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGhE;;;GAGG;AACH,MAAM,OAAO,cAAc;IACL;IAApB,YAAoB,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;IAAG,CAAC;IAEpD;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,KAAmB;QACpC,MAAM,WAAW,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CACzD,CAAC;QAEF,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,CAAC,EAAoD,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC;aACzF,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,kBAAkB,CAAC,IAAgB;QAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;QAE7C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAChC,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,IAAI,CAAC,IAAI;SACpB,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/services/docker/system-service.d.ts

@@ -0,0 +1,49 @@
+import type { DockerDiskUsage, DockerSystemInfo, HostConfig, HostStatus, PruneResult } from "../../types.js";
+import type { ClientManager } from "./utils/client-manager.js";
+/**
+ * Service for Docker system operations.
+ * Handles system info, disk usage, resource pruning, and host status.
+ */
+export declare class SystemService {
+    private clientManager;
+    constructor(clientManager: ClientManager);
+    /**
+     * Get status overview for multiple hosts in parallel.
+     *
+     * @param hosts - List of Docker hosts to query
+     * @returns Promise resolving to array of host status information
+     */
+    getHostStatus(hosts: HostConfig[]): Promise<HostStatus[]>;
+    /**
+     * Get status for a single host (internal helper).
+     */
+    private getHostStatusSingle;
+    /**
+     * Get Docker system information for a host.
+     *
+     * @param host - Host configuration
+     * @returns Promise resolving to Docker system information
+     */
+    getDockerInfo(host: HostConfig): Promise<DockerSystemInfo>;
+    /**
+     * Get Docker disk usage statistics (system df).
+     *
+     * @param host - Host configuration
+     * @returns Promise resolving to disk usage statistics
+     */
+    getDockerDiskUsage(host: HostConfig): Promise<DockerDiskUsage>;
+    /**
+     * Prune Docker resources (cleanup unused items).
+     * This is a destructive operation — callers must pass `force: true` to confirm.
+     *
+     * @param host - Host configuration
+     * @param target - Resource type to prune or "all" for everything
+     * @param options - Options including force confirmation
+     * @returns Promise resolving to array of prune results per resource type
+     * @throws Error if force is not true
+     */
+    pruneDocker(host: HostConfig, target: "containers" | "images" | "volumes" | "networks" | "buildcache" | "all", options?: {
+        force?: boolean;
+    }): Promise<PruneResult[]>;
+}
+//# sourceMappingURL=system-service.d.ts.map

package/dist/services/docker/system-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-service.d.ts","sourceRoot":"","sources":["../../../src/services/docker/system-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,WAAW,EACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAQ/D;;;GAGG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,aAAa;gBAAb,aAAa,EAAE,aAAa;IAEhD;;;;;OAKG;IACG,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAK/D;;OAEG;YACW,mBAAmB;IA4BjC;;;;;OAKG;IACG,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuBhE;;;;;OAKG;IACG,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,eAAe,CAAC;IA+CpE;;;;;;;;;OASG;IACG,WAAW,CACf,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,KAAK,EAC/E,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAChC,OAAO,CAAC,WAAW,EAAE,CAAC;CAwF1B"}

package/dist/services/docker/system-service.js

@@ -0,0 +1,215 @@
+import { HostOperationError, logError } from "../../utils/errors.js";
+import { calculateBuildCacheStats, calculateContainerStats, calculateImageStats, calculateVolumeStats, } from "./utils/stats-calculator.js";
+/**
+ * Service for Docker system operations.
+ * Handles system info, disk usage, resource pruning, and host status.
+ */
+export class SystemService {
+    clientManager;
+    constructor(clientManager) {
+        this.clientManager = clientManager;
+    }
+    /**
+     * Get status overview for multiple hosts in parallel.
+     *
+     * @param hosts - List of Docker hosts to query
+     * @returns Promise resolving to array of host status information
+     */
+    async getHostStatus(hosts) {
+        // Query all hosts in parallel - errors are handled in getHostStatusSingle
+        return Promise.all(hosts.map((host) => this.getHostStatusSingle(host)));
+    }
+    /**
+     * Get status for a single host (internal helper).
+     */
+    async getHostStatusSingle(host) {
+        try {
+            const docker = await this.clientManager.getClient(host);
+            const containers = await docker.listContainers({ all: true });
+            const running = containers.filter((c) => c.State === "running").length;
+            return {
+                name: host.name,
+                host: host.host,
+                connected: true,
+                containerCount: containers.length,
+                runningCount: running,
+            };
+        }
+        catch (error) {
+            logError(new HostOperationError("Failed to get host info", host.name, "getHostInfo", error), {
+                metadata: { host: host.host },
+            });
+            return {
+                name: host.name,
+                host: host.host,
+                connected: false,
+                containerCount: 0,
+                runningCount: 0,
+                error: error instanceof Error ? error.message : "Connection failed",
+            };
+        }
+    }
+    /**
+     * Get Docker system information for a host.
+     *
+     * @param host - Host configuration
+     * @returns Promise resolving to Docker system information
+     */
+    async getDockerInfo(host) {
+        const docker = await this.clientManager.getClient(host);
+        const info = await docker.info();
+        const version = await docker.version();
+        return {
+            dockerVersion: version.Version || "unknown",
+            apiVersion: version.ApiVersion || "unknown",
+            os: info.OperatingSystem || info.OSType || "unknown",
+            arch: info.Architecture || "unknown",
+            kernelVersion: info.KernelVersion || "unknown",
+            cpus: info.NCPU || 0,
+            memoryBytes: info.MemTotal || 0,
+            storageDriver: info.Driver || "unknown",
+            rootDir: info.DockerRootDir || "/var/lib/docker",
+            containersTotal: info.Containers || 0,
+            containersRunning: info.ContainersRunning || 0,
+            containersPaused: info.ContainersPaused || 0,
+            containersStopped: info.ContainersStopped || 0,
+            images: info.Images || 0,
+        };
+    }
+    /**
+     * Get Docker disk usage statistics (system df).
+     *
+     * @param host - Host configuration
+     * @returns Promise resolving to disk usage statistics
+     */
+    async getDockerDiskUsage(host) {
+        const docker = await this.clientManager.getClient(host);
+        const df = await docker.df();
+        // Calculate stats using helper functions
+        const imageStats = calculateImageStats(df.Images || []);
+        const containerStats = calculateContainerStats(df.Containers || []);
+        const volumeStats = calculateVolumeStats(df.Volumes || []);
+        const buildCacheStats = calculateBuildCacheStats(df.BuildCache || []);
+        const totalSize = imageStats.size + containerStats.size + volumeStats.size + buildCacheStats.size;
+        const totalReclaimable = imageStats.reclaimable +
+            containerStats.size +
+            volumeStats.reclaimable +
+            buildCacheStats.reclaimable;
+        return {
+            images: {
+                total: imageStats.total,
+                active: imageStats.active,
+                size: imageStats.size,
+                reclaimable: imageStats.reclaimable,
+            },
+            containers: {
+                total: containerStats.total,
+                running: containerStats.running,
+                size: containerStats.size + containerStats.rootfsSize,
+                reclaimable: containerStats.size,
+            },
+            volumes: {
+                total: volumeStats.total,
+                active: volumeStats.active,
+                size: volumeStats.size,
+                reclaimable: volumeStats.reclaimable,
+            },
+            buildCache: {
+                total: buildCacheStats.total,
+                size: buildCacheStats.size,
+                reclaimable: buildCacheStats.reclaimable,
+            },
+            totalSize,
+            totalReclaimable,
+        };
+    }
+    /**
+     * Prune Docker resources (cleanup unused items).
+     * This is a destructive operation — callers must pass `force: true` to confirm.
+     *
+     * @param host - Host configuration
+     * @param target - Resource type to prune or "all" for everything
+     * @param options - Options including force confirmation
+     * @returns Promise resolving to array of prune results per resource type
+     * @throws Error if force is not true
+     */
+    async pruneDocker(host, target, options = {}) {
+        if (!options.force) {
+            throw new Error("pruneDocker requires { force: true } to confirm destructive operation");
+        }
+        const docker = await this.clientManager.getClient(host);
+        const results = [];
+        const targets = target === "all"
+            ? ["containers", "images", "volumes", "networks", "buildcache"]
+            : [target];
+        for (const t of targets) {
+            try {
+                switch (t) {
+                    case "containers": {
+                        const res = await docker.pruneContainers();
+                        results.push({
+                            type: "containers",
+                            spaceReclaimed: res.SpaceReclaimed || 0,
+                            itemsDeleted: res.ContainersDeleted?.length || 0,
+                            details: res.ContainersDeleted,
+                        });
+                        break;
+                    }
+                    case "images": {
+                        const res = await docker.pruneImages();
+                        results.push({
+                            type: "images",
+                            spaceReclaimed: res.SpaceReclaimed || 0,
+                            itemsDeleted: res.ImagesDeleted?.length || 0,
+                            details: res.ImagesDeleted?.map((i) => i.Deleted || i.Untagged || ""),
+                        });
+                        break;
+                    }
+                    case "volumes": {
+                        const res = await docker.pruneVolumes();
+                        results.push({
+                            type: "volumes",
+                            spaceReclaimed: res.SpaceReclaimed || 0,
+                            itemsDeleted: res.VolumesDeleted?.length || 0,
+                            details: res.VolumesDeleted,
+                        });
+                        break;
+                    }
+                    case "networks": {
+                        const res = await docker.pruneNetworks();
+                        results.push({
+                            type: "networks",
+                            spaceReclaimed: 0,
+                            itemsDeleted: res.NetworksDeleted?.length || 0,
+                            details: res.NetworksDeleted,
+                        });
+                        break;
+                    }
+                    case "buildcache": {
+                        const res = (await docker.pruneBuilder());
+                        results.push({
+                            type: "buildcache",
+                            spaceReclaimed: res.SpaceReclaimed || 0,
+                            itemsDeleted: res.CachesDeleted?.length || 0,
+                            details: res.CachesDeleted,
+                        });
+                        break;
+                    }
+                }
+            }
+            catch (error) {
+                logError(new HostOperationError("Docker cleanup failed", host.name, "dockerCleanup", error), {
+                    metadata: { type: t },
+                });
+                results.push({
+                    type: t,
+                    spaceReclaimed: 0,
+                    itemsDeleted: 0,
+                    details: [`Error: ${error instanceof Error ? error.message : "Unknown error"}`],
+                });
+            }
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=system-service.js.map

package/dist/services/docker/system-service.js.map

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

package/dist/services/docker/utils/client-factory.d.ts

@@ -0,0 +1,56 @@
+import Docker from "dockerode";
+import type { HostConfig } from "../../../types.js";
+/**
+ * Interface for Docker client factory.
+ * Allows dependency injection of custom Docker client creation logic.
+ */
+export interface IDockerClientFactory {
+    createClient(config: HostConfig): Promise<Docker>;
+}
+/**
+ * Check if a string looks like a Unix socket path
+ */
+export declare function isSocketPath(value: string): boolean;
+/**
+ * Default Docker client factory implementation.
+ * Creates Docker clients based on host configuration (socket, SSH, HTTP/HTTPS).
+ *
+ * Architecture Note: Dual SSH Connection Strategy
+ * ------------------------------------------------
+ * This system uses TWO separate SSH connection mechanisms:
+ *
+ * 1. Docker API SSH (via dockerode/ssh2):
+ *    - Used for Docker API calls (listContainers, stats, etc.)
+ *    - Managed by dockerode library with native SSH tunnel support
+ *    - Connections created per Docker client instance
+ *    - Cached at the client level by ClientManager
+ *
+ * 2. SSH Command Execution (via node-ssh/SSHConnectionPool):
+ *    - Used for shell commands (compose, find, scan, exec)
+ *    - Managed by SSHConnectionPool with health checks and pooling
+ *    - Connections pooled and reused across operations
+ *
+ * This separation is intentional and provides:
+ * - API operations isolated from command execution failures
+ * - Different retry/timeout strategies for different operation types
+ * - No dependency between Docker API and shell command availability
+ *
+ * Future optimization: Consider SSH multiplexing (ControlMaster) at the OS level
+ * to share TCP connections between both mechanisms.
+ */
+export declare class DefaultDockerClientFactory implements IDockerClientFactory {
+    private keyCache;
+    /**
+     * Get private key content with caching.
+     * Caching eliminates redundant file I/O for repeated client creation.
+     * Matches SSHConnectionPool pattern for consistency.
+     */
+    private getPrivateKey;
+    /**
+     * Clear cached SSH private keys.
+     * Call during shutdown to release sensitive key material from memory.
+     */
+    clearKeyCache(): void;
+    createClient(config: HostConfig): Promise<Docker>;
+}
+//# sourceMappingURL=client-factory.d.ts.map

package/dist/services/docker/utils/client-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-factory.d.ts","sourceRoot":"","sources":["../../../../src/services/docker/utils/client-factory.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,WAAW,CAAC;AAE/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAwBpD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACnD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,0BAA2B,YAAW,oBAAoB;IACrE,OAAO,CAAC,QAAQ,CAA6B;IAE7C;;;;OAIG;IACH,OAAO,CAAC,aAAa;IASrB;;;OAGG;IACH,aAAa,IAAI,IAAI;IAIf,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;CAwExD"}