agent-web-interface 4.1.1 → 4.2.0

package/dist/src/worker/errors/worker.error.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Worker Error
+ *
+ * Standardized error classification for worker operations.
+ * Provides error codes for programmatic handling and detailed messages for debugging.
+ */
+/**
+ * Error codes for worker operations
+ */
+export type WorkerErrorCode = 'WORKER_NOT_FOUND' | 'WORKER_NOT_RUNNING' | 'WORKER_CRASHED' | 'WORKER_START_FAILED' | 'WORKER_STOP_FAILED' | 'LEASE_NOT_FOUND' | 'LEASE_NOT_HELD' | 'LEASE_EXPIRED' | 'LEASE_ALREADY_HELD' | 'PORT_EXHAUSTED' | 'MAX_WORKERS_REACHED' | 'HEALTH_CHECK_FAILED' | 'HEALTH_CHECK_TIMEOUT' | 'INVALID_STATE' | 'OPERATION_FAILED';
+/**
+ * Standardized error for worker operations.
+ *
+ * @example
+ * ```typescript
+ * throw new WorkerError(
+ *   'Worker crashed unexpectedly',
+ *   'WORKER_CRASHED',
+ *   { workerId: 'w-123', exitCode: 1 }
+ * );
+ *
+ * // Catching and handling by code
+ * try {
+ *   await workerManager.acquireForTenant('tenant-a', 'controller-1');
+ * } catch (error) {
+ *   if (error instanceof WorkerError) {
+ *     switch (error.code) {
+ *       case 'MAX_WORKERS_REACHED':
+ *         console.log('Worker limit reached, try again later');
+ *         break;
+ *       case 'LEASE_ALREADY_HELD':
+ *         console.log('Another session has the lease');
+ *         break;
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare class WorkerError extends Error {
+    /**
+     * Error code for programmatic handling
+     */
+    readonly code: WorkerErrorCode;
+    /**
+     * Original error that caused this error (if any)
+     */
+    readonly cause?: Error;
+    /**
+     * Additional context for debugging
+     */
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, code: WorkerErrorCode, context?: Record<string, unknown>, cause?: Error);
+    /**
+     * Create a JSON-serializable representation of the error
+     */
+    toJSON(): Record<string, unknown>;
+    /**
+     * Type guard to check if an error is a WorkerError
+     */
+    static isWorkerError(error: unknown): error is WorkerError;
+    /**
+     * Create error for worker not found
+     */
+    static workerNotFound(workerId: string, context?: Record<string, unknown>): WorkerError;
+    /**
+     * Create error for worker not running
+     */
+    static workerNotRunning(workerId: string, currentState: string, context?: Record<string, unknown>): WorkerError;
+    /**
+     * Create error for worker crash
+     */
+    static workerCrashed(workerId: string, exitCode: number | null, signal: string | null, context?: Record<string, unknown>): WorkerError;
+    /**
+     * Create error for worker start failure
+     */
+    static workerStartFailed(workerId: string, cause: Error, context?: Record<string, unknown>): WorkerError;
+    /**
+     * Create error for worker stop failure
+     */
+    static workerStopFailed(workerId: string, cause: Error, context?: Record<string, unknown>): WorkerError;
+    /**
+     * Create error for lease not found
+     */
+    static leaseNotFound(tenantId: string, context?: Record<string, unknown>): WorkerError;
+    /**
+     * Create error for lease not held by controller
+     */
+    static leaseNotHeld(tenantId: string, controllerId: string, actualControllerId: string, context?: Record<string, unknown>): WorkerError;
+    /**
+     * Create error for expired lease
+     */
+    static leaseExpired(tenantId: string, expiredAt: number, context?: Record<string, unknown>): WorkerError;
+    /**
+     * Create error for lease already held
+     */
+    static leaseAlreadyHeld(tenantId: string, heldByControllerId: string, context?: Record<string, unknown>): WorkerError;
+    /**
+     * Create error for port exhaustion
+     */
+    static portExhausted(portMin: number, portMax: number, context?: Record<string, unknown>): WorkerError;
+    /**
+     * Create error for max workers reached
+     */
+    static maxWorkersReached(maxWorkers: number, currentCount: number, context?: Record<string, unknown>): WorkerError;
+    /**
+     * Create error for health check failure
+     */
+    static healthCheckFailed(workerId: string, cause: Error, context?: Record<string, unknown>): WorkerError;
+    /**
+     * Create error for health check timeout
+     */
+    static healthCheckTimeout(workerId: string, timeoutMs: number, context?: Record<string, unknown>): WorkerError;
+    /**
+     * Create error for invalid state transition
+     */
+    static invalidState(currentState: string, attemptedOperation: string, context?: Record<string, unknown>): WorkerError;
+    /**
+     * Create error for generic operation failure
+     */
+    static operationFailed(operation: string, cause: Error, context?: Record<string, unknown>): WorkerError;
+}
+//# sourceMappingURL=worker.error.d.ts.map

package/dist/src/worker/errors/worker.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.error.d.ts","sourceRoot":"","sources":["../../../../src/worker/errors/worker.error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAEvB,kBAAkB,GAClB,oBAAoB,GACpB,gBAAgB,GAChB,qBAAqB,GACrB,oBAAoB,GAEpB,iBAAiB,GACjB,gBAAgB,GAChB,eAAe,GACf,oBAAoB,GAEpB,gBAAgB,GAChB,qBAAqB,GAErB,qBAAqB,GACrB,sBAAsB,GAEtB,eAAe,GACf,kBAAkB,CAAC;AAEvB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGzC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,KAAK,CAAC,EAAE,KAAK;IAcf;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAgBjC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW;IAM1D;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW;IAIvF;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW;IAQd;;OAEG;IACH,MAAM,CAAC,aAAa,CAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW;IAQd;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW;IASd;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW;IASd;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW;IAOtF;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,kBAAkB,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW;IASd;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW;IAQd;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,QAAQ,EAAE,MAAM,EAChB,kBAAkB,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW;IAQd;;OAEG;IACH,MAAM,CAAC,aAAa,CAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW;IAQd;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW;IAQd;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW;IASd;;OAEG;IACH,MAAM,CAAC,kBAAkB,CACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW;IAQd;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,YAAY,EAAE,MAAM,EACpB,kBAAkB,EAAE,MAAM,EAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW;IAQd;;OAEG;IACH,MAAM,CAAC,eAAe,CACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,WAAW;CAQf"}

package/dist/src/worker/errors/worker.error.js

@@ -0,0 +1,199 @@
+/**
+ * Worker Error
+ *
+ * Standardized error classification for worker operations.
+ * Provides error codes for programmatic handling and detailed messages for debugging.
+ */
+/**
+ * Standardized error for worker operations.
+ *
+ * @example
+ * ```typescript
+ * throw new WorkerError(
+ *   'Worker crashed unexpectedly',
+ *   'WORKER_CRASHED',
+ *   { workerId: 'w-123', exitCode: 1 }
+ * );
+ *
+ * // Catching and handling by code
+ * try {
+ *   await workerManager.acquireForTenant('tenant-a', 'controller-1');
+ * } catch (error) {
+ *   if (error instanceof WorkerError) {
+ *     switch (error.code) {
+ *       case 'MAX_WORKERS_REACHED':
+ *         console.log('Worker limit reached, try again later');
+ *         break;
+ *       case 'LEASE_ALREADY_HELD':
+ *         console.log('Another session has the lease');
+ *         break;
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export class WorkerError extends Error {
+    /**
+     * Error code for programmatic handling
+     */
+    code;
+    /**
+     * Original error that caused this error (if any)
+     */
+    cause;
+    /**
+     * Additional context for debugging
+     */
+    context;
+    constructor(message, code, context, cause) {
+        super(message);
+        this.name = 'WorkerError';
+        this.code = code;
+        this.cause = cause;
+        this.context = context;
+        // Maintains proper stack trace for where error was thrown (V8 only)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, WorkerError);
+        }
+    }
+    /**
+     * Create a JSON-serializable representation of the error
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            context: this.context,
+            cause: this.cause
+                ? {
+                    name: this.cause.name,
+                    message: this.cause.message,
+                }
+                : undefined,
+            stack: this.stack,
+        };
+    }
+    /**
+     * Type guard to check if an error is a WorkerError
+     */
+    static isWorkerError(error) {
+        return error instanceof WorkerError;
+    }
+    // ==================== Factory Methods ====================
+    /**
+     * Create error for worker not found
+     */
+    static workerNotFound(workerId, context) {
+        return new WorkerError('Worker not found', 'WORKER_NOT_FOUND', { workerId, ...context });
+    }
+    /**
+     * Create error for worker not running
+     */
+    static workerNotRunning(workerId, currentState, context) {
+        return new WorkerError(`Worker is not running (current state: ${currentState})`, 'WORKER_NOT_RUNNING', { workerId, currentState, ...context });
+    }
+    /**
+     * Create error for worker crash
+     */
+    static workerCrashed(workerId, exitCode, signal, context) {
+        return new WorkerError(`Worker crashed (exit code: ${exitCode}, signal: ${signal})`, 'WORKER_CRASHED', { workerId, exitCode, signal, ...context });
+    }
+    /**
+     * Create error for worker start failure
+     */
+    static workerStartFailed(workerId, cause, context) {
+        return new WorkerError(`Failed to start worker: ${cause.message}`, 'WORKER_START_FAILED', { workerId, ...context }, cause);
+    }
+    /**
+     * Create error for worker stop failure
+     */
+    static workerStopFailed(workerId, cause, context) {
+        return new WorkerError(`Failed to stop worker: ${cause.message}`, 'WORKER_STOP_FAILED', { workerId, ...context }, cause);
+    }
+    /**
+     * Create error for lease not found
+     */
+    static leaseNotFound(tenantId, context) {
+        return new WorkerError('Lease not found for tenant', 'LEASE_NOT_FOUND', {
+            tenantId,
+            ...context,
+        });
+    }
+    /**
+     * Create error for lease not held by controller
+     */
+    static leaseNotHeld(tenantId, controllerId, actualControllerId, context) {
+        return new WorkerError('Lease is held by a different controller', 'LEASE_NOT_HELD', {
+            tenantId,
+            controllerId,
+            actualControllerId,
+            ...context,
+        });
+    }
+    /**
+     * Create error for expired lease
+     */
+    static leaseExpired(tenantId, expiredAt, context) {
+        return new WorkerError('Lease has expired', 'LEASE_EXPIRED', {
+            tenantId,
+            expiredAt,
+            ...context,
+        });
+    }
+    /**
+     * Create error for lease already held
+     */
+    static leaseAlreadyHeld(tenantId, heldByControllerId, context) {
+        return new WorkerError('Lease is already held by another controller', 'LEASE_ALREADY_HELD', {
+            tenantId,
+            heldByControllerId,
+            ...context,
+        });
+    }
+    /**
+     * Create error for port exhaustion
+     */
+    static portExhausted(portMin, portMax, context) {
+        return new WorkerError(`No available ports in range ${portMin}-${portMax}`, 'PORT_EXHAUSTED', {
+            portMin,
+            portMax,
+            ...context,
+        });
+    }
+    /**
+     * Create error for max workers reached
+     */
+    static maxWorkersReached(maxWorkers, currentCount, context) {
+        return new WorkerError(`Maximum worker limit reached (${currentCount}/${maxWorkers})`, 'MAX_WORKERS_REACHED', { maxWorkers, currentCount, ...context });
+    }
+    /**
+     * Create error for health check failure
+     */
+    static healthCheckFailed(workerId, cause, context) {
+        return new WorkerError(`Health check failed: ${cause.message}`, 'HEALTH_CHECK_FAILED', { workerId, ...context }, cause);
+    }
+    /**
+     * Create error for health check timeout
+     */
+    static healthCheckTimeout(workerId, timeoutMs, context) {
+        return new WorkerError(`Health check timed out after ${timeoutMs}ms`, 'HEALTH_CHECK_TIMEOUT', {
+            workerId,
+            timeoutMs,
+            ...context,
+        });
+    }
+    /**
+     * Create error for invalid state transition
+     */
+    static invalidState(currentState, attemptedOperation, context) {
+        return new WorkerError(`Invalid operation "${attemptedOperation}" in state "${currentState}"`, 'INVALID_STATE', { currentState, attemptedOperation, ...context });
+    }
+    /**
+     * Create error for generic operation failure
+     */
+    static operationFailed(operation, cause, context) {
+        return new WorkerError(`Operation failed: ${operation} - ${cause.message}`, 'OPERATION_FAILED', { operation, ...context }, cause);
+    }
+}
+//# sourceMappingURL=worker.error.js.map

package/dist/src/worker/errors/worker.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.error.js","sourceRoot":"","sources":["../../../../src/worker/errors/worker.error.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2BH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC;;OAEG;IACM,IAAI,CAAkB;IAE/B;;OAEG;IACM,KAAK,CAAS;IAEvB;;OAEG;IACM,OAAO,CAA2B;IAE3C,YACE,OAAe,EACf,IAAqB,EACrB,OAAiC,EACjC,KAAa;QAEb,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QAEvB,oEAAoE;QACpE,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACf,CAAC,CAAC;oBACE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;oBACrB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;iBAC5B;gBACH,CAAC,CAAC,SAAS;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAc;QACjC,OAAO,KAAK,YAAY,WAAW,CAAC;IACtC,CAAC;IAED,4DAA4D;IAE5D;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,QAAgB,EAAE,OAAiC;QACvE,OAAO,IAAI,WAAW,CAAC,kBAAkB,EAAE,kBAAkB,EAAE,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,QAAgB,EAChB,YAAoB,EACpB,OAAiC;QAEjC,OAAO,IAAI,WAAW,CACpB,yCAAyC,YAAY,GAAG,EACxD,oBAAoB,EACpB,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,CACvC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAClB,QAAgB,EAChB,QAAuB,EACvB,MAAqB,EACrB,OAAiC;QAEjC,OAAO,IAAI,WAAW,CACpB,8BAA8B,QAAQ,aAAa,MAAM,GAAG,EAC5D,gBAAgB,EAChB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAC3C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,QAAgB,EAChB,KAAY,EACZ,OAAiC;QAEjC,OAAO,IAAI,WAAW,CACpB,2BAA2B,KAAK,CAAC,OAAO,EAAE,EAC1C,qBAAqB,EACrB,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,EACxB,KAAK,CACN,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,QAAgB,EAChB,KAAY,EACZ,OAAiC;QAEjC,OAAO,IAAI,WAAW,CACpB,0BAA0B,KAAK,CAAC,OAAO,EAAE,EACzC,oBAAoB,EACpB,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,EACxB,KAAK,CACN,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,QAAgB,EAAE,OAAiC;QACtE,OAAO,IAAI,WAAW,CAAC,4BAA4B,EAAE,iBAAiB,EAAE;YACtE,QAAQ;YACR,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,QAAgB,EAChB,YAAoB,EACpB,kBAA0B,EAC1B,OAAiC;QAEjC,OAAO,IAAI,WAAW,CAAC,yCAAyC,EAAE,gBAAgB,EAAE;YAClF,QAAQ;YACR,YAAY;YACZ,kBAAkB;YAClB,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,QAAgB,EAChB,SAAiB,EACjB,OAAiC;QAEjC,OAAO,IAAI,WAAW,CAAC,mBAAmB,EAAE,eAAe,EAAE;YAC3D,QAAQ;YACR,SAAS;YACT,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,QAAgB,EAChB,kBAA0B,EAC1B,OAAiC;QAEjC,OAAO,IAAI,WAAW,CAAC,6CAA6C,EAAE,oBAAoB,EAAE;YAC1F,QAAQ;YACR,kBAAkB;YAClB,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAClB,OAAe,EACf,OAAe,EACf,OAAiC;QAEjC,OAAO,IAAI,WAAW,CAAC,+BAA+B,OAAO,IAAI,OAAO,EAAE,EAAE,gBAAgB,EAAE;YAC5F,OAAO;YACP,OAAO;YACP,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,UAAkB,EAClB,YAAoB,EACpB,OAAiC;QAEjC,OAAO,IAAI,WAAW,CACpB,iCAAiC,YAAY,IAAI,UAAU,GAAG,EAC9D,qBAAqB,EACrB,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,CACzC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,QAAgB,EAChB,KAAY,EACZ,OAAiC;QAEjC,OAAO,IAAI,WAAW,CACpB,wBAAwB,KAAK,CAAC,OAAO,EAAE,EACvC,qBAAqB,EACrB,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,EACxB,KAAK,CACN,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,kBAAkB,CACvB,QAAgB,EAChB,SAAiB,EACjB,OAAiC;QAEjC,OAAO,IAAI,WAAW,CAAC,gCAAgC,SAAS,IAAI,EAAE,sBAAsB,EAAE;YAC5F,QAAQ;YACR,SAAS;YACT,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,YAAoB,EACpB,kBAA0B,EAC1B,OAAiC;QAEjC,OAAO,IAAI,WAAW,CACpB,sBAAsB,kBAAkB,eAAe,YAAY,GAAG,EACtE,eAAe,EACf,EAAE,YAAY,EAAE,kBAAkB,EAAE,GAAG,OAAO,EAAE,CACjD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CACpB,SAAiB,EACjB,KAAY,EACZ,OAAiC;QAEjC,OAAO,IAAI,WAAW,CACpB,qBAAqB,SAAS,MAAM,KAAK,CAAC,OAAO,EAAE,EACnD,kBAAkB,EAClB,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,EACzB,KAAK,CACN,CAAC;IACJ,CAAC;CACF"}

package/dist/src/worker/health-monitor.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Health Monitor
+ *
+ * Monitors the health of Chrome workers by periodically checking
+ * their CDP endpoints via /json/version.
+ */
+import { EventEmitter } from 'events';
+import type { HealthCheckResult, HealthMonitorEvents } from './types.js';
+/**
+ * Configuration for health checking
+ */
+export interface HealthCheckConfig {
+    /** Timeout for individual health checks (ms) */
+    timeoutMs?: number;
+    /** Number of consecutive failures before considered unhealthy */
+    failureThreshold?: number;
+}
+/**
+ * Track health state for a worker
+ */
+interface WorkerHealthState {
+    workerId: string;
+    port: number;
+    healthy: boolean;
+    consecutiveFailures: number;
+    lastCheck?: HealthCheckResult;
+    lastCheckTime?: number;
+}
+/**
+ * Type-safe EventEmitter for HealthMonitor
+ */
+interface HealthMonitorEmitter {
+    on<K extends keyof HealthMonitorEvents>(event: K, listener: (data: HealthMonitorEvents[K]) => void): this;
+    once<K extends keyof HealthMonitorEvents>(event: K, listener: (data: HealthMonitorEvents[K]) => void): this;
+    emit<K extends keyof HealthMonitorEvents>(event: K, data: HealthMonitorEvents[K]): boolean;
+    off<K extends keyof HealthMonitorEvents>(event: K, listener: (data: HealthMonitorEvents[K]) => void): this;
+    removeAllListeners<K extends keyof HealthMonitorEvents>(event?: K): this;
+}
+/**
+ * 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 declare class HealthMonitor extends EventEmitter implements HealthMonitorEmitter {
+    private readonly intervalMs;
+    private readonly config;
+    private readonly workers;
+    private intervalId;
+    private _isRunning;
+    constructor(intervalMs?: number, config?: HealthCheckConfig);
+    /**
+     * Check if the monitor is currently running
+     */
+    get isRunning(): boolean;
+    /**
+     * Get the number of registered workers
+     */
+    get workerCount(): number;
+    /**
+     * Register a worker for health monitoring
+     *
+     * @param workerId - Unique worker identifier
+     * @param port - CDP port number
+     */
+    registerWorker(workerId: string, port: number): void;
+    /**
+     * Unregister a worker from health monitoring
+     *
+     * @param workerId - Unique worker identifier
+     * @returns true if the worker was found and removed
+     */
+    unregisterWorker(workerId: string): boolean;
+    /**
+     * Check if a worker is registered
+     */
+    isWorkerRegistered(workerId: string): boolean;
+    /**
+     * Get the current health state of a worker
+     */
+    getWorkerHealth(workerId: string): WorkerHealthState | undefined;
+    /**
+     * Start periodic health monitoring
+     */
+    start(): void;
+    /**
+     * Stop periodic health monitoring
+     */
+    stop(): void;
+    /**
+     * Check health of all registered workers
+     */
+    checkAllWorkers(): Promise<void>;
+    /**
+     * Check health of a specific worker by ID
+     *
+     * @param workerId - Worker identifier
+     * @returns Health check result
+     */
+    checkWorkerById(workerId: string): Promise<HealthCheckResult>;
+    /**
+     * Perform a single health check on a worker
+     */
+    private checkWorker;
+    /**
+     * Perform a health check against the CDP endpoint
+     *
+     * @param port - CDP port number
+     * @returns Health check result
+     */
+    performHealthCheck(port: number): Promise<HealthCheckResult>;
+    /**
+     * Get all unhealthy workers
+     */
+    getUnhealthyWorkers(): string[];
+    /**
+     * Reset health state for a worker (e.g., after restart)
+     */
+    resetWorkerHealth(workerId: string): void;
+    /**
+     * Clear all registered workers
+     */
+    clear(): void;
+}
+export {};
+//# sourceMappingURL=health-monitor.d.ts.map

package/dist/src/worker/health-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-monitor.d.ts","sourceRoot":"","sources":["../../../src/worker/health-monitor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAkB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAKzF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAUD;;GAEG;AACH,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,UAAU,oBAAoB;IAC5B,EAAE,CAAC,CAAC,SAAS,MAAM,mBAAmB,EACpC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC/C,IAAI,CAAC;IACR,IAAI,CAAC,CAAC,SAAS,MAAM,mBAAmB,EACtC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC/C,IAAI,CAAC;IACR,IAAI,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAC3F,GAAG,CAAC,CAAC,SAAS,MAAM,mBAAmB,EACrC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC/C,IAAI,CAAC;IACR,kBAAkB,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;CAC1E;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,aAAc,SAAQ,YAAa,YAAW,oBAAoB;IAC7E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAChE,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,SAAS,EAAE,MAAM,GAAE,iBAAsB;IAM/D;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAgBpD;;;;;OAKG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAQ3C;;OAEG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI7C;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIhE;;OAEG;IACH,KAAK,IAAI,IAAI;IAmBb;;OAEG;IACH,IAAI,IAAI,IAAI;IAcZ;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtC;;;;;OAKG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAYnE;;OAEG;YACW,WAAW;IAsCzB;;;;;OAKG;IACG,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwClE;;OAEG;IACH,mBAAmB,IAAI,MAAM,EAAE;IAM/B;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAUzC;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}