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

package/dist/schemas/claim.js

@@ -0,0 +1,137 @@
+/**
+ * Worker claim contracts and physical queue partitioning.
+ *
+ * Protected jobs use a queue name that old workers cannot derive. This is the
+ * backwards-compatible fail-closed boundary: metadata predicates alone are
+ * insufficient because an old worker can ignore fields it does not know.
+ */
+import * as z from 'zod/v4';
+import { resolveWorkspaceToolingId } from '@vibesdotdev/identity';
+import { hostWorkspaceRoot } from '@vibesdotdev/kernel/context/workspace-path.context.impl';
+export const WORKER_CLAIM_SCHEMA_VERSION = 1;
+export const MAX_PHYSICAL_QUEUE_NAME_LENGTH = 200;
+const ClaimTokenSchema = z
+    .string()
+    .min(1)
+    .max(96)
+    .regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/);
+/** Exact physical-partition contract advertised by a worker descriptor. */
+export const WorkerClaimPartitionSchema = z
+    .object({
+    schemaVersion: z.literal(WORKER_CLAIM_SCHEMA_VERSION),
+    family: ClaimTokenSchema,
+    version: z.number().int().positive(),
+    workspaceScoped: z.boolean()
+})
+    .strict();
+/** Claim contract owned by a workers/job descriptor. */
+export const JobClaimRequirementsSchema = z
+    .object({
+    schemaVersion: z.literal(WORKER_CLAIM_SCHEMA_VERSION),
+    partition: WorkerClaimPartitionSchema,
+    jobVersion: z.number().int().positive(),
+    requiredCapabilities: z.array(ClaimTokenSchema).default([]),
+    revisionPolicy: z.enum(['any-compatible', 'exact']).default('any-compatible'),
+    sourceRevision: z.string().min(1).optional()
+})
+    .strict()
+    .superRefine((value, ctx) => {
+    if (value.revisionPolicy === 'exact' && !value.sourceRevision) {
+        ctx.addIssue({
+            code: 'custom',
+            path: ['sourceRevision'],
+            message: 'sourceRevision is required when revisionPolicy is exact'
+        });
+    }
+});
+export const WorkerSupportedJobSchema = z
+    .object({
+    versions: z.array(z.number().int().positive()).min(1),
+    capabilities: z.array(ClaimTokenSchema).default([])
+})
+    .strict();
+/** Live identity contract for IPC handshakes and durable claim evidence. */
+export const WorkerClaimIdentitySchema = z
+    .object({
+    schemaVersion: z.literal(WORKER_CLAIM_SCHEMA_VERSION),
+    workerInstanceId: z.string().min(1),
+    workerId: z.string().min(1),
+    hardware: z.enum(['consumer', 'cloud']),
+    workspaceRoot: z.string().min(1),
+    workspaceToolingId: ClaimTokenSchema,
+    sourceEntrypoint: z.string().min(1),
+    sourceRevision: z.string().min(1),
+    startedAt: z.iso.datetime(),
+    supportedJobs: z.record(z.string(), WorkerSupportedJobSchema)
+})
+    .strict();
+function sanitizeQueueSegment(value) {
+    const sanitized = value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    if (!sanitized)
+        throw new Error('Worker claim queue segments must contain an alphanumeric character');
+    return sanitized;
+}
+function fnv1a32Base36(input) {
+    let hash = 0x811c9dc5;
+    for (let index = 0; index < input.length; index++) {
+        hash ^= input.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(36);
+}
+/**
+ * Derive a provider-safe physical queue name for an exact claim partition.
+ * Workspace-scoped contracts refuse ambient/default identity.
+ */
+export function deriveWorkerClaimQueueName(baseQueue, partition, workspaceToolingId) {
+    const parsed = WorkerClaimPartitionSchema.parse(partition);
+    const base = sanitizeQueueSegment(baseQueue);
+    const family = sanitizeQueueSegment(parsed.family);
+    let workspace = '';
+    if (parsed.workspaceScoped) {
+        if (!workspaceToolingId?.trim()) {
+            throw new Error(`Worker claim partition '${parsed.family}@${parsed.version}' requires a bound workspace identity`);
+        }
+        workspace = `-${sanitizeQueueSegment(workspaceToolingId)}`;
+    }
+    const physical = `${base}--claim-v${parsed.schemaVersion}-${family}-v${parsed.version}${workspace}`;
+    if (physical.length <= MAX_PHYSICAL_QUEUE_NAME_LENGTH)
+        return physical;
+    const digest = fnv1a32Base36(physical);
+    const suffix = `--claim-v${parsed.schemaVersion}-${family.slice(0, 48)}-v${parsed.version}-${digest}`;
+    const baseBudget = MAX_PHYSICAL_QUEUE_NAME_LENGTH - suffix.length;
+    if (baseBudget < 1) {
+        throw new Error(`Worker claim partition '${parsed.family}' cannot fit a physical queue name`);
+    }
+    return `${base.slice(0, baseBudget)}${suffix}`;
+}
+export function resolveBoundWorkspaceIdentity(runtime) {
+    const workspaceRoot = hostWorkspaceRoot(runtime);
+    return {
+        workspaceRoot,
+        workspaceToolingId: resolveWorkspaceToolingId(workspaceRoot)
+    };
+}
+/** Resolve a base queue through an optional protected partition contract. */
+export function resolvePhysicalQueueName(baseQueue, partition, runtime) {
+    if (!partition)
+        return baseQueue;
+    const workspaceToolingId = partition.workspaceScoped
+        ? resolveBoundWorkspaceIdentity(runtime).workspaceToolingId
+        : undefined;
+    return deriveWorkerClaimQueueName(baseQueue, partition, workspaceToolingId);
+}
+/** Exact family/version/scope equality; no implicit downgrade or version range. */
+export function workerClaimPartitionsMatch(worker, job) {
+    const workerPartition = WorkerClaimPartitionSchema.parse(worker);
+    const jobPartition = WorkerClaimPartitionSchema.parse(job);
+    return (workerPartition.schemaVersion === jobPartition.schemaVersion &&
+        workerPartition.family === jobPartition.family &&
+        workerPartition.version === jobPartition.version &&
+        workerPartition.workspaceScoped === jobPartition.workspaceScoped);
+}
+//# sourceMappingURL=claim.js.map

package/dist/schemas/claim.js.map

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

package/dist/schemas/client.d.ts

@@ -0,0 +1,221 @@
+/** Public Workers client contracts; implementations re-export these for compatibility. */
+import * as z from 'zod/v4';
+import type { CaughtFailure, ValueFreeFailure } from '@vibesdotdev/kernel';
+import type { JsonValue } from '@vibesdotdev/kernel/schemas/json';
+import type { JobStatus, RepeatOptions, ScheduleInfo } from '../core/queue-adapter.ts';
+import type { JobMetadataRecord, JobMutationStamp } from '../core/schemas/index.ts';
+import type { JobExecutionEvents } from '../kinds/schemas/index.ts';
+import type { JobDispatchOverrides } from '../client/dispatch-overrides.ts';
+import type { JobClaimRequirements } from './claim.ts';
+import type { ResumeAdmission } from '../core/schemas/resume.ts';
+import type { Cancellation } from './cancellation.ts';
+export type { CancelJobOptions } from './cancellation.ts';
+export interface EnqueueOptions {
+    jobType?: string;
+    /** Stable caller-owned identity for retry-safe queue delivery. */
+    jobId?: string;
+    resume?: ResumeAdmission;
+    timeoutMs?: number;
+    metadata?: Record<string, JsonValue>;
+}
+/**
+ * Open job-metadata bag stamped on every dispatch path: the queue's own
+ * metadata contract. Workers owns `type`, `workerClaim` and `maxAttempts`;
+ * the caller's entries ride along unchanged.
+ */
+export type JobMetadata = JobMetadataRecord;
+export interface EnqueueWithTimeoutResult<T> {
+    jobId: string;
+    status: 'pending' | 'processing' | 'completed' | 'failed';
+    result?: T;
+    error?: string;
+}
+export type WorkerEnqueueFailureClass = 'transient' | 'permanent';
+export interface EnqueueJobRetryOptions extends Omit<EnqueueOptions, 'jobType'> {
+    maxAttempts?: number;
+    delayMs?: number;
+    classify?: (error: CaughtFailure) => WorkerEnqueueFailureClass;
+}
+export interface JobQueueIdentity {
+    jobId: string;
+    logicalQueue: string;
+    physicalQueue: string;
+    claim?: JobClaimRequirements;
+}
+export interface WorkerRuntimeDescriptor {
+    id: string;
+    description?: string;
+    queue?: string;
+    queueId?: string;
+    concurrency?: number;
+    hardware?: readonly string[] | string[];
+    tags?: readonly string[] | string[];
+}
+export interface EnqueueStreamingOptions {
+    jobType?: string;
+    signal?: AbortSignal;
+}
+export interface ScheduleJobOptions extends EnqueueOptions {
+    queue?: string;
+    repeat?: RepeatOptions;
+    cron?: string;
+    pattern?: string;
+    timezone?: string;
+    tz?: string;
+    enabled?: boolean;
+    maxFailures?: number;
+    startDate?: Date | string;
+    endDate?: Date | string;
+    limit?: number;
+}
+export interface RemoveRepeatableOptions {
+    queue?: string;
+    repeat?: RepeatOptions;
+    cron?: string;
+    pattern?: string;
+    jobId?: string;
+}
+export interface RunJobOptions {
+    metadata?: JobMetadata;
+    signal?: AbortSignal;
+    /**
+     * The job's admission id, a dedupe key (`keepsCallerAdmission`): a call under an id whose job is
+     * pending, running or completed reattaches to it and returns its result instead of starting a
+     * second one, so a resumed parent finds the children it already ran.
+     */
+    jobId?: string;
+    resume?: ResumeAdmission;
+    /**
+     * Preserve the caller's runtime context by requiring in-process execution.
+     *
+     * `prefer-background` jobs run inline when set. A background-only job fails
+     * closed because caller context must never be serialized into queue data.
+     */
+    callerContext?: 'preserve';
+}
+/** Exact inline execution envelope for owner adapters that already have a job identity. */
+export interface InvokeInlineJobOptions extends RunJobOptions {
+    jobId?: string;
+    attempt?: number;
+    maxAttempts?: number;
+    events?: JobExecutionEvents;
+}
+export interface StartJobOptions extends z.input<typeof DispatchCancellationSchema> {
+    /** Cancellation owns only this dispatch until its receipt is returned. */
+    signal?: AbortSignal;
+    /** Stable caller-owned identity for retry-safe queue delivery. */
+    jobId?: string;
+    /**
+     * Caller metadata. Workers owns `type`, `workerClaim` and `maxAttempts`; a
+     * numeric `maxAttempts` here is read as `dispatch.attempts` and admitted
+     * the same way.
+     */
+    metadata?: Record<string, JsonValue>;
+    /**
+     * Per-dispatch delay, priority, attempts and backoff, admitted only within
+     * the descriptor's declared `dispatchBounds`/`retries`; anything outside is
+     * refused `INVALID_INPUT dispatch-override-*`.
+     */
+    dispatch?: JobDispatchOverrides;
+}
+/**
+ * One queue's schedules in `WorkersClient.getSchedulesByQueue`: the schedules
+ * it holds, or the value-free failure that kept them unread.
+ */
+export type QueueSchedules = {
+    queueId: string;
+    schedules: ScheduleInfo[];
+} | {
+    queueId: string;
+    failure: ValueFreeFailure;
+};
+export declare const StartedJobSchema: z.ZodObject<{
+    jobId: z.ZodString;
+    queueId: z.ZodString;
+}, z.core.$strip>;
+export type StartedJob = z.infer<typeof StartedJobSchema>;
+export declare const CompleteJobOptionsSchema: z.ZodObject<{
+    signal: z.ZodOptional<z.ZodInstanceOf<AbortSignal>>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    pollIntervalMs: z.ZodDefault<z.ZodNumber>;
+    cancelOnAbort: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type CompleteJobOptions = z.input<typeof CompleteJobOptionsSchema>;
+/** The whole dispatch, including adapter resolution, has this caller-configurable budget. */
+export declare const DispatchCancellationSchema: z.ZodObject<{
+    signal: z.ZodOptional<z.ZodInstanceOf<AbortSignal>>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Outcome of {@link WorkersClient.startJobOnce}: `started` enqueued a job,
+ * `already-active` found the keyed job still delayed, pending or running,
+ * `restarted` replaced a failed (dead-lettered) keyed job with a new attempt
+ * because the caller's `restartFailed` admitted it, and `terminal` found it
+ * failed or cancelled and left it — cancellation is always final, and a dead
+ * letter is final unless the caller's owner decides the failure is stale.
+ * The queue owner decides each claim in one step, so concurrent claims on one
+ * key start it once; a claim that loses reports the winner's current state.
+ */
+export interface ClaimedJob extends StartedJob {
+    claim: 'started' | 'already-active' | 'restarted' | 'terminal';
+    /** The existing job's status when the claim found one. */
+    existingStatus?: string;
+}
+/** The failed keyed job {@link StartJobOnceOptions.restartFailed} decides about. */
+export interface FailedKeyedJob {
+    jobId: string;
+    status: 'failed';
+    /** The metadata the failed job was enqueued with (the caller's plus Workers' own). */
+    metadata: JobMetadata;
+    error?: string;
+    attemptsMade: number;
+}
+export interface StartJobOnceOptions extends StartJobOptions {
+    jobId: string;
+    /**
+     * Admit a new attempt past a failed (dead-lettered) keyed job. Returning
+     * `true` enqueues the job again under the same key, which replaces the
+     * failed one only while it is still the admission that was judged (a retry
+     * or replacement since then wins), and marks its dead letter replayed. Absent or `false`, a
+     * failed job stays terminal. A cancelled job is never restarted.
+     */
+    restartFailed?: (existing: FailedKeyedJob) => boolean;
+}
+export type RunJobStreamingOptions = Omit<RunJobOptions, 'callerContext'> & {
+    /** Caller work that must finish before a background job can be claimed. */
+    beforeEnqueue?: () => Promise<void>;
+};
+export interface StreamingEvent {
+    type: string;
+    /** Actual admitted execution identity, available before its completion. */
+    jobId?: string;
+    /** Open payload. A graph node reads the `completed` event's job result through the JSON contract. */
+    data?: unknown;
+}
+export type CancelJobResultStatus = 'cancelled' | 'already-terminal' | 'not-found' | 'unsupported';
+export interface CancelJobResult {
+    jobId: string;
+    status: CancelJobResultStatus;
+    cancelled: boolean;
+    message: string;
+    queueId?: string;
+    workerId?: string;
+    previousStatus?: JobStatus;
+    currentStatus?: JobStatus;
+}
+/** The Workers HTTP shape of one queue job. */
+export interface WorkerApiJob {
+    id: string;
+    generation: JobMutationStamp['generation'];
+    status: JobStatus;
+    cancellation?: Cancellation;
+    progress?: number | object;
+    data: object;
+    result?: object;
+    error?: string;
+    timestamp: number;
+    processedOn?: number;
+    finishedOn?: number;
+    attemptsMade: number;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/schemas/client.d.ts.map

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

package/dist/schemas/client.js

@@ -0,0 +1,19 @@
+/** Public Workers client contracts; implementations re-export these for compatibility. */
+import * as z from 'zod/v4';
+export const StartedJobSchema = z.object({
+    jobId: z.string().min(1),
+    queueId: z.string().min(1)
+});
+export const CompleteJobOptionsSchema = z.object({
+    signal: z.instanceof(AbortSignal).optional(),
+    timeoutMs: z.number().positive().max(2_147_483_647).default(45 * 60_000),
+    pollIntervalMs: z.number().positive().finite().default(250),
+    /** Explicit authority; attaching to a receipt is passive by default. */
+    cancelOnAbort: z.boolean().default(false)
+});
+/** The whole dispatch, including adapter resolution, has this caller-configurable budget. */
+export const DispatchCancellationSchema = z.object({
+    signal: z.instanceof(AbortSignal).optional(),
+    timeoutMs: z.number().positive().max(2_147_483_647).default(30_000)
+});
+//# sourceMappingURL=client.js.map

package/dist/schemas/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/schemas/client.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AA2J5B,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC1B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC;IACxE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IAC3D,wEAAwE;IACxE,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACzC,CAAC,CAAC;AAGH,6FAA6F;AAC7F,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;CACnE,CAAC,CAAC"}

package/dist/schemas/descriptors.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Worker & Job Descriptor Schemas
+ *
+ * Kind-specific descriptor schemas owned by the workers module.
+ * Uses `createRuntimeAssetSchema` to compose the shared runtime base
+ * with worker/job-specific fields.
+ */
+import * as z from 'zod/v4';
+import { type RuntimeDescriptor } from '@vibesdotdev/kernel/schemas/descriptor';
+import { JobIsolationSchema } from '@vibesdotdev/kernel/schemas/job-execution';
+/** Job type determines lifecycle and context available to handler */
+export declare const JobTypeSchema: z.ZodEnum<{
+    default: "default";
+    progress: "progress";
+    subtask: "subtask";
+    streaming: "streaming";
+    scheduled: "scheduled";
+}>;
+export type JobType = z.infer<typeof JobTypeSchema>;
+/**
+ * Job handler isolation after dispatch. Delivery location is declared
+ * independently by `dispatch`. One owner: the runtime's job execution
+ * contracts declare it; this re-export keeps the workers surface.
+ */
+export { JobIsolationSchema };
+export type JobIsolation = z.infer<typeof JobIsolationSchema>;
+/**
+ * Where a job is dispatched. This is deliberately separate from `isolation`:
+ * dispatch chooses the execution location, while isolation chooses how a
+ * handler is contained once it reaches that location.
+ */
+export declare const JobDispatchSchema: z.ZodEnum<{
+    inline: "inline";
+    background: "background";
+    "prefer-background": "prefer-background";
+}>;
+export type JobDispatch = z.infer<typeof JobDispatchSchema>;
+/**
+ * Worker descriptor config — fields specific to the `workers/worker` kind.
+ */
+export declare const WorkerDescriptorConfigSchema: z.ZodObject<{
+    queue: z.ZodOptional<z.ZodString>;
+    concurrency: z.ZodOptional<z.ZodNumber>;
+    handlers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    claimPartition: z.ZodOptional<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        family: z.ZodString;
+        version: z.ZodNumber;
+        workspaceScoped: z.ZodBoolean;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+/**
+ * Full worker descriptor schema (base + kind literal + config).
+ */
+export declare const WorkerDescriptorSchema: z.ZodObject<{
+    [x: string]: any;
+}, z.core.$strip>;
+export type WorkerAssetDescriptor = RuntimeDescriptor & {
+    kind: 'workers/worker';
+} & z.output<typeof WorkerDescriptorConfigSchema>;
+/**
+ * Job descriptor config — fields specific to the `workers/job` kind.
+ */
+export declare const JobDescriptorConfigSchema: z.ZodObject<{
+    queue: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        progress: "progress";
+        subtask: "subtask";
+        streaming: "streaming";
+        scheduled: "scheduled";
+    }>>;
+    isolation: z.ZodOptional<z.ZodEnum<{
+        inline: "inline";
+        worker_thread: "worker_thread";
+        subprocess: "subprocess";
+    }>>;
+    dispatch: z.ZodOptional<z.ZodEnum<{
+        inline: "inline";
+        background: "background";
+        "prefer-background": "prefer-background";
+    }>>;
+    workerSmol: z.ZodOptional<z.ZodBoolean>;
+    schedule: z.ZodOptional<z.ZodString>;
+    scheduleData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    scheduleTimezone: z.ZodOptional<z.ZodString>;
+    scheduleEnabled: z.ZodOptional<z.ZodBoolean>;
+    retries: z.ZodOptional<z.ZodObject<{
+        maxAttempts: z.ZodOptional<z.ZodNumber>;
+        backoff: z.ZodOptional<z.ZodEnum<{
+            fixed: "fixed";
+            exponential: "exponential";
+        }>>;
+        delay: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    dispatchBounds: z.ZodOptional<z.ZodObject<{
+        delayMs: z.ZodOptional<z.ZodObject<{
+            max: z.ZodNumber;
+        }, z.core.$strip>>;
+        priority: z.ZodOptional<z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+        }, z.core.$strip>>;
+        attempts: z.ZodOptional<z.ZodObject<{
+            max: z.ZodNumber;
+        }, z.core.$strip>>;
+        backoff: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            fixed: "fixed";
+            exponential: "exponential";
+        }>>>;
+    }, z.core.$strip>>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    retryBackoff: z.ZodOptional<z.ZodNumber>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    schemas: z.ZodOptional<z.ZodObject<{
+        input: z.ZodOptional<z.ZodUnknown>;
+        output: z.ZodOptional<z.ZodUnknown>;
+    }, z.core.$strip>>;
+    inputSchema: z.ZodOptional<z.ZodUnknown>;
+    outputSchema: z.ZodOptional<z.ZodUnknown>;
+    claim: z.ZodOptional<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        partition: z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            family: z.ZodString;
+            version: z.ZodNumber;
+            workspaceScoped: z.ZodBoolean;
+        }, z.core.$strict>;
+        jobVersion: z.ZodNumber;
+        requiredCapabilities: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        revisionPolicy: z.ZodDefault<z.ZodEnum<{
+            exact: "exact";
+            "any-compatible": "any-compatible";
+        }>>;
+        sourceRevision: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    adapterRequirements: z.ZodOptional<z.ZodObject<{
+        persistent: z.ZodOptional<z.ZodBoolean>;
+        distributed: z.ZodOptional<z.ZodBoolean>;
+        priorities: z.ZodOptional<z.ZodBoolean>;
+        scheduling: z.ZodOptional<z.ZodBoolean>;
+        progress: z.ZodOptional<z.ZodBoolean>;
+        crossHardware: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        keyedClaims: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+        coalescedEnqueue: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>>;
+    contract: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$loose>>;
+}, z.core.$strip>;
+export type JobAssetDescriptor = RuntimeDescriptor & {
+    kind: 'workers/job';
+} & z.output<typeof JobDescriptorConfigSchema> & {
+    dispatch: JobDispatch;
+};
+export declare const JobDescriptorInputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export type JobDescriptorInput = z.infer<typeof JobDescriptorInputSchema>;
+/**
+ * Full job descriptor schema (base + kind literal + config).
+ */
+export declare const JobDescriptorSchema: z.ZodPipe<z.ZodObject<{
+    [x: string]: any;
+}, z.core.$strip>, z.ZodTransform<JobAssetDescriptor, Record<string, unknown>>>;
+/**
+ * Flow descriptor config — the `workers/flow` kind exposes outside-job
+ * dispatch (spawn + wait + fire) to any caller. Routing is handled
+ * internally by per-scope implementations; no descriptor-level config.
+ */
+export declare const FlowDescriptorConfigSchema: z.ZodObject<{}, z.core.$strip>;
+export declare const FlowDescriptorSchema: z.ZodObject<{
+    [x: string]: any;
+}, z.core.$strip>;
+export type FlowAssetDescriptor = RuntimeDescriptor & {
+    kind: 'workers/flow';
+};
+/**
+ * Usage-emitter descriptor — `workers/usage-emitter` is the abstract sink
+ * for per-job-handle metering events (code execution seconds). The impl
+ * is registered by the billing layer (account package) so the workers
+ * package never depends on it directly.
+ */
+export declare const UsageEmitterDescriptorConfigSchema: z.ZodObject<{}, z.core.$strip>;
+export declare const UsageEmitterDescriptorSchema: z.ZodObject<{
+    [x: string]: any;
+}, z.core.$strip>;
+export type UsageEmitterAssetDescriptor = z.infer<typeof UsageEmitterDescriptorSchema>;
+declare module '@vibesdotdev/kernel/schemas/asset' {
+    interface RuntimeAssetSchemaRegistry {
+        'workers/worker': WorkerAssetDescriptor;
+        'workers/job': JobAssetDescriptor;
+        'workers/flow': FlowAssetDescriptor;
+        'workers/usage-emitter': UsageEmitterAssetDescriptor;
+    }
+}
+//# sourceMappingURL=descriptors.d.ts.map

package/dist/schemas/descriptors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptors.d.ts","sourceRoot":"","sources":["../../src/schemas/descriptors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAA2B,KAAK,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AACzG,OAAO,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAO/E,qEAAqE;AACrE,eAAO,MAAM,aAAa;;;;;;EAAuE,CAAC;AAClG,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD;;;;GAIG;AACH,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAC9B,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;EAAwD,CAAC;AACvF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;iBASvC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB;;iBAGlC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GACpD;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B,CAAC,CAAC,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqGpC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GACjD;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GACvB,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,GAAG;IAAE,QAAQ,EAAE,WAAW,CAAA;CAAE,CAAC;AAExE,eAAO,MAAM,wBAAwB,wCAAoC,CAAC;AAC1E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAa1E;;GAEG;AACH,eAAO,MAAM,mBAAmB;;+EA4BC,CAAC;AAElC;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,gCAAe,CAAC;AAEvD,eAAO,MAAM,oBAAoB;;iBAGhC,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG,iBAAiB,GAAG;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC;AAE/E;;;;;GAKG;AACH,eAAO,MAAM,kCAAkC,gCAAe,CAAC;AAE/D,eAAO,MAAM,4BAA4B;;iBAGxC,CAAC;AACF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEvF,OAAO,QAAQ,mCAAmC,CAAC;IAClD,UAAU,0BAA0B;QACnC,gBAAgB,EAAE,qBAAqB,CAAC;QACxC,aAAa,EAAE,kBAAkB,CAAC;QAClC,cAAc,EAAE,mBAAmB,CAAC;QACpC,uBAAuB,EAAE,2BAA2B,CAAC;KACrD;CACD"}