synapse-mcp 1.0.0 → 1.0.2

package/dist/services/config-loader.d.ts

@@ -0,0 +1,23 @@
+import type { HostConfig } from "../types.js";
+/**
+ * Get config file search paths (in order of priority)
+ * Computed at runtime to support testing with env var changes
+ */
+export declare function getConfigPaths(): string[];
+/**
+ * Auto-add local Docker socket if it exists and isn't already configured
+ */
+export declare function ensureLocalSocket(hosts: HostConfig[]): HostConfig[];
+/**
+ * Load host configurations from SSH config, config file, env var, or defaults
+ *
+ * Priority order:
+ * 1. Manual config file (synapse.config.json) - highest priority
+ * 2. SYNAPSE_HOSTS_CONFIG environment variable
+ * 3. SSH config auto-discovery (~/.ssh/config)
+ * 4. Local Docker socket (fallback)
+ *
+ * Manual hosts completely replace SSH config hosts with the same name.
+ */
+export declare function loadHostConfigs(): HostConfig[];
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/services/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/services/config-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAO9C;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAOzC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAkCnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,UAAU,EAAE,CAiE9C"}

package/dist/services/config-loader.js

@@ -0,0 +1,124 @@
+// src/services/config-loader.ts
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir, hostname } from "node:os";
+import { loadFromSSHConfigSync, mergeHostConfigs } from "./ssh-config-loader.js";
+import { logError } from "../utils/errors.js";
+const DEFAULT_DOCKER_SOCKET = "/var/run/docker.sock";
+const ENV_HOSTS_CONFIG = "SYNAPSE_HOSTS_CONFIG";
+/**
+ * Get config file search paths (in order of priority)
+ * Computed at runtime to support testing with env var changes
+ */
+export function getConfigPaths() {
+    return [
+        process.env.SYNAPSE_CONFIG_FILE, // Explicit path
+        join(process.cwd(), "synapse.config.json"), // Current directory
+        join(homedir(), ".config", "synapse-mcp", "config.json"), // XDG style
+        join(homedir(), ".synapse-mcp.json") // Dotfile style
+    ].filter(Boolean);
+}
+/**
+ * Auto-add local Docker socket if it exists and isn't already configured
+ */
+export function ensureLocalSocket(hosts) {
+    // Check if local socket exists
+    if (!existsSync(DEFAULT_DOCKER_SOCKET)) {
+        return hosts;
+    }
+    // Check if any host already uses the local socket
+    const hasLocalSocket = hosts.some((h) => h.dockerSocketPath === DEFAULT_DOCKER_SOCKET ||
+        h.host === DEFAULT_DOCKER_SOCKET ||
+        (h.host === "localhost" && h.dockerSocketPath));
+    if (hasLocalSocket) {
+        return hosts;
+    }
+    // Auto-add local socket entry
+    const localName = hostname()
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, "-") || "local";
+    console.error(`Auto-adding local Docker socket as "${localName}"`);
+    return [
+        ...hosts,
+        {
+            name: localName,
+            host: DEFAULT_DOCKER_SOCKET,
+            protocol: "http",
+            dockerSocketPath: DEFAULT_DOCKER_SOCKET
+        }
+    ];
+}
+/**
+ * Load host configurations from SSH config, config file, env var, or defaults
+ *
+ * Priority order:
+ * 1. Manual config file (synapse.config.json) - highest priority
+ * 2. SYNAPSE_HOSTS_CONFIG environment variable
+ * 3. SSH config auto-discovery (~/.ssh/config)
+ * 4. Local Docker socket (fallback)
+ *
+ * Manual hosts completely replace SSH config hosts with the same name.
+ */
+export function loadHostConfigs() {
+    let manualHosts = [];
+    // 1. Try manual config file first
+    for (const configPath of getConfigPaths()) {
+        if (existsSync(configPath)) {
+            try {
+                const raw = readFileSync(configPath, "utf-8");
+                const config = JSON.parse(raw);
+                const configHosts = config.hosts || config; // Support { hosts: [...] } or just [...]
+                if (Array.isArray(configHosts) && configHosts.length > 0) {
+                    console.error(`Loaded ${configHosts.length} hosts from ${configPath}`);
+                    manualHosts = configHosts;
+                    break;
+                }
+            }
+            catch (error) {
+                logError(error, {
+                    operation: "loadHostConfigs",
+                    metadata: { configPath, source: "file" }
+                });
+            }
+        }
+    }
+    // 2. Fall back to env var if no config file
+    if (manualHosts.length === 0) {
+        const configJson = process.env[ENV_HOSTS_CONFIG];
+        if (configJson) {
+            try {
+                manualHosts = JSON.parse(configJson);
+                console.error(`Loaded ${manualHosts.length} hosts from SYNAPSE_HOSTS_CONFIG env`);
+            }
+            catch (error) {
+                logError(error, {
+                    operation: "loadHostConfigs",
+                    metadata: { source: "SYNAPSE_HOSTS_CONFIG" }
+                });
+            }
+        }
+    }
+    // 3. Load SSH config hosts (auto-discovery)
+    const sshConfigPath = join(homedir(), ".ssh", "config");
+    const sshHosts = loadFromSSHConfigSync(sshConfigPath);
+    if (sshHosts.length > 0) {
+        console.error(`Auto-discovered ${sshHosts.length} hosts from SSH config`);
+    }
+    // 4. Merge hosts with manual taking precedence
+    const hosts = mergeHostConfigs(sshHosts, manualHosts);
+    // 5. If still no hosts, default to local socket only
+    if (hosts.length === 0) {
+        console.error("No config found, using local Docker socket");
+        return [
+            {
+                name: "local",
+                host: "localhost",
+                protocol: "http",
+                dockerSocketPath: DEFAULT_DOCKER_SOCKET
+            }
+        ];
+    }
+    // 6. Auto-add local socket if exists and not configured
+    return ensureLocalSocket(hosts);
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/services/config-loader.js.map

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

package/dist/services/config-service.d.ts

@@ -0,0 +1,38 @@
+import type { HostConfig } from "../types.js";
+/**
+ * ConfigService - Caches host configurations to avoid blocking I/O on every request
+ * PERF-C1: Eliminates 2-10ms sync file I/O per tool invocation
+ */
+export declare class ConfigService {
+    private configCache;
+    private cacheTime;
+    private configLoadLock;
+    private readonly CACHE_TTL;
+    /**
+     * Load host configurations with caching and async I/O
+     *
+     * Priority order:
+     * 1. Manual config file (synapse.config.json) - highest priority
+     * 2. SYNAPSE_HOSTS_CONFIG environment variable
+     * 3. SSH config auto-discovery (~/.ssh/config)
+     * 4. Local Docker socket (fallback)
+     *
+     * Manual hosts completely replace SSH config hosts with the same name.
+     */
+    loadHostConfigs(): Promise<HostConfig[]>;
+    /**
+     * Internal load implementation
+     */
+    private _doLoad;
+    /**
+     * Invalidate cache (for testing or manual refresh)
+     */
+    invalidateCache(): void;
+}
+export declare const configService: ConfigService;
+/**
+ * Legacy sync wrapper for backwards compatibility
+ * @deprecated Use configService.loadHostConfigs() instead for async caching
+ */
+export declare function loadHostConfigs(): HostConfig[];
+//# sourceMappingURL=config-service.d.ts.map

package/dist/services/config-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-service.d.ts","sourceRoot":"","sources":["../../src/services/config-service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAoD9C;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC;;;;;;;;;;OAUG;IACG,eAAe,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAuB9C;;OAEG;YACW,OAAO;IAiErB;;OAEG;IACH,eAAe,IAAI,IAAI;CAIxB;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,UAAU,EAAE,CAyE9C"}

package/dist/services/config-service.js

@@ -0,0 +1,225 @@
+import { promises as fs } from "fs";
+import { homedir, hostname } from "os";
+import { join } from "path";
+import { DEFAULT_DOCKER_SOCKET, ENV_HOSTS_CONFIG } from "../constants.js";
+import { logError } from "../utils/errors.js";
+import { loadFromSSHConfig, loadFromSSHConfigSync, mergeHostConfigs } from "./ssh-config-loader.js";
+/**
+ * Get prioritized list of config file paths
+ */
+function getConfigPaths() {
+    const configName = "synapse.config.json";
+    const paths = [];
+    // 1. Explicit path from environment variable (highest priority)
+    if (process.env.SYNAPSE_CONFIG_FILE) {
+        paths.push(process.env.SYNAPSE_CONFIG_FILE);
+    }
+    // 2. Standard search paths
+    paths.push(join(process.cwd(), configName), join(homedir(), ".config", "synapse", configName), join(homedir(), `.${configName}`), join("/etc", "synapse", configName));
+    return paths;
+}
+/**
+ * Ensure local Docker socket is included if available
+ */
+function ensureLocalSocket(hosts) {
+    const localName = `local-${hostname()}`;
+    // Check if local socket is already configured
+    const hasLocalSocket = hosts.some((h) => h.dockerSocketPath === DEFAULT_DOCKER_SOCKET);
+    if (hasLocalSocket) {
+        return hosts;
+    }
+    return [
+        ...hosts,
+        {
+            name: localName,
+            host: DEFAULT_DOCKER_SOCKET,
+            protocol: "http",
+            dockerSocketPath: DEFAULT_DOCKER_SOCKET
+        }
+    ];
+}
+/**
+ * ConfigService - Caches host configurations to avoid blocking I/O on every request
+ * PERF-C1: Eliminates 2-10ms sync file I/O per tool invocation
+ */
+export class ConfigService {
+    configCache = null;
+    cacheTime = 0;
+    configLoadLock = null;
+    CACHE_TTL = 60000; // 60s
+    /**
+     * Load host configurations with caching and async I/O
+     *
+     * Priority order:
+     * 1. Manual config file (synapse.config.json) - highest priority
+     * 2. SYNAPSE_HOSTS_CONFIG environment variable
+     * 3. SSH config auto-discovery (~/.ssh/config)
+     * 4. Local Docker socket (fallback)
+     *
+     * Manual hosts completely replace SSH config hosts with the same name.
+     */
+    async loadHostConfigs() {
+        const now = Date.now();
+        // Return cached config if still valid
+        if (this.configCache && now - this.cacheTime < this.CACHE_TTL) {
+            return this.configCache;
+        }
+        // Prevent concurrent loads with lock
+        if (this.configLoadLock) {
+            return this.configLoadLock;
+        }
+        this.configLoadLock = this._doLoad();
+        try {
+            this.configCache = await this.configLoadLock;
+            this.cacheTime = now;
+            return this.configCache;
+        }
+        finally {
+            this.configLoadLock = null;
+        }
+    }
+    /**
+     * Internal load implementation
+     */
+    async _doLoad() {
+        let manualHosts = [];
+        // 1. Try manual config file first (async I/O)
+        for (const configPath of getConfigPaths()) {
+            try {
+                // Check file exists with async stat
+                await fs.access(configPath);
+                const raw = await fs.readFile(configPath, "utf-8");
+                const config = JSON.parse(raw);
+                const configHosts = config.hosts || config; // Support { hosts: [...] } or just [...]
+                if (Array.isArray(configHosts) && configHosts.length > 0) {
+                    console.error(`Loaded ${configHosts.length} hosts from ${configPath}`);
+                    manualHosts = configHosts;
+                    break;
+                }
+            }
+            catch {
+                // File doesn't exist or can't be read - try next path
+                continue;
+            }
+        }
+        // 2. Fall back to env var if no config file
+        if (manualHosts.length === 0) {
+            const configJson = process.env[ENV_HOSTS_CONFIG];
+            if (configJson) {
+                try {
+                    manualHosts = JSON.parse(configJson);
+                    console.error(`Loaded ${manualHosts.length} hosts from SYNAPSE_HOSTS_CONFIG env`);
+                }
+                catch (error) {
+                    logError(error, {
+                        operation: "loadHostConfigs",
+                        metadata: { source: "SYNAPSE_HOSTS_CONFIG" }
+                    });
+                }
+            }
+        }
+        // 3. Load SSH config hosts (auto-discovery) - already async
+        const sshConfigPath = join(homedir(), ".ssh", "config");
+        const sshHosts = await loadFromSSHConfig(sshConfigPath);
+        if (sshHosts.length > 0) {
+            console.error(`Auto-discovered ${sshHosts.length} hosts from SSH config`);
+        }
+        // 4. Merge hosts with manual taking precedence
+        const hosts = mergeHostConfigs(sshHosts, manualHosts);
+        // 5. If still no hosts, default to local socket only
+        if (hosts.length === 0) {
+            console.error("No config found, using local Docker socket");
+            return [
+                {
+                    name: "local",
+                    host: "localhost",
+                    protocol: "http",
+                    dockerSocketPath: DEFAULT_DOCKER_SOCKET
+                }
+            ];
+        }
+        // 6. Auto-add local socket if exists and not configured
+        return ensureLocalSocket(hosts);
+    }
+    /**
+     * Invalidate cache (for testing or manual refresh)
+     */
+    invalidateCache() {
+        this.configCache = null;
+        this.cacheTime = 0;
+    }
+}
+// Global singleton instance for service-wide caching
+export const configService = new ConfigService();
+/**
+ * Legacy sync wrapper for backwards compatibility
+ * @deprecated Use configService.loadHostConfigs() instead for async caching
+ */
+export function loadHostConfigs() {
+    // This is a fallback for sync callers - it will block but at least cache works
+    // We need to use the sync version of the old code temporarily
+    console.warn("WARNING: Using deprecated sync loadHostConfigs() - migrate to async configService.loadHostConfigs()");
+    let manualHosts = [];
+    // 1. Try manual config file first
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { readFileSync, existsSync } = require("fs");
+    for (const configPath of getConfigPaths()) {
+        if (existsSync(configPath)) {
+            try {
+                const raw = readFileSync(configPath, "utf-8");
+                const config = JSON.parse(raw);
+                const configHosts = config.hosts || config;
+                if (Array.isArray(configHosts) && configHosts.length > 0) {
+                    console.error(`Loaded ${configHosts.length} hosts from ${configPath}`);
+                    manualHosts = configHosts;
+                    break;
+                }
+            }
+            catch (error) {
+                logError(error, {
+                    operation: "loadHostConfigs",
+                    metadata: { configPath, source: "file" }
+                });
+            }
+        }
+    }
+    // 2. Fall back to env var if no config file
+    if (manualHosts.length === 0) {
+        const configJson = process.env[ENV_HOSTS_CONFIG];
+        if (configJson) {
+            try {
+                manualHosts = JSON.parse(configJson);
+                console.error(`Loaded ${manualHosts.length} hosts from SYNAPSE_HOSTS_CONFIG env`);
+            }
+            catch (error) {
+                logError(error, {
+                    operation: "loadHostConfigs",
+                    metadata: { source: "SYNAPSE_HOSTS_CONFIG" }
+                });
+            }
+        }
+    }
+    // 3. Load SSH config hosts (auto-discovery) - use sync for backwards compat
+    const sshConfigPath = join(homedir(), ".ssh", "config");
+    const sshHosts = loadFromSSHConfigSync(sshConfigPath);
+    if (sshHosts.length > 0) {
+        console.error(`Auto-discovered ${sshHosts.length} hosts from SSH config`);
+    }
+    // 4. Merge hosts with manual taking precedence
+    const hosts = mergeHostConfigs(sshHosts, manualHosts);
+    // 5. If still no hosts, default to local socket only
+    if (hosts.length === 0) {
+        console.error("No config found, using local Docker socket");
+        return [
+            {
+                name: "local",
+                host: "localhost",
+                protocol: "http",
+                dockerSocketPath: DEFAULT_DOCKER_SOCKET
+            }
+        ];
+    }
+    // 6. Auto-add local socket if exists and not configured
+    return ensureLocalSocket(hosts);
+}
+//# sourceMappingURL=config-service.js.map

package/dist/services/config-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-service.js","sourceRoot":"","sources":["../../src/services/config-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEpG;;GAEG;AACH,SAAS,cAAc;IACrB,MAAM,UAAU,GAAG,qBAAqB,CAAC;IACzC,MAAM,KAAK,GAAG,EAAE,CAAC;IAEjB,gEAAgE;IAChE,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAC9C,CAAC;IAED,2BAA2B;IAC3B,KAAK,CAAC,IAAI,CACR,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,EAC/B,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,EACjD,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,UAAU,EAAE,CAAC,EACjC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,CACpC,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,KAAmB;IAC5C,MAAM,SAAS,GAAG,SAAS,QAAQ,EAAE,EAAE,CAAC;IAExC,8CAA8C;IAC9C,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,KAAK,qBAAqB,CAAC,CAAC;IAEvF,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO;QACL,GAAG,KAAK;QACR;YACE,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,qBAAqB;YAC3B,QAAQ,EAAE,MAAe;YACzB,gBAAgB,EAAE,qBAAqB;SACxC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,aAAa;IAChB,WAAW,GAAwB,IAAI,CAAC;IACxC,SAAS,GAAG,CAAC,CAAC;IACd,cAAc,GAAiC,IAAI,CAAC;IAC3C,SAAS,GAAG,KAAK,CAAC,CAAC,MAAM;IAE1C;;;;;;;;;;OAUG;IACH,KAAK,CAAC,eAAe;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,sCAAsC;QACtC,IAAI,IAAI,CAAC,WAAW,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAC9D,OAAO,IAAI,CAAC,WAAW,CAAC;QAC1B,CAAC;QAED,qCAAqC;QACrC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,cAAc,CAAC;QAC7B,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,IAAI,CAAC,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC;YAC7C,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;YACrB,OAAO,IAAI,CAAC,WAAW,CAAC;QAC1B,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,OAAO;QACnB,IAAI,WAAW,GAAiB,EAAE,CAAC;QAEnC,8CAA8C;QAC9C,KAAK,MAAM,UAAU,IAAI,cAAc,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC;gBACH,oCAAoC;gBACpC,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAC5B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBACnD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC/B,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC,yCAAyC;gBACrF,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzD,OAAO,CAAC,KAAK,CAAC,UAAU,WAAW,CAAC,MAAM,eAAe,UAAU,EAAE,CAAC,CAAC;oBACvE,WAAW,GAAG,WAA2B,CAAC;oBAC1C,MAAM;gBACR,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,sDAAsD;gBACtD,SAAS;YACX,CAAC;QACH,CAAC;QAED,4CAA4C;QAC5C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YACjD,IAAI,UAAU,EAAE,CAAC;gBACf,IAAI,CAAC;oBACH,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAiB,CAAC;oBACrD,OAAO,CAAC,KAAK,CAAC,UAAU,WAAW,CAAC,MAAM,sCAAsC,CAAC,CAAC;gBACpF,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,QAAQ,CAAC,KAAK,EAAE;wBACd,SAAS,EAAE,iBAAiB;wBAC5B,QAAQ,EAAE,EAAE,MAAM,EAAE,sBAAsB,EAAE;qBAC7C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,4DAA4D;QAC5D,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,aAAa,CAAC,CAAC;QACxD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,KAAK,CAAC,mBAAmB,QAAQ,CAAC,MAAM,wBAAwB,CAAC,CAAC;QAC5E,CAAC;QAED,+CAA+C;QAC/C,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAEtD,qDAAqD;QACrD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAC5D,OAAO;gBACL;oBACE,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,WAAW;oBACjB,QAAQ,EAAE,MAAM;oBAChB,gBAAgB,EAAE,qBAAqB;iBACxC;aACF,CAAC;QACJ,CAAC;QAED,wDAAwD;QACxD,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,eAAe;QACb,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;IACrB,CAAC;CACF;AAED,qDAAqD;AACrD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;AAEjD;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,+EAA+E;IAC/E,8DAA8D;IAC9D,OAAO,CAAC,IAAI,CACV,qGAAqG,CACtG,CAAC;IAEF,IAAI,WAAW,GAAiB,EAAE,CAAC;IAEnC,kCAAkC;IAClC,iEAAiE;IACjE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,KAAK,MAAM,UAAU,IAAI,cAAc,EAAE,EAAE,CAAC;QAC1C,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;gBAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC/B,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC;gBAC3C,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzD,OAAO,CAAC,KAAK,CAAC,UAAU,WAAW,CAAC,MAAM,eAAe,UAAU,EAAE,CAAC,CAAC;oBACvE,WAAW,GAAG,WAA2B,CAAC;oBAC1C,MAAM;gBACR,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,QAAQ,CAAC,KAAK,EAAE;oBACd,SAAS,EAAE,iBAAiB;oBAC5B,QAAQ,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE;iBACzC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,4CAA4C;IAC5C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACjD,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC;gBACH,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAiB,CAAC;gBACrD,OAAO,CAAC,KAAK,CAAC,UAAU,WAAW,CAAC,MAAM,sCAAsC,CAAC,CAAC;YACpF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,QAAQ,CAAC,KAAK,EAAE;oBACd,SAAS,EAAE,iBAAiB;oBAC5B,QAAQ,EAAE,EAAE,MAAM,EAAE,sBAAsB,EAAE;iBAC7C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAC;IACtD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,mBAAmB,QAAQ,CAAC,MAAM,wBAAwB,CAAC,CAAC;IAC5E,CAAC;IAED,+CAA+C;IAC/C,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAEtD,qDAAqD;IACrD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC5D,OAAO;YACL;gBACE,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE,WAAW;gBACjB,QAAQ,EAAE,MAAM;gBAChB,gBAAgB,EAAE,qBAAqB;aACxC;SACF,CAAC;IACJ,CAAC;IAED,wDAAwD;IACxD,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC"}

package/dist/services/container-host-map-cache.d.ts

@@ -0,0 +1,121 @@
+import type { DockerRawContainerInfo, HostConfig } from "../types.js";
+import type { IDockerClientProvider } from "./interfaces.js";
+/**
+ * Container to host mapping entry with multiple index keys.
+ * Supports lookup by full ID, short ID (12 chars), and container name.
+ *
+ * @internal This is an internal cache structure; external callers should use findContainerHost()
+ */
+export interface ContainerHostMapping {
+    containerId: string;
+    shortId: string;
+    containerName: string;
+    hostName: string;
+    host: HostConfig;
+    container: DockerRawContainerInfo;
+    timestamp: number;
+}
+/**
+ * Cache for container-to-host mappings.
+ * Optimizes findContainerHost() by eliminating N+1 queries.
+ *
+ * Key features:
+ * - Parallel host scanning with configurable concurrency
+ * - Multiple index keys per container (ID, name, ID prefix)
+ * - TTL-based expiration (default: 5 minutes)
+ * - Automatic cache rebuild on miss
+ * - LRU eviction policy
+ *
+ * @example
+ * ```typescript
+ * const cache = new ContainerHostMapCache();
+ * await cache.buildMapping(hosts, dockerService);
+ *
+ * const result = await cache.findContainerHost("my-container", hosts, dockerService);
+ * // Returns { host, container } immediately without scanning all hosts
+ * ```
+ */
+export declare class ContainerHostMapCache {
+    private cache;
+    private concurrency;
+    /**
+     * Create a new container-to-host mapping cache.
+     *
+     * @param ttlMs - Time-to-live for cache entries in milliseconds (default: 5 minutes)
+     * @param maxSize - Maximum number of cache entries (default: 500)
+     * @param concurrency - Number of parallel host scans (default from constants)
+     */
+    constructor(ttlMs?: number, maxSize?: number, concurrency?: number);
+    /**
+     * Build container-to-host mapping for all hosts in parallel.
+     * Uses concurrency control to avoid overwhelming the network.
+     *
+     * @param hosts - List of hosts to scan
+     * @param dockerService - Docker service to query containers
+     * @returns Promise that resolves when mapping is complete
+     */
+    buildMapping(hosts: HostConfig[], dockerService: IDockerClientProvider): Promise<void>;
+    /**
+     * Scan a single host and cache its containers.
+     * Returns true if the target container was found on this host.
+     *
+     * @param host - Host to scan
+     * @param dockerService - Docker service to query containers
+     * @param targetContainerId - Optional container ID/name to search for
+     * @returns Whether the target container was found on this host
+     */
+    private scanSingleHost;
+    /**
+     * Find which host a container is on, using cache with fallback.
+     * Supports full ID, short ID, or container name lookups.
+     *
+     * On cache miss, scans hosts incrementally (one at a time) instead of
+     * rebuilding the entire mapping. Stops as soon as the container is found,
+     * avoiding unnecessary network calls to remaining hosts.
+     *
+     * @param containerId - Container ID (full/short) or name
+     * @param hosts - Array of host configurations to search
+     * @param dockerService - Docker service for fallback queries
+     * @returns Host config and container info if found, null otherwise
+     */
+    findContainerHost(containerId: string, hosts: HostConfig[], dockerService: IDockerClientProvider): Promise<{
+        host: HostConfig;
+        container: DockerRawContainerInfo;
+    } | null>;
+    /**
+     * Invalidate entire cache after container lifecycle changes.
+     * Call this after container state changes (start, stop, pause, resume, remove, create).
+     *
+     * Note: Clears the ENTIRE cache for all hosts. This is simpler than selective
+     * per-host invalidation and the cache will rebuild automatically on next query.
+     * For production use with many hosts, consider implementing per-host invalidation.
+     */
+    invalidateCache(): void;
+    /**
+     * Warm cache by pre-populating with all containers on startup.
+     * Reduces initial query latency.
+     *
+     * @param hosts - Array of host configurations
+     * @param dockerService - Docker service for API calls
+     */
+    warmCache(hosts: HostConfig[], dockerService: IDockerClientProvider): Promise<void>;
+    /**
+     * Get cache statistics for monitoring and debugging.
+     * Returns metrics on hits, misses, size, and evictions.
+     *
+     * @returns Cache statistics object
+     */
+    getStats(): {
+        hits: number;
+        misses: number;
+        size: number;
+        maxSize: number;
+        evictions: number;
+    };
+    /**
+     * Log cache statistics to console.error for observability.
+     * Outputs formatted stats with hit rate calculation.
+     */
+    logStats(): void;
+}
+//# sourceMappingURL=container-host-map-cache.d.ts.map

package/dist/services/container-host-map-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-host-map-cache.d.ts","sourceRoot":"","sources":["../../src/services/container-host-map-cache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,SAAS,EAAE,sBAAsB,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,WAAW,CAAS;IAE5B;;;;;;OAMG;gBAED,KAAK,GAAE,MAAsB,EAC7B,OAAO,GAAE,MAAY,EACrB,WAAW,GAAE,MAA0C;IAMzD;;;;;;;OAOG;IACG,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,aAAa,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5F;;;;;;;;OAQG;YACW,cAAc;IA8C5B;;;;;;;;;;;;OAYG;IACG,iBAAiB,CACrB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,UAAU,EAAE,EACnB,aAAa,EAAE,qBAAqB,GACnC,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,SAAS,EAAE,sBAAsB,CAAA;KAAE,GAAG,IAAI,CAAC;IA6B1E;;;;;;;OAOG;IACH,eAAe,IAAI,IAAI;IAWvB;;;;;;OAMG;IACG,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,aAAa,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzF;;;;;OAKG;IACH,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAI9F;;;OAGG;IACH,QAAQ,IAAI,IAAI;CAYjB"}