synapse-mcp 1.0.0 → 1.0.2

package/dist/tools/handlers/container.js

@@ -0,0 +1,333 @@
+// src/tools/handlers/container.ts
+import pLimit from "p-limit";
+import { formatContainerExecMarkdown, formatContainerPauseMarkdown, formatContainerRestartMarkdown, formatContainerResumeMarkdown, formatContainerStartMarkdown, formatContainerStopMarkdown, formatContainersMarkdown, formatContainerTopMarkdown, formatInspectMarkdown, formatInspectSummaryMarkdown, formatLogsMarkdown, formatMultiStatsMarkdown, formatSearchResultsMarkdown, formatStatsMarkdown, } from "../../formatters/index.js";
+import { logError } from "../../utils/errors.js";
+import { CONTAINER_SEVERITY, sortBySeverity } from "../../utils/sorting.js";
+import { getCurrentTimestamp } from "../../utils/time.js";
+import { createExhaustiveError, formatResponse, initializeHandler, paginateItems, resolveNonEmptyString, resolveTargetHosts, } from "./base-handler.js";
+/**
+ * Handle all container subactions for Docker container management.
+ *
+ * Supports 14 subactions: list, start, stop, restart, pause, resume, logs, stats,
+ * inspect, search, pull, recreate, exec, top.
+ *
+ * @param validatedut - Validated Flux input with container action
+ * @param container - Service container with Docker service
+ * @returns Formatted response string (markdown or JSON)
+ * @throws {Error} When container not found or operation fails
+ *
+ * @example
+ * ```typescript
+ * const result = await handleContainerAction(
+ *   { action: 'container', subaction: 'list', state: 'running' },
+ *   container
+ * );
+ * ```
+ */
+export async function handleContainerAction(input, container) {
+    const validated = input;
+    const { service: dockerService, hosts, format, } = await initializeHandler(validated, container, (c) => c.getDockerService());
+    const targetHosts = resolveTargetHosts(hosts, validated.host);
+    switch (validated.subaction) {
+        case "list": {
+            const listInput = validated;
+            // Map schema state values to service state values
+            // Schema uses 'exited'/'restarting' but service uses 'stopped'
+            const stateMap = {
+                all: undefined,
+                running: "running",
+                exited: "stopped",
+                paused: "paused",
+                restarting: "running", // restarting containers are treated as running
+            };
+            const containers = await dockerService.listContainers(targetHosts, {
+                state: stateMap[listInput.state] ?? undefined,
+                nameFilter: listInput.name_filter,
+                imageFilter: listInput.image_filter,
+                labelFilter: listInput.label_filter,
+            });
+            // Sort by severity BEFORE pagination to ensure critical containers appear on page 1
+            // exited/dead → stopped → paused/restarting → running
+            const sortedContainers = sortBySeverity(containers, (c) => c.state, CONTAINER_SEVERITY, (c) => c.name);
+            // Apply pagination
+            const { items: paginatedContainers, total, offset, hasMore, } = paginateItems(sortedContainers, { offset: listInput.offset, limit: listInput.limit });
+            return formatResponse(paginatedContainers, format, () => formatContainersMarkdown(paginatedContainers, total, offset, hasMore));
+        }
+        case "start":
+        case "stop":
+        case "restart":
+        case "pause": {
+            const lifecycleInput = validated;
+            const found = await dockerService.findContainerHost(lifecycleInput.container_id, targetHosts);
+            if (!found) {
+                throw new Error(`Container not found: ${lifecycleInput.container_id}`);
+            }
+            await dockerService.containerAction(lifecycleInput.container_id, lifecycleInput.subaction, found.host);
+            // CRITICAL: Invalidate cache after state change
+            container.getContainerHostMapCache().invalidateCache();
+            // Emit events for audit trail and cross-cutting concerns
+            container.getEventEmitter().emit({
+                type: "container_state_changed",
+                containerId: lifecycleInput.container_id,
+                action: lifecycleInput.subaction,
+                host: found.host.name,
+                timestamp: getCurrentTimestamp(),
+            });
+            container.getEventEmitter().emit({
+                type: "cache_invalidated",
+                cache: "container_host_map",
+                reason: `Container ${lifecycleInput.subaction} operation`,
+                timestamp: getCurrentTimestamp(),
+            });
+            // Use proper formatter for each lifecycle action
+            const formatters = {
+                start: formatContainerStartMarkdown,
+                stop: formatContainerStopMarkdown,
+                restart: formatContainerRestartMarkdown,
+                pause: formatContainerPauseMarkdown,
+            };
+            const formatter = formatters[lifecycleInput.subaction];
+            return formatter(lifecycleInput.container_id, found.host.name);
+        }
+        case "resume": {
+            const resumeInput = validated;
+            const found = await dockerService.findContainerHost(resumeInput.container_id, targetHosts);
+            if (!found) {
+                throw new Error(`Container not found: ${resumeInput.container_id}`);
+            }
+            // Resume maps to unpause in Docker API
+            await dockerService.containerAction(resumeInput.container_id, "unpause", found.host);
+            // CRITICAL: Invalidate cache after state change
+            container.getContainerHostMapCache().invalidateCache();
+            // Emit events for audit trail and cross-cutting concerns
+            container.getEventEmitter().emit({
+                type: "container_state_changed",
+                containerId: resumeInput.container_id,
+                action: "unpause",
+                host: found.host.name,
+                timestamp: getCurrentTimestamp(),
+            });
+            container.getEventEmitter().emit({
+                type: "cache_invalidated",
+                cache: "container_host_map",
+                reason: "Container resume operation",
+                timestamp: getCurrentTimestamp(),
+            });
+            return formatContainerResumeMarkdown(resumeInput.container_id, found.host.name);
+        }
+        case "logs": {
+            const logsInput = validated;
+            const found = await dockerService.findContainerHost(logsInput.container_id, targetHosts);
+            if (!found) {
+                throw new Error(`Container not found: ${logsInput.container_id}`);
+            }
+            const logs = await dockerService.getContainerLogs(logsInput.container_id, found.host, {
+                lines: logsInput.lines,
+                since: logsInput.since,
+                until: logsInput.until,
+                stream: logsInput.stream === "both" ? "all" : logsInput.stream,
+            });
+            // Apply grep filter if specified
+            const grepFilter = logsInput.grep;
+            const filteredLogs = grepFilter
+                ? logs.filter((log) => log.message.includes(grepFilter))
+                : logs;
+            return formatResponse(filteredLogs, format, (data) => formatLogsMarkdown(data, logsInput.container_id, found.host.name, logsInput.lines, false, // truncated - not currently implemented
+            false // follow - not currently implemented
+            ));
+        }
+        case "stats": {
+            const statsInput = validated;
+            // If container_id is provided, get stats for specific container
+            if (statsInput.container_id) {
+                const found = await dockerService.findContainerHost(statsInput.container_id, targetHosts);
+                if (!found) {
+                    throw new Error(`Container not found: ${statsInput.container_id}`);
+                }
+                const stats = await dockerService.getContainerStats(statsInput.container_id, found.host);
+                return formatResponse(stats, format, (data) => formatStatsMarkdown([data], found.host.name));
+            }
+            // Otherwise, get stats for all running containers with cache optimization
+            // Get cache from ServiceContainer for proper lifecycle management
+            const containerHostCache = container.getContainerHostMapCache();
+            // Build mapping ONCE upfront (eliminates N+1)
+            await containerHostCache.buildMapping(targetHosts, dockerService);
+            const allContainers = await dockerService.listContainers(targetHosts, { state: "running" });
+            // Limit concurrent stats calls to prevent Docker daemon overload
+            // For 50 containers, this prevents 100 simultaneous API calls (2 per container)
+            const limit = pLimit(10);
+            const statsPromises = allContainers.map((c) => limit(async () => {
+                try {
+                    // O(1) cache lookup instead of N queries!
+                    const mapping = await containerHostCache.findContainerHost(c.id, targetHosts, dockerService);
+                    if (!mapping) {
+                        console.error(`Container ${c.id} not found in mapping`);
+                        return null;
+                    }
+                    const stats = await dockerService.getContainerStats(c.id, mapping.host);
+                    return { stats, host: mapping.host.name };
+                }
+                catch (error) {
+                    logError(error, { operation: `getContainerStats:${c.id}` });
+                    return null;
+                }
+            }));
+            const allStats = (await Promise.all(statsPromises)).filter((s) => s !== null);
+            return formatResponse(allStats, format, formatMultiStatsMarkdown);
+        }
+        case "inspect": {
+            const inspectInput = validated;
+            const found = await dockerService.findContainerHost(inspectInput.container_id, targetHosts);
+            if (!found) {
+                throw new Error(`Container not found: ${inspectInput.container_id}`);
+            }
+            const inspection = await dockerService.inspectContainer(inspectInput.container_id, found.host);
+            const summary = inspectInput.summary
+                ? {
+                    id: inspection.Id.slice(0, 12),
+                    name: inspection.Name.replace(/^\//, ""),
+                    image: inspection.Config.Image,
+                    state: inspection.State.Status,
+                    created: inspection.Created,
+                    started: inspection.State.StartedAt,
+                    restartCount: inspection.RestartCount,
+                    ports: Object.entries(inspection.NetworkSettings.Ports || {})
+                        .map(([containerPort, bindings]) => {
+                        // Filter out null/undefined bindings, keep only valid ones
+                        if (!Array.isArray(bindings) || bindings.length === 0) {
+                            return null;
+                        }
+                        const validBindings = bindings.filter((b) => b !== null &&
+                            b !== undefined &&
+                            typeof b === "object" &&
+                            "HostIp" in b &&
+                            typeof b.HostIp === "string" &&
+                            "HostPort" in b &&
+                            typeof b.HostPort === "string");
+                        if (validBindings.length === 0) {
+                            return null;
+                        }
+                        const binding = validBindings[0];
+                        return `${binding.HostIp || "0.0.0.0"}:${binding.HostPort} → ${containerPort}`;
+                    })
+                        .filter((port) => port !== null),
+                    mounts: (inspection.Mounts || []).map((m) => ({
+                        src: m.Source,
+                        dst: m.Destination,
+                        type: m.Type,
+                    })),
+                    networks: Object.keys(inspection.NetworkSettings.Networks || {}),
+                    env_count: inspection.Config.Env?.length || 0,
+                    labels_count: Object.keys(inspection.Config.Labels || {}).length,
+                    host: found.host.name,
+                }
+                : null;
+            if (summary) {
+                return formatResponse(summary, format, (data) => formatInspectSummaryMarkdown(data));
+            }
+            return formatResponse(inspection, format, () => formatInspectMarkdown(inspection, found.host.name));
+        }
+        case "search": {
+            const searchInput = validated;
+            const containers = await dockerService.listContainers(targetHosts, {
+                nameFilter: searchInput.query,
+            });
+            // Apply pagination
+            const { items: paginatedContainers, total } = paginateItems(containers, {
+                offset: searchInput.offset,
+                limit: searchInput.limit,
+            });
+            return formatResponse(paginatedContainers, format, () => formatSearchResultsMarkdown(paginatedContainers, searchInput.query, total));
+        }
+        case "pull": {
+            const pullInput = validated;
+            const found = await dockerService.findContainerHost(pullInput.container_id, targetHosts);
+            if (!found) {
+                throw new Error(`Container not found: ${pullInput.container_id}`);
+            }
+            const inputImage = resolveNonEmptyString(pullInput.image);
+            let image = resolveNonEmptyString(found.container?.Image);
+            if (!image) {
+                try {
+                    const inspection = await dockerService.inspectContainer(pullInput.container_id, found.host);
+                    image = resolveNonEmptyString(inspection?.Config?.Image);
+                }
+                catch (error) {
+                    logError(error, {
+                        operation: `inspectContainer:${pullInput.container_id}`,
+                        metadata: {
+                            host: found.host.name,
+                            context: "Falling back to inputImage for pull operation",
+                        },
+                    });
+                    if (!inputImage) {
+                        throw error;
+                    }
+                }
+            }
+            image = image ?? inputImage;
+            if (!image) {
+                throw new Error(`Cannot determine image for container: ${pullInput.container_id}`);
+            }
+            const result = await dockerService.pullImage(image, found.host);
+            return `Pulled image ${image}: ${result.status}`;
+        }
+        case "recreate": {
+            const recreateInput = validated;
+            const found = await dockerService.findContainerHost(recreateInput.container_id, targetHosts);
+            if (!found) {
+                throw new Error(`Container not found: ${recreateInput.container_id}`);
+            }
+            const result = await dockerService.recreateContainer(recreateInput.container_id, found.host, {
+                pull: recreateInput.pull,
+            });
+            return `Container recreated: ${result.containerId} (${result.status})`;
+        }
+        case "exec": {
+            const execInput = validated;
+            const found = await dockerService.findContainerHost(execInput.container_id, targetHosts);
+            if (!found) {
+                throw new Error(`Container not found: ${execInput.container_id}`);
+            }
+            const result = await dockerService.execContainer(execInput.container_id, found.host, {
+                command: execInput.command,
+                user: execInput.user,
+                workdir: execInput.workdir,
+            });
+            const execResult = {
+                host: found.host.name,
+                container: execInput.container_id,
+                ...result,
+            };
+            return formatResponse(execResult, format, () => {
+                // Combine stdout and stderr for output parameter
+                const output = result.stderr
+                    ? `${result.stdout}\n\nstderr:\n${result.stderr}`
+                    : result.stdout;
+                return formatContainerExecMarkdown(execInput.container_id, found.host.name, execInput.command, output, result.exitCode);
+            });
+        }
+        case "top": {
+            const topInput = validated;
+            const found = await dockerService.findContainerHost(topInput.container_id, targetHosts);
+            if (!found) {
+                throw new Error(`Container not found: ${topInput.container_id}`);
+            }
+            const result = await dockerService.getContainerProcesses(topInput.container_id, found.host);
+            const topResult = {
+                host: found.host.name,
+                container: topInput.container_id,
+                ...result,
+            };
+            return formatResponse(topResult, format, () => {
+                const header = result.titles.join(" ");
+                const rows = result.processes.map((row) => row.join(" "));
+                const processes = [header, ...rows].join("\n").trim();
+                return formatContainerTopMarkdown(topInput.container_id, found.host.name, processes);
+            });
+        }
+        default:
+            throw createExhaustiveError(validated, "container subaction");
+    }
+}
+//# sourceMappingURL=container.js.map

package/dist/tools/handlers/container.js.map

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

package/dist/tools/handlers/docker.d.ts

@@ -0,0 +1,24 @@
+import type { DockerActionInput } from "../../schemas/flux/docker.js";
+import type { ServiceContainer } from "../../services/container.js";
+/**
+ * Handle all docker subactions for Docker daemon operations.
+ *
+ * Supports 9 subactions: info, df, prune, images, pull, build, rmi, networks, volumes.
+ * Most operations require a specific host, while some (images, networks, volumes) can
+ * query all hosts.
+ *
+ * @param input - Validated Flux input with docker action
+ * @param container - Service container with Docker service
+ * @returns Formatted response string (markdown or JSON)
+ * @throws {Error} When host not found, operation fails, or required parameters missing
+ *
+ * @example
+ * ```typescript
+ * const result = await handleDockerAction(
+ *   { action: 'docker', subaction: 'info', host: 'host1' },
+ *   container
+ * );
+ * ```
+ */
+export declare function handleDockerAction(input: DockerActionInput, container: ServiceContainer): Promise<string>;
+//# sourceMappingURL=docker.d.ts.map

package/dist/tools/handlers/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/docker.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAWpE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,iBAAiB,EACxB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAiNjB"}

package/dist/tools/handlers/docker.js

@@ -0,0 +1,155 @@
+// src/tools/handlers/docker.ts
+import { formatDockerDfMarkdown, formatDockerInfoMarkdown, formatImagesMarkdown, formatNetworksMarkdown, formatPruneMarkdown, formatVolumesMarkdown, } from "../../formatters/index.js";
+import { getCurrentTimestamp } from "../../utils/time.js";
+import { createExhaustiveError, formatResponse, getHostConfigOptional, initializeHandler, paginateItems, resolveTargetHosts, } from "./base-handler.js";
+/**
+ * Handle all docker subactions for Docker daemon operations.
+ *
+ * Supports 9 subactions: info, df, prune, images, pull, build, rmi, networks, volumes.
+ * Most operations require a specific host, while some (images, networks, volumes) can
+ * query all hosts.
+ *
+ * @param input - Validated Flux input with docker action
+ * @param container - Service container with Docker service
+ * @returns Formatted response string (markdown or JSON)
+ * @throws {Error} When host not found, operation fails, or required parameters missing
+ *
+ * @example
+ * ```typescript
+ * const result = await handleDockerAction(
+ *   { action: 'docker', subaction: 'info', host: 'host1' },
+ *   container
+ * );
+ * ```
+ */
+export async function handleDockerAction(input, container) {
+    const validated = input;
+    const { service: dockerService, hosts, format, } = await initializeHandler(validated, container, (c) => c.getDockerService());
+    // Find the target host (some docker subactions may query all hosts if not specified)
+    const hostName = validated.host;
+    const hostConfig = getHostConfigOptional(hosts, hostName);
+    // For single-host operations, require the host
+    if (hostName && !hostConfig) {
+        throw new Error(`Host not found: ${hostName}`);
+    }
+    switch (validated.subaction) {
+        case "info": {
+            if (!hostConfig) {
+                throw new Error("Host is required for docker:info");
+            }
+            const info = await dockerService.getDockerInfo(hostConfig);
+            return formatResponse(info, format, (data) => formatDockerInfoMarkdown([
+                { host: hostConfig.name, info: { status: "success", ...data } },
+            ]));
+        }
+        case "df": {
+            if (!hostConfig) {
+                throw new Error("Host is required for docker:df");
+            }
+            const usage = await dockerService.getDockerDiskUsage(hostConfig);
+            return formatResponse(usage, format, (data) => formatDockerDfMarkdown([{ host: hostConfig.name, usage: data }]));
+        }
+        case "prune": {
+            if (!hostConfig) {
+                throw new Error("Host is required for docker:prune");
+            }
+            // Require force flag for prune operations
+            if (!validated.force) {
+                throw new Error("Prune requires force=true to prevent accidental data loss");
+            }
+            const target = validated.prune_target;
+            // Emit destructive operation event BEFORE execution for audit trail
+            container.getEventEmitter().emit({
+                type: "destructive_operation",
+                operation: `docker_prune_${target}`,
+                target: target,
+                host: hostConfig.name,
+                confirmed: validated.force === true,
+                timestamp: getCurrentTimestamp(),
+            });
+            const results = await dockerService.pruneDocker(hostConfig, target, { force: true });
+            const pruneResult = { host: hostConfig.name, results };
+            return formatResponse(pruneResult, format, (data) => formatPruneMarkdown([data]));
+        }
+        case "images": {
+            // Can query all hosts or specific host
+            const targetHosts = resolveTargetHosts(hosts, hostName);
+            const options = {};
+            if (validated.dangling_only) {
+                options.danglingOnly = true;
+            }
+            const images = await dockerService.listImages(targetHosts, options);
+            // Sort by hostName BEFORE pagination to ensure correct ordering
+            const sortedImages = [...images].sort((a, b) => {
+                const hostA = a.hostName ?? "";
+                const hostB = b.hostName ?? "";
+                return hostA.localeCompare(hostB);
+            });
+            // Apply pagination
+            const { items: paginatedImages, total, offset, } = paginateItems(sortedImages, { offset: validated.offset, limit: validated.limit });
+            return formatResponse(paginatedImages, format, () => formatImagesMarkdown(paginatedImages, total, offset));
+        }
+        case "networks": {
+            // Can query all hosts or specific host
+            const targetHosts = resolveTargetHosts(hosts, hostName);
+            const networks = await dockerService.listNetworks(targetHosts);
+            // Sort by hostName BEFORE pagination to ensure correct ordering
+            const sortedNetworks = [...networks].sort((a, b) => {
+                const hostA = a.hostName ?? "";
+                const hostB = b.hostName ?? "";
+                return hostA.localeCompare(hostB);
+            });
+            const { items: paginatedNetworks, total, offset, } = paginateItems(sortedNetworks, { offset: validated.offset, limit: validated.limit });
+            return formatResponse(paginatedNetworks, format, () => formatNetworksMarkdown(paginatedNetworks, total, offset));
+        }
+        case "volumes": {
+            // Can query all hosts or specific host
+            const targetHosts = resolveTargetHosts(hosts, hostName);
+            const volumes = await dockerService.listVolumes(targetHosts);
+            // Sort by hostName BEFORE pagination to ensure correct ordering
+            const sortedVolumes = [...volumes].sort((a, b) => {
+                const hostA = a.hostName ?? "";
+                const hostB = b.hostName ?? "";
+                return hostA.localeCompare(hostB);
+            });
+            const { items: paginatedVolumes, total, offset, } = paginateItems(sortedVolumes, { offset: validated.offset, limit: validated.limit });
+            return formatResponse(paginatedVolumes, format, () => formatVolumesMarkdown(paginatedVolumes, total, offset));
+        }
+        case "pull": {
+            if (!hostConfig) {
+                throw new Error("Host is required for docker:pull");
+            }
+            const imageName = validated.image;
+            const result = await dockerService.pullImage(imageName, hostConfig);
+            const pullResult = { host: hostConfig.name, image: imageName, ...result };
+            return formatResponse(pullResult, format, (data) => `Image '${data.image}' pull completed on ${data.host}: ${data.status}`);
+        }
+        case "build": {
+            if (!hostConfig) {
+                throw new Error("Host is required for docker:build");
+            }
+            const options = {
+                context: validated.context,
+                tag: validated.tag,
+                dockerfile: validated.dockerfile,
+                noCache: validated.no_cache,
+            };
+            const result = await dockerService.buildImage(hostConfig, options);
+            const buildResult = { host: hostConfig.name, ...options, ...result };
+            return formatResponse(buildResult, format, (data) => `Image '${options.tag}' build completed on ${data.host}: ${data.status}`);
+        }
+        case "rmi": {
+            if (!hostConfig) {
+                throw new Error("Host is required for docker:rmi");
+            }
+            const imageName = validated.image;
+            const force = validated.force ?? false;
+            const result = await dockerService.removeImage(imageName, hostConfig, { force });
+            const rmiResult = { host: hostConfig.name, image: imageName, ...result };
+            return formatResponse(rmiResult, format, (data) => `Image '${data.image}' removed from ${data.host}: ${data.status}`);
+        }
+        default:
+            throw createExhaustiveError(validated, "docker subaction");
+    }
+}
+//# sourceMappingURL=docker.js.map

package/dist/tools/handlers/docker.js.map

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

package/dist/tools/handlers/host.d.ts

@@ -0,0 +1,23 @@
+import type { FluxHostActionInput } from "../../schemas/flux/index.js";
+import type { ServiceContainer } from "../../services/container.js";
+/**
+ * Handle all host subactions for system-level operations.
+ *
+ * Supports 7 subactions: status, resources, info, uptime, services, network, mounts.
+ * Can query all hosts (status, resources) or require specific host (others).
+ *
+ * @param input - Validated Flux input with host action
+ * @param container - Service container with SSH and Docker services
+ * @returns Formatted response string (markdown or JSON)
+ * @throws {Error} When host not found or command fails
+ *
+ * @example
+ * ```typescript
+ * const result = await handleHostAction(
+ *   { action: 'host', subaction: 'status' },
+ *   container
+ * );
+ * ```
+ */
+export declare function handleHostAction(input: FluxHostActionInput, container: ServiceContainer): Promise<string>;
+//# sourceMappingURL=host.d.ts.map

package/dist/tools/handlers/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/host.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AA6CpE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA+MjB"}