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

package/dist/runtime/schedule-registration.js

@@ -0,0 +1,168 @@
+/**
+ * Register the schedules that job descriptors declare.
+ *
+ * WHY THIS EXISTS — the failure it closes.
+ *
+ * Scheduling used to live in `maintenance/default-schedules.ts`: a hand-written
+ * list of four `{ jobType, cronPattern }` pairs, exported, re-exported, and read
+ * by nothing. `schedules.json` in the Vibes home — the file the IPC adapter
+ * persists registered schedules to — did not exist on a workstation that had been running
+ * the stack for months, because no code path ever called `scheduleRepeatable`.
+ * The scheduler started, logged "Worker scheduler started", and polled an empty
+ * set forever.
+ *
+ * The cost was not four idle jobs. `awareness.prune` — a job written expressly
+ * to fix retention that never runs — was never added to that second list, so it
+ * was doubly unscheduled: no `schedule` on its descriptor AND no entry in the
+ * list. Two tables reached 610k and 720k rows, 1.2GB, with 719,597 of 719,834
+ * staged items already processed and nothing draining them.
+ *
+ * A second registry that must be hand-synced with the first will drift, and the
+ * drift is silent — a job that never runs looks exactly like a job with nothing
+ * to do. So the cadence now lives on the descriptor that owns the job, and this
+ * module is the single reader. Declaring a schedule IS registering it.
+ *
+ * IDEMPOTENCE. `scheduleRepeatable` keys stored entries on
+ * `queue:name:pattern`, so re-registering a job whose cron CHANGED would leave
+ * the old entry behind and fire twice. Every registration therefore removes all
+ * entries for `(queue, jobId)` first — the no-repeat form of `removeSchedule` —
+ * and then writes exactly one. Restarting the runtime converges; it never
+ * accumulates.
+ */
+import { valueFreeFailure } from '@vibesdotdev/kernel';
+import { settle } from "../core/settle.js";
+import { resolvePhysicalQueueName } from "../schemas/claim.js";
+/**
+ * Is this job's schedule active? The `workers` manifest wins over the
+ * descriptor, so a user can silence one job without editing code. A job that
+ * declares a schedule is on by default: declaring is enough.
+ */
+export function scheduleIsEnabled(descriptor, schedules) {
+    const override = schedules[descriptor.id];
+    if (override)
+        return override.enabled;
+    return descriptor.scheduleEnabled !== false;
+}
+function isSchedulable(descriptor) {
+    return (descriptor.schedule !== undefined &&
+        descriptor.schedule.trim().length > 0 &&
+        descriptor.queue !== undefined &&
+        descriptor.queue.length > 0);
+}
+/**
+ * Job descriptors this runtime should register schedules for.
+ *
+ * Filtered by hardware because a cloud-only job on a laptop has no
+ * implementation to run — `maintenance.db-prune` ships only
+ * `.impl.cloud.ts`, and enqueuing it on consumer would produce a job that
+ * dequeues and fails rather than one that is honestly absent.
+ */
+function declaredSchedulableJobs(runtime, hardware) {
+    // A host that composes no job kind has nothing to schedule; a registered
+    // kind whose descriptors cannot be read fails registration.
+    if (!runtime.hasKind?.('workers/job'))
+        return [];
+    const descriptors = runtime
+        .assets('workers/job')
+        .forHardware(hardware)
+        .descriptors();
+    return descriptors.filter(isSchedulable);
+}
+export function selectSchedulableJobs(runtime, hardware, schedules) {
+    return declaredSchedulableJobs(runtime, hardware)
+        .filter(descriptor => descriptor.enabled !== false && scheduleIsEnabled(descriptor, schedules));
+}
+/**
+ * Write every declared schedule into the adapter's schedule store.
+ *
+ * Never throws: a runtime that cannot register housekeeping must still come up
+ * and serve jobs. Failures are logged individually and returned, so the caller
+ * can report a partial result rather than a silent one.
+ */
+export async function registerDeclaredSchedules(input) {
+    const result = {
+        registered: [],
+        unserved: [],
+        failed: []
+    };
+    for (const descriptor of declaredSchedulableJobs(input.runtime, input.hardware)) {
+        const jobId = descriptor.id;
+        if (descriptor.enabled === false || !scheduleIsEnabled(descriptor, input.schedules)) {
+            for (const [queueId, queue] of input.queues) {
+                if (!queue.scheduleRepeatable && !queue.removeSchedule)
+                    continue;
+                const removeSchedule = queue.removeSchedule;
+                if (!removeSchedule) {
+                    input.logger.warn('Cannot disable declared schedule: queue cannot remove it', { jobId, queue: queueId });
+                    result.failed.push(jobId);
+                    continue;
+                }
+                const removed = await settle(() => removeSchedule.call(queue, jobId));
+                if (!removed.ok) {
+                    input.logger.warn('Failed to disable declared schedule', { jobId, queue: queueId, error: valueFreeFailure(removed.caught) });
+                    result.failed.push(jobId);
+                }
+            }
+            continue;
+        }
+        const resolved = await settle(() => resolvePhysicalQueueName(descriptor.queue, descriptor.claim?.partition, input.runtime));
+        if (!resolved.ok) {
+            input.logger.warn('Could not resolve queue for scheduled job', {
+                jobId,
+                queue: descriptor.queue,
+                error: valueFreeFailure(resolved.caught)
+            });
+            result.failed.push(jobId);
+            continue;
+        }
+        const physicalQueue = resolved.value;
+        const queue = physicalQueue ? input.queues.get(physicalQueue) : undefined;
+        if (!queue) {
+            // Not an error: a runtime that serves other queues legitimately has
+            // nowhere to put this. Reported so "nobody serves this queue" is
+            // visible instead of looking like a job with nothing to do.
+            result.unserved.push(jobId);
+            continue;
+        }
+        const scheduleRepeatable = queue.scheduleRepeatable;
+        if (!scheduleRepeatable) {
+            result.unserved.push(jobId);
+            continue;
+        }
+        const written = await settle(async () => {
+            // Converge across every served queue, not only the current target queue:
+            // if a scheduled job's declared queue changes, any prior registration on
+            // an older served queue must be removed before writing the current one.
+            for (const [, servedQueue] of input.queues) {
+                if (servedQueue.removeSchedule) {
+                    await servedQueue.removeSchedule(jobId);
+                }
+            }
+            await scheduleRepeatable.call(queue, jobId, descriptor.scheduleData ?? {}, {
+                jobName: jobId,
+                // `metadata.type` is what `worker-runner` routes on. `jobName`
+                // alone does NOT dispatch — a schedule registered without this
+                // enqueues jobs no handler claims.
+                metadata: { type: jobId },
+                repeat: {
+                    pattern: descriptor.schedule,
+                    tz: descriptor.scheduleTimezone ?? 'UTC'
+                }
+            });
+        });
+        if (written.ok) {
+            result.registered.push(jobId);
+        }
+        else {
+            input.logger.warn('Failed to register declared schedule', {
+                jobId,
+                queue: physicalQueue,
+                schedule: descriptor.schedule,
+                error: valueFreeFailure(written.caught)
+            });
+            result.failed.push(jobId);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=schedule-registration.js.map

package/dist/runtime/schedule-registration.js.map

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

package/dist/runtime/schemas/contracts.d.ts

@@ -0,0 +1,23 @@
+/** Contracts shared by Workers runtime execution owners. */
+import type { RuntimeLogger } from '@vibesdotdev/logging';
+import type { WorkerEventSink } from '../../core/events.ts';
+import type { JobAssetDescriptor } from '../../schemas/descriptors.ts';
+import type { UsageAggregator } from '../usage-aggregator.ts';
+/** The parts of a job descriptor the shared execution contract reads. */
+export type JobContractDescriptor = Pick<JobAssetDescriptor, 'schemas' | 'timeout'>;
+export interface WorkerRunnerOptions {
+    logger?: RuntimeLogger;
+    pollIntervalMs?: number;
+    aggregator?: UsageAggregator;
+    heartbeatIntervalMs?: number;
+    cancellationPollIntervalMs?: number;
+    /** How long stop() waits for in-flight jobs before aborting them. */
+    drainTimeoutMs?: number;
+    /** Elapsed milliseconds without non-waiting progress or metadata advancement before emitting `job.stalled`. */
+    stallThresholdMs?: number;
+    /** Clock source in milliseconds for progress stall measurement. */
+    now?: () => number;
+    /** Optional sink receiving structured `WorkerEvent` emissions (`job.progress`, `job.stalled`, etc.). */
+    eventSink?: WorkerEventSink;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/runtime/schemas/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/runtime/schemas/contracts.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,yEAAyE;AACzE,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;AAEpF,MAAM,WAAW,mBAAmB;IACnC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+GAA+G;IAC/G,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,wGAAwG;IACxG,SAAS,CAAC,EAAE,eAAe,CAAC;CAC5B"}

package/dist/runtime/schemas/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/runtime/schemas/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/runtime/schemas/contracts.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,191 @@
+/**
+ * Worker Runtime Schemas
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import { type JsonValue } from '@vibesdotdev/kernel/schemas/json';
+import * as z from 'zod/v4';
+import type { WorkerImplementation } from '../../kinds/schemas/index.ts';
+import type { WorkerAdapterInterface } from '../../interfaces/adapter.ts';
+import type { HardwareType } from '../../core/schemas/config.ts';
+import type { SubtaskEventStream } from '../../core/job-handler.ts';
+import type { JobMetadataRecord } from '../../core/schemas/index.ts';
+export declare const OutcomeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    status: z.ZodLiteral<"pending">;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"completed">;
+    result: z.ZodType<JsonValue, JsonValue, z.core.$ZodTypeInternals<JsonValue, JsonValue>>;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"failed">;
+    error: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"cancelled">;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"unknown">;
+}, z.core.$strip>], "status">;
+export type Outcome = z.infer<typeof OutcomeSchema>;
+export type TerminalOutcome = Exclude<Outcome, {
+    status: 'pending';
+} | {
+    status: 'unknown';
+}>;
+export interface JobResultStorage {
+    get(key: string): Promise<JsonValue | undefined>;
+    put(key: string, value: JsonValue): Promise<void>;
+    deleteAll(): Promise<void>;
+    setAlarm(when: number): Promise<void>;
+}
+export declare const STATE_KEY = "state";
+export declare const DEFAULT_TTL_MS: number;
+export declare const DurableJobEventSchema: z.ZodObject<{
+    cursor: z.ZodNumber;
+    event: z.ZodString;
+    data: z.ZodOptional<z.ZodType<JsonValue, JsonValue, z.core.$ZodTypeInternals<JsonValue, JsonValue>>>;
+    timestamp: z.ZodString;
+}, z.core.$strip>;
+export type DurableJobEvent = z.infer<typeof DurableJobEventSchema>;
+export interface DurableJobEventPage {
+    events: DurableJobEvent[];
+    cursor: number;
+    outcome: Outcome;
+    gap?: {
+        requestedAfter: number;
+        oldestAvailable: number;
+    };
+}
+export interface JobResultStoreStub {
+    register(jobId: string, options?: {
+        ttlMs?: number;
+    }): Promise<void>;
+    /** Compare-and-set execution lease; required by every result-store owner. */
+    claimExecution(jobId: string, owner: string, options?: {
+        leaseMs?: number;
+    }): Promise<boolean>;
+    releaseExecution(jobId: string, owner: string): Promise<void>;
+    appendEvent(jobId: string, event: string, data?: DurableJobEvent['data']): Promise<DurableJobEvent>;
+    readEvents(jobId: string, options?: {
+        after?: number;
+        limit?: number;
+        waitMs?: number;
+    }): Promise<DurableJobEventPage>;
+    wait<TResult = unknown>(jobId: string, options?: {
+        timeoutMs?: number;
+    }): Promise<{
+        status: 'completed';
+        result: TResult;
+    } | {
+        status: 'failed';
+        error: string;
+    } | {
+        status: 'cancelled';
+    }>;
+    complete(jobId: string, result: JsonValue): Promise<void>;
+    fail(jobId: string, error: string): Promise<void>;
+    cancel(jobId: string): Promise<void>;
+    peek(jobId: string): Promise<Outcome>;
+}
+/** Greppable marker every drained dead-letter message emits (alertable). */
+export declare const DLQ_ERROR_MARKER = "[VIBES-ERR jobs dlq]";
+/** Fixed DeadLetterStore DO instance name — one rolling log per worker. */
+export declare const DEAD_LETTER_STORE_NAME = "dead-letter-log";
+/** Default retention for a persisted dead-letter record (14 days). */
+export declare const DEAD_LETTER_TTL_MS: number;
+/** Storage-key prefix for persisted dead-letter records. */
+export declare const DEAD_LETTER_KEY_PREFIX = "dlq:";
+/** A persisted failed-message record, kept for inspection and replay. */
+export declare const DeadLetterRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    queue: z.ZodString;
+    jobType: z.ZodNullable<z.ZodString>;
+    jobId: z.ZodNullable<z.ZodString>;
+    body: z.ZodType<JsonValue, JsonValue, z.core.$ZodTypeInternals<JsonValue, JsonValue>>;
+    failedAt: z.ZodString;
+    error: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type DeadLetterRecord = z.infer<typeof DeadLetterRecordSchema>;
+/** Storage surface the DeadLetterStore state machine needs (DO `ctx.storage`). */
+export interface DeadLetterStorage {
+    getAlarm(): Promise<number | null>;
+    get(key: string): Promise<JsonValue | undefined>;
+    put(key: string, value: JsonValue): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    list(options: {
+        prefix: string;
+    }): Promise<Map<string, JsonValue>>;
+    setAlarm(when: number): Promise<void>;
+}
+/** RPC surface the drainer calls on a DeadLetterStore DO stub. */
+export interface DeadLetterStoreStub {
+    record(record: DeadLetterRecord): Promise<void>;
+    list(options?: {
+        limit?: number;
+    }): Promise<DeadLetterRecord[]>;
+    get(id: string): Promise<DeadLetterRecord | undefined>;
+    purge(id: string): Promise<boolean>;
+    stats(): Promise<{
+        count: number;
+        oldestFailedAt: string | null;
+    }>;
+}
+export interface Flow extends FlowSpawner {
+    fire<TData = unknown>(type: string, data: TData, options?: FlowSpawnOptions): Promise<string>;
+}
+export interface FlowSpawner {
+    spawn<TChildData = unknown>(type: string, data: TChildData, options?: FlowSpawnOptions): Promise<string>;
+    wait<TChildResult = unknown>(jobId: string): Promise<TChildResult>;
+    spawnMany<TChildData = unknown>(jobs: Array<{
+        type: string;
+        data: TChildData;
+        options?: FlowSpawnOptions;
+    }>): Promise<string[]>;
+    spawnWithEvents<TChildData = unknown, TChildResult = unknown>(type: string, data: TChildData, options?: FlowSpawnOptions): SubtaskEventStream<TChildResult>;
+}
+export interface FlowSpawnOptions {
+    /** The spawned job's queue metadata. */
+    metadata?: JobMetadataRecord;
+    priority?: number;
+    signal?: AbortSignal;
+    /** Attribution captured before cancellation crosses the flow boundary. */
+    cancellation?: import('../../schemas/cancellation.ts').CancellationAttribution;
+    /** The spawned job's admission id, a dedupe key: an id whose job still stands reattaches to it. */
+    jobId?: string;
+    /** Parent attempt authority for reattaching a graph-owned admission. */
+    resume?: import('../../core/schemas/resume.ts').ResumeAdmission;
+}
+export interface ResolvedSchedulerConfig {
+    enabled: boolean;
+    pollIntervalMs: number;
+}
+export interface WorkerRuntimeConfig {
+    runtime: VibesRuntime;
+    hardware: HardwareType;
+    workers: WorkerImplementation[];
+    adapter: WorkerAdapterInterface;
+    verbose?: boolean;
+    usageAggregator?: import('../usage-aggregator.ts').UsageAggregator;
+    /**
+     * This runtime is its host's consumer for every queue on its hardware, so it
+     * also serves declared workers without a class and queues no worker
+     * declares. Leave unset for a runtime that serves a selected subset.
+     */
+    servesAllQueues?: boolean;
+}
+export interface WorkerRuntimeState {
+    workers: Map<string, unknown>;
+    handlers: Map<string, unknown>;
+    queues: Map<string, unknown>;
+}
+export interface WorkerRuntimeMetrics {
+    activeJobs: number;
+    completedJobs: number;
+    failedJobs: number;
+    averageLatencyMs: number;
+}
+export interface JobContextConfig {
+    jobId: string;
+    jobName: string;
+    queueName: string;
+    workerId: string;
+    attempt: number;
+    maxRetries: number;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/runtime/schemas/index.js

@@ -0,0 +1,56 @@
+/**
+ * Worker Runtime Schemas
+ */
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import * as z from 'zod/v4';
+// Job Result Store State
+export const OutcomeSchema = z.discriminatedUnion('status', [
+    z.object({ status: z.literal('pending') }),
+    z.object({ status: z.literal('completed'), result: JsonValueSchema }),
+    z.object({ status: z.literal('failed'), error: z.string() }),
+    z.object({ status: z.literal('cancelled') }),
+    z.object({ status: z.literal('unknown') })
+]);
+export const STATE_KEY = 'state';
+export const DEFAULT_TTL_MS = 35 * 60_000;
+export const DurableJobEventSchema = z.object({
+    cursor: z.number(),
+    event: z.string(),
+    data: JsonValueSchema.optional(),
+    timestamp: z.string()
+});
+// Dead-Letter Store
+//
+// A job that exhausts its retries lands in the queue's dead-letter queue
+// (DLQ). Without a consumer that message is silently lost. The DLQ drainer
+// reads the DLQ, writes a greppable `[VIBES-ERR jobs dlq]` marker, and
+// persists the failed message into the DeadLetterStore Durable Object so it
+// stays visible and replayable. The DO mirrors the JobResultStore discipline:
+// a single instance, `ctx.storage`-backed, with an `alarm()` TTL sweep that
+// caps retention so the store can never grow unbounded.
+/** Greppable marker every drained dead-letter message emits (alertable). */
+export const DLQ_ERROR_MARKER = '[VIBES-ERR jobs dlq]';
+/** Fixed DeadLetterStore DO instance name — one rolling log per worker. */
+export const DEAD_LETTER_STORE_NAME = 'dead-letter-log';
+/** Default retention for a persisted dead-letter record (14 days). */
+export const DEAD_LETTER_TTL_MS = 14 * 24 * 60 * 60_000;
+/** Storage-key prefix for persisted dead-letter records. */
+export const DEAD_LETTER_KEY_PREFIX = 'dlq:';
+/** A persisted failed-message record, kept for inspection and replay. */
+export const DeadLetterRecordSchema = z.object({
+    /** CF Queue message id (also the storage key suffix). */
+    id: z.string(),
+    /** Origin queue the message was drained from (the DLQ name). */
+    queue: z.string(),
+    /** Resolved job type from the message body, when present. */
+    jobType: z.string().nullable(),
+    /** Resolved job id from the message body, when present. */
+    jobId: z.string().nullable(),
+    /** The original message body, verbatim, for replay. */
+    body: JsonValueSchema,
+    /** ISO timestamp the drainer observed the dead letter. */
+    failedAt: z.string(),
+    /** Free-form failure detail, when known. */
+    error: z.string().nullable()
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/schemas/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAkB,MAAM,kCAAkC,CAAC;AACnF,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAO5B,yBAAyB;AACzB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE;IAC3D,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;IAC1C,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IACrE,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAC5D,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;IAC5C,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;CAC1C,CAAC,CAAC;AAYH,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC;AACjC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,GAAG,MAAM,CAAC;AAE1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,eAAe,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC;AAyCH,oBAAoB;AACpB,EAAE;AACF,yEAAyE;AACzE,2EAA2E;AAC3E,uEAAuE;AACvE,4EAA4E;AAC5E,8EAA8E;AAC9E,4EAA4E;AAC5E,wDAAwD;AAExD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEvD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,sBAAsB,GAAG,iBAAiB,CAAC;AAExD,sEAAsE;AACtE,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;AAExD,4DAA4D;AAC5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE7C,yEAAyE;AACzE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,yDAAyD;IACzD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,gEAAgE;IAChE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,6DAA6D;IAC7D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,2DAA2D;IAC3D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,uDAAuD;IACvD,IAAI,EAAE,eAAe;IACrB,0DAA0D;IAC1D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,4CAA4C;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC"}

package/dist/runtime/served-jobs.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Served jobs — which job types a queue consumer runs, derived from the
+ * registry.
+ *
+ * Declaring a `workers/job` on a queue is enough for it to run: a worker on
+ * that queue serves every enabled job for its hardware that names the queue
+ * and claim partition and has an implementation here. A queue that background
+ * jobs name but no worker descriptor serves is reported so the runtime can
+ * serve it anyway.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { WorkerImplementation } from '../kinds/schemas/index.ts';
+import type { WorkerAssetDescriptor } from '../schemas/descriptors.ts';
+type QueueConsumer = Pick<WorkerAssetDescriptor, 'queue' | 'claimPartition'>;
+/** Whether one of `consumers` already serves `candidate`'s queue and claim partition. */
+export declare function servesSameQueue(consumers: QueueConsumer[], candidate: QueueConsumer): boolean;
+/** Job types a consumer of `worker.queue` (and its claim partition) serves on this hardware. */
+export declare function servedJobTypes(runtime: VibesRuntime, hardware: string, worker: QueueConsumer): string[];
+/**
+ * Queues that background jobs name on this hardware with no declared worker.
+ * Each entry is a queue consumer the runtime can serve, with the jobs waiting on it.
+ */
+export declare function unservedQueues(runtime: VibesRuntime, hardware: string, workers: QueueConsumer[]): Array<QueueConsumer & {
+    queue: string;
+    jobs: string[];
+}>;
+/** The descriptor of a worker for a queue no worker declares: one runner, this hardware only. */
+export declare function undeclaredQueueWorker(entry: QueueConsumer & {
+    queue: string;
+}, hardware: string): WorkerAssetDescriptor;
+/** A queue consumer with no class of its own: it serves whatever the registry puts on its queue. */
+export declare function queueConsumerWorker(descriptor: WorkerAssetDescriptor): WorkerImplementation<WorkerAssetDescriptor>;
+export {};
+//# sourceMappingURL=served-jobs.d.ts.map

package/dist/runtime/served-jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"served-jobs.d.ts","sourceRoot":"","sources":["../../src/runtime/served-jobs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAsB,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAG3F,KAAK,aAAa,GAAG,IAAI,CAAC,qBAAqB,EAAE,OAAO,GAAG,gBAAgB,CAAC,CAAC;AAkB7E,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,SAAS,EAAE,aAAa,EAAE,EAAE,SAAS,EAAE,aAAa,GAAG,OAAO,CAM7F;AAED,gGAAgG;AAChG,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAKvG;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC7B,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa,EAAE,GACtB,KAAK,CAAC,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAY1D;AAED,iGAAiG;AACjG,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EACxC,QAAQ,EAAE,MAAM,GACd,qBAAqB,CAcvB;AAED,oGAAoG;AACpG,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,qBAAqB,GAAG,oBAAoB,CAAC,qBAAqB,CAAC,CAOlH"}

package/dist/runtime/served-jobs.js

@@ -0,0 +1,87 @@
+/**
+ * Served jobs — which job types a queue consumer runs, derived from the
+ * registry.
+ *
+ * Declaring a `workers/job` on a queue is enough for it to run: a worker on
+ * that queue serves every enabled job for its hardware that names the queue
+ * and claim partition and has an implementation here. A queue that background
+ * jobs name but no worker descriptor serves is reported so the runtime can
+ * serve it anyway.
+ */
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+import { workerClaimPartitionsMatch } from "../schemas/claim.js";
+function partitionsMatch(worker, job) {
+    if (!worker || !job)
+        return !worker && !job;
+    return workerClaimPartitionsMatch(worker, job);
+}
+function runnableJobs(runtime, hardware) {
+    if (!runtime.hasKind('workers/job'))
+        return [];
+    const available = new Set(runtime.assets('workers/job').available());
+    return runtime
+        .query('workers/job')
+        .forHardware(hardware)
+        .enabled()
+        .descriptors()
+        .filter((job) => job.queue !== undefined && job.queue.length > 0 && available.has(job.id));
+}
+/** Whether one of `consumers` already serves `candidate`'s queue and claim partition. */
+export function servesSameQueue(consumers, candidate) {
+    return consumers.some((consumer) => consumer.queue === candidate.queue &&
+        partitionsMatch(consumer.claimPartition, candidate.claimPartition));
+}
+/** Job types a consumer of `worker.queue` (and its claim partition) serves on this hardware. */
+export function servedJobTypes(runtime, hardware, worker) {
+    if (!worker.queue)
+        return [];
+    return runnableJobs(runtime, hardware)
+        .filter((job) => job.queue === worker.queue && partitionsMatch(worker.claimPartition, job.claim?.partition))
+        .map((job) => job.id);
+}
+/**
+ * Queues that background jobs name on this hardware with no declared worker.
+ * Each entry is a queue consumer the runtime can serve, with the jobs waiting on it.
+ */
+export function unservedQueues(runtime, hardware, workers) {
+    const unserved = new Map();
+    for (const job of runnableJobs(runtime, hardware)) {
+        if (job.dispatch === 'inline')
+            continue;
+        const partition = job.claim?.partition;
+        if (servesSameQueue(workers, { queue: job.queue, claimPartition: partition }))
+            continue;
+        const key = partition ? `${job.queue}#${JSON.stringify(partition)}` : job.queue;
+        const entry = unserved.get(key) ?? { queue: job.queue, claimPartition: partition, jobs: [] };
+        entry.jobs.push(job.id);
+        unserved.set(key, entry);
+    }
+    return [...unserved.values()];
+}
+/** The descriptor of a worker for a queue no worker declares: one runner, this hardware only. */
+export function undeclaredQueueWorker(entry, hardware) {
+    const partition = entry.claimPartition;
+    const suffix = partition ? `.${partition.family}-v${partition.version}` : '';
+    const consumer = {
+        kind: 'workers/worker',
+        id: `workers.queue.${entry.queue}${suffix}`,
+        name: `Queue ${entry.queue}`,
+        description: 'Serves a queue that background jobs name and no worker declares',
+        queue: entry.queue,
+        concurrency: 1,
+        hardware: [hardware]
+    };
+    if (partition)
+        consumer.claimPartition = partition;
+    return createRuntimeAsset(consumer);
+}
+/** A queue consumer with no class of its own: it serves whatever the registry puts on its queue. */
+export function queueConsumerWorker(descriptor) {
+    return {
+        id: descriptor.id,
+        descriptor,
+        getHandlerIds: () => [],
+        canRunOnHardware: () => true
+    };
+}
+//# sourceMappingURL=served-jobs.js.map

package/dist/runtime/served-jobs.js.map

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

package/dist/runtime/services.consumer.plugin.d.ts

@@ -0,0 +1,3 @@
+declare const workersConsumerServicesPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default workersConsumerServicesPlugin;
+//# sourceMappingURL=services.consumer.plugin.d.ts.map

package/dist/runtime/services.consumer.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.consumer.plugin.d.ts","sourceRoot":"","sources":["../../src/runtime/services.consumer.plugin.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,6BAA6B,6CAMjC,CAAC;AAEH,eAAe,6BAA6B,CAAC"}

package/dist/runtime/services.consumer.plugin.js

@@ -0,0 +1,11 @@
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import { getVibesClient } from '@vibesdotdev/kernel/client';
+const workersConsumerServicesPlugin = createRuntimePlugin({
+    id: 'workers-consumer-services',
+    dependencies: ['runtime-client'],
+    descriptors: [{ kind: 'runtime/client', id: 'workers.consumer' }],
+    loaders: [loader('workers.consumer', { kind: 'runtime/client' }, () => import("./consumer-client.js"))],
+    async onRegister(runtime) { await getVibesClient('workers.consumer', runtime); }
+});
+export default workersConsumerServicesPlugin;
+//# sourceMappingURL=services.consumer.plugin.js.map

package/dist/runtime/services.consumer.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.consumer.plugin.js","sourceRoot":"","sources":["../../src/runtime/services.consumer.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,MAAM,6BAA6B,GAAG,mBAAmB,CAAC;IACzD,EAAE,EAAE,2BAA2B;IAC/B,YAAY,EAAE,CAAC,gBAAgB,CAAC;IAChC,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,kBAAkB,EAAE,CAAC;IACjE,OAAO,EAAE,CAAC,MAAM,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC;IACvG,KAAK,CAAC,UAAU,CAAC,OAAO,IAAI,MAAM,cAAc,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CAChF,CAAC,CAAC;AAEH,eAAe,6BAA6B,CAAC"}