synapse-mcp 1.0.0 → 1.0.2

package/dist/tools/handlers/compose-handlers.js

@@ -0,0 +1,293 @@
+import { DEFAULT_COMPOSE_SCAN_CONCURRENCY } from "../../constants.js";
+import { HostResolver } from "../../services/host-resolver.js";
+import { getCurrentTimestamp } from "../../utils/time.js";
+import { withCacheInvalidation } from "./compose-utils.js";
+/**
+ * Cache for HostResolver instances keyed by ComposeDiscovery.
+ * Avoids creating 7+ HostResolver instances per compose request when
+ * the same discovery and hosts are used repeatedly.
+ *
+ * Uses WeakMap so resolvers are garbage-collected when their discovery
+ * instance is no longer referenced.
+ */
+const resolverCache = new WeakMap();
+/**
+ * Get or create a shared HostResolver for the given discovery and hosts.
+ * Returns a cached instance if the discovery and hosts array are the same.
+ *
+ * @param discovery - ComposeDiscovery instance
+ * @param hosts - Array of host configurations
+ * @returns Shared HostResolver instance
+ */
+function getResolver(discovery, hosts) {
+    const cached = resolverCache.get(discovery);
+    if (cached && cached.hosts === hosts) {
+        return cached.resolver;
+    }
+    const resolver = new HostResolver(discovery, hosts);
+    resolverCache.set(discovery, { resolver, hosts });
+    return resolver;
+}
+/**
+ * Format compose operation result as markdown.
+ *
+ * @param operation - Operation performed (e.g., 'started', 'stopped')
+ * @param hostName - Name of the host
+ * @param projectName - Name of the compose project
+ * @param result - Optional additional result text
+ * @returns Formatted markdown string
+ */
+function formatComposeResult(operation, hostName, projectName, result) {
+    return `Project '${projectName}' ${operation} completed on ${hostName}${result ? `\n${result}` : ""}`;
+}
+/**
+ * Handle compose up operation with cache invalidation.
+ *
+ * Starts services in a compose project with auto-discovery support.
+ * Invalidates compose cache after successful operation.
+ *
+ * @param input - Validated compose up input with project and detach options
+ * @param hosts - Array of available host configurations
+ * @param container - Service container with compose service
+ * @returns Success message
+ * @throws {Error} When project/host not found or operation fails
+ */
+export async function handleComposeUp(input, hosts, container) {
+    const resolver = getResolver(container.getComposeDiscovery(), hosts);
+    const host = await resolver.resolveHost(input.project, input.host);
+    const eventEmitter = container.getEventEmitter();
+    const result = await withCacheInvalidation(async () => {
+        await container.getComposeService().composeUp(host, input.project, input.detach ?? true);
+        return formatComposeResult("started", host.name, input.project);
+    }, input.project, host.name, container.getComposeDiscovery(), "handleComposeUp", eventEmitter);
+    // Emit operation event for audit trail
+    eventEmitter.emit({
+        type: "compose_operation",
+        operation: "up",
+        project: input.project,
+        host: host.name,
+        timestamp: getCurrentTimestamp(),
+    });
+    return result;
+}
+/**
+ * Handle compose down operation with cache invalidation.
+ *
+ * Stops services in a compose project with optional volume removal.
+ * Requires force flag when removing volumes to prevent accidental data loss.
+ *
+ * @param input - Validated compose down input with project and volume options
+ * @param hosts - Array of available host configurations
+ * @param container - Service container with compose service
+ * @returns Success message
+ * @throws {Error} When project/host not found, force required, or operation fails
+ */
+export async function handleComposeDown(input, hosts, container) {
+    const resolver = getResolver(container.getComposeDiscovery(), hosts);
+    const host = await resolver.resolveHost(input.project, input.host);
+    // Validate force requirement for remove_volumes
+    if (input.remove_volumes && !input.force) {
+        throw new Error("Compose down with remove_volumes requires force=true to prevent accidental data loss");
+    }
+    const eventEmitter = container.getEventEmitter();
+    // Emit destructive operation event BEFORE execution for audit trail
+    if (input.remove_volumes) {
+        eventEmitter.emit({
+            type: "destructive_operation",
+            operation: "compose_down_with_volumes",
+            target: input.project,
+            host: host.name,
+            confirmed: input.force === true,
+            timestamp: getCurrentTimestamp(),
+        });
+    }
+    const result = await withCacheInvalidation(async () => {
+        await container
+            .getComposeService()
+            .composeDown(host, input.project, input.remove_volumes ?? false);
+        return formatComposeResult("stopped", host.name, input.project);
+    }, input.project, host.name, container.getComposeDiscovery(), "handleComposeDown", eventEmitter);
+    // Emit operation event for audit trail
+    eventEmitter.emit({
+        type: "compose_operation",
+        operation: "down",
+        project: input.project,
+        host: host.name,
+        timestamp: getCurrentTimestamp(),
+    });
+    return result;
+}
+/**
+ * Handle compose restart operation with cache invalidation.
+ *
+ * Restarts all services in a compose project.
+ * Invalidates compose cache after successful operation.
+ *
+ * @param input - Validated compose restart input with project
+ * @param hosts - Array of available host configurations
+ * @param container - Service container with compose service
+ * @returns Success message
+ * @throws {Error} When project/host not found or operation fails
+ */
+export async function handleComposeRestart(input, hosts, container) {
+    const resolver = getResolver(container.getComposeDiscovery(), hosts);
+    const host = await resolver.resolveHost(input.project, input.host);
+    return withCacheInvalidation(async () => {
+        await container.getComposeService().composeRestart(host, input.project);
+        return formatComposeResult("restarted", host.name, input.project);
+    }, input.project, host.name, container.getComposeDiscovery(), "handleComposeRestart");
+}
+/**
+ * Handle compose logs operation with cache invalidation.
+ *
+ * Retrieves logs from compose project services with optional filtering.
+ * Supports time range, service filtering, and grep patterns.
+ *
+ * @param input - Validated compose logs input with project and filter options
+ * @param hosts - Array of available host configurations
+ * @param container - Service container with compose service
+ * @returns Formatted logs in markdown
+ * @throws {Error} When project/host not found or operation fails
+ */
+export async function handleComposeLogs(input, hosts, container) {
+    const resolver = getResolver(container.getComposeDiscovery(), hosts);
+    const host = await resolver.resolveHost(input.project, input.host);
+    return withCacheInvalidation(async () => {
+        const options = {};
+        if (input.lines !== undefined) {
+            options.tail = input.lines;
+        }
+        if (input.since) {
+            options.since = input.since;
+        }
+        if (input.until) {
+            options.until = input.until;
+        }
+        if (input.service) {
+            options.services = [input.service];
+        }
+        let logs = await container.getComposeService().composeLogs(host, input.project, options);
+        // Apply grep filter if specified
+        if (input.grep) {
+            const grepPattern = input.grep;
+            const lines = logs.split("\n");
+            const filtered = lines.filter((line) => line.includes(grepPattern));
+            logs = filtered.join("\n");
+        }
+        return `## Logs: ${input.project} (${host.name})\n\n\`\`\`\n${logs}\n\`\`\``;
+    }, input.project, host.name, container.getComposeDiscovery(), "handleComposeLogs");
+}
+/**
+ * Handle compose build operation with cache invalidation.
+ *
+ * Builds or rebuilds service images in a compose project.
+ * Supports no-cache builds and service-specific builds.
+ *
+ * @param input - Validated compose build input with project and build options
+ * @param hosts - Array of available host configurations
+ * @param container - Service container with compose service
+ * @returns Success message
+ * @throws {Error} When project/host not found or operation fails
+ */
+export async function handleComposeBuild(input, hosts, container) {
+    const resolver = getResolver(container.getComposeDiscovery(), hosts);
+    const host = await resolver.resolveHost(input.project, input.host);
+    return withCacheInvalidation(async () => {
+        const options = {};
+        if (input.service) {
+            options.service = input.service;
+        }
+        if (input.no_cache) {
+            options.noCache = input.no_cache;
+        }
+        await container.getComposeService().composeBuild(host, input.project, options);
+        return formatComposeResult("build", host.name, input.project);
+    }, input.project, host.name, container.getComposeDiscovery(), "handleComposeBuild");
+}
+/**
+ * Handle compose pull operation with cache invalidation.
+ *
+ * Pulls service images defined in a compose project.
+ * Supports service-specific pulls.
+ *
+ * @param input - Validated compose pull input with project and service options
+ * @param hosts - Array of available host configurations
+ * @param container - Service container with compose service
+ * @returns Success message
+ * @throws {Error} When project/host not found or operation fails
+ */
+export async function handleComposePull(input, hosts, container) {
+    const resolver = getResolver(container.getComposeDiscovery(), hosts);
+    const host = await resolver.resolveHost(input.project, input.host);
+    return withCacheInvalidation(async () => {
+        const options = {};
+        if (input.service) {
+            options.service = input.service;
+        }
+        await container.getComposeService().composePull(host, input.project, options);
+        return formatComposeResult("pull", host.name, input.project);
+    }, input.project, host.name, container.getComposeDiscovery(), "handleComposePull");
+}
+/**
+ * Handle compose recreate operation with cache invalidation.
+ *
+ * Recreates containers in a compose project without rebuilding images.
+ * Supports service-specific recreation and force-recreate option.
+ *
+ * @param input - Validated compose recreate input with project and recreate options
+ * @param hosts - Array of available host configurations
+ * @param container - Service container with compose service
+ * @returns Success message
+ * @throws {Error} When project/host not found or operation fails
+ */
+export async function handleComposeRecreate(input, hosts, container) {
+    const resolver = getResolver(container.getComposeDiscovery(), hosts);
+    const host = await resolver.resolveHost(input.project, input.host);
+    return withCacheInvalidation(async () => {
+        const options = {};
+        if (input.service) {
+            options.service = input.service;
+        }
+        await container.getComposeService().composeRecreate(host, input.project, options);
+        return formatComposeResult("recreated", host.name, input.project);
+    }, input.project, host.name, container.getComposeDiscovery(), "handleComposeRecreate");
+}
+/**
+ * Handle compose refresh operation - scans filesystem and updates cache.
+ *
+ * Scans host for compose files and updates discovery cache.
+ * Uses host's configured compose search paths.
+ *
+ * @param input - Validated compose refresh input with host
+ * @param hosts - Array of available host configurations
+ * @param container - Service container with compose scanner and discovery
+ * @returns Summary of discovered projects
+ * @throws {Error} When host not found or scan fails
+ */
+export async function handleComposeRefresh(input, hosts, container) {
+    const host = hosts.find((h) => h.name === input.host);
+    if (!host) {
+        throw new Error(`Host '${input.host}' not found`);
+    }
+    const discovery = container.getComposeDiscovery();
+    const scanner = container.getComposeScanner();
+    // Scan filesystem for compose files (scanner uses host.composeSearchPaths internally)
+    const composePaths = await scanner.findComposeFiles(host);
+    // Batch parse all files at once (uses DEFAULT_COMPOSE_SCAN_CONCURRENCY)
+    const nameMap = await scanner.batchParseComposeNames(host, composePaths, DEFAULT_COMPOSE_SCAN_CONCURRENCY);
+    const projects = [];
+    for (const composePath of composePaths) {
+        const explicitName = nameMap.get(composePath);
+        const projectName = explicitName ?? scanner.extractProjectName(composePath);
+        // Update cache with discovered project
+        await discovery.cache.updateProject(host.name, projectName, {
+            name: projectName,
+            path: composePath,
+            discoveredFrom: "scan",
+            lastSeen: getCurrentTimestamp(),
+        });
+        projects.push(`${projectName} (${composePath})`);
+    }
+    return `Cache refreshed for host '${host.name}'\nDiscovered ${projects.length} project(s):\n${projects.join("\n")}`;
+}
+//# sourceMappingURL=compose-handlers.js.map

package/dist/tools/handlers/compose-handlers.js.map

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

package/dist/tools/handlers/compose-utils.d.ts

@@ -0,0 +1,35 @@
+import type { EventEmitter } from "../../events/index.js";
+import type { ComposeDiscovery } from "../../services/compose-discovery.js";
+/**
+ * Check if an error is a file-not-found error
+ *
+ * Detects:
+ * - ENOENT error code (Node.js file system errors)
+ * - Error messages containing file-not-found indicators
+ *
+ * @param error - The error to check
+ * @returns True if this is a file-not-found error
+ */
+export declare function isFileNotFoundError(error: unknown): boolean;
+/**
+ * Wrap a compose operation with cache invalidation on file-not-found errors
+ *
+ * When a compose operation fails due to a stale cached path, this wrapper:
+ * 1. Detects the file-not-found error
+ * 2. Invalidates the cache for that project
+ * 3. Emits cache invalidation event
+ * 4. Re-throws the error for normal error handling
+ *
+ * The cache invalidation ensures the next operation will re-discover the project.
+ *
+ * @param operation - The async operation to execute
+ * @param projectName - The compose project name
+ * @param hostName - The host name
+ * @param discovery - The discovery service (for cache access)
+ * @param operationName - Name of the operation (for logging)
+ * @param eventEmitter - Optional event emitter for cross-cutting concerns
+ * @returns The result of the operation
+ * @throws Re-throws any errors from the operation
+ */
+export declare function withCacheInvalidation<T>(operation: () => Promise<T>, projectName: string, hostName: string, discovery: ComposeDiscovery, operationName: string, eventEmitter?: EventEmitter): Promise<T>;
+//# sourceMappingURL=compose-utils.d.ts.map

package/dist/tools/handlers/compose-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-utils.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/compose-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAI5E;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAqB3D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,EAC3C,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,gBAAgB,EAC3B,aAAa,EAAE,MAAM,EACrB,YAAY,CAAC,EAAE,YAAY,GAC1B,OAAO,CAAC,CAAC,CAAC,CA0BZ"}

package/dist/tools/handlers/compose-utils.js

@@ -0,0 +1,76 @@
+import { logError } from "../../utils/errors.js";
+import { getCurrentTimestamp } from "../../utils/time.js";
+/**
+ * Check if an error is a file-not-found error
+ *
+ * Detects:
+ * - ENOENT error code (Node.js file system errors)
+ * - Error messages containing file-not-found indicators
+ *
+ * @param error - The error to check
+ * @returns True if this is a file-not-found error
+ */
+export function isFileNotFoundError(error) {
+    if (!error || typeof error !== "object") {
+        return false;
+    }
+    // Check for ENOENT error code
+    if ("code" in error && error.code === "ENOENT") {
+        return true;
+    }
+    // Check error message for file-not-found indicators
+    if ("message" in error && typeof error.message === "string") {
+        const message = error.message.toLowerCase();
+        return (message.includes("no such file or directory") ||
+            message.includes("does not exist") ||
+            message.includes("cannot find"));
+    }
+    return false;
+}
+/**
+ * Wrap a compose operation with cache invalidation on file-not-found errors
+ *
+ * When a compose operation fails due to a stale cached path, this wrapper:
+ * 1. Detects the file-not-found error
+ * 2. Invalidates the cache for that project
+ * 3. Emits cache invalidation event
+ * 4. Re-throws the error for normal error handling
+ *
+ * The cache invalidation ensures the next operation will re-discover the project.
+ *
+ * @param operation - The async operation to execute
+ * @param projectName - The compose project name
+ * @param hostName - The host name
+ * @param discovery - The discovery service (for cache access)
+ * @param operationName - Name of the operation (for logging)
+ * @param eventEmitter - Optional event emitter for cross-cutting concerns
+ * @returns The result of the operation
+ * @throws Re-throws any errors from the operation
+ */
+export async function withCacheInvalidation(operation, projectName, hostName, discovery, operationName, eventEmitter) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        // If this is a file-not-found error, invalidate cache and re-throw
+        if (isFileNotFoundError(error)) {
+            await discovery.cache.removeProject(hostName, projectName);
+            logError(error, {
+                operation: operationName,
+                metadata: { host: hostName, project: projectName, reason: "stale path, cache invalidated" },
+            });
+            // Emit cache invalidation event
+            if (eventEmitter) {
+                eventEmitter.emit({
+                    type: "cache_invalidated",
+                    cache: "compose_project",
+                    reason: `Stale path for project ${projectName} on ${hostName}`,
+                    timestamp: getCurrentTimestamp(),
+                });
+            }
+        }
+        // Always re-throw the error
+        throw error;
+    }
+}
+//# sourceMappingURL=compose-utils.js.map

package/dist/tools/handlers/compose-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-utils.js","sourceRoot":"","sources":["../../../src/tools/handlers/compose-utils.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8BAA8B;IAC9B,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oDAAoD;IACpD,IAAI,SAAS,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAC5C,OAAO,CACL,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YAC7C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAChC,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,SAA2B,EAC3B,WAAmB,EACnB,QAAgB,EAChB,SAA2B,EAC3B,aAAqB,EACrB,YAA2B;IAE3B,IAAI,CAAC;QACH,OAAO,MAAM,SAAS,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,mEAAmE;QACnE,IAAI,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,SAAS,CAAC,KAAK,CAAC,aAAa,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YAC3D,QAAQ,CAAC,KAAK,EAAE;gBACd,SAAS,EAAE,aAAa;gBACxB,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,+BAA+B,EAAE;aAC5F,CAAC,CAAC;YAEH,gCAAgC;YAChC,IAAI,YAAY,EAAE,CAAC;gBACjB,YAAY,CAAC,IAAI,CAAC;oBAChB,IAAI,EAAE,mBAAmB;oBACzB,KAAK,EAAE,iBAAiB;oBACxB,MAAM,EAAE,0BAA0B,WAAW,OAAO,QAAQ,EAAE;oBAC9D,SAAS,EAAE,mBAAmB,EAAE;iBACjC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,4BAA4B;QAC5B,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,23 @@
+import type { ComposeActionInput } from "../../schemas/flux/compose.js";
+import type { ServiceContainer } from "../../services/container.js";
+/**
+ * Handle all compose subactions for Docker Compose project management.
+ *
+ * Supports 10 subactions: list, status, up, down, restart, logs, build, pull,
+ * recreate, refresh. Uses auto-discovery to find projects across hosts.
+ *
+ * @param input - Validated Flux input with compose action
+ * @param container - Service container with Compose service
+ * @returns Formatted response string (markdown or JSON)
+ * @throws {Error} When project/host not found or operation fails
+ *
+ * @example
+ * ```typescript
+ * const result = await handleComposeAction(
+ *   { action: 'compose', subaction: 'status', project: 'myapp' },
+ *   container
+ * );
+ * ```
+ */
+export declare function handleComposeAction(input: ComposeActionInput, container: ServiceContainer): Promise<string>;
+//# sourceMappingURL=compose.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/compose.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,kBAAkB,EAWnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAsBpE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA+IjB"}

package/dist/tools/handlers/compose.js

@@ -0,0 +1,125 @@
+// src/tools/handlers/compose.ts
+import { formatComposeListMarkdown, formatComposeStatusMarkdown } from "../../formatters/index.js";
+import { HostResolver } from "../../services/host-resolver.js";
+import { logError } from "../../utils/errors.js";
+import { createExhaustiveError, formatResponse, initializeHandler, paginateItems, resolveTargetHosts, } from "./base-handler.js";
+import { handleComposeBuild, handleComposeDown, handleComposeLogs, handleComposePull, handleComposeRecreate, handleComposeRefresh, handleComposeRestart, handleComposeUp, } from "./compose-handlers.js";
+/**
+ * Handle all compose subactions for Docker Compose project management.
+ *
+ * Supports 10 subactions: list, status, up, down, restart, logs, build, pull,
+ * recreate, refresh. Uses auto-discovery to find projects across hosts.
+ *
+ * @param input - Validated Flux input with compose action
+ * @param container - Service container with Compose service
+ * @returns Formatted response string (markdown or JSON)
+ * @throws {Error} When project/host not found or operation fails
+ *
+ * @example
+ * ```typescript
+ * const result = await handleComposeAction(
+ *   { action: 'compose', subaction: 'status', project: 'myapp' },
+ *   container
+ * );
+ * ```
+ */
+export async function handleComposeAction(input, container) {
+    const validated = input;
+    const { service: composeService, hosts, format, } = await initializeHandler(validated, container, (c) => c.getComposeService());
+    switch (validated.subaction) {
+        case "list": {
+            const listInput = validated;
+            const targetHosts = resolveTargetHosts(hosts, listInput.host);
+            // For single-host queries, propagate errors. For multi-host aggregation, catch and continue.
+            const isSingleHost = targetHosts.length === 1;
+            const allProjects = await Promise.all(targetHosts.map(async (h) => {
+                try {
+                    const projects = await composeService.listComposeProjects(h);
+                    return projects.map((p) => ({ ...p, host: h.name }));
+                }
+                catch (error) {
+                    if (isSingleHost) {
+                        // Propagate errors when targeting a specific host
+                        throw error;
+                    }
+                    // Log and continue when aggregating across multiple hosts
+                    logError(error, { operation: "compose:list", metadata: { host: h.name } });
+                    return [];
+                }
+            }));
+            let projects = allProjects.flat();
+            // Apply name filter
+            if (listInput.name_filter) {
+                const nameFilter = listInput.name_filter;
+                projects = projects.filter((p) => p.name.toLowerCase().includes(nameFilter.toLowerCase()));
+            }
+            // Apply pagination
+            const { items: paginatedProjects, total, offset, hasMore, } = paginateItems(projects, { offset: listInput.offset, limit: listInput.limit });
+            const label = targetHosts.length === 1 ? (targetHosts[0]?.name ?? "all-hosts") : "all-hosts";
+            return formatResponse(paginatedProjects, format, () => formatComposeListMarkdown(paginatedProjects, label, total, offset, hasMore));
+        }
+        case "status": {
+            const statusInput = validated;
+            let hostConfig;
+            // Use HostResolver for auto-discovery if no host specified
+            if (!statusInput.host) {
+                const resolver = new HostResolver(container.getComposeDiscovery(), hosts);
+                hostConfig = await resolver.resolveHost(statusInput.project, undefined);
+            }
+            else {
+                const found = hosts.find((h) => h.name === statusInput.host);
+                if (!found) {
+                    throw new Error(`Host not found: ${statusInput.host}`);
+                }
+                hostConfig = found;
+            }
+            const project = await composeService.getComposeStatus(hostConfig, statusInput.project);
+            // Apply service filter if specified
+            let services = project.services;
+            if (statusInput.service_filter) {
+                const serviceFilter = statusInput.service_filter;
+                services = services.filter((s) => s.name.toLowerCase().includes(serviceFilter.toLowerCase()));
+                project.services = services;
+            }
+            // Apply pagination to services
+            const { items: paginatedServices, total: totalServices, offset, hasMore, } = paginateItems(services, { offset: statusInput.offset, limit: statusInput.limit });
+            const paginatedProject = { ...project, services: paginatedServices };
+            return formatResponse(paginatedProject, format, () => formatComposeStatusMarkdown(paginatedProject, totalServices, offset, hasMore));
+        }
+        case "up": {
+            const upInput = validated;
+            return handleComposeUp(upInput, hosts, container);
+        }
+        case "down": {
+            const downInput = validated;
+            return handleComposeDown(downInput, hosts, container);
+        }
+        case "restart": {
+            const restartInput = validated;
+            return handleComposeRestart(restartInput, hosts, container);
+        }
+        case "logs": {
+            const logsInput = validated;
+            return handleComposeLogs(logsInput, hosts, container);
+        }
+        case "build": {
+            const buildInput = validated;
+            return handleComposeBuild(buildInput, hosts, container);
+        }
+        case "pull": {
+            const pullInput = validated;
+            return handleComposePull(pullInput, hosts, container);
+        }
+        case "recreate": {
+            const recreateInput = validated;
+            return handleComposeRecreate(recreateInput, hosts, container);
+        }
+        case "refresh": {
+            const refreshInput = validated;
+            return handleComposeRefresh(refreshInput, hosts, container);
+        }
+        default:
+            throw createExhaustiveError(validated, "compose subaction");
+    }
+}
+//# sourceMappingURL=compose.js.map

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

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

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

@@ -0,0 +1,23 @@
+import type { ContainerActionInput } from "../../schemas/flux/container.js";
+import type { ServiceContainer } from "../../services/container.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 declare function handleContainerAction(input: ContainerActionInput, container: ServiceContainer): Promise<string>;
+//# sourceMappingURL=container.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/container.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,oBAAoB,EAUrB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAcpE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,oBAAoB,EAC3B,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA0ZjB"}