synapse-mcp 1.0.0 → 1.0.2

package/dist/tools/flux.js

@@ -1,86 +1,47 @@
 // src/tools/flux.ts
-import { FluxSchema } from '../schemas/flux/index.js';
-import { generateHelp, formatHelpMarkdown, formatHelpJson } from '../utils/help.js';
+import { FluxSchema } from "../schemas/flux/index.js";
+import { handleHelpAction } from "../utils/help-handler.js";
+import { handleComposeAction } from "./handlers/compose.js";
+import { handleContainerAction } from "./handlers/container.js";
+import { handleDockerAction } from "./handlers/docker.js";
+import { handleHostAction } from "./handlers/host.js";
 /**
- * Flux tool handler - Docker infrastructure management
+ * Handle all Flux tool requests - Docker infrastructure management.
  *
- * Handles 4 action categories with 39 total subactions:
- * - container: 14 subactions (list, start, stop, restart, pause, resume, logs, stats, inspect, search, pull, recreate, exec, top)
- * - compose: 9 subactions (list, status, up, down, restart, logs, build, pull, recreate)
- * - docker: 9 subactions (info, df, prune, images, pull, build, rmi, networks, volumes)
- * - host: 7 subactions (status, resources, info, uptime, services, network, mounts)
+ * Routes incoming requests to specialized handlers based on action type.
+ * Validates input against Flux schema before dispatching.
  *
- * Plus 'help' pseudo-action for auto-generated documentation.
+ * @param input - Unvalidated user input to process
+ * @param container - Service container with dependencies
+ * @returns Formatted response string (markdown or JSON)
+ * @throws {Error} When validation fails or action is unknown
+ *
+ * @example
+ * ```typescript
+ * const result = await handleFluxTool(
+ *   { action: 'container', subaction: 'list', state: 'running' },
+ *   container
+ * );
+ * ```
  */
 export async function handleFluxTool(input, container) {
-    // Handle help action before schema validation
-    if (typeof input === 'object' && input !== null && 'action' in input && input.action === 'help') {
-        const helpInput = input;
-        const entries = generateHelp(FluxSchema, helpInput.topic);
-        if (helpInput.format === 'json') {
-            return formatHelpJson(entries);
-        }
-        return formatHelpMarkdown(entries);
-    }
     // Validate input against Flux schema
     const validated = FluxSchema.parse(input);
     // Route to appropriate handler based on action
     switch (validated.action) {
-        case 'container':
+        case "help":
+            return handleHelpAction(validated, FluxSchema);
+        case "container":
             return handleContainerAction(validated, container);
-        case 'compose':
+        case "compose":
             return handleComposeAction(validated, container);
-        case 'docker':
+        case "docker":
             return handleDockerAction(validated, container);
-        case 'host':
+        case "host":
             return handleHostAction(validated, container);
         default:
             // Zod validation should prevent reaching here
             throw new Error(`Unknown action: ${validated.action}`);
     }
 }
-/**
- * Placeholder handler for container actions
- * Will be implemented in Task 16
- */
-function handleContainerAction(input, _container) {
-    // Type guard to ensure we have container action
-    if (input.action !== 'container') {
-        throw new Error(`Invalid action for container handler: ${input.action}`);
-    }
-    throw new Error(`Handler not implemented: container:${input.subaction}`);
-}
-/**
- * Placeholder handler for compose actions
- * Will be implemented in Task 17
- */
-function handleComposeAction(input, _container) {
-    // Type guard to ensure we have compose action
-    if (input.action !== 'compose') {
-        throw new Error(`Invalid action for compose handler: ${input.action}`);
-    }
-    throw new Error(`Handler not implemented: compose:${input.subaction}`);
-}
-/**
- * Placeholder handler for docker actions
- * Will be implemented in Task 18
- */
-function handleDockerAction(input, _container) {
-    // Type guard to ensure we have docker action
-    if (input.action !== 'docker') {
-        throw new Error(`Invalid action for docker handler: ${input.action}`);
-    }
-    throw new Error(`Handler not implemented: docker:${input.subaction}`);
-}
-/**
- * Placeholder handler for host actions
- * Will be implemented in Task 19
- */
-function handleHostAction(input, _container) {
-    // Type guard to ensure we have host action
-    if (input.action !== 'host') {
-        throw new Error(`Invalid action for host handler: ${input.action}`);
-    }
-    throw new Error(`Handler not implemented: host:${input.subaction}`);
-}
 //# sourceMappingURL=flux.js.map

package/dist/tools/flux.js.map

@@ -1 +1 @@
-{"version":3,"file":"flux.js","sourceRoot":"","sources":["../../src/tools/flux.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"flux.js","sourceRoot":"","sources":["../../src/tools/flux.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,OAAO,EAAkB,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtE,OAAO,EAAkB,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAc,EAAE,SAA2B;IAC9E,qCAAqC;IACrC,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAc,CAAC;IAEvD,+CAA+C;IAC/C,QAAQ,SAAS,CAAC,MAAM,EAAE,CAAC;QACzB,KAAK,MAAM;YACT,OAAO,gBAAgB,CAAC,SAAiC,EAAE,UAAU,CAAC,CAAC;QACzE,KAAK,WAAW;YACd,OAAO,qBAAqB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACrD,KAAK,SAAS;YACZ,OAAO,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACnD,KAAK,QAAQ;YACX,OAAO,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAClD,KAAK,MAAM;YACT,OAAO,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAChD;YACE,8CAA8C;YAC9C,MAAM,IAAI,KAAK,CAAC,mBAAoB,SAAgC,CAAC,MAAM,EAAE,CAAC,CAAC;IACnF,CAAC;AACH,CAAC"}

package/dist/tools/handlers/base-handler.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Base handler utilities for reducing boilerplate across handlers
+ *
+ * Consolidates common patterns found in all handler files:
+ * - Initialization (service extraction, format resolution)
+ * - Host lookup and resolution
+ * - Action validation
+ * - Response formatting
+ * - Pagination
+ * - String utilities
+ */
+import type { z } from "zod";
+import type { ServiceContainer } from "../../services/container.js";
+import type { HostConfig, ResponseFormat } from "../../types.js";
+/**
+ * Common handler context with services and configuration
+ */
+export interface HandlerContext<TService> {
+    service: TService;
+    hosts: HostConfig[];
+    format: ResponseFormat;
+}
+/**
+ * Initialize handler context with common setup
+ * Consolidates repeated initialization from 6+ handlers
+ *
+ * @param input - Input object containing optional response_format
+ * @param container - Service container for dependency injection
+ * @param getService - Function to extract specific service from container
+ * @returns Promise resolving to handler context with service, hosts, and format
+ */
+export declare function initializeHandler<TService>(input: {
+    response_format?: ResponseFormat;
+}, container: ServiceContainer, getService: (container: ServiceContainer) => TService): Promise<HandlerContext<TService>>;
+/**
+ * Find host by name or throw if not found
+ * Consolidates host lookup pattern from container.ts, docker.ts, host.ts, scout-logs.ts
+ *
+ * @param hosts - Array of host configurations to search
+ * @param hostName - Name of the host to find
+ * @returns The found host configuration
+ * @throws Error if host is not found
+ */
+export declare function getHostConfigOrThrow(hosts: HostConfig[], hostName: string): HostConfig;
+/**
+ * Find host by name, returns undefined if not provided or not found
+ *
+ * @param hosts - Array of host configurations to search
+ * @param hostName - Name of the host to find (optional)
+ * @returns The found host configuration or undefined
+ */
+export declare function getHostConfigOptional(hosts: HostConfig[], hostName: string | undefined): HostConfig | undefined;
+/**
+ * Resolve target hosts - single host if specified, all hosts otherwise
+ * Consolidates pattern from compose.ts, host.ts, docker.ts
+ *
+ * @param hosts - Array of all available host configurations
+ * @param hostName - Optional specific host name to filter to
+ * @returns Array containing single host if specified, or all hosts
+ * @throws Error if specified host is not found
+ */
+export declare function resolveTargetHosts(hosts: HostConfig[], hostName: string | undefined): HostConfig[];
+/**
+ * Validate action matches handler type
+ * Consolidates action validation from all handlers
+ *
+ * @param input - Input object with action property
+ * @param expectedAction - The expected action value
+ * @param handlerName - Name of the handler (for error messages)
+ * @throws Error if action doesn't match expected
+ */
+export declare function assertValidAction(input: {
+    action: string;
+} | Record<string, unknown>, expectedAction: string, handlerName: string): void;
+/**
+ * Format response based on format preference using strategy pattern
+ * Consolidates 40+ occurrences across all handlers
+ *
+ * @param data - The data to format
+ * @param format - The desired output format (JSON or MARKDOWN)
+ * @param markdownFormatter - Function to convert data to markdown (called for markdown format)
+ * @returns Formatted string (JSON or markdown)
+ *
+ * @example
+ * ```typescript
+ * // Handler provides raw data and markdown formatter
+ * return formatResponse(containers, format, () =>
+ *   formatContainersMarkdown(containers, total, offset, hasMore)
+ * );
+ * ```
+ */
+export declare function formatResponse<T>(data: T, format: ResponseFormat, markdownFormatter: (data: T) => string): string;
+/**
+ * Pagination options for list operations
+ */
+export interface PaginationOptions {
+    offset?: number;
+    limit?: number;
+}
+/**
+ * Result of pagination operation
+ */
+export interface PaginatedResult<T> {
+    items: T[];
+    total: number;
+    offset: number;
+    limit: number;
+    hasMore: boolean;
+}
+/**
+ * Apply pagination to array and return paginated result
+ * Consolidates pagination pattern from 8+ locations
+ *
+ * @param items - Full array of items to paginate
+ * @param options - Pagination options (offset, limit)
+ * @returns Paginated result with items and metadata
+ */
+export declare function paginateItems<T>(items: T[], options: PaginationOptions): PaginatedResult<T>;
+/**
+ * Create exhaustive check error for switch statements
+ * Consolidates pattern from all handlers
+ *
+ * @param value - The unhandled value (should be never type)
+ * @param context - Context description for error message
+ * @returns Error with descriptive message
+ */
+export declare function createExhaustiveError(value: never, context: string): Error;
+/**
+ * Resolve non-empty string or undefined
+ * Consolidates utility from container.ts
+ *
+ * @param value - Value to check
+ * @returns Trimmed string if valid and non-empty, undefined otherwise
+ */
+export declare function resolveNonEmptyString(value: unknown): string | undefined;
+/**
+ * Get optional string field with type checking
+ * Consolidates utility from host.ts
+ *
+ * @param value - Value to check
+ * @param fieldName - Name of the field (for error messages)
+ * @returns The string value or undefined
+ * @throws Error if value is not undefined and not a string
+ */
+export declare function getOptionalString(value: unknown, fieldName: string): string | undefined;
+/**
+ * Get host name from input object with validation
+ * Consolidates getHostName from host.ts
+ *
+ * @param input - Input object that may contain a host field
+ * @returns The host name string or undefined
+ * @throws Error if host is present but not a string
+ */
+export declare function getHostNameFromInput(input: Record<string, unknown>): string | undefined;
+/**
+ * Validate input with Zod schema at handler boundary
+ *
+ * Provides runtime safety and consistent error messages across all handlers.
+ * Throws Error with handler name and field-specific validation issues.
+ *
+ * @param input - Unknown input to validate
+ * @param schema - Zod schema to validate against
+ * @param handlerName - Name of handler (for error messages)
+ * @returns Validated and typed input
+ * @throws Error if validation fails
+ *
+ * @example
+ * const validated = validateInput(input, scoutZfsSchema, 'zfs');
+ * // validated is now typed as ScoutZfsInput
+ */
+export declare function validateInput<T>(input: unknown, schema: z.ZodSchema<T>, handlerName: string): T;
+//# sourceMappingURL=base-handler.d.ts.map

package/dist/tools/handlers/base-handler.d.ts.map

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

package/dist/tools/handlers/base-handler.js

@@ -0,0 +1,234 @@
+/**
+ * Base handler utilities for reducing boilerplate across handlers
+ *
+ * Consolidates common patterns found in all handler files:
+ * - Initialization (service extraction, format resolution)
+ * - Host lookup and resolution
+ * - Action validation
+ * - Response formatting
+ * - Pagination
+ * - String utilities
+ */
+import { createFormatter } from "../../formatters/index.js";
+import { ResponseFormat as ResponseFormatEnum } from "../../types.js";
+/**
+ * Initialize handler context with common setup
+ * Consolidates repeated initialization from 6+ handlers
+ *
+ * @param input - Input object containing optional response_format
+ * @param container - Service container for dependency injection
+ * @param getService - Function to extract specific service from container
+ * @returns Promise resolving to handler context with service, hosts, and format
+ */
+export async function initializeHandler(input, container, getService) {
+    const service = getService(container);
+    const format = input.response_format ?? ResponseFormatEnum.MARKDOWN;
+    // Load hosts from repository via container
+    const hosts = await container.getHostConfigRepository().loadHosts();
+    return { service, hosts, format };
+}
+/**
+ * Find host by name or throw if not found
+ * Consolidates host lookup pattern from container.ts, docker.ts, host.ts, scout-logs.ts
+ *
+ * @param hosts - Array of host configurations to search
+ * @param hostName - Name of the host to find
+ * @returns The found host configuration
+ * @throws Error if host is not found
+ */
+export function getHostConfigOrThrow(hosts, hostName) {
+    const host = hosts.find((h) => h.name === hostName);
+    if (!host) {
+        throw new Error(`Host not found: ${hostName}`);
+    }
+    return host;
+}
+/**
+ * Find host by name, returns undefined if not provided or not found
+ *
+ * @param hosts - Array of host configurations to search
+ * @param hostName - Name of the host to find (optional)
+ * @returns The found host configuration or undefined
+ */
+export function getHostConfigOptional(hosts, hostName) {
+    if (!hostName)
+        return undefined;
+    return hosts.find((h) => h.name === hostName);
+}
+/**
+ * Resolve target hosts - single host if specified, all hosts otherwise
+ * Consolidates pattern from compose.ts, host.ts, docker.ts
+ *
+ * @param hosts - Array of all available host configurations
+ * @param hostName - Optional specific host name to filter to
+ * @returns Array containing single host if specified, or all hosts
+ * @throws Error if specified host is not found
+ */
+export function resolveTargetHosts(hosts, hostName) {
+    const rawDefaultHost = process.env.SYNAPSE_DEFAULT_HOST?.trim();
+    const defaultHost = rawDefaultHost && rawDefaultHost !== "undefined" && rawDefaultHost !== "null"
+        ? rawDefaultHost
+        : undefined;
+    const localSocketHost = hosts.find((host) => {
+        return Boolean(host.dockerSocketPath) || host.host.startsWith("/");
+    });
+    const requestedHost = hostName ?? defaultHost ?? localSocketHost?.name;
+    if (!requestedHost)
+        return hosts;
+    const host = hosts.find((h) => h.name === requestedHost);
+    if (!host) {
+        if (!hostName && defaultHost) {
+            throw new Error(`Default host not found: ${defaultHost}`);
+        }
+        throw new Error(`Host not found: ${requestedHost}`);
+    }
+    return [host];
+}
+/**
+ * Validate action matches handler type
+ * Consolidates action validation from all handlers
+ *
+ * @param input - Input object with action property
+ * @param expectedAction - The expected action value
+ * @param handlerName - Name of the handler (for error messages)
+ * @throws Error if action doesn't match expected
+ */
+export function assertValidAction(input, expectedAction, handlerName) {
+    const action = "action" in input ? input.action : undefined;
+    if (action !== expectedAction) {
+        throw new Error(`Invalid action for ${handlerName} handler: ${action}`);
+    }
+}
+/**
+ * Format response based on format preference using strategy pattern
+ * Consolidates 40+ occurrences across all handlers
+ *
+ * @param data - The data to format
+ * @param format - The desired output format (JSON or MARKDOWN)
+ * @param markdownFormatter - Function to convert data to markdown (called for markdown format)
+ * @returns Formatted string (JSON or markdown)
+ *
+ * @example
+ * ```typescript
+ * // Handler provides raw data and markdown formatter
+ * return formatResponse(containers, format, () =>
+ *   formatContainersMarkdown(containers, total, offset, hasMore)
+ * );
+ * ```
+ */
+export function formatResponse(data, format, markdownFormatter) {
+    // Use strategy pattern via createFormatter
+    const formatter = createFormatter(format);
+    // For markdown format, pass the pre-formatted markdown string
+    // For JSON format, pass the raw data for direct serialization
+    const input = format === ResponseFormatEnum.MARKDOWN ? markdownFormatter(data) : data;
+    return formatter.format(input);
+}
+/**
+ * Apply pagination to array and return paginated result
+ * Consolidates pagination pattern from 8+ locations
+ *
+ * @param items - Full array of items to paginate
+ * @param options - Pagination options (offset, limit)
+ * @returns Paginated result with items and metadata
+ */
+export function paginateItems(items, options) {
+    const offset = options.offset ?? 0;
+    const limit = options.limit ?? 50;
+    const total = items.length;
+    const paginatedItems = items.slice(offset, offset + limit);
+    const hasMore = offset + limit < total;
+    return {
+        items: paginatedItems,
+        total,
+        offset,
+        limit,
+        hasMore,
+    };
+}
+/**
+ * Create exhaustive check error for switch statements
+ * Consolidates pattern from all handlers
+ *
+ * @param value - The unhandled value (should be never type)
+ * @param context - Context description for error message
+ * @returns Error with descriptive message
+ */
+export function createExhaustiveError(value, context) {
+    const subaction = value.subaction;
+    return new Error(`Unknown ${context}: ${subaction ?? value}`);
+}
+/**
+ * Resolve non-empty string or undefined
+ * Consolidates utility from container.ts
+ *
+ * @param value - Value to check
+ * @returns Trimmed string if valid and non-empty, undefined otherwise
+ */
+export function resolveNonEmptyString(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+/**
+ * Get optional string field with type checking
+ * Consolidates utility from host.ts
+ *
+ * @param value - Value to check
+ * @param fieldName - Name of the field (for error messages)
+ * @returns The string value or undefined
+ * @throws Error if value is not undefined and not a string
+ */
+export function getOptionalString(value, fieldName) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === "string")
+        return value;
+    throw new Error(`Invalid ${fieldName}: expected string`);
+}
+/**
+ * Get host name from input object with validation
+ * Consolidates getHostName from host.ts
+ *
+ * @param input - Input object that may contain a host field
+ * @returns The host name string or undefined
+ * @throws Error if host is present but not a string
+ */
+export function getHostNameFromInput(input) {
+    if (!("host" in input))
+        return undefined;
+    const hostValue = input.host;
+    if (hostValue === undefined)
+        return undefined;
+    if (typeof hostValue === "string")
+        return hostValue;
+    throw new Error("Invalid host: expected string");
+}
+/**
+ * Validate input with Zod schema at handler boundary
+ *
+ * Provides runtime safety and consistent error messages across all handlers.
+ * Throws Error with handler name and field-specific validation issues.
+ *
+ * @param input - Unknown input to validate
+ * @param schema - Zod schema to validate against
+ * @param handlerName - Name of handler (for error messages)
+ * @returns Validated and typed input
+ * @throws Error if validation fails
+ *
+ * @example
+ * const validated = validateInput(input, scoutZfsSchema, 'zfs');
+ * // validated is now typed as ScoutZfsInput
+ */
+export function validateInput(input, schema, handlerName) {
+    const parsed = schema.safeParse(input);
+    if (!parsed.success) {
+        const issues = parsed.error.issues
+            .map((issue) => `${issue.path.join(".")}: ${issue.message}`)
+            .join(", ");
+        throw new Error(`${handlerName} input validation failed: ${issues}`);
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=base-handler.js.map

package/dist/tools/handlers/base-handler.js.map

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

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

@@ -0,0 +1,108 @@
+import type { ComposeBuildInput, ComposeDownInput, ComposeLogsInput, ComposePullInput, ComposeRecreateInput, ComposeRefreshInput, ComposeRestartInput, ComposeUpInput } from "../../schemas/flux/compose.js";
+import type { ServiceContainer } from "../../services/container.js";
+import type { HostConfig } from "../../types.js";
+/**
+ * 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 declare function handleComposeUp(input: ComposeUpInput, hosts: HostConfig[], container: ServiceContainer): Promise<string>;
+/**
+ * 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 declare function handleComposeDown(input: ComposeDownInput, hosts: HostConfig[], container: ServiceContainer): Promise<string>;
+/**
+ * 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 declare function handleComposeRestart(input: ComposeRestartInput, hosts: HostConfig[], container: ServiceContainer): Promise<string>;
+/**
+ * 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 declare function handleComposeLogs(input: ComposeLogsInput, hosts: HostConfig[], container: ServiceContainer): Promise<string>;
+/**
+ * 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 declare function handleComposeBuild(input: ComposeBuildInput, hosts: HostConfig[], container: ServiceContainer): Promise<string>;
+/**
+ * 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 declare function handleComposePull(input: ComposePullInput, hosts: HostConfig[], container: ServiceContainer): Promise<string>;
+/**
+ * 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 declare function handleComposeRecreate(input: ComposeRecreateInput, hosts: HostConfig[], container: ServiceContainer): Promise<string>;
+/**
+ * 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 declare function handleComposeRefresh(input: ComposeRefreshInput, hosts: HostConfig[], container: ServiceContainer): Promise<string>;
+//# sourceMappingURL=compose-handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compose-handlers.d.ts","sourceRoot":"","sources":["../../../src/tools/handlers/compose-handlers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACf,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAqDjD;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAiDjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA2CjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,UAAU,EAAE,EACnB,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAoCjB"}