@vibesdotdev/workers 0.0.0-stage → 1.0.0-rc.3

package/dist/adapters/memory/worker-adapter.memory.impl.js

@@ -0,0 +1,50 @@
+/**
+ * Memory Worker Adapter Implementation
+ *
+ * Runtime-aware wrapper for MemoryRuntimeAdapter.
+ */
+import { MemoryRuntimeAdapter } from "./runtime/adapter.js";
+/**
+ * Memory worker adapter - wraps MemoryRuntimeAdapter with runtime integration
+ */
+export class MemoryWorkerAdapter {
+    context;
+    id;
+    descriptor;
+    adapters = new Map();
+    connected = false;
+    constructor(descriptor, context) {
+        this.context = context;
+        this.id = descriptor.id;
+        this.descriptor = descriptor;
+    }
+    getQueueAdapter(queueName) {
+        const existing = this.adapters.get(queueName);
+        if (existing)
+            return existing;
+        const adapter = new MemoryRuntimeAdapter(queueName, this.context.runtime);
+        this.adapters.set(queueName, adapter);
+        return adapter;
+    }
+    isConnected() {
+        return this.connected;
+    }
+    async connect() {
+        if (this.connected)
+            return;
+        const adapter = this.getQueueAdapter('default');
+        await adapter.connect();
+        this.connected = true;
+    }
+    async disconnect() {
+        if (!this.connected)
+            return;
+        for (const adapter of this.adapters.values()) {
+            await adapter.disconnect();
+        }
+        this.adapters.clear();
+        this.connected = false;
+    }
+}
+export default MemoryWorkerAdapter;
+//# sourceMappingURL=worker-adapter.memory.impl.js.map

package/dist/adapters/memory/worker-adapter.memory.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-adapter.memory.impl.js","sourceRoot":"","sources":["../../../src/adapters/memory/worker-adapter.memory.impl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;GAEG;AACH,MAAM,OAAO,mBAAmB;IAOmC;IANzD,EAAE,CAAS;IACX,UAAU,CAA0B;IAErC,QAAQ,GAAsC,IAAI,GAAG,EAAE,CAAC;IACxD,SAAS,GAAG,KAAK,CAAC;IAE1B,YAAY,UAAmC,EAAmB,OAA6B;QAA7B,YAAO,GAAP,OAAO,CAAsB;QAC9F,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC9B,CAAC;IAED,eAAe,CAAC,SAAiB;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,oBAAoB,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1E,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACtC,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,WAAW;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAO;QACZ,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAE3B,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,UAAU;QACf,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAC5B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9C,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACxB,CAAC;CACD;AAED,eAAe,mBAAmB,CAAC"}

package/dist/adapters/schemas/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Worker Adapter Schemas
+ */
+import type { EnqueueOptionsExtended, JobExtended } from '../../core/schemas/index.ts';
+import type { Cancellation } from '../../schemas/cancellation.ts';
+export interface WorkerClientAdapter<TJob = unknown, _TResult = unknown> {
+    submitJob(data: TJob, options?: EnqueueOptionsExtended): Promise<string>;
+    getJobStatus(jobId: string): Promise<string>;
+    getJob(jobId: string): Promise<JobExtended<TJob> | null>;
+    cancelJob(jobId: string, cancellation: Cancellation): Promise<boolean>;
+}
+export interface IPCManagerConfig {
+    maxConnections?: number;
+    heartbeatIntervalMs?: number;
+    connectionTimeoutMs?: number;
+}
+export interface IPCMessage {
+    type: string;
+    payload: unknown;
+    timestamp: number;
+    correlationId?: string;
+}
+export type IPCMessageType = 'request' | 'response' | 'event' | 'heartbeat';
+export interface IPCServerConfig {
+    port?: number;
+    host?: string;
+    maxConnections?: number;
+}
+export type IPCDispatcherType = 'round-robin' | 'least-connections' | 'random';
+export interface IPCClientBufferConfig {
+    maxSize: number;
+    flushIntervalMs: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/schemas/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAGlE,MAAM,WAAW,mBAAmB,CAAC,IAAI,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO;IACtE,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACzD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvE;AAGD,MAAM,WAAW,gBAAgB;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAGD,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AAG5E,MAAM,WAAW,eAAe;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,mBAAmB,GAAG,QAAQ,CAAC;AAG/E,MAAM,WAAW,qBAAqB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;CACxB"}

package/dist/adapters/schemas/index.js

@@ -0,0 +1,5 @@
+/**
+ * Worker Adapter Schemas
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/adapters/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/schemas/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/cli/adapter-helpers.d.ts

@@ -0,0 +1,10 @@
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { Job, QueueAdapter } from '../core/queue-adapter.ts';
+/**
+ * Connect the named queue through the adapter that serves this host's
+ * declared hardware. The scope is read, never rewritten.
+ */
+export declare function resolveQueueAdapter(runtime: VibesRuntime, queueId: string): Promise<QueueAdapter<unknown, unknown>>;
+/** Wait for `jobId` to complete and return the completed job (its `result` is what the worker produced). */
+export declare function pollJobCompletion(runtime: Pick<VibesRuntime, 'lifecycle'>, queue: QueueAdapter<unknown, unknown>, jobId: string, timeoutMs: number): Promise<Job>;
+//# sourceMappingURL=adapter-helpers.d.ts.map

package/dist/cli/adapter-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-helpers.d.ts","sourceRoot":"","sources":["../../src/cli/adapter-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIlE;;;GAGG;AACH,wBAAsB,mBAAmB,CACxC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAUzC;AAED,4GAA4G;AAC5G,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,EACxC,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EACrC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,GAAG,CAAC,CAiBd"}

package/dist/cli/adapter-helpers.js

@@ -0,0 +1,33 @@
+/**
+ * Connect the named queue through the adapter that serves this host's
+ * declared hardware. The scope is read, never rewritten.
+ */
+export async function resolveQueueAdapter(runtime, queueId) {
+    const adapter = await runtime
+        .query('workers/adapter')
+        .forHardware(runtime.scope.hardware)
+        .enabled()
+        .resolve();
+    const queue = adapter.getQueueAdapter(queueId);
+    await queue.connect();
+    return queue;
+}
+/** Wait for `jobId` to complete and return the completed job (its `result` is what the worker produced). */
+export async function pollJobCompletion(runtime, queue, jobId, timeoutMs) {
+    const started = Date.now();
+    while (Date.now() - started < timeoutMs) {
+        const job = await queue.getJob(jobId);
+        if (job?.status === 'completed') {
+            return job;
+        }
+        if (job?.status === 'failed') {
+            throw new Error(job.error || `Job ${jobId} failed`);
+        }
+        if (job?.status === 'cancelled') {
+            throw new Error(`Job ${jobId} was cancelled`);
+        }
+        await runtime.lifecycle.delay(200);
+    }
+    throw new Error(`Timed out waiting for job ${jobId} after ${timeoutMs}ms`);
+}
+//# sourceMappingURL=adapter-helpers.js.map

package/dist/cli/adapter-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-helpers.js","sourceRoot":"","sources":["../../src/cli/adapter-helpers.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,OAAqB,EACrB,OAAe;IAEf,MAAM,OAAO,GAAG,MAAM,OAAO;SAC3B,KAAK,CAAoE,iBAAiB,CAAC;SAC3F,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;SACnC,OAAO,EAAE;SACT,OAAO,EAAE,CAAC;IAEZ,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;IACtB,OAAO,KAAK,CAAC;AACd,CAAC;AAED,4GAA4G;AAC5G,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,OAAwC,EACxC,KAAqC,EACrC,KAAa,EACb,SAAiB;IAEjB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,SAAS,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,GAAG,EAAE,MAAM,KAAK,WAAW,EAAE,CAAC;YACjC,OAAO,GAAG,CAAC;QACZ,CAAC;QACD,IAAI,GAAG,EAAE,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,KAAK,SAAS,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,GAAG,EAAE,MAAM,KAAK,WAAW,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,gBAAgB,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,UAAU,SAAS,IAAI,CAAC,CAAC;AAC5E,CAAC"}

package/dist/cli/command-output.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Where a `vibes workers` command writes what it reports: the handed
+ * runtime's host text output (`runtime/stdio`), never the process console.
+ * Results go to stdout, diagnostics to stderr. A host without text output
+ * refuses `UNAVAILABLE` `stdio-unavailable` before the command writes.
+ */
+import { type CommandOutputRuntime } from '@vibesdotdev/cli/output';
+/** A workers command's text output for one run. */
+export interface WorkersCommandOutput {
+    /** `text` and a newline on stdout; with no text, an empty line. */
+    line(text?: string): void;
+    /** `text` and a newline on stderr: a diagnostic, never a result. */
+    warn(text: string): void;
+}
+/** Resolve the handed runtime's text output for one command run. */
+export declare function openWorkersCommandOutput(runtime: CommandOutputRuntime): Promise<WorkersCommandOutput>;
+//# sourceMappingURL=command-output.d.ts.map

package/dist/cli/command-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-output.d.ts","sourceRoot":"","sources":["../../src/cli/command-output.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEpF,mDAAmD;AACnD,MAAM,WAAW,oBAAoB;IACpC,mEAAmE;IACnE,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oEAAoE;IACpE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,oEAAoE;AACpE,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAM3G"}

package/dist/cli/command-output.js

@@ -0,0 +1,16 @@
+/**
+ * Where a `vibes workers` command writes what it reports: the handed
+ * runtime's host text output (`runtime/stdio`), never the process console.
+ * Results go to stdout, diagnostics to stderr. A host without text output
+ * refuses `UNAVAILABLE` `stdio-unavailable` before the command writes.
+ */
+import { commandWriters } from '@vibesdotdev/cli/output';
+/** Resolve the handed runtime's text output for one command run. */
+export async function openWorkersCommandOutput(runtime) {
+    const { out, err } = await commandWriters(runtime);
+    return {
+        line: (text = '') => out(`${text}\n`),
+        warn: (text) => err(`${text}\n`)
+    };
+}
+//# sourceMappingURL=command-output.js.map

package/dist/cli/command-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-output.js","sourceRoot":"","sources":["../../src/cli/command-output.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAA6B,MAAM,yBAAyB,CAAC;AAUpF,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,OAA6B;IAC3E,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IACnD,OAAO;QACN,IAAI,EAAE,CAAC,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC;QACrC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC;KAChC,CAAC;AACH,CAAC"}

package/dist/cli/context.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Workers CLI Context
+ */
+export type { WorkersRuntimeContext } from './schemas/index.ts';
+//# sourceMappingURL=context.d.ts.map

package/dist/cli/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/cli/context.js

@@ -0,0 +1,5 @@
+/**
+ * Workers CLI Context
+ */
+export {};
+//# sourceMappingURL=context.js.map

package/dist/cli/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/cli/job-health.d.ts

@@ -0,0 +1,20 @@
+import type { Job } from '../core/queue-adapter.ts';
+export type WorkerJobHealthStatus = 'queued' | 'healthy' | 'unknown' | 'unhealthy' | 'terminal';
+export interface WorkerJobHealth {
+    status: WorkerJobHealthStatus;
+    reason: string;
+    lastHeartbeatAt?: string;
+    heartbeatAgeMs?: number;
+    heartbeatIntervalMs?: number;
+    heartbeatState?: string;
+}
+/**
+ * One line for a job's progress: a percentage, a message, the structured lane
+ * fields, or the report as JSON (its text form when JSON refuses it).
+ */
+export declare function summarizeWorkerJobProgress<Progress>(progress: Progress, now?: number): string | null;
+export declare function getWorkerJobHealth(job: Job, now?: number): WorkerJobHealth;
+export declare function withWorkerJobHealth<TJob>(job: Job<TJob>, now?: number): Job<TJob> & {
+    health: WorkerJobHealth;
+};
+//# sourceMappingURL=job-health.d.ts.map

package/dist/cli/job-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-health.d.ts","sourceRoot":"","sources":["../../src/cli/job-health.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,0BAA0B,CAAC;AAEpD,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAEhG,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AA2GD;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,SAAa,GAAG,MAAM,GAAG,IAAI,CAkBxG;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,SAAa,GAAG,eAAe,CAkF9E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,SAAa,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG;IACxF,MAAM,EAAE,eAAe,CAAC;CACxB,CAKA"}

package/dist/cli/job-health.js

@@ -0,0 +1,195 @@
+import { CaughtFailureSchema, valueFreeFailure } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+const DEFAULT_HEARTBEAT_INTERVAL_MS = 30_000;
+const MIN_STALE_HEARTBEAT_MS = 90_000;
+/** A date fact as stored: a valid `Date`, or a string/number that builds one. */
+const DateFactSchema = z
+    .union([z.date(), z.string(), z.number()])
+    .transform((value) => (value instanceof Date ? value : new Date(value)))
+    .refine((date) => !Number.isNaN(date.getTime()));
+/** A finite number fact. */
+const FiniteNumberSchema = z.number();
+/** A non-empty text fact. */
+const NonEmptyTextSchema = z.string().min(1);
+/** The subtask snapshot a lane job reports inside its progress. */
+const SubtaskProgressSchema = z.object({
+    childJobId: z.unknown().optional(),
+    childStatus: z.unknown().optional(),
+    waitDurationMs: z.unknown().optional(),
+    workerHeartbeatAt: z.unknown().optional(),
+    workerHeartbeatState: z.unknown().optional(),
+    childProgress: z.unknown().optional()
+});
+/** The fields a structured progress report may carry. */
+const ProgressFieldsSchema = z.object({
+    phase: z.unknown().optional(),
+    laneId: z.unknown().optional(),
+    role: z.unknown().optional(),
+    message: z.unknown().optional(),
+    subtask: z.unknown().optional()
+});
+function isNumberValue(value) {
+    return typeof value === 'number';
+}
+function isTextValue(value) {
+    return typeof value === 'string';
+}
+function readDate(value) {
+    const parsed = DateFactSchema.safeParse(value);
+    return parsed.success ? parsed.data : null;
+}
+function readNumber(value) {
+    const parsed = FiniteNumberSchema.safeParse(value);
+    return parsed.success ? parsed.data : null;
+}
+function readString(value) {
+    const parsed = NonEmptyTextSchema.safeParse(value);
+    return parsed.success ? parsed.data : undefined;
+}
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    const seconds = ms / 1000;
+    return `${Number.isInteger(seconds) ? seconds.toFixed(0) : seconds.toFixed(1)}s`;
+}
+function summarizeSubtaskProgress(subtask, now) {
+    const childJobId = readString(subtask.childJobId);
+    const childStatus = readString(subtask.childStatus);
+    const label = ['subtask', childJobId, childStatus].filter(Boolean).join(' ');
+    const parts = label ? [label] : [];
+    const waitDurationMs = readNumber(subtask.waitDurationMs);
+    if (waitDurationMs !== null) {
+        parts.push(`wait ${formatDuration(waitDurationMs)}`);
+    }
+    const heartbeatAt = readDate(subtask.workerHeartbeatAt);
+    const heartbeatState = readString(subtask.workerHeartbeatState);
+    if (heartbeatAt || heartbeatState) {
+        const heartbeatParts = ['heartbeat'];
+        if (heartbeatState)
+            heartbeatParts.push(heartbeatState);
+        if (heartbeatAt)
+            heartbeatParts.push(`${formatDuration(Math.max(0, now - heartbeatAt.getTime()))} old`);
+        parts.push(heartbeatParts.join(' '));
+    }
+    if (subtask.childProgress !== undefined) {
+        const childProgress = summarizeWorkerJobProgress(subtask.childProgress, now);
+        if (childProgress)
+            parts.push(`child progress ${childProgress}`);
+    }
+    return parts.length > 0 ? parts.join('; ') : null;
+}
+/** JSON text for a progress report; a report JSON refuses (a cycle, a bigint) comes back as its value-free failure. */
+function serializeProgress(progress) {
+    try {
+        return { text: JSON.stringify(progress) };
+    }
+    catch (error) {
+        return { failure: valueFreeFailure(CaughtFailureSchema.parse(error)) };
+    }
+}
+/**
+ * One line for a job's progress: a percentage, a message, the structured lane
+ * fields, or the report as JSON (its text form when JSON refuses it).
+ */
+export function summarizeWorkerJobProgress(progress, now = Date.now()) {
+    if (progress === undefined || progress === null)
+        return null;
+    if (isNumberValue(progress))
+        return `${progress}%`;
+    if (isTextValue(progress))
+        return progress;
+    const fields = ProgressFieldsSchema.safeParse(progress);
+    if (fields.success) {
+        const record = fields.data;
+        const phase = readString(record.phase);
+        const laneId = readString(record.laneId);
+        const role = readString(record.role);
+        const message = readString(record.message);
+        const subtask = SubtaskProgressSchema.safeParse(record.subtask);
+        const subtaskSummary = subtask.success ? summarizeSubtaskProgress(subtask.data, now) : null;
+        const parts = [phase, laneId, role, message, subtaskSummary].filter(Boolean);
+        if (parts.length > 0)
+            return parts.join(' · ');
+    }
+    const serialized = serializeProgress(progress);
+    return serialized.failure ? String(progress) : (serialized.text ?? null);
+}
+export function getWorkerJobHealth(job, now = Date.now()) {
+    const claim = job.executionClaim;
+    if (claim.state === 'unknown' && claim.invalidRecord) {
+        return {
+            status: 'unhealthy',
+            reason: `Stored job ownership is invalid (${claim.invalidRecord.reason}: ${claim.invalidRecord.fields.join(', ')}); ` +
+                'the job is fenced until its execution is confirmed retired.'
+        };
+    }
+    if (job.status === 'pending') {
+        return { status: 'queued', reason: 'Job is queued and has not started.' };
+    }
+    if (job.status === 'delayed') {
+        const delayedUntil = readDate(job.metadata?.delayedUntil);
+        if (!delayedUntil) {
+            return { status: 'queued', reason: 'Job is delayed and not ready to run.' };
+        }
+        const delayMs = delayedUntil.getTime() - now;
+        return {
+            status: 'queued',
+            reason: delayMs > 0
+                ? `Job is delayed for ${formatDuration(delayMs)}.`
+                : 'Job delay elapsed and is waiting for queue promotion.'
+        };
+    }
+    if (job.status !== 'processing') {
+        return { status: 'terminal', reason: `Job is ${job.status}.` };
+    }
+    const metadata = job.metadata ?? {};
+    const heartbeatAt = readDate(metadata.workerHeartbeatAt);
+    const heartbeatIntervalMs = readNumber(metadata.workerHeartbeatIntervalMs) ?? DEFAULT_HEARTBEAT_INTERVAL_MS;
+    const staleAfterMs = Math.max(heartbeatIntervalMs * 3, MIN_STALE_HEARTBEAT_MS);
+    const heartbeatState = readString(metadata.workerHeartbeatState);
+    if (heartbeatAt) {
+        const heartbeatAgeMs = Math.max(0, now - heartbeatAt.getTime());
+        const common = {
+            lastHeartbeatAt: heartbeatAt.toISOString(),
+            heartbeatAgeMs,
+            heartbeatIntervalMs,
+            heartbeatState
+        };
+        if (heartbeatAgeMs <= staleAfterMs) {
+            return {
+                status: 'healthy',
+                reason: `Heartbeat is fresh (${heartbeatAgeMs}ms old).`,
+                ...common
+            };
+        }
+        return {
+            status: 'unhealthy',
+            reason: `Heartbeat is stale (${heartbeatAgeMs}ms old; threshold ${staleAfterMs}ms).`,
+            ...common
+        };
+    }
+    const startedAt = readDate(job.startedAt);
+    if (!startedAt) {
+        return { status: 'unknown', reason: 'Processing job has no startedAt or heartbeat metadata.' };
+    }
+    const ageMs = Math.max(0, now - startedAt.getTime());
+    if (ageMs > MIN_STALE_HEARTBEAT_MS) {
+        return {
+            status: 'unhealthy',
+            reason: `Processing job has no heartbeat metadata after ${ageMs}ms.`,
+            heartbeatAgeMs: ageMs
+        };
+    }
+    return {
+        status: 'unknown',
+        reason: `Processing job has not emitted heartbeat metadata yet (${ageMs}ms since start).`,
+        heartbeatAgeMs: ageMs
+    };
+}
+export function withWorkerJobHealth(job, now = Date.now()) {
+    return {
+        ...job,
+        health: getWorkerJobHealth(job, now)
+    };
+}
+//# sourceMappingURL=job-health.js.map

package/dist/cli/job-health.js.map

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

package/dist/cli/plugin.d.ts

@@ -0,0 +1,4 @@
+/** CLI projection for the provider-neutral Workers runtime. */
+export declare const workersCliPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default workersCliPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/cli/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/cli/plugin.ts"],"names":[],"mappings":"AA0BA,+DAA+D;AAC/D,eAAO,MAAM,gBAAgB,6CAsD3B,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/dist/cli/plugin.js

@@ -0,0 +1,83 @@
+import { workersServePlugin } from "./runtime-loader.js";
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import workersGroup from "./workers.descriptor.js";
+import workersJobsGroup from "./workers.jobs.descriptor.js";
+import workersInfo from "./workers.info.descriptor.js";
+import workersJobsHistory from "./workers.jobs.history.descriptor.js";
+import workersList from "./workers.list.descriptor.js";
+import workersCheck from "./workers.check.descriptor.js";
+import workersLogs from "./workers.logs.descriptor.js";
+import workersRestart from "./workers.restart.descriptor.js";
+import workersServe from "./workers.serve.descriptor.js";
+import workersStart from "./workers.start.descriptor.js";
+import workersStatus from "./workers.status.descriptor.js";
+import workersStop from "./workers.stop.descriptor.js";
+import workersJobsInfo from "./workers.jobs.info.descriptor.js";
+import workersJobsCancel from "./workers.jobs.cancel.descriptor.js";
+import workersJobsList from "./workers.jobs.list.descriptor.js";
+import workersJobsRun from "./workers.jobs.run.descriptor.js";
+import workersJobsWatch from "./workers.jobs.watch.descriptor.js";
+import workersDlqGroup from "./workers.dlq.descriptor.js";
+import workersDlqList from "./workers.dlq.list.descriptor.js";
+import workersDlqShow from "./workers.dlq.show.descriptor.js";
+import workersDlqReplay from "./workers.dlq.replay.descriptor.js";
+import workersDlqPurge from "./workers.dlq.purge.descriptor.js";
+import vibesWorkersConsumerProcess from "./vibes-workers-consumer.process.descriptor.js";
+/** CLI projection for the provider-neutral Workers runtime. */
+export const workersCliPlugin = createRuntimePlugin({
+    id: 'workers/cli',
+    name: 'Workers CLI',
+    description: 'Worker, job, lifecycle, and foreground-serving CLI commands.',
+    dependencies: ['workers', 'cli'],
+    async onRegister(runtime) { await runtime.registerPlugin(workersServePlugin); },
+    descriptors: [
+        workersGroup,
+        workersJobsGroup,
+        workersInfo,
+        workersList,
+        workersCheck,
+        workersJobsHistory,
+        workersLogs,
+        workersRestart,
+        workersServe,
+        workersStart,
+        workersStatus,
+        workersStop,
+        workersJobsInfo,
+        workersJobsCancel,
+        workersJobsList,
+        workersJobsRun,
+        workersJobsWatch,
+        workersDlqGroup,
+        workersDlqList,
+        workersDlqShow,
+        workersDlqReplay,
+        workersDlqPurge,
+        // The consumer worker runtime PM supervises (rc02-rc03 §2.5 authorship).
+        vibesWorkersConsumerProcess
+    ],
+    loaders: [
+        loader('workers.info', () => import("./workers.info.impl.js")),
+        loader('workers.list', () => import("./workers.list.impl.js")),
+        loader('workers.check', () => import("./workers.check.impl.js")),
+        loader('workers.jobs.history', () => import("./workers.jobs.history.impl.js")),
+        loader('workers.logs', () => import("./workers.logs.impl.js")),
+        loader('workers.restart', () => import("./workers.restart.impl.js")),
+        // A serve command's impl runs on its own serve host (surface 'worker'), not the CLI surface.
+        loader('workers.serve', () => import("./workers.serve.impl.cli.js")),
+        loader('workers.start', () => import("./workers.start.impl.js")),
+        loader('workers.status', { kind: 'cli/command' }, () => import("./workers.status.impl.js")),
+        loader('workers.stop', () => import("./workers.stop.impl.js")),
+        loader('workers.jobs.info', () => import("./workers.jobs.info.impl.js")),
+        loader('workers.jobs.cancel', () => import("./workers.jobs.cancel.impl.js")),
+        loader('workers.jobs.list', () => import("./workers.jobs.list.impl.js")),
+        loader('workers.jobs.run', () => import("./workers.jobs.run.impl.js")),
+        loader('workers.jobs.watch', () => import("./workers.jobs.watch.impl.js")),
+        loader('workers.dlq.list', () => import("./workers.dlq.list.impl.js")),
+        loader('workers.dlq.show', () => import("./workers.dlq.show.impl.js")),
+        loader('workers.dlq.replay', () => import("./workers.dlq.replay.impl.js")),
+        loader('workers.dlq.purge', () => import("./workers.dlq.purge.impl.js"))
+    ]
+});
+export default workersCliPlugin;
+//# sourceMappingURL=plugin.js.map

package/dist/cli/plugin.js.map

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

package/dist/cli/runtime-loader.d.ts

@@ -0,0 +1,17 @@
+import { BaseRuntimeClient } from '@vibesdotdev/kernel/client';
+/**
+ * Runtime Loader
+ * Builds the worker runtime for the hardware this host declared.
+ * Queries the vibes runtime directly for worker implementations.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { WorkerRuntime } from '../runtime/index.ts';
+export declare class WorkersServeClient extends BaseRuntimeClient<VibesRuntime> {
+    private served?;
+    getWorkerRuntime(): Promise<WorkerRuntime>;
+    protected onDispose(): Promise<void>;
+}
+export declare const workersServePlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export declare function getWorkerRuntime(runtime: VibesRuntime): Promise<WorkerRuntime>;
+export declare function ensureWorkersCatalog(runtime: VibesRuntime): Promise<void>;
+//# sourceMappingURL=runtime-loader.d.ts.map

package/dist/cli/runtime-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-loader.d.ts","sourceRoot":"","sources":["../../src/cli/runtime-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAkB,MAAM,4BAA4B,CAAC;AAC/E;;;;GAIG;AAEH,OAAO,EAAgE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEtH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,qBAAa,kBAAmB,SAAQ,iBAAiB,CAAC,YAAY,CAAC;IACtE,OAAO,CAAC,MAAM,CAAC,CAAyB;IACxC,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC;cAOjB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAInD;AAED,eAAO,MAAM,kBAAkB,6CAO7B,CAAC;AAEH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAGpF;AA4BD,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAW/E"}