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

package/dist/core/schemas/index.js

@@ -0,0 +1,101 @@
+/**
+ * Core Workers Schemas
+ */
+import { JobExecutionClaimSchema } from '@vibesdotdev/kernel/schemas/job-execution';
+import * as z from 'zod/v4';
+/**
+ * A job's metadata bag as queue adapters store and return it. Persistent
+ * adapters validate their serialization format; memory adapters retain live
+ * JavaScript values, so consumers parse any entry they read.
+ */
+export const JobMetadataRecordSchema = z.record(z.string(), z.unknown());
+/** Logical outcome phase; physical execution ownership is separate. */
+export const JobStatusSchema = z.enum([
+    'delayed', 'pending', 'processing', 'completed', 'failed', 'cancelled'
+]);
+export { JobExecutionClaimSchema };
+export const JobExecutionOwnershipSchema = z.enum(['none', 'unknown', 'held']);
+/** Why a stored claim was not restored: the stored fields that broke it, never their values. */
+export const JobExecutionRecordFaultSchema = z.object({
+    reason: z.literal('job-execution-record-invalid'),
+    fields: z.array(z.string().min(1)).min(1)
+}).strict();
+/**
+ * Missing historical ownership is unknown, never a known empty claim. A stored
+ * claim that is malformed is unknown too, carrying its typed fault.
+ */
+export const JobExecutionClaimStateSchema = z.discriminatedUnion('state', [
+    z.object({ state: JobExecutionOwnershipSchema.extract(['none']) }).strict(),
+    z.object({
+        state: JobExecutionOwnershipSchema.extract(['unknown']),
+        invalidRecord: JobExecutionRecordFaultSchema.optional()
+    }).strict(),
+    z.object({
+        state: JobExecutionOwnershipSchema.extract(['held']),
+        identity: JobExecutionClaimSchema,
+        heartbeatAt: z.string().datetime()
+    }).strict()
+]).readonly();
+/** Admission and logical phase compared atomically by the queue owner. */
+export const JobWriteGuardSchema = z.object({
+    generation: z.number().int().nonnegative(),
+    claimToken: z.string().min(1).nullable(),
+    expectedStatus: JobStatusSchema
+}).strict().readonly();
+/** Every retry names its generation; callers may also bind a revision and phase observation. */
+export const JobRetryOptionsSchema = z.object({
+    expectedGeneration: z.number().int().nonnegative(),
+    expectedRevision: z.number().int().nonnegative().optional(),
+    expectedStatus: JobStatusSchema.optional(),
+    delay: z.number().optional()
+}).strict();
+/** Queue-authoritative ordering of an admitted mutation or event. */
+export const JobMutationStampSchema = z.object({
+    generation: z.number().int().nonnegative(),
+    revision: z.number().int().nonnegative(),
+    status: JobStatusSchema
+}).strict().readonly();
+/** Normalized queue columns. Historical NULL/missing ownership stays unknown. */
+export const JobExecutionRecordSchema = z.object({
+    generation: z.number().int().nonnegative().nullish(),
+    revision: z.number().int().nonnegative().nullish(),
+    executionState: JobExecutionOwnershipSchema.nullish(),
+    claimToken: z.string().min(1).nullish(),
+    claimAttempt: z.number().int().positive().nullish(),
+    claimOwner: z.string().min(1).nullish(),
+    claimHeartbeatAt: z.string().datetime().nullish(),
+    retiredAt: z.union([z.date(), z.string().datetime(), z.number()]).nullish()
+});
+/** A top-level field of a job's data that a list query can match on. */
+export const JobDataFieldSchema = z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/);
+/**
+ * Jobs whose data is an object carrying every named top-level field with
+ * exactly this string value; any other data matches nothing.
+ */
+export const JobDataEqualsSchema = z
+    .record(JobDataFieldSchema, z.string())
+    .refine((fields) => Object.keys(fields).length > 0, { message: 'Name at least one data field.' });
+/** The data a `dataEquals` selection admits: an object whose named fields are exactly those strings, other fields free. */
+export function jobDataSelectorSchema(dataEquals) {
+    return z.looseObject(Object.fromEntries(Object.entries(dataEquals).map(([field, value]) => [field, z.literal(value)])));
+}
+/**
+ * One page of a queue's jobs. `dataEquals` selects before `offset` and
+ * `limit` cut the page, so a short page is the end of the selection.
+ */
+/**
+ * A job field a list may leave out of each row: the unbounded payloads a job
+ * carries besides the data its selection reads. A row listed without a field
+ * does not carry it at all; read the job to get it.
+ */
+export const JobListOmittableFieldSchema = z.enum(['result', 'progress']);
+export const JobListOptionsSchema = z
+    .object({
+    limit: z.number().int().positive().optional(),
+    offset: z.number().int().nonnegative().optional(),
+    dataEquals: JobDataEqualsSchema.optional(),
+    /** Fields each listed row leaves out (`result`, `progress`); every other field is kept. */
+    omit: z.array(JobListOmittableFieldSchema).optional()
+})
+    .strict();
+//# sourceMappingURL=index.js.map

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

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

package/dist/core/schemas/resume.d.ts

@@ -0,0 +1,11 @@
+/** The executing job a keyed child is admitted by (`core/keyed-dispatch.ts`). */
+import * as z from 'zod/v4';
+/** The executing job and attempt a keyed child was admitted by: a failed child runs again only when that job retried. */
+export declare const ResumeAdmissionSchema: z.ZodObject<{
+    parentJobId: z.ZodString;
+    parentAttempt: z.ZodNumber;
+}, z.core.$strict>;
+export type ResumeAdmission = z.output<typeof ResumeAdmissionSchema>;
+/** Metadata key a keyed child carries: the `ResumeAdmission` that admitted it. */
+export declare const ADMITTED_BY_METADATA_KEY: "admittedBy";
+//# sourceMappingURL=resume.d.ts.map

package/dist/core/schemas/resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../../src/core/schemas/resume.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAEjF,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,yHAAyH;AACzH,eAAO,MAAM,qBAAqB;;;kBAGvB,CAAC;AACZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAErE,kFAAkF;AAClF,eAAO,MAAM,wBAAwB,EAAG,YAAqB,CAAC"}

package/dist/core/schemas/resume.js

@@ -0,0 +1,10 @@
+/** The executing job a keyed child is admitted by (`core/keyed-dispatch.ts`). */
+import * as z from 'zod/v4';
+/** The executing job and attempt a keyed child was admitted by: a failed child runs again only when that job retried. */
+export const ResumeAdmissionSchema = z.object({
+    parentJobId: z.string().min(1),
+    parentAttempt: z.number().int().min(1)
+}).strict();
+/** Metadata key a keyed child carries: the `ResumeAdmission` that admitted it. */
+export const ADMITTED_BY_METADATA_KEY = 'admittedBy';
+//# sourceMappingURL=resume.js.map

package/dist/core/schemas/resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../../../src/core/schemas/resume.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAEjF,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,yHAAyH;AACzH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACtC,CAAC,CAAC,MAAM,EAAE,CAAC;AAGZ,kFAAkF;AAClF,MAAM,CAAC,MAAM,wBAAwB,GAAG,YAAqB,CAAC"}

package/dist/core/schemas/types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Worker Framework Types
+ *
+ * All TypeScript types derived from Zod schemas.
+ * Never define types here directly - import and infer from schemas.
+ */
+import type { submitJobBodySchema, submitJobResponseSchema, submitBatchJobsBodySchema, submitBatchJobsResponseSchema, jobStatusSchema, listJobsQuerySchema, listJobsResponseSchema, queueMetricsSchema, metricsResponseSchema, cancelJobRequestSchema, cancelJobResponseSchema, retryJobResponseSchema } from './api.ts';
+import type { z } from 'zod/v4';
+export type SubmitJobBody = z.infer<typeof submitJobBodySchema>;
+export type SubmitJobResponse = z.infer<typeof submitJobResponseSchema>;
+export type SubmitBatchJobsBody = z.infer<typeof submitBatchJobsBodySchema>;
+export type SubmitBatchJobsResponse = z.infer<typeof submitBatchJobsResponseSchema>;
+export type JobStatus = z.infer<typeof jobStatusSchema>;
+export type ListJobsQuery = z.infer<typeof listJobsQuerySchema>;
+export type ListJobsResponse = z.infer<typeof listJobsResponseSchema>;
+export type QueueMetrics = z.infer<typeof queueMetricsSchema>;
+export type MetricsResponse = z.infer<typeof metricsResponseSchema>;
+export type CancelJobRequest = z.infer<typeof cancelJobRequestSchema>;
+export type CancelJobResponse = z.infer<typeof cancelJobResponseSchema>;
+export type RetryJobResponse = z.infer<typeof retryJobResponseSchema>;
+export type JobState = 'waiting' | 'active' | 'completed' | 'failed' | 'delayed' | 'paused';
+//# sourceMappingURL=types.d.ts.map

package/dist/core/schemas/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/schemas/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EACzB,6BAA6B,EAC7B,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAGhC,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AACpF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAGtE,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC"}

package/dist/core/schemas/types.js

@@ -0,0 +1,8 @@
+/**
+ * Worker Framework Types
+ *
+ * All TypeScript types derived from Zod schemas.
+ * Never define types here directly - import and infer from schemas.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/schemas/types.js.map

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

package/dist/core/settle.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Outcome form for work whose failure the caller handles as a value: a loop
+ * that reports one unreadable queue and moves on, a best-effort follow-up
+ * read, a probe. The failure is carried, never dropped: `caught` is the
+ * catch-boundary parse (for classification and value-free logging) and
+ * `thrown` is the value exactly as thrown (for rethrowing it unchanged).
+ */
+import { type CaughtFailure } from '@vibesdotdev/kernel';
+/** Work that settled: its value, or its failure carried as a value. */
+export type Settled<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly caught: CaughtFailure;
+    readonly thrown: unknown;
+};
+/**
+ * Run `work` and carry its value or its failure. Never rejects: a synchronous
+ * throw from `work` settles the same way as a rejection.
+ */
+export declare function settle<T>(work: () => T | PromiseLike<T>): Promise<Settled<T>>;
+/**
+ * Run synchronous `work` and carry its value or its failure, for a caller that
+ * must stay synchronous (a stream's data callback). Never throws.
+ */
+export declare function settleSync<T>(work: () => T): Settled<T>;
+//# sourceMappingURL=settle.d.ts.map

package/dist/core/settle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle.d.ts","sourceRoot":"","sources":["../../src/core/settle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE9E,uEAAuE;AACvE,MAAM,MAAM,OAAO,CAAC,CAAC,IAClB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GACxC;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpF;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAK7E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAMvD"}

package/dist/core/settle.js

@@ -0,0 +1,28 @@
+/**
+ * Outcome form for work whose failure the caller handles as a value: a loop
+ * that reports one unreadable queue and moves on, a best-effort follow-up
+ * read, a probe. The failure is carried, never dropped: `caught` is the
+ * catch-boundary parse (for classification and value-free logging) and
+ * `thrown` is the value exactly as thrown (for rethrowing it unchanged).
+ */
+import { CaughtFailureSchema } from '@vibesdotdev/kernel';
+/**
+ * Run `work` and carry its value or its failure. Never rejects: a synchronous
+ * throw from `work` settles the same way as a rejection.
+ */
+export function settle(work) {
+    return new Promise((resolve) => resolve(work())).then((value) => ({ ok: true, value }), (error) => ({ ok: false, caught: CaughtFailureSchema.parse(error), thrown: error }));
+}
+/**
+ * Run synchronous `work` and carry its value or its failure, for a caller that
+ * must stay synchronous (a stream's data callback). Never throws.
+ */
+export function settleSync(work) {
+    try {
+        return { ok: true, value: work() };
+    }
+    catch (error) {
+        return { ok: false, caught: CaughtFailureSchema.parse(error), thrown: error };
+    }
+}
+//# sourceMappingURL=settle.js.map

package/dist/core/settle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle.js","sourceRoot":"","sources":["../../src/core/settle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAsB,MAAM,qBAAqB,CAAC;AAO9E;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAI,IAA8B;IACvD,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CACvD,CAAC,KAAK,EAAc,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAC5C,CAAC,KAAK,EAAc,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAC/F,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAI,IAAa;IAC1C,IAAI,CAAC;QACJ,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAC/E,CAAC;AACF,CAAC"}

package/dist/core/supervised-workloads.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Supervised PM workloads recorded before launch. Legacy process-only entries
+ * retain their existing conservative status lookup. New admissions are pinned
+ * to PM-owned scope, admission id and run generation.
+ *
+ * Recovery uses the PM owner schemas; legacy unknown evidence stays unresolved.
+ */
+import * as z from 'zod/v4';
+export declare const SUPERVISED_METADATA_KEY = "supervised";
+export declare const SupervisedPmAdmissionSchema: z.ZodObject<{
+    scope: z.ZodObject<{
+        workspacePath: z.ZodString;
+        toolingId: z.ZodString;
+    }, z.core.$strict>;
+    admissionId: z.ZodString;
+    processId: z.ZodString;
+    supervisor: z.ZodLiteral<"pm">;
+    startedAt: z.ZodOptional<z.ZodNumber>;
+    settlement: z.ZodOptional<z.ZodObject<{
+        scope: z.ZodObject<{
+            workspacePath: z.ZodString;
+            toolingId: z.ZodString;
+        }, z.core.$strict>;
+        admissionId: z.ZodString;
+        processId: z.ZodString;
+        startedAt: z.ZodNumber;
+        status: z.ZodEnum<{
+            pass: "pass";
+            completed: "completed";
+            stopped: "stopped";
+            crashed: "crashed";
+            fail: "fail";
+        }>;
+        succeeded: z.ZodBoolean;
+        exitCode: z.ZodNullable<z.ZodNumber>;
+        signal: z.ZodNullable<z.ZodString>;
+        pid: z.ZodNullable<z.ZodNumber>;
+        stoppedAt: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+export type SupervisedPmAdmission = z.infer<typeof SupervisedPmAdmissionSchema>;
+export declare const SupervisedWorkloadSchema: z.ZodUnion<readonly [z.ZodObject<{
+    scope: z.ZodObject<{
+        workspacePath: z.ZodString;
+        toolingId: z.ZodString;
+    }, z.core.$strict>;
+    admissionId: z.ZodString;
+    processId: z.ZodString;
+    supervisor: z.ZodLiteral<"pm">;
+    startedAt: z.ZodOptional<z.ZodNumber>;
+    settlement: z.ZodOptional<z.ZodObject<{
+        scope: z.ZodObject<{
+            workspacePath: z.ZodString;
+            toolingId: z.ZodString;
+        }, z.core.$strict>;
+        admissionId: z.ZodString;
+        processId: z.ZodString;
+        startedAt: z.ZodNumber;
+        status: z.ZodEnum<{
+            pass: "pass";
+            completed: "completed";
+            stopped: "stopped";
+            crashed: "crashed";
+            fail: "fail";
+        }>;
+        succeeded: z.ZodBoolean;
+        exitCode: z.ZodNullable<z.ZodNumber>;
+        signal: z.ZodNullable<z.ZodString>;
+        pid: z.ZodNullable<z.ZodNumber>;
+        stoppedAt: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strip>, z.ZodObject<{
+    supervisor: z.ZodLiteral<"pm">;
+    processId: z.ZodString;
+    admissionId: z.ZodOptional<z.ZodNever>;
+    scope: z.ZodOptional<z.ZodNever>;
+    startedAt: z.ZodOptional<z.ZodNever>;
+    settlement: z.ZodOptional<z.ZodNever>;
+}, z.core.$strip>]>;
+export type SupervisedWorkload = z.infer<typeof SupervisedWorkloadSchema>;
+export declare const SupervisedWorkloadsSchema: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+    scope: z.ZodObject<{
+        workspacePath: z.ZodString;
+        toolingId: z.ZodString;
+    }, z.core.$strict>;
+    admissionId: z.ZodString;
+    processId: z.ZodString;
+    supervisor: z.ZodLiteral<"pm">;
+    startedAt: z.ZodOptional<z.ZodNumber>;
+    settlement: z.ZodOptional<z.ZodObject<{
+        scope: z.ZodObject<{
+            workspacePath: z.ZodString;
+            toolingId: z.ZodString;
+        }, z.core.$strict>;
+        admissionId: z.ZodString;
+        processId: z.ZodString;
+        startedAt: z.ZodNumber;
+        status: z.ZodEnum<{
+            pass: "pass";
+            completed: "completed";
+            stopped: "stopped";
+            crashed: "crashed";
+            fail: "fail";
+        }>;
+        succeeded: z.ZodBoolean;
+        exitCode: z.ZodNullable<z.ZodNumber>;
+        signal: z.ZodNullable<z.ZodString>;
+        pid: z.ZodNullable<z.ZodNumber>;
+        stoppedAt: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strip>, z.ZodObject<{
+    supervisor: z.ZodLiteral<"pm">;
+    processId: z.ZodString;
+    admissionId: z.ZodOptional<z.ZodNever>;
+    scope: z.ZodOptional<z.ZodNever>;
+    startedAt: z.ZodOptional<z.ZodNever>;
+    settlement: z.ZodOptional<z.ZodNever>;
+}, z.core.$strip>]>>;
+//# sourceMappingURL=supervised-workloads.d.ts.map

package/dist/core/supervised-workloads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervised-workloads.d.ts","sourceRoot":"","sources":["../../src/core/supervised-workloads.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAM5B,eAAO,MAAM,uBAAuB,eAAe,CAAC;AAmBpD,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAUtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAEnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAQpC,CAAC"}

package/dist/core/supervised-workloads.js

@@ -0,0 +1,52 @@
+/**
+ * Supervised PM workloads recorded before launch. Legacy process-only entries
+ * retain their existing conservative status lookup. New admissions are pinned
+ * to PM-owned scope, admission id and run generation.
+ *
+ * Recovery uses the PM owner schemas; legacy unknown evidence stays unresolved.
+ */
+import * as z from 'zod/v4';
+import { PmTaskProcessIdentitySchema, PmTaskSettlementSchema } from '@vibesdotdev/pm/schemas/process';
+export const SUPERVISED_METADATA_KEY = 'supervised';
+function sameProcessIdentity(left, right) {
+    return left.admissionId === right.admissionId &&
+        left.processId === right.processId &&
+        left.scope.workspacePath === right.scope.workspacePath &&
+        left.scope.toolingId === right.scope.toolingId;
+}
+const LegacySupervisedWorkloadSchema = z.object({
+    supervisor: z.literal('pm'),
+    processId: z.string().min(1),
+    // A malformed new admission must never fall back to process-only proof.
+    admissionId: z.never().optional(),
+    scope: z.never().optional(),
+    startedAt: z.never().optional(),
+    settlement: z.never().optional()
+});
+export const SupervisedPmAdmissionSchema = PmTaskProcessIdentitySchema.extend({
+    supervisor: z.literal('pm'),
+    startedAt: z.number().int().nonnegative().optional(),
+    settlement: PmTaskSettlementSchema.optional()
+}).strip().superRefine((entry, context) => {
+    if (!entry.settlement)
+        return;
+    if (entry.startedAt === undefined || entry.startedAt !== entry.settlement.startedAt ||
+        !sameProcessIdentity(entry, entry.settlement)) {
+        context.addIssue({ code: 'custom', path: ['settlement'], message: 'The terminal receipt must identify this exact pinned PM admission.' });
+    }
+});
+export const SupervisedWorkloadSchema = z.union([
+    SupervisedPmAdmissionSchema, LegacySupervisedWorkloadSchema
+]);
+export const SupervisedWorkloadsSchema = z.array(SupervisedWorkloadSchema).superRefine((entries, context) => {
+    const seen = new Set();
+    for (const [index, entry] of entries.entries()) {
+        if (entry.admissionId === undefined)
+            continue;
+        const key = JSON.stringify([entry.scope.workspacePath, entry.scope.toolingId, entry.processId, entry.admissionId]);
+        if (seen.has(key))
+            context.addIssue({ code: 'custom', path: [index], message: 'A supervised PM admission is recorded more than once.' });
+        seen.add(key);
+    }
+});
+//# sourceMappingURL=supervised-workloads.js.map

package/dist/core/supervised-workloads.js.map

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

package/dist/core/worker-job-event.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Worker Job Event Types
+ */
+export type { WorkerJobEvent, WorkerJobEventType, WorkerJobEventPayload } from './schemas/index.ts';
+//# sourceMappingURL=worker-job-event.d.ts.map

package/dist/core/worker-job-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-job-event.d.ts","sourceRoot":"","sources":["../../src/core/worker-job-event.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EACX,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,MAAM,oBAAoB,CAAC"}

package/dist/core/worker-job-event.js

@@ -0,0 +1,5 @@
+/**
+ * Worker Job Event Types
+ */
+export {};
+//# sourceMappingURL=worker-job-event.js.map

package/dist/core/worker-job-event.js.map

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

package/dist/core/worker.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Worker
+ *
+ * Declarative worker configuration and job handler registry.
+ * Workers don't execute jobs - they define configuration and register handlers.
+ * The runtime wires workers to adapters and routes jobs to handlers.
+ */
+import type { JobHandler } from './job-handler.ts';
+import type { HardwareType } from './schemas/config.ts';
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { WorkerLogger, WorkerConfig } from './schemas/index.ts';
+export type { WorkerConfig } from './schemas/index.ts';
+type JobHandlerClass = new (runtime: VibesRuntime) => JobHandler;
+export declare abstract class Worker {
+    protected readonly runtime: VibesRuntime;
+    abstract readonly id: string;
+    abstract readonly config: WorkerConfig;
+    abstract readonly jobs: JobHandlerClass[];
+    readonly workers?: Worker[];
+    protected logger: WorkerLogger;
+    private handlerInstances;
+    constructor(runtime: VibesRuntime);
+    getHandler(jobType: string): JobHandler | undefined;
+    getHandlers(): JobHandler[];
+    getHandlerIds(): string[];
+    setup?(): Promise<void>;
+    cleanup?(): Promise<void>;
+    getConfig(): Readonly<WorkerConfig & {
+        id: string;
+    }>;
+    getQueueId(): string;
+    getHardware(): readonly HardwareType[] | undefined;
+    canRunOnHardware(hardware: HardwareType): boolean;
+}
+//# sourceMappingURL=worker.d.ts.map

package/dist/core/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/core/worker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAErE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,KAAK,eAAe,GAAG,KAAK,OAAO,EAAE,YAAY,KAAK,UAAU,CAAC;AAWjE,8BAAsB,MAAM;IASf,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY;IARpD,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC;IAC/B,OAAO,CAAC,gBAAgB,CAAsC;gBAE/B,OAAO,EAAE,YAAY;IAKpD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAenD,WAAW,IAAI,UAAU,EAAE;IAW3B,aAAa,IAAI,MAAM,EAAE;IAInB,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IACvB,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;IAE/B,SAAS,IAAI,QAAQ,CAAC,YAAY,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAOpD,UAAU,IAAI,MAAM;IAIpB,WAAW,IAAI,SAAS,YAAY,EAAE,GAAG,SAAS;IAIlD,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO;CAOjD"}

package/dist/core/worker.js

@@ -0,0 +1,71 @@
+/**
+ * Worker
+ *
+ * Declarative worker configuration and job handler registry.
+ * Workers don't execute jobs - they define configuration and register handlers.
+ * The runtime wires workers to adapters and routes jobs to handlers.
+ */
+import { getLogger } from '@vibesdotdev/logging';
+/**
+ * The worker id as readable while the base constructor runs: a subclass's
+ * `readonly id = '...'` field initializer has not run yet (only a prototype
+ * getter is visible), so the id may still be absent here.
+ */
+function idDuringConstruction(worker) {
+    return worker.id;
+}
+export class Worker {
+    runtime;
+    workers;
+    logger;
+    handlerInstances = new Map();
+    constructor(runtime) {
+        this.runtime = runtime;
+        const workerId = idDuringConstruction(this) ?? this.constructor.name;
+        this.logger = getLogger(`worker:${workerId}`, runtime).withContext({ workerId });
+    }
+    getHandler(jobType) {
+        if (!this.handlerInstances.has(jobType)) {
+            const HandlerClass = this.jobs.find((HandlerClass) => {
+                const instance = new HandlerClass(this.runtime);
+                return instance.id === jobType;
+            });
+            if (HandlerClass) {
+                this.handlerInstances.set(jobType, new HandlerClass(this.runtime));
+            }
+        }
+        return this.handlerInstances.get(jobType);
+    }
+    getHandlers() {
+        for (const HandlerClass of this.jobs) {
+            const instance = new HandlerClass(this.runtime);
+            if (!this.handlerInstances.has(instance.id)) {
+                this.handlerInstances.set(instance.id, instance);
+            }
+        }
+        return Array.from(this.handlerInstances.values());
+    }
+    getHandlerIds() {
+        return this.jobs.map((HandlerClass) => new HandlerClass(this.runtime).id);
+    }
+    getConfig() {
+        return {
+            id: this.id,
+            ...this.config
+        };
+    }
+    getQueueId() {
+        return this.config.queueId || `${this.id}-jobs`;
+    }
+    getHardware() {
+        return this.config.hardware;
+    }
+    canRunOnHardware(hardware) {
+        const workerHardware = this.getHardware();
+        if (!workerHardware || workerHardware.length === 0) {
+            return true;
+        }
+        return workerHardware.includes(hardware);
+    }
+}
+//# sourceMappingURL=worker.js.map

package/dist/core/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/core/worker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAQjD;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,MAAc;IAC3C,OAAO,MAAM,CAAC,EAAE,CAAC;AAClB,CAAC;AAED,MAAM,OAAgB,MAAM;IASI;IALtB,OAAO,CAAY;IAElB,MAAM,CAAe;IACvB,gBAAgB,GAA4B,IAAI,GAAG,EAAE,CAAC;IAE9D,YAA+B,OAAqB;QAArB,YAAO,GAAP,OAAO,CAAc;QACnD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QACrE,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,UAAU,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,UAAU,CAAC,OAAe;QACzB,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACzC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE;gBACpD,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAChD,OAAO,QAAQ,CAAC,EAAE,KAAK,OAAO,CAAC;YAChC,CAAC,CAAC,CAAC;YAEH,IAAI,YAAY,EAAE,CAAC;gBAClB,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YACpE,CAAC;QACF,CAAC;QAED,OAAO,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,WAAW;QACV,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAChD,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC7C,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YAClD,CAAC;QACF,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,aAAa;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IAKD,SAAS;QACR,OAAO;YACN,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,GAAG,IAAI,CAAC,MAAM;SACd,CAAC;IACH,CAAC;IAED,UAAU;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC;IACjD,CAAC;IAED,WAAW;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED,gBAAgB,CAAC,QAAsB;QACtC,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,CAAC,cAAc,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,OAAO,IAAI,CAAC;QACb,CAAC;QACD,OAAO,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;CACD"}

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

@@ -0,0 +1,28 @@
+/**
+ * Consumer dead-letter store over the `workers.dead-letter` localdb record.
+ */
+import { type RuntimeDescriptor, type VibesRuntime } from '@vibesdotdev/kernel';
+import type { KindContext } from '@vibesdotdev/kernel/schemas/kind';
+import type { DeadLetterStore } from './dead-letter-store.kind.ts';
+import { type DeadLetterEntry, type DeadLetterQuery } from './dead-letter.schema.ts';
+export declare const consumerDeadLetterStoreDescriptor: {
+    kind: "workers/dead-letter-store";
+    id: string;
+    name: string;
+    description: string;
+    hardware: string[];
+};
+export declare class ConsumerDeadLetterStore implements DeadLetterStore {
+    private readonly runtime;
+    constructor(_descriptor: RuntimeDescriptor, context: KindContext & {
+        runtime?: VibesRuntime;
+    });
+    private records;
+    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 default ConsumerDeadLetterStore;
+//# sourceMappingURL=dead-letter-store.impl.consumer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dead-letter-store.impl.consumer.d.ts","sourceRoot":"","sources":["../../src/dead-letter/dead-letter-store.impl.consumer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAsB,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAGpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAyB,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG5G,eAAO,MAAM,iCAAiC;;;;;;CAM5C,CAAC;AAEH,qBAAa,uBAAwB,YAAW,eAAe;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAE3B,WAAW,EAAE,iBAAiB,EAAE,OAAO,EAAE,WAAW,GAAG;QAAE,OAAO,CAAC,EAAE,YAAY,CAAA;KAAE;YAO/E,OAAO;IAWf,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAIhD,IAAI,CAAC,KAAK,GAAE,eAAoB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAc7D,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAUvE,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAIzC;AAED,eAAe,uBAAuB,CAAC"}