@zintrust/queue-monitor 0.7.0 → 0.7.8

package/dist/QueueMonitoringService.js

@@ -259,6 +259,7 @@ export async function getRecentJobsForQueue(queueName, metrics, driver) {
             name: job.name,
             queue: queueName,
             data: job.data,
+            opts: job.opts,
             attempts: job.attemptsMade,
             status,
             failedReason: job.failedReason || undefined,

package/dist/build-manifest.json

@@ -1,15 +1,15 @@
 {
   "name": "@zintrust/queue-monitor",
-  "version": "0.7.0",
-  "buildDate": "2026-04-17T13:08:39.068Z",
+  "version": "0.7.8",
+  "buildDate": "2026-04-20T12:28:52.322Z",
   "buildEnvironment": {
-    "node": "v22.22.1",
-    "platform": "darwin",
-    "arch": "arm64"
+    "node": "v20.20.2",
+    "platform": "linux",
+    "arch": "x64"
   },
   "git": {
-    "commit": "c6722d91",
-    "branch": "release"
+    "commit": "52d4df96",
+    "branch": "master"
   },
   "package": {
     "engines": {
@@ -37,36 +37,8 @@
       "sha256": "26a91f1b41d8a976a9e8fabaedc3fe6dc955c700499f0afc1a16fb91c9848665"
     },
     "QueueMonitoringService.js": {
-      "size": 8900,
-      "sha256": "0d00a27755a372ce77bb5921ce25fe024d3e57274cd48f963457f76bf5486e4b"
-    },
-    "api/workerClient.d.ts": {
-      "size": 597,
-      "sha256": "1d712bfa9127aa2df4f1fbd0efbb6d84069e1888ed73aca5542a41eee865d4bb"
-    },
-    "api/workerClient.js": {
-      "size": 1629,
-      "sha256": "60f993a42f4a9dd5000b01dae3b0f105a8f4348da8433a735b5cc1929a8f64ce"
-    },
-    "build-manifest.json": {
-      "size": 4134,
-      "sha256": "27d3df03ab7a4e59fcf59d62f077fd5b76a431f930881e3d6e31ea878875fc0e"
-    },
-    "config/queueMonitor.d.ts": {
-      "size": 407,
-      "sha256": "4541f47e64c8ede1bfd8fc0cb7edb76c4e885311b28b1f51c9be7639e5d87eca"
-    },
-    "config/queueMonitor.js": {
-      "size": 689,
-      "sha256": "0b95e6b65d4b6ffdd69788cdfd19e0e76400a39ad69dce018d8827a3b298e419"
-    },
-    "config/workerConfig.d.ts": {
-      "size": 86,
-      "sha256": "b669205d50c8844455a2d9b34a54f48a71118eb6ac99bad5372683ab666f5a22"
-    },
-    "config/workerConfig.js": {
-      "size": 628,
-      "sha256": "ca1c6dbaa751893f0e6b7c8a7fd41a80f7d5e8fc9aaaa4877ca12821bb25f56f"
+      "size": 8928,
+      "sha256": "fc408db720d5883821b169eabce66944295068cd6f2338f1884493c299f0a0f1"
     },
     "connection.d.ts": {
       "size": 107,
@@ -81,40 +53,32 @@
       "sha256": "5140191207b5620500ac5e1edacefed65956a1ad88739695d545ea7d2b405243"
     },
     "dashboard-ui.js": {
-      "size": 54386,
-      "sha256": "9b8d8c41cefbb7a153956c0ed3c29b5fa2c7aa10077b4ca81ae5a99621cfbce1"
+      "size": 54576,
+      "sha256": "b3ee7f13f8fa2fee8204316ac5fe4c9ee0d424131565a58de17061296c7c8e1b"
     },
     "driver.d.ts": {
-      "size": 900,
-      "sha256": "848ea8360e810319c093d8895a61538672cf4932f4abc525cced997ca7fd6732"
+      "size": 1102,
+      "sha256": "70b74e7a0489da3a5545dfd8458ab5b4def1f3733c291a782c033fed0afd0bcf"
     },
     "driver.js": {
-      "size": 4337,
-      "sha256": "7dde8bd310b764f621a4c5d0fb81715b7483ec4819ae2e69143004295735536d"
+      "size": 5165,
+      "sha256": "06a4aa4294ed0694146d184e8b0f1677ebe22a3d90bffa30b7c268657035c760"
     },
     "index.d.ts": {
       "size": 2161,
       "sha256": "2556c136641769f4e7cd81abd6ecae8663433aba74b09bc507b8fba01e3fc6f5"
     },
     "index.js": {
-      "size": 13141,
-      "sha256": "b3f5da1e52773f99526f9789220a8aae77be5c761bd81ecf95e20f8e5db00a5f"
+      "size": 13905,
+      "sha256": "c7ab600099b0b05c81ac97e98668f6649c60c283a82867b8851ab83250d65c2b"
     },
     "metrics.d.ts": {
-      "size": 868,
-      "sha256": "cbae21100c770e0960f4ae8c96bfaa2015162042122e04f00812817f04306512"
+      "size": 910,
+      "sha256": "6467795f6de818a1f295c42755005e394f25b145163c7678d6ac9ac1f9477fea"
     },
     "metrics.js": {
-      "size": 3448,
-      "sha256": "022c97865d37933fd7ed92f47b86b0450056caffd629fce6add51c902529bfe5"
-    },
-    "routes/workers.d.ts": {
-      "size": 477,
-      "sha256": "cfcc3527c47d1a796a3ced2d4777b339dd767f7feb3ecc66c5ce0a91d8ff1bc8"
-    },
-    "routes/workers.js": {
-      "size": 901,
-      "sha256": "1ec48c0becc8c0628b1780fb400e957c5fe50da79f73112436c33ecde7d7d574"
+      "size": 3472,
+      "sha256": "fab0e6d62ed694dcf57904a68b683280e4063c2fdcf97c60fdf5d933ae2b8f4f"
     },
     "worker.d.ts": {
       "size": 332,
@@ -123,14 +87,6 @@
     "worker.js": {
       "size": 1233,
       "sha256": "da26c1b80da7473e1644a4e0f8d814097ce0adff14e36037164f9ae5855e656a"
-    },
-    "workers-ui.d.ts": {
-      "size": 214,
-      "sha256": "4f5fd3bbd077d0dee2cc6c73d2c736fc52119b0d3a5f4a1878a4f3d3d3edf299"
-    },
-    "workers-ui.js": {
-      "size": 24928,
-      "sha256": "ba2c5cbf890fe875cc5336c76bd29b146089bc8ba3a70de4a2c383f395f9be73"
     }
   }
 }

package/dist/dashboard-ui.js

@@ -983,9 +983,12 @@ const getRetryJobFunction = () => `
                 const res = await fetch(API_BASE + '/api/retry/' + queueName + '/' + jobId, {
                     method: 'POST'
                 });
+                const payload = await res.json().catch(() => null);
 
                 if (res.ok) {
-                    btn.textContent = '✓ Retried';
+                    btn.textContent = payload && payload.status === 'requeued_from_snapshot'
+                        ? '✓ Requeued'
+                        : '✓ Retried';
                     setTimeout(() => {
                         console.log('HTTP jobs polling disabled - using SSE only');
                         // fetchJobs(currentQueue);

package/dist/driver.d.ts

@@ -2,9 +2,18 @@ import type { Job, JobsOptions } from 'bullmq';
 import { type RedisConfig } from './connection';
 export type JobPayload<T = unknown> = T;
 export type JobCounts = Record<string, number>;
+export type RetrySnapshot = {
+    name?: string;
+    data: unknown;
+    opts?: JobsOptions;
+};
 export type RetryJobResult = {
     ok: true;
     status: 'retried';
+} | {
+    ok: true;
+    status: 'requeued_from_snapshot';
+    newJobId?: string;
 } | {
     ok: false;
     status: 'missing';
@@ -18,7 +27,7 @@ export type QueueDriver = {
     getJob(queueName: string, jobId: string): Promise<Job | undefined>;
     getJobCounts(queueName: string): Promise<JobCounts>;
     getRecentJobs(queueName: string, limit?: number): Promise<Job[]>;
-    retryJob(queueName: string, jobId: string): Promise<RetryJobResult>;
+    retryJob(queueName: string, jobId: string, snapshot?: RetrySnapshot): Promise<RetryJobResult>;
     getQueues(): Promise<string[]>;
     close(): Promise<void>;
 };

package/dist/driver.js

@@ -41,6 +41,7 @@ async function discoverQueuesFromRedis(redis, inMemoryQueues) {
     }
     return Array.from(found.values());
 }
+// eslint-disable-next-line max-lines-per-function
 export const createBullMQDriver = (config) => {
     const queues = new Map();
     const redis = createRedisConnection(config, 3, { subsystem: 'queue-monitor' });
@@ -77,6 +78,23 @@ export const createBullMQDriver = (config) => {
         const queue = getQueue(queueName);
         return queue.getJobCounts();
     };
+    const requeueFromSnapshot = async (queue, snapshot) => {
+        try {
+            const requeued = await queue.add(snapshot.name ?? 'default', snapshot.data, snapshot.opts);
+            return {
+                ok: true,
+                status: 'requeued_from_snapshot',
+                newJobId: requeued.id === undefined || requeued.id === null ? undefined : String(requeued.id),
+            };
+        }
+        catch (error) {
+            return {
+                ok: false,
+                status: 'not_retryable',
+                reason: error instanceof Error ? error.message : String(error),
+            };
+        }
+    };
     const getRecentJobs = async (queueName, limit = 100) => {
         const queue = getQueue(queueName);
         const jobs = await queue.getJobs(['completed', 'failed', 'active', 'waiting', 'delayed', 'paused'], 0, Math.max(0, limit - 1), true);
@@ -84,9 +102,12 @@ export const createBullMQDriver = (config) => {
         await enrichJobsWithState(jobs);
         return jobs;
     };
-    const retryJob = async (queueName, jobId) => {
+    const retryJob = async (queueName, jobId, snapshot) => {
+        const queue = getQueue(queueName);
         const job = await getJob(queueName, jobId);
         if (!job) {
+            if (snapshot)
+                return requeueFromSnapshot(queue, snapshot);
             return { ok: false, status: 'missing' };
         }
         try {

package/dist/index.js

@@ -168,16 +168,34 @@ async function handleJobsEndpoint(req, res, metrics, driver) {
     const jobs = await getRecentJobsForSelection(queueName, metrics, driver);
     res.json(jobs);
 }
-async function handleRetryEndpoint(req, res, driver) {
+async function handleRetryEndpoint(req, res, driver, metrics) {
     const queueName = extractQueueParam(req);
     const jobId = typeof req.getParam === 'function' ? req.getParam?.('jobId') : req.params?.['jobId'];
     if (!queueName || !jobId) {
         res.status(400).json(fieldError('queue_name,job_id', 'Queue name and job ID must be provided'));
         return;
     }
-    const result = await driver.retryJob(queueName, jobId);
+    const recentJobs = await getRecentJobsForSelection(queueName, metrics, driver);
+    const snapshotCandidate = recentJobs.find((job) => String(job.id) === jobId);
+    const retrySnapshot = snapshotCandidate === undefined
+        ? undefined
+        : {
+            name: snapshotCandidate.name,
+            data: snapshotCandidate.data,
+            opts: snapshotCandidate.opts,
+        };
+    const result = await driver.retryJob(queueName, jobId, retrySnapshot);
     if (result.ok) {
-        res.json({ ok: true, status: result.status, message: `Job ${jobId} queued for retry` });
+        res.json({
+            ok: true,
+            status: result.status,
+            message: result.status === 'requeued_from_snapshot'
+                ? `Job ${jobId} re-queued from monitor snapshot`
+                : `Job ${jobId} queued for retry`,
+            ...(result.status === 'requeued_from_snapshot' && result.newJobId
+                ? { newJobId: result.newJobId }
+                : {}),
+        });
         return;
     }
     if (result.status === 'missing') {
@@ -246,7 +264,7 @@ function registerApiRoutes(router, settings, routeOptions, metrics, driver, getS
     registerSnapshotApi(router, settings, routeOptions, getSnapshot);
     registerJobsApi(router, settings, routeOptions, metrics, driver);
     registerLocksApi(router, settings, routeOptions, getLocks);
-    registerRetryApi(router, settings, routeOptions, driver);
+    registerRetryApi(router, settings, routeOptions, driver, metrics);
     registerEventsApi(router, settings, routeOptions, getSnapshot, getLocks, metrics, driver);
 }
 function registerSnapshotApi(router, settings, routeOptions, getSnapshot) {
@@ -270,9 +288,9 @@ function registerLocksApi(router, settings, routeOptions, getLocks) {
         res.json(locks);
     }, routeOptions);
 }
-function registerRetryApi(router, settings, routeOptions, driver) {
+function registerRetryApi(router, settings, routeOptions, driver, metrics) {
     Router.post(router, `${settings.basePath}/api/retry/:queue/:jobId`, async (req, res) => {
-        await handleRetryEndpoint(req, res, driver);
+        await handleRetryEndpoint(req, res, driver, metrics);
     }, routeOptions);
 }
 function registerEventsApi(router, settings, routeOptions, getSnapshot, getLocks, metrics, driver) {

package/dist/metrics.d.ts

@@ -1,4 +1,4 @@
-import { type Job } from 'bullmq';
+import { type Job, type JobsOptions } from 'bullmq';
 import { type RedisConfig } from './connection';
 export type JobStatus = 'completed' | 'failed';
 export type JobSummary = {
@@ -6,6 +6,7 @@ export type JobSummary = {
     name: string;
     queue?: string;
     data: unknown;
+    opts?: JobsOptions;
     attempts: number;
     status?: string;
     failedReason?: string;

package/dist/metrics.js

@@ -19,6 +19,7 @@ const recordJobImpl = async (redis, queue, status, job, error) => {
         id: job.id,
         name: job.name,
         data: job.data,
+        opts: job.opts,
         attempts: job.attemptsMade,
         failedReason: job.failedReason || error?.message,
         timestamp: Date.now(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/queue-monitor",
-  "version": "0.7.0",
+  "version": "0.7.8",
   "description": "Queue monitoring package for ZinTrust with BullMQ and Redis.",
   "private": false,
   "type": "module",
@@ -20,7 +20,7 @@
     "node": ">=20.0.0"
   },
   "peerDependencies": {
-    "@zintrust/core": "^0.7.0"
+    "@zintrust/core": "^0.7.8"
   },
   "publishConfig": {
     "access": "public"

package/dist/api/workerClient.d.ts

@@ -1,20 +0,0 @@
-type WorkerApiResponse<T> = {
-    ok: boolean;
-    error?: string;
-} & T;
-export declare const WorkerClient: Readonly<{
-    listWorkers(): Promise<string[]>;
-    getWorker(name: string): Promise<unknown>;
-    getStatus(name: string): Promise<unknown>;
-    getHealth(name: string): Promise<unknown>;
-    startWorker(name: string): Promise<WorkerApiResponse<{
-        message?: string;
-    }>>;
-    stopWorker(name: string): Promise<WorkerApiResponse<{
-        message?: string;
-    }>>;
-    restartWorker(name: string): Promise<WorkerApiResponse<{
-        message?: string;
-    }>>;
-}>;
-export {};

package/dist/api/workerClient.js

@@ -1,45 +0,0 @@
-import { ErrorFactory, Logger } from '@zintrust/core';
-import { WorkerConfig } from '../config/workerConfig.js';
-const requestJson = async (path, options = {}) => {
-    const baseUrl = WorkerConfig.getWorkerBaseUrl();
-    const url = `${baseUrl}${path}`;
-    const response = await fetch(url, {
-        ...options,
-        headers: {
-            'Content-Type': 'application/json',
-            ...options.headers,
-        },
-    });
-    if (!response.ok) {
-        Logger.error('Worker API request failed', { url, status: response.status });
-        throw ErrorFactory.createWorkerError(`Worker API request failed (${response.status})`);
-    }
-    return (await response.json());
-};
-export const WorkerClient = Object.freeze({
-    async listWorkers() {
-        const response = await requestJson('/api/workers');
-        return response.workers ?? [];
-    },
-    async getWorker(name) {
-        const response = await requestJson(`/api/workers/${name}`);
-        return response.worker;
-    },
-    async getStatus(name) {
-        const response = await requestJson(`/api/workers/${name}/status`);
-        return response.status;
-    },
-    async getHealth(name) {
-        const response = await requestJson(`/api/workers/${name}/health`);
-        return response.health;
-    },
-    async startWorker(name) {
-        return requestJson(`/api/workers/${name}/start`, { method: 'POST' });
-    },
-    async stopWorker(name) {
-        return requestJson(`/api/workers/${name}/stop`, { method: 'POST' });
-    },
-    async restartWorker(name) {
-        return requestJson(`/api/workers/${name}/restart`, { method: 'POST' });
-    },
-});

package/dist/config/queueMonitor.d.ts

@@ -1,18 +0,0 @@
-/**
- * Queue Monitor Configuration (default override)
- *
- * Keep this file declarative:
- * - Core owns env parsing/default logic.
- * - Projects can override config by editing values below.
- */
-declare const _default: {
-    enabled: boolean;
-    basePath: string;
-    middleware: string[];
-    redis: {
-        host: string;
-        port: number;
-        password: string;
-    };
-};
-export default _default;

package/dist/config/queueMonitor.js

@@ -1,21 +0,0 @@
-import { Env } from '@zintrust/core';
-/**
- * Queue Monitor Configuration (default override)
- *
- * Keep this file declarative:
- * - Core owns env parsing/default logic.
- * - Projects can override config by editing values below.
- */
-export default {
-    enabled: Env.getBool('QUEUE_MONITOR_ENABLED', true),
-    basePath: Env.get('QUEUE_MONITOR_BASE_PATH', '/queue-monitor'),
-    middleware: Env.get('QUEUE_MONITOR_MIDDLEWARE', 'auth')
-        .split(',')
-        .map((m) => m.trim())
-        .filter((m) => m.length > 0),
-    redis: {
-        host: Env.get('REDIS_HOST', 'localhost'),
-        port: Env.getInt('REDIS_PORT', 6379),
-        password: Env.get('REDIS_PASSWORD', ''),
-    },
-};

package/dist/config/workerConfig.d.ts

@@ -1,3 +0,0 @@
-export declare const WorkerConfig: Readonly<{
-    getWorkerBaseUrl: () => string;
-}>;

package/dist/config/workerConfig.js

@@ -1,19 +0,0 @@
-import { Env } from '@zintrust/core';
-const normalizeBaseUrl = (value) => {
-    let end = value.length;
-    while (end > 0 && value.charAt(end - 1) === '/') {
-        end--;
-    }
-    return value.slice(0, end);
-};
-const withHttpScheme = (value) => value.startsWith('http://') || value.startsWith('https://') ? value : `http://${value}`;
-const resolveWorkerApiUrl = () => {
-    const workerApiUrl = Env.get('WORKER_API_URL');
-    if (workerApiUrl) {
-        return normalizeBaseUrl(withHttpScheme(workerApiUrl));
-    }
-    return '';
-};
-export const WorkerConfig = Object.freeze({
-    getWorkerBaseUrl: resolveWorkerApiUrl,
-});

package/dist/routes/workers.d.ts

@@ -1,10 +0,0 @@
-import { type IRouter } from '@zintrust/core';
-import { type WorkerUiOptions } from '../workers-ui';
-type RouteOptions = {
-    middleware?: ReadonlyArray<string>;
-} | undefined;
-export declare const registerWorkerUiRoutes: (router: IRouter, options: WorkerUiOptions, routeOptions: RouteOptions) => void;
-declare const _default: Readonly<{
-    registerWorkerUiRoutes: (router: IRouter, options: WorkerUiOptions, routeOptions: RouteOptions) => void;
-}>;
-export default _default;

package/dist/routes/workers.js

@@ -1,20 +0,0 @@
-import { Router } from '@zintrust/core';
-import { WorkerConfig } from '../config/workerConfig.js';
-import { getWorkersHtml } from '../workers-ui.js';
-const registerWorkerUiPage = (router, options, routeOptions) => {
-    const handler = (_req, res) => {
-        res.html(getWorkersHtml({
-            basePath: options.basePath,
-            apiBaseUrl: WorkerConfig.getWorkerBaseUrl(),
-            autoRefresh: options.autoRefresh,
-            refreshIntervalMs: options.refreshIntervalMs,
-        }));
-    };
-    Router.get(router, `${options.basePath}/workers`, handler, routeOptions);
-    Router.get(router, '/workers', handler, routeOptions);
-    Router.get(router, '/workers/', handler, routeOptions);
-};
-export const registerWorkerUiRoutes = (router, options, routeOptions) => {
-    registerWorkerUiPage(router, options, routeOptions);
-};
-export default Object.freeze({ registerWorkerUiRoutes });

package/dist/workers-ui.d.ts

@@ -1,7 +0,0 @@
-export type WorkerUiOptions = {
-    basePath: string;
-    apiBaseUrl?: string;
-    autoRefresh: boolean;
-    refreshIntervalMs: number;
-};
-export declare const getWorkersHtml: (options: WorkerUiOptions) => string;

package/dist/workers-ui.js

@@ -1,655 +0,0 @@
-const getBaseStyles = () => `
-  body {
-    margin: 0;
-    font-family: 'Inter', ui-sans-serif, system-ui;
-    background: #0b1220;
-    color: #f1f5f9;
-  }
-  .hidden { display: none; }
-`;
-const getLayoutStyles = () => `
-  .zt-page { min-height: 100vh; padding: 32px 24px; }
-  .zt-container { max-width: 72rem; margin: 0 auto; display: flex; flex-direction: column; gap: 24px; }
-  .zt-header { display: flex; flex-direction: column; gap: 16px; }
-  .zt-brand { display: flex; align-items: center; gap: 16px; }
-  .zt-brand-icon { height: 48px; width: 48px; border-radius: 16px; border: 1px solid #1e293b; background: rgba(15, 23, 42, 0.8); display: flex; align-items: center; justify-content: center; }
-  .zt-kicker { font-size: 0.75rem; text-transform: uppercase; letter-spacing: 0.2em; color: #94a3b8; }
-  .zt-title { font-size: 1.5rem; font-weight: 600; color: #f8fafc; margin: 0; }
-  .zt-subtitle { font-size: 0.875rem; color: #94a3b8; margin: 0.25rem 0 0; }
-  .zt-actions { display: flex; flex-wrap: wrap; align-items: center; gap: 12px; }
-  .zt-nav { display: flex; flex-wrap: wrap; gap: 8px; }
-  .zt-nav-link {
-    border: 1px solid #1e293b;
-    color: #e2e8f0;
-    text-decoration: none;
-    padding: 0.4rem 0.75rem;
-    border-radius: 0.6rem;
-    font-size: 0.75rem;
-    font-weight: 600;
-    transition: border-color 0.2s ease, color 0.2s ease;
-  }
-  .zt-nav-link:hover { border-color: #38bdf8; color: #38bdf8; }
-  .zt-grid { display: grid; gap: 16px; }
-  .zt-grid-3 { grid-template-columns: repeat(1, minmax(0, 1fr)); }
-`;
-const getCardStyles = () => `
-  .zt-card { background: rgba(15, 23, 42, 0.75); border: 1px solid rgba(148, 163, 184, 0.2); border-radius: 1rem; padding: 1.25rem; }
-  .zt-card-title { font-size: 0.75rem; text-transform: uppercase; letter-spacing: 0.2em; color: #94a3b8; }
-  .zt-card-value { margin-top: 0.75rem; font-size: 1.875rem; font-weight: 600; }
-  .zt-text-emerald { color: #6ee7b7; }
-  .zt-text-amber { color: #fbbf24; }
-`;
-const getAlertStyles = () => `
-  .zt-alert {
-    border: 1px solid rgba(239, 68, 68, 0.3);
-    background: rgba(239, 68, 68, 0.1);
-    color: #fecaca;
-    padding: 0.75rem 1rem;
-    border-radius: 1rem;
-    font-size: 0.875rem;
-  }
-`;
-const getButtonStyles = () => `
-  .zt-button {
-    border: 1px solid #1e293b;
-    background: #0f172a;
-    color: #f1f5f9;
-    padding: 0.5rem 1rem;
-    border-radius: 0.75rem;
-    font-size: 0.875rem;
-    font-weight: 600;
-    cursor: pointer;
-    transition: border-color 0.2s ease, color 0.2s ease;
-  }
-  .zt-button:hover { border-color: #38bdf8; color: #38bdf8; }
-  .zt-select {
-    border: 1px solid #1e293b;
-    background: #0f172a;
-    color: #f1f5f9;
-    padding: 0.5rem 0.75rem;
-    border-radius: 0.75rem;
-    font-size: 0.75rem;
-    font-weight: 600;
-  }
-`;
-const getTableStyles = () => `
-  .zt-table-card { border-radius: 1.5rem; padding: 1.5rem; }
-  .zt-table-header { display: flex; flex-direction: column; gap: 12px; }
-  .zt-table-meta { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; font-size: 0.75rem; color: #94a3b8; }
-  .zt-table-wrap { margin-top: 1.5rem; overflow-x: auto; }
-  .zt-table { width: 100%; border-collapse: collapse; font-size: 0.875rem; }
-  .zt-head-cell { font-size: 0.75rem; text-transform: uppercase; letter-spacing: 0.08em; color: #94a3b8; padding: 0.5rem 0.75rem; text-align: left; }
-  .zt-cell { padding: 0.75rem; border-top: 1px solid #1f2937; }
-  .zt-cell--strong { font-weight: 600; color: #f1f5f9; }
-  .zt-cell--muted { color: #94a3b8; }
-  .zt-cell--right { text-align: right; }
-  .zt-empty { padding: 1.5rem 0.75rem; text-align: center; font-size: 0.875rem; color: #94a3b8; }
-`;
-const getBadgeStyles = () => `
-  .zt-dot { display: inline-block; width: 0.5rem; height: 0.5rem; border-radius: 999px; }
-  .zt-dot--emerald { background: #34d399; }
-  .zt-dot--amber { background: #fbbf24; }
-  .zt-dot--rose { background: #fb7185; }
-  .zt-badge { display: inline-flex; align-items: center; border-radius: 999px; padding: 0.125rem 0.625rem; font-size: 0.75rem; font-weight: 600; border: 1px solid transparent; }
-  .zt-badge--success { background: rgba(16, 185, 129, 0.12); color: #6ee7b7; border-color: rgba(16, 185, 129, 0.3); }
-  .zt-badge--warn { background: rgba(245, 158, 11, 0.12); color: #fbbf24; border-color: rgba(245, 158, 11, 0.3); }
-  .zt-badge--danger { background: rgba(244, 63, 94, 0.12); color: #fda4af; border-color: rgba(244, 63, 94, 0.3); }
-  .zt-badge--neutral { background: rgba(148, 163, 184, 0.12); color: #cbd5f5; border-color: rgba(148, 163, 184, 0.3); }
-  .status-pill { border-radius: 999px; padding: 0.125rem 0.625rem; font-size: 0.75rem; font-weight: 600; }
-`;
-const getActionStyles = () => `
-  .zt-row-actions { display: flex; flex-wrap: wrap; justify-content: flex-end; gap: 0.5rem; }
-  .action-btn {
-    border: 1px solid #1e293b;
-    background: transparent;
-    color: #e2e8f0;
-    padding: 0.25rem 0.75rem;
-    border-radius: 0.5rem;
-    font-size: 0.75rem;
-    font-weight: 600;
-    cursor: pointer;
-    transition: border-color 0.2s ease, color 0.2s ease;
-  }
-  .action-btn.is-disabled {
-    opacity: 0.45;
-    cursor: not-allowed;
-    border-color: #1f2937;
-    color: #64748b;
-  }
-  .action-btn.is-disabled:hover { border-color: #1f2937; color: #64748b; }
-  .action-btn.is-active {
-    border-color: rgba(16, 185, 129, 0.6);
-    color: #6ee7b7;
-  }
-  .action-btn.is-toggle {
-    border-color: rgba(56, 189, 248, 0.4);
-    color: #bae6fd;
-  }
-  .action-btn.is-delete {
-    border-color: rgba(244, 63, 94, 0.5);
-    color: #fda4af;
-  }
-  .action-btn.is-delete:hover { border-color: #fb7185; color: #fb7185; }
-  .zt-toggle {
-    display: inline-flex;
-    align-items: center;
-    gap: 0.4rem;
-    font-size: 0.7rem;
-    font-weight: 600;
-    color: #cbd5f5;
-  }
-  .zt-switch {
-    appearance: none;
-    width: 2.25rem;
-    height: 1.2rem;
-    border-radius: 999px;
-    border: 1px solid rgba(148, 163, 184, 0.4);
-    background: rgba(239, 68, 68, 0.2);
-    position: relative;
-    cursor: pointer;
-    transition: background 0.2s ease, border-color 0.2s ease;
-  }
-  .zt-switch::after {
-    content: '';
-    position: absolute;
-    top: 1px;
-    left: 1px;
-    width: 0.95rem;
-    height: 0.95rem;
-    border-radius: 999px;
-    background: #f8fafc;
-    transition: transform 0.2s ease;
-  }
-  .zt-switch:checked {
-    background: rgba(16, 185, 129, 0.25);
-    border-color: rgba(16, 185, 129, 0.5);
-  }
-  .zt-switch:checked::after {
-    transform: translateX(1rem);
-  }
-  .action-btn:hover { border-color: #38bdf8; color: #38bdf8; }
-  .action-btn[data-action="start"]:hover { border-color: #34d399; color: #34d399; }
-  .action-btn[data-action="restart"]:hover { border-color: #fbbf24; color: #fbbf24; }
-  .action-btn[data-action="stop"]:hover { border-color: #fb7185; color: #fb7185; }
-`;
-const getResponsiveStyles = () => `
-  @media (min-width: 640px) {
-    .zt-header { flex-direction: row; align-items: center; justify-content: space-between; }
-    .zt-table-header { flex-direction: row; align-items: center; justify-content: space-between; }
-  }
-  @media (min-width: 768px) {
-    .zt-grid-3 { grid-template-columns: repeat(3, minmax(0, 1fr)); }
-  }
-`;
-const getInlineStyles = () => `
-<style>
-${getBaseStyles()}
-${getLayoutStyles()}
-${getCardStyles()}
-${getAlertStyles()}
-${getButtonStyles()}
-${getTableStyles()}
-${getBadgeStyles()}
-${getActionStyles()}
-${getResponsiveStyles()}
-</style>`;
-const getLogo = () => `
-<svg width="28" height="28" viewBox="0 0 100 100" fill="none" xmlns="http://www.w3.org/2000/svg">
-  <defs>
-    <linearGradient id="zt-workers" x1="10" y1="50" x2="90" y2="50" gradientUnits="userSpaceOnUse">
-      <stop stop-color="#22c55e" />
-      <stop offset="1" stop-color="#38bdf8" />
-    </linearGradient>
-  </defs>
-  <circle cx="50" cy="50" r="34" stroke="rgba(255,255,255,0.16)" stroke-width="4" />
-  <ellipse cx="50" cy="50" rx="40" ry="18" stroke="url(#zt-workers)" stroke-width="4" />
-  <ellipse cx="50" cy="50" rx="18" ry="40" stroke="url(#zt-workers)" stroke-width="4" opacity="0.75" />
-  <circle cx="50" cy="50" r="6" fill="url(#zt-workers)" />
-  <path d="M40 52C35 52 32 49 32 44C32 39 35 36 40 36H48" stroke="white" stroke-width="6" stroke-linecap="round" />
-  <path d="M60 48C65 48 68 51 68 56C68 61 65 64 60 64H52" stroke="white" stroke-width="6" stroke-linecap="round" />
-  <path d="M44 50H56" stroke="rgba(255,255,255,0.22)" stroke-width="6" stroke-linecap="round" />
-</svg>`;
-const normalizeBasePath = (value) => {
-    let basePath = value;
-    while (basePath.endsWith('/')) {
-        basePath = basePath.slice(0, -1);
-    }
-    return basePath;
-};
-const getWorkersHead = () => `
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>ZinTrust Workers</title>
-    ${getInlineStyles()}
-  </head>`;
-const getWorkersHeader = () => `
-        <header class="zt-header">
-          <div class="zt-brand">
-            <div class="zt-brand-icon">
-              ${getLogo()}
-            </div>
-            <div>
-              <p class="zt-kicker">ZinTrust</p>
-              <h1 class="zt-title">Worker Command Center</h1>
-              <p class="zt-subtitle">Live control plane for worker orchestration</p>
-            </div>
-          </div>
-          <div class="zt-actions">
-            <span id="last-updated" class="zt-kicker"></span>
-            <select id="storage-select" class="zt-select" aria-label="Worker storage">
-              <option value="memory">Memory</option>
-              <option value="redis">Redis</option>
-              <option value="db">Database</option>
-            </select>
-            <nav class="zt-nav">
-              <a class="zt-nav-link" href="/queue-monitor/">Queue monitor</a>
-              <a class="zt-nav-link" href="/workers">Workers</a>
-              <a class="zt-nav-link" href="/telemetry">Telemetry</a>
-              <a class="zt-nav-link" href="/metrics">Metrics</a>
-            </nav>
-            <button id="refresh-btn" class="zt-button">Refresh</button>
-            <button id="auto-refresh-btn" class="zt-button">Pause auto refresh</button>
-          </div>
-        </header>`;
-const getWorkersStats = () => `
-        <section class="zt-grid zt-grid-3">
-          <div class="zt-card">
-            <p class="zt-card-title">Total Workers</p>
-            <p id="total-workers" class="zt-card-value">0</p>
-          </div>
-          <div class="zt-card">
-            <p class="zt-card-title">Active</p>
-            <p id="active-workers" class="zt-card-value zt-text-emerald">0</p>
-          </div>
-          <div class="zt-card">
-            <p class="zt-card-title">Attention Needed</p>
-            <p id="attention-workers" class="zt-card-value zt-text-amber">0</p>
-          </div>
-        </section>`;
-const getWorkersTable = () => `
-        <section class="zt-card zt-table-card">
-          <div class="zt-table-header">
-            <div>
-              <h2 class="zt-title" style="font-size: 1.125rem;">Workers</h2>
-              <p class="zt-subtitle">Start, stop, and monitor health across the fleet.</p>
-            </div>
-            <div class="zt-table-meta">
-              <span class="zt-dot zt-dot--emerald"></span> Healthy
-              <span class="zt-dot zt-dot--amber" style="margin-left: 0.75rem;"></span> Degraded
-              <span class="zt-dot zt-dot--rose" style="margin-left: 0.75rem;"></span> Critical
-            </div>
-          </div>
-          <div class="zt-table-wrap">
-            <table class="zt-table">
-              <thead>
-                <tr>
-                  <th class="zt-head-cell">Worker</th>
-                  <th class="zt-head-cell">Status</th>
-                  <th class="zt-head-cell">Health</th>
-                  <th class="zt-head-cell">Version</th>
-                  <th class="zt-head-cell zt-cell--right">Actions</th>
-                </tr>
-              </thead>
-              <tbody id="workers-body"></tbody>
-            </table>
-          </div>
-        </section>`;
-const getWorkersBody = () => `
-    <div class="zt-page">
-      <div class="zt-container">
-${getWorkersHeader()}
-
-        <section id="error" class="hidden zt-alert"></section>
-
-${getWorkersStats()}
-
-${getWorkersTable()}
-      </div>
-    </div>`;
-const getWorkersScriptState = (options, apiBaseUrl) => `
-      const RAW_API_BASE = '${apiBaseUrl}';
-      const API_BASE = RAW_API_BASE
-        ? (RAW_API_BASE.startsWith('/') ? window.location.origin + RAW_API_BASE : RAW_API_BASE)
-  : window.location.origin;
-      const STORAGE_KEYS = {
-        autoRefresh: 'zintrust.workers.autoRefresh',
-        storageMode: 'zintrust.workers.storageMode',
-      };
-      const AUTO_REFRESH = ${options.autoRefresh ? 'true' : 'false'};
-      const REFRESH_INTERVAL = ${Math.max(1000, Math.floor(options.refreshIntervalMs))};
-
-      const errorEl = document.getElementById('error');
-      const totalEl = document.getElementById('total-workers');
-      const activeEl = document.getElementById('active-workers');
-      const attentionEl = document.getElementById('attention-workers');
-      const bodyEl = document.getElementById('workers-body');
-      const refreshBtn = document.getElementById('refresh-btn');
-      const autoBtn = document.getElementById('auto-refresh-btn');
-      const lastUpdated = document.getElementById('last-updated');
-      const storageSelect = document.getElementById('storage-select');
-
-      let autoRefresh = AUTO_REFRESH;
-      let storageMode = 'memory';
-      let autoTimer = null;
-`;
-const getWorkersScriptStorage = () => `
-      const readStorage = (key) => {
-        try {
-          return localStorage.getItem(key);
-        } catch (error) {
-          return null;
-        }
-      };
-
-      const writeStorage = (key, value) => {
-        try {
-          localStorage.setItem(key, value);
-        } catch (error) {
-          return;
-        }
-      };
-
-      const setAutoLabel = () => {
-        autoBtn.textContent = autoRefresh ? 'Pause auto refresh' : 'Resume auto refresh';
-      };
-
-      const setStorageValue = (value) => {
-        storageMode = value || 'memory';
-        if (storageSelect) {
-          storageSelect.value = storageMode;
-        }
-      };
-`;
-const getWorkersScriptError = () => `
-      const setError = (message) => {
-        if (!message) {
-          errorEl.classList.add('hidden');
-          errorEl.textContent = '';
-          return;
-        }
-        errorEl.classList.remove('hidden');
-        errorEl.textContent = message;
-      };
-`;
-const getWorkersScriptBadges = () => `
-      const statusBadge = (label, tone) => {
-        const tones = {
-          success: 'zt-badge--success',
-          warn: 'zt-badge--warn',
-          danger: 'zt-badge--danger',
-          neutral: 'zt-badge--neutral',
-        };
-        return '<span class="zt-badge ' + (tones[tone] || tones.neutral) + '">' + label + '</span>';
-      };
-`;
-const getWorkersScriptTone = () => `
-      const toStatusTone = (status) => {
-        if (!status) return { label: 'unknown', tone: 'neutral' };
-        const normalized = String(status).toLowerCase();
-        if (['running', 'active'].includes(normalized)) return { label: normalized, tone: 'success' };
-        if (['stopped', 'stopping', 'sleeping', 'paused'].includes(normalized)) return { label: normalized, tone: 'neutral' };
-        if (['starting', 'draining'].includes(normalized)) return { label: normalized, tone: 'warn' };
-        return { label: normalized, tone: 'danger' };
-      };
-
-      const toHealthTone = (health) => {
-        if (!health) return { label: 'unknown', tone: 'neutral' };
-        const normalized = String(health).toLowerCase();
-        if (['healthy', 'green'].includes(normalized)) return { label: normalized, tone: 'success' };
-        if (['degraded', 'yellow'].includes(normalized)) return { label: normalized, tone: 'warn' };
-        if (['critical', 'unhealthy', 'red'].includes(normalized)) return { label: normalized, tone: 'danger' };
-        return { label: normalized, tone: 'neutral' };
-      };
-`;
-const getWorkersScriptRenderRowTemplate = () => `
-      const renderWorkerRow = (worker) => {
-        const resolvedName =
-          worker.name || worker.workerName || worker.worker?.name || worker.status?.name || '';
-        const statusValue =
-          worker.status?.status ||
-          worker.status?.state ||
-          worker.status ||
-          worker.worker?.status ||
-          'unknown';
-        const statusInfo = toStatusTone(statusValue);
-        const healthInfo = toHealthTone(worker.health?.status || worker.health);
-        const version =
-          worker.version ||
-          worker.status?.version ||
-          worker.worker?.config?.version ||
-          worker.worker?.version ||
-          'n/a';
-        const autoStart = Boolean(worker.autoStart ?? worker.worker?.config?.autoStart ?? false);
-
-        const normalizedStatus = String(statusValue || '').toLowerCase();
-        const isRunning = ['running', 'active'].includes(normalizedStatus);
-        const startClass = isRunning ? 'action-btn is-disabled is-active' : 'action-btn';
-        const startAttr = isRunning ? ' disabled' : '';
-
-        if (!resolvedName) {
-          return '';
-        }
-
-        const rowHtml =
-          '<tr>' +
-          '<td class="zt-cell zt-cell--strong">' +
-          resolvedName +
-          '</td>' +
-          '<td class="zt-cell">' +
-          statusBadge(statusInfo.label, statusInfo.tone) +
-          '</td>' +
-          '<td class="zt-cell">' +
-          statusBadge(healthInfo.label, healthInfo.tone) +
-          '</td>' +
-          '<td class="zt-cell zt-cell--muted">' +
-          version +
-          '</td>' +
-          '<td class="zt-cell zt-cell--right">' +
-          '<div class="zt-row-actions">' +
-          '<label class="zt-toggle" title="Auto start">' +
-          '<input class="zt-switch" type="checkbox" data-action="auto-start" data-worker="' +
-          resolvedName +
-          '" data-auto-start="' +
-          (autoStart ? 'true' : 'false') +
-          '"' +
-          (autoStart ? ' checked' : '') +
-          ' />' +
-          '<span>Auto</span>' +
-          '</label>' +
-          '<button class="' +
-          startClass +
-          '" data-action="start" data-worker="' +
-          resolvedName +
-          '"' +
-          startAttr +
-          '>Start</button>' +
-          '<button class="action-btn" data-action="restart" data-worker="' +
-          resolvedName +
-          '">Restart</button>' +
-          '<button class="action-btn" data-action="stop" data-worker="' +
-          resolvedName +
-          '">Stop</button>' +
-          '<button class="action-btn is-delete" data-action="delete" data-worker="' +
-          resolvedName +
-          '">Delete</button>' +
-          '</div>' +
-          '</td>' +
-          '</tr>';
-
-        return rowHtml;
-      };
-`;
-const getWorkersScriptRenderRows = () => `
-      const renderWorkers = (workers) => {
-        bodyEl.innerHTML = '';
-        if (!workers.length) {
-          bodyEl.innerHTML = '<tr><td colspan="5" class="zt-empty">No workers found.</td></tr>';
-          return;
-        }
-
-        workers.forEach((worker) => {
-          const rowHtml = renderWorkerRow(worker);
-          if (!rowHtml) {
-            return;
-          }
-          bodyEl.insertAdjacentHTML('beforeend', rowHtml);
-        });
-      };
-`;
-const getWorkersScriptRenderSummary = () => `
-      const updateSummary = (workers) => {
-        totalEl.textContent = workers.length;
-        const activeCount = workers.filter((worker) => {
-          const status = String(worker.status?.status || worker.status || '').toLowerCase();
-          return status === 'running' || status === 'active';
-        }).length;
-        const attentionCount = workers.filter((worker) => {
-          const health = String(worker.health?.status || worker.health || '').toLowerCase();
-          return ['degraded', 'critical', 'unhealthy', 'red', 'yellow'].includes(health);
-        }).length;
-
-        activeEl.textContent = activeCount;
-        attentionEl.textContent = attentionCount;
-      };
-`;
-const getWorkersScriptFetch = () => `
-      const fetchWorkers = async () => {
-        setError('');
-        try {
-          const query = new URLSearchParams({
-            detail: 'true',
-            storage: storageMode,
-          });
-          const response = await fetch(API_BASE + '/api/workers?' + query.toString());
-          if (!response.ok) throw new Error('Failed to load workers');
-          const payload = await response.json();
-          const workers = payload.workers || [];
-          renderWorkers(workers);
-          updateSummary(workers);
-          lastUpdated.textContent = 'Updated ' + new Date().toLocaleTimeString();
-        } catch (error) {
-          setError(error.message || 'Failed to load worker data');
-        }
-      };
-
-      const handleAction = async (action, workerName, extraParams = {}, methodOverride) => {
-        setError('');
-        try {
-          if (!workerName) {
-            throw new Error('Missing worker name');
-          }
-          const query = new URLSearchParams({ storage: storageMode, ...extraParams });
-          const path = action ? '/' + action : '';
-          const response = await fetch(
-            API_BASE + '/api/workers/' + workerName + path + '?' + query.toString(),
-            {
-            method: methodOverride || 'POST',
-            }
-          );
-          if (!response.ok) throw new Error('Action failed');
-          await fetchWorkers();
-        } catch (error) {
-          setError(error.message || 'Failed to execute action');
-        }
-      };
-`;
-const getWorkersScriptControls = () => `
-      bodyEl.addEventListener('click', (event) => {
-        const target = event.target;
-        if (!target || !target.dataset) return;
-        if (target.dataset.action && target.dataset.worker) {
-          if (target.dataset.action === 'auto-start') {
-            return;
-          }
-          if (target.dataset.action === 'delete') {
-            const first = window.confirm('Delete this worker?');
-            if (!first) return;
-            const second = window.confirm('This cannot be undone. Delete worker permanently?');
-            if (!second) return;
-            handleAction('', target.dataset.worker, {}, 'DELETE');
-            return;
-          }
-          handleAction(target.dataset.action, target.dataset.worker);
-        }
-      });
-
-      bodyEl.addEventListener('change', (event) => {
-        const target = event.target;
-        if (!target || !target.dataset) return;
-        if (target.dataset.action === 'auto-start' && target.dataset.worker) {
-          const nextValue = target.checked === true;
-          const confirmMessage = nextValue
-            ? 'Enable auto start for this worker?'
-            : 'Disable auto start for this worker?';
-          if (!window.confirm(confirmMessage)) {
-            target.checked = !nextValue;
-            return;
-          }
-          handleAction('auto-start', target.dataset.worker, { enabled: String(nextValue) });
-        }
-      });
-
-      refreshBtn.addEventListener('click', () => fetchWorkers());
-      if (storageSelect) {
-        storageSelect.addEventListener('change', (event) => {
-          setStorageValue(event.target.value);
-          writeStorage(STORAGE_KEYS.storageMode, storageMode);
-          fetchWorkers();
-        });
-      }
-      autoBtn.addEventListener('click', () => {
-        autoRefresh = !autoRefresh;
-        setAutoLabel();
-        writeStorage(STORAGE_KEYS.autoRefresh, String(autoRefresh));
-        if (autoRefresh) {
-          autoTimer = setInterval(fetchWorkers, REFRESH_INTERVAL);
-        } else if (autoTimer) {
-          clearInterval(autoTimer);
-        }
-      });
-`;
-const getWorkersScriptBootstrap = () => `
-      const storedAuto = readStorage(STORAGE_KEYS.autoRefresh);
-      if (storedAuto !== null) {
-        autoRefresh = storedAuto === 'true';
-      }
-      const storedStorage = readStorage(STORAGE_KEYS.storageMode);
-      if (storedStorage) {
-        setStorageValue(storedStorage);
-      } else {
-        setStorageValue('memory');
-      }
-      setAutoLabel();
-
-      if (autoRefresh) {
-        autoTimer = setInterval(fetchWorkers, REFRESH_INTERVAL);
-      }
-
-      fetchWorkers();
-`;
-const getWorkersScript = (options, apiBaseUrl) => `
-    <script>
-${getWorkersScriptState(options, apiBaseUrl)}
-${getWorkersScriptStorage()}
-${getWorkersScriptError()}
-${getWorkersScriptBadges()}
-${getWorkersScriptTone()}
-${getWorkersScriptRenderRowTemplate()}
-${getWorkersScriptRenderRows()}
-${getWorkersScriptRenderSummary()}
-${getWorkersScriptFetch()}
-${getWorkersScriptControls()}
-${getWorkersScriptBootstrap()}
-    </script>`;
-export const getWorkersHtml = (options) => {
-    const apiBaseUrl = normalizeBasePath(options.apiBaseUrl ?? '');
-    return `<!DOCTYPE html>
-<html lang="en">
-${getWorkersHead()}
-  <body>
-${getWorkersBody()}
-${getWorkersScript(options, apiBaseUrl)}
-  </body>
-</html>`;
-};