@monoes/monomindcli 1.11.12 → 1.11.13

package/dist/src/services/container-worker-pool.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Container Worker Pool
+ * Docker-based worker pool for high-throughput headless execution.
+ *
+ * ADR-020: Headless Worker Integration Architecture - Phase 3
+ * - Manages pool of Docker containers for isolated worker execution
+ * - Supports dynamic scaling based on workload
+ * - Provides container lifecycle management
+ * - Integrates with WorkerQueue for task distribution
+ *
+ * Key Features:
+ * - Container pooling with configurable size
+ * - Health checking and auto-recovery
+ * - Resource limits (CPU, memory)
+ * - Volume mounting for workspace access
+ * - Network isolation per worker type
+ */
+import { EventEmitter } from 'events';
+import type { HeadlessWorkerType, HeadlessExecutionResult, SandboxMode } from './headless-worker-executor.js';
+/**
+ * Container state
+ */
+export type ContainerState = 'creating' | 'ready' | 'busy' | 'unhealthy' | 'terminated';
+/**
+ * Container info
+ */
+export interface ContainerInfo {
+    id: string;
+    name: string;
+    state: ContainerState;
+    createdAt: Date;
+    lastUsedAt?: Date;
+    workerType?: HeadlessWorkerType;
+    executionCount: number;
+    healthCheckFailures: number;
+    pid?: number;
+}
+/**
+ * Container pool configuration
+ */
+export interface ContainerPoolConfig {
+    /** Maximum number of containers in the pool */
+    maxContainers: number;
+    /** Minimum number of containers to keep warm */
+    minContainers: number;
+    /** Docker image to use */
+    image: string;
+    /** Container resource limits */
+    resources: {
+        cpus: string;
+        memory: string;
+    };
+    /** Health check interval in ms */
+    healthCheckIntervalMs: number;
+    /** Container idle timeout in ms */
+    idleTimeoutMs: number;
+    /** Workspace volume mount path */
+    workspacePath: string;
+    /** State persistence path */
+    statePath: string;
+    /** Network name for container isolation */
+    network?: string;
+    /** Environment variables for containers */
+    env?: Record<string, string>;
+    /** Default sandbox mode */
+    defaultSandbox: SandboxMode;
+}
+/**
+ * Container execution options
+ */
+export interface ContainerExecutionOptions {
+    workerType: HeadlessWorkerType;
+    prompt: string;
+    contextPatterns?: string[];
+    sandbox?: SandboxMode;
+    model?: string;
+    timeoutMs?: number;
+}
+/**
+ * Pool status
+ */
+export interface ContainerPoolStatus {
+    totalContainers: number;
+    readyContainers: number;
+    busyContainers: number;
+    unhealthyContainers: number;
+    queuedTasks: number;
+    containers: ContainerInfo[];
+    dockerAvailable: boolean;
+    lastHealthCheck?: Date;
+}
+/**
+ * ContainerWorkerPool - Manages Docker containers for headless worker execution
+ */
+export declare class ContainerWorkerPool extends EventEmitter {
+    private config;
+    private projectRoot;
+    private containers;
+    private taskQueue;
+    private healthCheckTimer?;
+    private idleCheckTimer?;
+    private dockerAvailable;
+    private initialized;
+    private isShuttingDown;
+    private exitHandlersRegistered;
+    constructor(projectRoot: string, config?: Partial<ContainerPoolConfig>);
+    /**
+     * Initialize the container pool
+     */
+    initialize(): Promise<boolean>;
+    /**
+     * Register process exit handlers to clean up containers
+     */
+    private registerExitHandlers;
+    /**
+     * Execute a worker in a container
+     */
+    execute(options: ContainerExecutionOptions): Promise<HeadlessExecutionResult>;
+    /**
+     * Scale pool for batch execution
+     */
+    scaleForBatch(workerCount: number): Promise<void>;
+    /**
+     * Get pool status
+     */
+    getStatus(): ContainerPoolStatus;
+    /**
+     * Shutdown the pool
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Check if Docker is available (async)
+     */
+    private checkDockerAvailable;
+    /**
+     * Ensure the container image exists (async)
+     */
+    private ensureImage;
+    /**
+     * Create a new container
+     */
+    private createContainer;
+    /**
+     * Terminate a container (async)
+     */
+    private terminateContainer;
+    /**
+     * Get a ready container
+     */
+    private getReadyContainer;
+    /**
+     * Scale to minimum containers
+     */
+    private scaleToMinimum;
+    /**
+     * Execute worker in a specific container
+     */
+    private executeInContainer;
+    /**
+     * Execute command in container
+     */
+    private execInContainer;
+    /**
+     * Build worker command for container execution
+     */
+    private buildWorkerCommand;
+    /**
+     * Process queued tasks
+     */
+    private processQueue;
+    /**
+     * Start health check timer
+     */
+    private startHealthChecks;
+    /**
+     * Run health checks on all containers
+     */
+    private runHealthChecks;
+    /**
+     * Start idle check timer
+     */
+    private startIdleChecks;
+    /**
+     * Terminate idle containers above minimum
+     */
+    private runIdleChecks;
+    /**
+     * Try to parse JSON from output
+     */
+    private tryParseJson;
+    /**
+     * Create an error result
+     */
+    private createErrorResult;
+}
+export default ContainerWorkerPool;
+//# sourceMappingURL=container-worker-pool.d.ts.map

package/dist/src/services/container-worker-pool.d.ts.map

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