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

package/dist/dead-letter/dead-letter-store.impl.consumer.js

@@ -0,0 +1,71 @@
+/**
+ * Consumer dead-letter store over the `workers.dead-letter` localdb record.
+ */
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+import { DeadLetterQuerySchema } from "./dead-letter.schema.js";
+import { DEAD_LETTER_RECORD_ID } from "./dead-letter.record.descriptor.js";
+export const consumerDeadLetterStoreDescriptor = createRuntimeAsset({
+    kind: 'workers/dead-letter-store',
+    id: 'workers.dead-letter-store.consumer',
+    name: 'Consumer dead letters',
+    description: 'Dead letters in the workspace workers.db',
+    hardware: ['consumer']
+});
+export class ConsumerDeadLetterStore {
+    runtime;
+    constructor(_descriptor, context) {
+        if (!context.runtime) {
+            throw new Error('ConsumerDeadLetterStore requires runtime in KindContext');
+        }
+        this.runtime = context.runtime;
+    }
+    async records() {
+        const rec = await this.runtime
+            .query('storage/record')
+            .withId(DEAD_LETTER_RECORD_ID)
+            .resolve();
+        if (!rec) {
+            throw new Error(`Record ${DEAD_LETTER_RECORD_ID} not found`);
+        }
+        return rec;
+    }
+    async record(entry) {
+        const row = { ...entry, status: 'dead', replays: [] };
+        await (await this.records()).upsert(row.id, row, row);
+    }
+    async get(id) {
+        return (await this.records()).get(id);
+    }
+    async list(query = {}) {
+        const { limit, queue, jobType, status } = DeadLetterQuerySchema.parse(query);
+        const where = {};
+        if (queue !== undefined)
+            where.queue = queue;
+        if (jobType !== undefined)
+            where.jobType = jobType;
+        if (status !== undefined)
+            where.status = status;
+        const result = await (await this.records()).list({
+            where,
+            orderBy: { failedAt: 'desc' },
+            limit
+        });
+        return result.items;
+    }
+    async markReplayed(id, replayJobId) {
+        const records = await this.records();
+        const entry = await records.get(id);
+        if (!entry)
+            throw new Error(`No dead letter '${id}'`);
+        return records.update(id, {
+            status: 'replayed',
+            replays: [...entry.replays, { at: new Date().toISOString(), jobId: replayJobId }]
+        });
+    }
+    async purge(id) {
+        const result = await (await this.records()).delete(id, { force: true });
+        return result.count > 0;
+    }
+}
+export default ConsumerDeadLetterStore;
+//# sourceMappingURL=dead-letter-store.impl.consumer.js.map

package/dist/dead-letter/dead-letter-store.impl.consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter-store.impl.consumer.js","sourceRoot":"","sources":["../../src/dead-letter/dead-letter-store.impl.consumer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAA6C,MAAM,qBAAqB,CAAC;AAKpG,OAAO,EAAE,qBAAqB,EAA8C,MAAM,yBAAyB,CAAC;AAC5G,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,MAAM,CAAC,MAAM,iCAAiC,GAAG,kBAAkB,CAAC;IACnE,IAAI,EAAE,2BAA2B;IACjC,EAAE,EAAE,oCAAoC;IACxC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EAAE,0CAA0C;IACvD,QAAQ,EAAE,CAAC,UAAU,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,OAAO,uBAAuB;IAClB,OAAO,CAAe;IAEvC,YAAY,WAA8B,EAAE,OAAiD;QAC5F,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,CAAC;IAEO,KAAK,CAAC,OAAO;QACpB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO;aAC5B,KAAK,CAA6D,gBAAgB,CAAC;aACnF,MAAM,CAAC,qBAAqB,CAAC;aAC7B,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC,GAAG,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,UAAU,qBAAqB,YAAY,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,GAAG,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAkD;QAC9D,MAAM,GAAG,GAAoB,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QACvE,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QACnB,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAyB,EAAE;QACrC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAiC,EAAE,CAAC;QAC/C,IAAI,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QAC7C,IAAI,OAAO,KAAK,SAAS;YAAE,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;QACnD,IAAI,MAAM,KAAK,SAAS;YAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QAChD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC;YAChD,KAAK;YACL,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE;YAC7B,KAAK;SACL,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,EAAU,EAAE,WAAmB;QACjD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;QACtD,OAAO,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE;YACzB,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;SACjF,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,EAAU;QACrB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,OAAO,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;IACzB,CAAC;CACD;AAED,eAAe,uBAAuB,CAAC"}

package/dist/dead-letter/dead-letter-store.kind.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `workers/dead-letter-store` — where a job that failed every attempt is kept.
+ * Each host binds one implementation for its hardware: localdb on the
+ * consumer, the Durable Object on Cloudflare. There is no default: a host
+ * without one says so instead of pretending to keep dead letters.
+ */
+import { type DeadLetterEntry, type DeadLetterQuery } from './dead-letter.schema.ts';
+export interface DeadLetterStore {
+    record(entry: Omit<DeadLetterEntry, 'status' | 'replays'>): Promise<void>;
+    get(id: string): Promise<DeadLetterEntry | null>;
+    list(query?: DeadLetterQuery): Promise<DeadLetterEntry[]>;
+    markReplayed(id: string, replayJobId: string): Promise<DeadLetterEntry>;
+    purge(id: string): Promise<boolean>;
+}
+export declare const deadLetterStoreKind: {
+    id: string;
+    descriptorSchema: import("zod").ZodObject<{
+        [x: string]: any;
+    }, import("zod/v4/core").$strip>;
+    contexts: never[];
+};
+//# sourceMappingURL=dead-letter-store.kind.d.ts.map

package/dist/dead-letter/dead-letter-store.kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter-store.kind.d.ts","sourceRoot":"","sources":["../../src/dead-letter/dead-letter-store.kind.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAmC,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEtH,MAAM,WAAW,eAAe;IAC/B,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACjD,IAAI,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC1D,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACxE,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpC;AAED,eAAO,MAAM,mBAAmB;;;;;;CAIC,CAAC"}

package/dist/dead-letter/dead-letter-store.kind.js

@@ -0,0 +1,13 @@
+/**
+ * `workers/dead-letter-store` — where a job that failed every attempt is kept.
+ * Each host binds one implementation for its hardware: localdb on the
+ * consumer, the Durable Object on Cloudflare. There is no default: a host
+ * without one says so instead of pretending to keep dead letters.
+ */
+import { DeadLetterStoreDescriptorSchema } from "./dead-letter.schema.js";
+export const deadLetterStoreKind = {
+    id: 'workers/dead-letter-store',
+    descriptorSchema: DeadLetterStoreDescriptorSchema,
+    contexts: []
+};
+//# sourceMappingURL=dead-letter-store.kind.js.map

package/dist/dead-letter/dead-letter-store.kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter-store.kind.js","sourceRoot":"","sources":["../../src/dead-letter/dead-letter-store.kind.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,+BAA+B,EAA8C,MAAM,yBAAyB,CAAC;AAUtH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAClC,EAAE,EAAE,2BAA2B;IAC/B,gBAAgB,EAAE,+BAA+B;IACjD,QAAQ,EAAE,EAAE;CACoB,CAAC"}

package/dist/dead-letter/dead-letter.record.descriptor.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Consumer dead letters: one row per job that failed every attempt.
+ */
+import type { StorageRecordDescriptorInput } from '@vibesdotdev/storage/schemas/record';
+export declare const DEAD_LETTER_RECORD_ID = "workers.dead-letter";
+export declare const deadLetterRecordDescriptor: StorageRecordDescriptorInput;
+export default deadLetterRecordDescriptor;
+//# sourceMappingURL=dead-letter.record.descriptor.d.ts.map

package/dist/dead-letter/dead-letter.record.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter.record.descriptor.d.ts","sourceRoot":"","sources":["../../src/dead-letter/dead-letter.record.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAGxF,eAAO,MAAM,qBAAqB,wBAAwB,CAAC;AAE3D,eAAO,MAAM,0BAA0B,EAAE,4BAmCxC,CAAC;AAEF,eAAe,0BAA0B,CAAC"}

package/dist/dead-letter/dead-letter.record.descriptor.js

@@ -0,0 +1,42 @@
+/**
+ * Consumer dead letters: one row per job that failed every attempt.
+ */
+import { DeadLetterEntrySchema } from "./dead-letter.schema.js";
+export const DEAD_LETTER_RECORD_ID = 'workers.dead-letter';
+export const deadLetterRecordDescriptor = {
+    kind: 'storage/record',
+    id: DEAD_LETTER_RECORD_ID,
+    name: 'Workers Dead Letters',
+    description: 'Jobs that failed every attempt, kept for inspection and replay',
+    retention: {
+        maxAgeDays: 30,
+        ageField: 'failedAt',
+        reason: 'A dead letter is for a person to look at and replay. Thirty days covers a release cycle; ' +
+            'older failures have been fixed or forgotten.'
+    },
+    schema: DeadLetterEntrySchema,
+    tableName: 'workers_dead_letters',
+    primaryKey: 'id',
+    relations: {},
+    indexes: [
+        { fields: ['status', 'failedAt'], unique: false },
+        { fields: ['jobType'], unique: false }
+    ],
+    version: 1,
+    timestamps: false,
+    autoId: false,
+    allowedAdapters: ['storage.localdb'],
+    defaultAdapter: 'storage.localdb',
+    adapterConfig: { 'storage.localdb': { dbName: 'workers.db', scope: 'project' } },
+    scope: 'project',
+    validateOnWrite: false,
+    validateOnRead: false,
+    versioning: false,
+    audit: false,
+    changeTracking: false,
+    internal: false,
+    namespace: DEAD_LETTER_RECORD_ID,
+    tags: ['workers', 'dead-letter', 'tenancy:project']
+};
+export default deadLetterRecordDescriptor;
+//# sourceMappingURL=dead-letter.record.descriptor.js.map

package/dist/dead-letter/dead-letter.record.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter.record.descriptor.js","sourceRoot":"","sources":["../../src/dead-letter/dead-letter.record.descriptor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,CAAC,MAAM,qBAAqB,GAAG,qBAAqB,CAAC;AAE3D,MAAM,CAAC,MAAM,0BAA0B,GAAiC;IACvE,IAAI,EAAE,gBAAgB;IACtB,EAAE,EAAE,qBAAqB;IACzB,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,gEAAgE;IAC7E,SAAS,EAAE;QACV,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,UAAU;QACpB,MAAM,EACL,2FAA2F;YAC3F,8CAA8C;KAC/C;IACD,MAAM,EAAE,qBAAqB;IAC7B,SAAS,EAAE,sBAAsB;IACjC,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,EAAE;IACb,OAAO,EAAE;QACR,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE;QACjD,EAAE,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE;KACtC;IACD,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,KAAK;IACjB,MAAM,EAAE,KAAK;IACb,eAAe,EAAE,CAAC,iBAAiB,CAAC;IACpC,cAAc,EAAE,iBAAiB;IACjC,aAAa,EAAE,EAAE,iBAAiB,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;IAChF,KAAK,EAAE,SAAS;IAChB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,KAAK;IACrB,UAAU,EAAE,KAAK;IACjB,KAAK,EAAE,KAAK;IACZ,cAAc,EAAE,KAAK;IACrB,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,qBAAqB;IAChC,IAAI,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,iBAAiB,CAAC;CACnD,CAAC;AAEF,eAAe,0BAA0B,CAAC"}

package/dist/dead-letter/dead-letter.schema.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Dead letters — jobs that failed every attempt, kept so they can be seen and
+ * replayed instead of disappearing after their last retry.
+ */
+import * as z from 'zod/v4';
+export declare const DeadLetterStatusSchema: z.ZodEnum<{
+    dead: "dead";
+    replayed: "replayed";
+    purged: "purged";
+}>;
+export declare const DeadLetterEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    jobType: z.ZodString;
+    queue: z.ZodString;
+    attempts: z.ZodNumber;
+    lastError: z.ZodString;
+    failedAt: z.ZodString;
+    payload: z.ZodUnknown;
+    status: z.ZodEnum<{
+        dead: "dead";
+        replayed: "replayed";
+        purged: "purged";
+    }>;
+    replays: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        at: z.ZodString;
+        jobId: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type DeadLetterEntry = z.infer<typeof DeadLetterEntrySchema>;
+export declare const DeadLetterQuerySchema: z.ZodObject<{
+    queue: z.ZodOptional<z.ZodString>;
+    jobType: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        dead: "dead";
+        replayed: "replayed";
+        purged: "purged";
+    }>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type DeadLetterQuery = z.input<typeof DeadLetterQuerySchema>;
+export declare const DeadLetterStoreDescriptorSchema: z.ZodObject<{
+    [x: string]: any;
+}, z.core.$strip>;
+//# sourceMappingURL=dead-letter.schema.d.ts.map

package/dist/dead-letter/dead-letter.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter.schema.d.ts","sourceRoot":"","sources":["../../src/dead-letter/dead-letter.schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,sBAAsB;;;;EAAyC,CAAC;AAE7E,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;iBAahC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,qBAAqB;;;;;;;;;iBAKhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,+BAA+B;;iBAG3C,CAAC"}

package/dist/dead-letter/dead-letter.schema.js

@@ -0,0 +1,29 @@
+/**
+ * Dead letters — jobs that failed every attempt, kept so they can be seen and
+ * replayed instead of disappearing after their last retry.
+ */
+import * as z from 'zod/v4';
+import { createRuntimeAssetSchema } from '@vibesdotdev/kernel';
+export const DeadLetterStatusSchema = z.enum(['dead', 'replayed', 'purged']);
+export const DeadLetterEntrySchema = z.object({
+    /** The failed job's queue id. */
+    id: z.string().min(1),
+    jobType: z.string().min(1),
+    /** Logical queue from the job descriptor. */
+    queue: z.string().min(1),
+    attempts: z.number().int().positive(),
+    lastError: z.string(),
+    failedAt: z.string().datetime(),
+    /** The job's input, replayed as-is. */
+    payload: z.unknown(),
+    status: DeadLetterStatusSchema,
+    replays: z.array(z.object({ at: z.string().datetime(), jobId: z.string().min(1) })).default([])
+});
+export const DeadLetterQuerySchema = z.object({
+    queue: z.string().optional(),
+    jobType: z.string().optional(),
+    status: DeadLetterStatusSchema.optional(),
+    limit: z.number().int().positive().max(500).default(50)
+});
+export const DeadLetterStoreDescriptorSchema = createRuntimeAssetSchema('workers/dead-letter-store', z.object({ hardware: z.array(z.enum(['consumer', 'cloud'])).optional() }));
+//# sourceMappingURL=dead-letter.schema.js.map

package/dist/dead-letter/dead-letter.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter.schema.js","sourceRoot":"","sources":["../../src/dead-letter/dead-letter.schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,iCAAiC;IACjC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,6CAA6C;IAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,uCAAuC;IACvC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,MAAM,EAAE,sBAAsB;IAC9B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC/F,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,sBAAsB,CAAC,QAAQ,EAAE;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACvD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,+BAA+B,GAAG,wBAAwB,CACtE,2BAA2B,EAC3B,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CACzE,CAAC"}

package/dist/dead-letter/dead-letters.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Dead-letter access for the runner, the replay job and the CLI: resolve the
+ * store bound for this host, record, and replay.
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { DeadLetterStore } from './dead-letter-store.kind.ts';
+import type { DeadLetterEntry } from './dead-letter.schema.ts';
+/** The dead-letter store for this host's hardware; throws naming the kind when none is bound. */
+export declare function resolveDeadLetterStore(runtime: VibesRuntime): Promise<DeadLetterStore>;
+/**
+ * Keep a job that failed every attempt. Recording never changes the job's
+ * outcome: a host without a store says so once and keeps running jobs.
+ */
+export declare function recordDeadLetter(runtime: VibesRuntime, entry: Omit<DeadLetterEntry, 'status' | 'replays'>): Promise<void>;
+/** Enqueue a dead letter's job again with its original input, as `<id>:replay:<n>`. */
+export declare function replayDeadLetter(runtime: VibesRuntime, id: string): Promise<DeadLetterEntry>;
+//# sourceMappingURL=dead-letters.d.ts.map

package/dist/dead-letter/dead-letters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letters.d.ts","sourceRoot":"","sources":["../../src/dead-letter/dead-letters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAqB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAI3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAI/D,iGAAiG;AACjG,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAc5F;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,SAAS,CAAC,GAChD,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,uFAAuF;AACvF,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CASlG"}

package/dist/dead-letter/dead-letters.js

@@ -0,0 +1,58 @@
+/**
+ * Dead-letter access for the runner, the replay job and the CLI: resolve the
+ * store bound for this host, record, and replay.
+ */
+import { getLogger } from '@vibesdotdev/logging';
+import { settle } from "../core/settle.js";
+import { getWorkersClient } from "../client/get-workers-client.js";
+const unavailableWarned = new WeakSet();
+/** The dead-letter store for this host's hardware; throws naming the kind when none is bound. */
+export async function resolveDeadLetterStore(runtime) {
+    const hardware = String(runtime.scope?.hardware);
+    if (!runtime.hasKind('workers/dead-letter-store')) {
+        throw new Error(`No workers/dead-letter-store resolves for scope ${hardware}`);
+    }
+    const store = await runtime
+        .query('workers/dead-letter-store')
+        .forHardware(hardware)
+        .enabled()
+        .resolve();
+    if (!store) {
+        throw new Error(`No workers/dead-letter-store resolves for scope ${hardware}`);
+    }
+    return store;
+}
+/**
+ * Keep a job that failed every attempt. Recording never changes the job's
+ * outcome: a host without a store says so once and keeps running jobs.
+ */
+export async function recordDeadLetter(runtime, entry) {
+    const outcome = await settle(async () => {
+        const store = await resolveDeadLetterStore(runtime);
+        await store.record(entry);
+    });
+    if (outcome.ok)
+        return;
+    if (unavailableWarned.has(runtime))
+        return;
+    unavailableWarned.add(runtime);
+    const errorMsg = outcome.caught instanceof Error ? outcome.caught.message : outcome.caught.description;
+    getLogger('worker-runtime', runtime).child('dead-letter').warn('Dead letters are not kept on this host; a job that fails every attempt is only marked failed', {
+        jobId: entry.id,
+        error: errorMsg
+    });
+}
+/** Enqueue a dead letter's job again with its original input, as `<id>:replay:<n>`. */
+export async function replayDeadLetter(runtime, id) {
+    const store = await resolveDeadLetterStore(runtime);
+    const entry = await store.get(id);
+    if (!entry)
+        throw new Error(`No dead letter '${id}'`);
+    if (entry.status === 'purged')
+        throw new Error(`Dead letter '${id}' was purged`);
+    const replayJobId = `${id}:replay:${entry.replays.length + 1}`;
+    const workers = await getWorkersClient(runtime);
+    await workers.startJob(entry.jobType, entry.payload, { jobId: replayJobId });
+    return store.markReplayed(id, replayJobId);
+}
+//# sourceMappingURL=dead-letters.js.map

package/dist/dead-letter/dead-letters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letters.js","sourceRoot":"","sources":["../../src/dead-letter/dead-letters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAInE,MAAM,iBAAiB,GAAG,IAAI,OAAO,EAAU,CAAC;AAEhD,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,OAAqB;IACjE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACjD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,2BAA2B,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,mDAAmD,QAAQ,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,OAAO;SACzB,KAAK,CAAqC,2BAA2B,CAAC;SACtE,WAAW,CAAC,QAAQ,CAAC;SACrB,OAAO,EAAE;SACT,OAAO,EAAE,CAAC;IACZ,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,mDAAmD,QAAQ,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,OAAqB,EACrB,KAAkD;IAElD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,IAAI,EAAE;QACvC,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACpD,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,EAAE;QAAE,OAAO;IACvB,IAAI,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAC3C,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;IACvG,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,8FAA8F,EAAE;QAC9J,KAAK,EAAE,KAAK,CAAC,EAAE;QACf,KAAK,EAAE,QAAQ;KACf,CAAC,CAAC;AACJ,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAqB,EAAE,EAAU;IACvE,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClC,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IACtD,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;IACjF,MAAM,WAAW,GAAG,GAAG,EAAE,WAAW,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IAC/D,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IAC7E,OAAO,KAAK,CAAC,YAAY,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;AAC5C,CAAC"}

package/dist/dead-letter/workers.dlq.replay.job.d.ts

@@ -0,0 +1,58 @@
+/**
+ * `workers.dlq.replay` — replay a dead letter. Inline: it only enqueues the
+ * original job again, so it runs wherever it is called, and the run is
+ * recorded like any other job.
+ */
+import * as z from 'zod/v4';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { JobDescriptor, JobExecutionContext, JobImplementation } from '@vibesdotdev/kernel/kinds';
+import { DeadLetterEntrySchema } from './dead-letter.schema.ts';
+export declare const DlqReplayInputSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export type DlqReplayInput = z.infer<typeof DlqReplayInputSchema>;
+type DlqReplayOutput = z.infer<typeof DeadLetterEntrySchema>;
+export declare const dlqReplayJobDescriptor: {
+    readonly kind: "workers/job";
+    readonly id: "workers.dlq.replay";
+    readonly name: "Replay a dead letter";
+    readonly description: "Enqueue a dead-lettered job again with its original input";
+    readonly dispatch: "inline";
+    readonly schemas: {
+        readonly input: z.ZodObject<{
+            id: z.ZodString;
+        }, z.core.$strip>;
+        readonly output: z.ZodObject<{
+            id: z.ZodString;
+            jobType: z.ZodString;
+            queue: z.ZodString;
+            attempts: z.ZodNumber;
+            lastError: z.ZodString;
+            failedAt: z.ZodString;
+            payload: z.ZodUnknown;
+            status: z.ZodEnum<{
+                dead: "dead";
+                replayed: "replayed";
+                purged: "purged";
+            }>;
+            replays: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                at: z.ZodString;
+                jobId: z.ZodString;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+    };
+    readonly enabled: true;
+};
+export declare class DlqReplayJob implements JobImplementation<DlqReplayInput, DlqReplayOutput> {
+    readonly descriptor: JobDescriptor;
+    private readonly context;
+    readonly id: string;
+    readonly type: "default";
+    readonly isolation: "inline";
+    constructor(descriptor: JobDescriptor, context: {
+        runtime: VibesRuntime;
+    });
+    handle(context: JobExecutionContext<DlqReplayInput>): Promise<DlqReplayOutput>;
+}
+export default DlqReplayJob;
+//# sourceMappingURL=workers.dlq.replay.job.d.ts.map

package/dist/dead-letter/workers.dlq.replay.job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.dlq.replay.job.d.ts","sourceRoot":"","sources":["../../src/dead-letter/workers.dlq.replay.job.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEvG,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,oBAAoB;;iBAAsC,CAAC;AACxE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,KAAK,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE7D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQjC,CAAC;AAEH,qBAAa,YAAa,YAAW,iBAAiB,CAAC,cAAc,EAAE,eAAe,CAAC;IAMrF,QAAQ,CAAC,UAAU,EAAE,aAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO;IANzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IACnC,QAAQ,CAAC,SAAS,EAAG,QAAQ,CAAU;gBAG7B,UAAU,EAAE,aAAa,EACjB,OAAO,EAAE;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE;IAKpD,MAAM,CAAC,OAAO,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC;CAG9E;AAED,eAAe,YAAY,CAAC"}

package/dist/dead-letter/workers.dlq.replay.job.js

@@ -0,0 +1,36 @@
+/**
+ * `workers.dlq.replay` — replay a dead letter. Inline: it only enqueues the
+ * original job again, so it runs wherever it is called, and the run is
+ * recorded like any other job.
+ */
+import * as z from 'zod/v4';
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+import { replayDeadLetter } from "./dead-letters.js";
+import { DeadLetterEntrySchema } from "./dead-letter.schema.js";
+export const DlqReplayInputSchema = z.object({ id: z.string().min(1) });
+export const dlqReplayJobDescriptor = createRuntimeAsset({
+    kind: 'workers/job',
+    id: 'workers.dlq.replay',
+    name: 'Replay a dead letter',
+    description: 'Enqueue a dead-lettered job again with its original input',
+    dispatch: 'inline',
+    schemas: { input: DlqReplayInputSchema, output: DeadLetterEntrySchema },
+    enabled: true
+});
+export class DlqReplayJob {
+    descriptor;
+    context;
+    id;
+    type = 'default';
+    isolation = 'inline';
+    constructor(descriptor, context) {
+        this.descriptor = descriptor;
+        this.context = context;
+        this.id = descriptor.id;
+    }
+    handle(context) {
+        return replayDeadLetter(this.context.runtime, context.data.id);
+    }
+}
+export default DlqReplayJob;
+//# sourceMappingURL=workers.dlq.replay.job.js.map

package/dist/dead-letter/workers.dlq.replay.job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.dlq.replay.job.js","sourceRoot":"","sources":["../../src/dead-letter/workers.dlq.replay.job.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAqB,MAAM,qBAAqB,CAAC;AAE5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAIxE,MAAM,CAAC,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;IACxD,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,oBAAoB;IACxB,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,2DAA2D;IACxE,QAAQ,EAAE,QAAiB;IAC3B,OAAO,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,EAAE,qBAAqB,EAAE;IACvE,OAAO,EAAE,IAAI;CACb,CAAC,CAAC;AAEH,MAAM,OAAO,YAAY;IAMd;IACQ;IANT,EAAE,CAAS;IACX,IAAI,GAAG,SAAkB,CAAC;IAC1B,SAAS,GAAG,QAAiB,CAAC;IAEvC,YACU,UAAyB,EACjB,OAAkC;QAD1C,eAAU,GAAV,UAAU,CAAe;QACjB,YAAO,GAAP,OAAO,CAA2B;QAEnD,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,OAA4C;QAClD,OAAO,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;CACD;AAED,eAAe,YAAY,CAAC"}

package/dist/dead-letter-store.d.ts

@@ -0,0 +1,3 @@
+/** Provider-neutral dead-letter persistence contract for adapter packages. */
+export * from './runtime/dead-letter-store.state.ts';
+//# sourceMappingURL=dead-letter-store.d.ts.map

package/dist/dead-letter-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter-store.d.ts","sourceRoot":"","sources":["../src/dead-letter-store.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,cAAc,sCAAsC,CAAC"}

package/dist/dead-letter-store.js

@@ -0,0 +1,3 @@
+/** Provider-neutral dead-letter persistence contract for adapter packages. */
+export * from "./runtime/dead-letter-store.state.js";
+//# sourceMappingURL=dead-letter-store.js.map

package/dist/dead-letter-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter-store.js","sourceRoot":"","sources":["../src/dead-letter-store.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,cAAc,sCAAsC,CAAC"}

package/dist/diagnostics/check-workers.d.ts

@@ -0,0 +1,13 @@
+/**
+ * checkWorkers — inspect declared job, loader and worker coverage.
+ * Never resolves implementations, starts consumers or executes jobs. Loader
+ * availability and worker declarations are not runtime or live readiness proof.
+ *
+ * It evaluates the scope of the runtime it is given, so it reports for the
+ * host it runs in. Queue matching compares the base queue and claim partition
+ * a physical queue name is derived from, so it needs no bound workspace.
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { ConformanceReport } from './conformance.schema.ts';
+export declare function checkWorkers(runtime: VibesRuntime): ConformanceReport;
+//# sourceMappingURL=check-workers.d.ts.map

package/dist/diagnostics/check-workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-workers.d.ts","sourceRoot":"","sources":["../../src/diagnostics/check-workers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAUnF,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,iBAAiB,CAsHrE"}

package/dist/diagnostics/check-workers.js

@@ -0,0 +1,126 @@
+/**
+ * checkWorkers — inspect declared job, loader and worker coverage.
+ * Never resolves implementations, starts consumers or executes jobs. Loader
+ * availability and worker declarations are not runtime or live readiness proof.
+ *
+ * It evaluates the scope of the runtime it is given, so it reports for the
+ * host it runs in. Queue matching compares the base queue and claim partition
+ * a physical queue name is derived from, so it needs no bound workspace.
+ */
+function queueKey(queue, partition) {
+    return partition ? `${queue}#${JSON.stringify(partition)}` : queue;
+}
+function readQueue(descriptor) {
+    return descriptor.queue && descriptor.queue.length > 0 ? descriptor.queue : undefined;
+}
+export function checkWorkers(runtime) {
+    const hardware = String(runtime.scope?.hardware ?? 'unknown');
+    const surface = String(runtime.scope?.surface ?? 'unknown');
+    const failures = [];
+    const warnings = [];
+    const jobs = runtime.hasKind('workers/job')
+        ? runtime.query('workers/job').forHardware(hardware).enabled().descriptors()
+        : [];
+    const withLoader = new Set(runtime.hasKind('workers/job') ? runtime.assets('workers/job').available() : []);
+    const workers = runtime.hasKind('workers/worker')
+        ? runtime.query('workers/worker').forHardware(hardware).enabled().descriptors()
+        : [];
+    if (jobs.length === 0) {
+        failures.push({
+            code: 'empty-registry',
+            subject: 'workers/job',
+            detail: `No enabled jobs are declared on ${hardware}; coverage is unmeasured. Compose the intended jobs before checking this host.`
+        });
+    }
+    for (const job of jobs) {
+        if (!withLoader.has(job.id)) {
+            failures.push({
+                code: 'job-without-loader',
+                subject: job.id,
+                detail: `No loader is registered for '${job.id}' on ${hardware}.`
+            });
+        }
+    }
+    const served = new Map();
+    for (const worker of workers) {
+        if (worker.queue && worker.queue.length > 0) {
+            served.set(queueKey(worker.queue, worker.claimPartition), worker.id);
+        }
+    }
+    const background = jobs.filter((job) => job.dispatch !== 'inline' && readQueue(job));
+    const jobsByQueue = new Map();
+    for (const job of background) {
+        const key = queueKey(readQueue(job), job.claim?.partition);
+        jobsByQueue.set(key, [...(jobsByQueue.get(key) ?? []), job.id]);
+    }
+    for (const [key, ids] of jobsByQueue) {
+        if (!served.has(key)) {
+            failures.push({
+                code: 'queue-without-worker',
+                subject: key,
+                detail: `No worker declared on ${hardware} matches this queue: ${ids.join(', ')}.`
+            });
+        }
+    }
+    const usedQueues = new Set(jobs.filter(readQueue).map((job) => queueKey(readQueue(job), job.claim?.partition)));
+    for (const [key, workerId] of served) {
+        if (!usedQueues.has(key)) {
+            failures.push({
+                code: 'worker-without-jobs',
+                subject: workerId,
+                detail: `Worker '${workerId}' declares '${key}', which no job on ${hardware} uses.`
+            });
+        }
+    }
+    const scheduled = jobs.filter((job) => Boolean(job.schedule && job.schedule.trim().length > 0));
+    let servedSchedules = 0;
+    for (const job of scheduled) {
+        const queue = readQueue(job);
+        if (queue && served.has(queueKey(queue, job.claim?.partition))) {
+            servedSchedules += 1;
+            continue;
+        }
+        failures.push({
+            code: 'schedule-without-host',
+            subject: job.id,
+            detail: `'${job.id}' declares schedule '${job.schedule}' but no worker declared on ${hardware} matches its queue.`
+        });
+    }
+    if (background.length > 0) {
+        const flows = runtime.hasKind('workers/flow') ? runtime.assets('workers/flow').available() : [];
+        if (flows.length === 0) {
+            failures.push({
+                code: 'flow-unresolved',
+                subject: 'workers/flow',
+                detail: `${background.length} background jobs exist but no workers/flow loader is registered on ${hardware}.`
+            });
+        }
+    }
+    const emitters = runtime.hasKind('workers/usage-emitter')
+        ? runtime.query('workers/usage-emitter').enabled().descriptors().length
+        : 0;
+    if (emitters === 0) {
+        warnings.push({
+            code: 'emitter-unbound',
+            subject: 'workers/usage-emitter',
+            detail: `No usage emitter is registered on ${hardware}, so work here is not metered.`
+        });
+    }
+    return {
+        hardware,
+        surface,
+        counts: {
+            jobs: jobs.length,
+            jobsWithLoader: jobs.filter((job) => withLoader.has(job.id)).length,
+            backgroundJobs: background.length,
+            queues: jobsByQueue.size,
+            servedQueues: [...jobsByQueue.keys()].filter((key) => served.has(key)).length,
+            schedules: scheduled.length,
+            servedSchedules,
+            workers: workers.length
+        },
+        failures,
+        warnings
+    };
+}
+//# sourceMappingURL=check-workers.js.map

package/dist/diagnostics/check-workers.js.map

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