agent-web-interface 4.1.1 → 4.2.0

package/dist/src/worker/health-monitor.js

@@ -0,0 +1,260 @@
+/**
+ * Health Monitor
+ *
+ * Monitors the health of Chrome workers by periodically checking
+ * their CDP endpoints via /json/version.
+ */
+import { EventEmitter } from 'events';
+import { createLogger } from '../shared/services/logging.service.js';
+const logger = createLogger('HealthMonitor');
+/**
+ * Default health check configuration
+ */
+const DEFAULT_HEALTH_CONFIG = {
+    timeoutMs: 5000,
+    failureThreshold: 3,
+};
+/**
+ * Monitors the health of Chrome workers.
+ *
+ * @example
+ * ```typescript
+ * const monitor = new HealthMonitor({ intervalMs: 30000 });
+ *
+ * monitor.on('healthChange', ({ workerId, healthy, result }) => {
+ *   if (!healthy) {
+ *     console.log(`Worker ${workerId} became unhealthy: ${result.error}`);
+ *   }
+ * });
+ *
+ * monitor.registerWorker('w-123', 9300);
+ * monitor.start();
+ *
+ * // Later...
+ * monitor.unregisterWorker('w-123');
+ * monitor.stop();
+ * ```
+ */
+export class HealthMonitor extends EventEmitter {
+    intervalMs;
+    config;
+    workers = new Map();
+    intervalId = null;
+    _isRunning = false;
+    constructor(intervalMs = 30_000, config = {}) {
+        super();
+        this.intervalMs = intervalMs;
+        this.config = { ...DEFAULT_HEALTH_CONFIG, ...config };
+    }
+    /**
+     * Check if the monitor is currently running
+     */
+    get isRunning() {
+        return this._isRunning;
+    }
+    /**
+     * Get the number of registered workers
+     */
+    get workerCount() {
+        return this.workers.size;
+    }
+    /**
+     * Register a worker for health monitoring
+     *
+     * @param workerId - Unique worker identifier
+     * @param port - CDP port number
+     */
+    registerWorker(workerId, port) {
+        if (this.workers.has(workerId)) {
+            logger.warning('Worker already registered for health monitoring', { workerId });
+            return;
+        }
+        this.workers.set(workerId, {
+            workerId,
+            port,
+            healthy: true, // Assume healthy until proven otherwise
+            consecutiveFailures: 0,
+        });
+        logger.debug('Worker registered for health monitoring', { workerId, port });
+    }
+    /**
+     * Unregister a worker from health monitoring
+     *
+     * @param workerId - Unique worker identifier
+     * @returns true if the worker was found and removed
+     */
+    unregisterWorker(workerId) {
+        const removed = this.workers.delete(workerId);
+        if (removed) {
+            logger.debug('Worker unregistered from health monitoring', { workerId });
+        }
+        return removed;
+    }
+    /**
+     * Check if a worker is registered
+     */
+    isWorkerRegistered(workerId) {
+        return this.workers.has(workerId);
+    }
+    /**
+     * Get the current health state of a worker
+     */
+    getWorkerHealth(workerId) {
+        return this.workers.get(workerId);
+    }
+    /**
+     * Start periodic health monitoring
+     */
+    start() {
+        if (this._isRunning) {
+            logger.warning('Health monitor is already running');
+            return;
+        }
+        this._isRunning = true;
+        // Run initial check immediately
+        void this.checkAllWorkers();
+        // Set up periodic checks
+        this.intervalId = setInterval(() => {
+            void this.checkAllWorkers();
+        }, this.intervalMs);
+        logger.info('Health monitor started', { intervalMs: this.intervalMs });
+    }
+    /**
+     * Stop periodic health monitoring
+     */
+    stop() {
+        if (!this._isRunning) {
+            return;
+        }
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = null;
+        }
+        this._isRunning = false;
+        logger.info('Health monitor stopped');
+    }
+    /**
+     * Check health of all registered workers
+     */
+    async checkAllWorkers() {
+        const checks = Array.from(this.workers.values()).map((state) => this.checkWorker(state));
+        await Promise.all(checks);
+    }
+    /**
+     * Check health of a specific worker by ID
+     *
+     * @param workerId - Worker identifier
+     * @returns Health check result
+     */
+    async checkWorkerById(workerId) {
+        const state = this.workers.get(workerId);
+        if (!state) {
+            return {
+                healthy: false,
+                error: `Worker ${workerId} is not registered`,
+            };
+        }
+        return this.checkWorker(state);
+    }
+    /**
+     * Perform a single health check on a worker
+     */
+    async checkWorker(state) {
+        const result = await this.performHealthCheck(state.port);
+        state.lastCheck = result;
+        state.lastCheckTime = Date.now();
+        const wasHealthy = state.healthy;
+        if (result.healthy) {
+            state.consecutiveFailures = 0;
+            state.healthy = true;
+        }
+        else {
+            state.consecutiveFailures++;
+            // Only mark as unhealthy after threshold is reached
+            if (state.consecutiveFailures >= this.config.failureThreshold) {
+                state.healthy = false;
+            }
+        }
+        // Emit event if health state changed
+        if (wasHealthy !== state.healthy) {
+            logger.info('Worker health state changed', {
+                workerId: state.workerId,
+                healthy: state.healthy,
+                consecutiveFailures: state.consecutiveFailures,
+            });
+            this.emit('healthChange', {
+                workerId: state.workerId,
+                healthy: state.healthy,
+                result,
+            });
+        }
+        return result;
+    }
+    /**
+     * Perform a health check against the CDP endpoint
+     *
+     * @param port - CDP port number
+     * @returns Health check result
+     */
+    async performHealthCheck(port) {
+        const url = `http://127.0.0.1:${port}/json/version`;
+        const startTime = Date.now();
+        try {
+            const response = await fetch(url, {
+                signal: AbortSignal.timeout(this.config.timeoutMs),
+            });
+            if (!response.ok) {
+                return {
+                    healthy: false,
+                    responseTimeMs: Date.now() - startTime,
+                    error: `HTTP ${response.status}: ${response.statusText}`,
+                };
+            }
+            const versionInfo = (await response.json());
+            return {
+                healthy: true,
+                responseTimeMs: Date.now() - startTime,
+                versionInfo,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error
+                ? error.name === 'TimeoutError'
+                    ? `Timeout after ${this.config.timeoutMs}ms`
+                    : error.message
+                : String(error);
+            return {
+                healthy: false,
+                responseTimeMs: Date.now() - startTime,
+                error: errorMessage,
+            };
+        }
+    }
+    /**
+     * Get all unhealthy workers
+     */
+    getUnhealthyWorkers() {
+        return Array.from(this.workers.entries())
+            .filter(([_, state]) => !state.healthy)
+            .map(([workerId]) => workerId);
+    }
+    /**
+     * Reset health state for a worker (e.g., after restart)
+     */
+    resetWorkerHealth(workerId) {
+        const state = this.workers.get(workerId);
+        if (state) {
+            state.healthy = true;
+            state.consecutiveFailures = 0;
+            state.lastCheck = undefined;
+            state.lastCheckTime = undefined;
+        }
+    }
+    /**
+     * Clear all registered workers
+     */
+    clear() {
+        this.workers.clear();
+    }
+}
+//# sourceMappingURL=health-monitor.js.map

package/dist/src/worker/health-monitor.js.map

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

package/dist/src/worker/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Worker Module
+ *
+ * Exports the Browser Worker Manager system for managing tenant-bound
+ * Chrome workers with exclusive lease-based access control.
+ */
+export { WorkerManager } from './worker-manager.js';
+export { WorkerError, type WorkerErrorCode } from './errors/index.js';
+export type { WorkerState, LeaseStatus, WorkerDescriptor, LeaseDescriptor, LeaseAcquisitionResult, WorkerManagerConfig, PortRange, HealthCheckResult, CdpVersionInfo, WorkerProcessEvents, HealthMonitorEvents, WorkerManagerEvents, } from './types.js';
+export { DEFAULT_WORKER_CONFIG, CHROME_WORKER_ARGS } from './types.js';
+export { PortAllocator, type PortAllocatorConfig } from './port-allocator.js';
+export { ChromeWorkerProcess, type ChromeWorkerProcessConfig, findChromePath, } from './chrome-worker-process.js';
+export { HealthMonitor, type HealthCheckConfig } from './health-monitor.js';
+export { LeaseManager, type LeaseManagerConfig } from './lease-manager.js';
+export { getMultiTenantConfig, validateMultiTenantConfig, type MultiTenantConfig, } from './multi-tenant-config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/worker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/worker/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGtE,YAAY,EACV,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGvE,OAAO,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EACL,mBAAmB,EACnB,KAAK,yBAAyB,EAC9B,cAAc,GACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG3E,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,KAAK,iBAAiB,GACvB,MAAM,0BAA0B,CAAC"}

package/dist/src/worker/index.js

@@ -0,0 +1,19 @@
+/**
+ * Worker Module
+ *
+ * Exports the Browser Worker Manager system for managing tenant-bound
+ * Chrome workers with exclusive lease-based access control.
+ */
+// Main orchestrator
+export { WorkerManager } from './worker-manager.js';
+// Error handling
+export { WorkerError } from './errors/index.js';
+export { DEFAULT_WORKER_CONFIG, CHROME_WORKER_ARGS } from './types.js';
+// Component classes (for advanced usage/testing)
+export { PortAllocator } from './port-allocator.js';
+export { ChromeWorkerProcess, findChromePath, } from './chrome-worker-process.js';
+export { HealthMonitor } from './health-monitor.js';
+export { LeaseManager } from './lease-manager.js';
+// Multi-tenant configuration
+export { getMultiTenantConfig, validateMultiTenantConfig, } from './multi-tenant-config.js';
+//# sourceMappingURL=index.js.map

package/dist/src/worker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/worker/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oBAAoB;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAwB,MAAM,mBAAmB,CAAC;AAkBtE,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEvE,iDAAiD;AACjD,OAAO,EAAE,aAAa,EAA4B,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EACL,mBAAmB,EAEnB,cAAc,GACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,aAAa,EAA0B,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAA2B,MAAM,oBAAoB,CAAC;AAE3E,6BAA6B;AAC7B,OAAO,EACL,oBAAoB,EACpB,yBAAyB,GAE1B,MAAM,0BAA0B,CAAC"}

package/dist/src/worker/lease-manager.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Lease Manager
+ *
+ * Manages exclusive leases for worker access.
+ * Each tenant can hold at most one lease at a time.
+ */
+import type { LeaseDescriptor, LeaseAcquisitionResult } from './types.js';
+/**
+ * Configuration for LeaseManager
+ */
+export interface LeaseManagerConfig {
+    /** Default lease TTL in milliseconds */
+    defaultTtlMs: number;
+    /** Interval for checking expired leases (ms) */
+    cleanupIntervalMs?: number;
+}
+/**
+ * Manages exclusive leases for tenant workers.
+ *
+ * @example
+ * ```typescript
+ * const leaseManager = new LeaseManager({ defaultTtlMs: 300000 });
+ *
+ * // Acquire a lease
+ * const result = leaseManager.acquire('tenant-a', 'controller-1', 'w-123');
+ * if (result.success) {
+ *   console.log(`Lease acquired: ${result.lease.leaseId}`);
+ * }
+ *
+ * // Refresh the lease before it expires
+ * leaseManager.refresh('tenant-a');
+ *
+ * // Release when done
+ * leaseManager.release('tenant-a');
+ * ```
+ */
+export declare class LeaseManager {
+    private readonly defaultTtlMs;
+    private readonly leases;
+    private cleanupIntervalId;
+    /** Callbacks for lease expiration */
+    private onLeaseExpiredCallbacks;
+    /** Callbacks for lease revocation */
+    private onLeaseRevokedCallbacks;
+    constructor(config: LeaseManagerConfig);
+    /**
+     * Get number of active leases
+     */
+    get leaseCount(): number;
+    /**
+     * Acquire a lease for a tenant
+     *
+     * @param tenantId - Tenant identifier
+     * @param controllerId - Controller/session identifier
+     * @param workerId - Worker to lease
+     * @param ttlMs - Optional custom TTL (uses default if not specified)
+     * @returns Lease acquisition result
+     */
+    acquire(tenantId: string, controllerId: string, workerId: string, ttlMs?: number): LeaseAcquisitionResult;
+    /**
+     * Release a lease
+     *
+     * @param tenantId - Tenant identifier
+     * @param controllerId - Optional controller ID to validate ownership
+     * @returns true if lease was released
+     */
+    release(tenantId: string, controllerId?: string): boolean;
+    /**
+     * Refresh a lease to extend its TTL
+     *
+     * @param tenantId - Tenant identifier
+     * @param ttlMs - Optional new TTL (uses default if not specified)
+     * @returns true if lease was refreshed
+     * @throws WorkerError if lease not found or expired
+     */
+    refresh(tenantId: string, ttlMs?: number): boolean;
+    /**
+     * Revoke a lease (typically on worker crash)
+     *
+     * @param tenantId - Tenant identifier
+     * @param reason - Reason for revocation
+     */
+    revoke(tenantId: string, reason: string): void;
+    /**
+     * Check if a tenant has an active lease
+     */
+    hasLease(tenantId: string): boolean;
+    /**
+     * Get the lease for a tenant (if any)
+     */
+    getLease(tenantId: string): LeaseDescriptor | undefined;
+    /**
+     * Get the lease holder (controller) for a tenant
+     */
+    getLeaseHolder(tenantId: string): string | undefined;
+    /**
+     * Check if a specific controller holds the lease for a tenant
+     */
+    isLeaseHeldBy(tenantId: string, controllerId: string): boolean;
+    /**
+     * Get the worker ID for a tenant's lease
+     */
+    getWorkerIdForTenant(tenantId: string): string | undefined;
+    /**
+     * Register a callback for lease expiration
+     */
+    onLeaseExpired(callback: (lease: LeaseDescriptor) => void): void;
+    /**
+     * Register a callback for lease revocation
+     */
+    onLeaseRevoked(callback: (lease: LeaseDescriptor, reason: string) => void): void;
+    /**
+     * Clean up expired leases
+     */
+    cleanupExpired(): number;
+    /**
+     * Get all active leases
+     */
+    getAllLeases(): LeaseDescriptor[];
+    /**
+     * Clear all leases
+     */
+    clear(): void;
+    /**
+     * Stop the cleanup interval
+     */
+    stop(): void;
+    /**
+     * Internal: refresh lease TTL
+     */
+    private refreshLease;
+    /**
+     * Internal: start cleanup interval
+     */
+    private startCleanupInterval;
+}
+//# sourceMappingURL=lease-manager.d.ts.map

package/dist/src/worker/lease-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease-manager.d.ts","sourceRoot":"","sources":["../../../src/worker/lease-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAM1E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,iBAAiB,CAA+C;IAExE,qCAAqC;IACrC,OAAO,CAAC,uBAAuB,CAA4C;IAC3E,qCAAqC;IACrC,OAAO,CAAC,uBAAuB,CAA4D;gBAE/E,MAAM,EAAE,kBAAkB;IAStC;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;;;;;;;OAQG;IACH,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,sBAAsB;IA+DzB;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO;IA4BzD;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IAoBlD;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IA4B9C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAanC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIvD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKpD;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO;IAW9D;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAQ1D;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI;IAIhE;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIhF;;OAEG;IACH,cAAc,IAAI,MAAM;IAoCxB;;OAEG;IACH,YAAY,IAAI,eAAe,EAAE;IAIjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAQ7B"}