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

package/dist/schemas/adapter.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Worker Adapter Descriptor Schema
+ *
+ * Schema for worker/adapter kind descriptors.
+ * Adapters provide queue backend implementations (kafka, ipc, memory, etc.).
+ */
+import * as z from 'zod/v4';
+import type { RuntimeScope } from '@vibesdotdev/kernel/schemas/scope';
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+/**
+ * Adapter capabilities schema
+ */
+export declare const WorkerAdapterCapabilitiesSchema: z.ZodObject<{
+    persistent: z.ZodBoolean;
+    distributed: z.ZodBoolean;
+    priorities: z.ZodBoolean;
+    scheduling: z.ZodBoolean;
+    progress: z.ZodBoolean;
+    crossHardware: z.ZodOptional<z.ZodBoolean>;
+    keyedClaims: z.ZodOptional<z.ZodBoolean>;
+    coalescedEnqueue: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const WorkerAdapterRequirementsSchema: 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>;
+/**
+ * Worker adapter descriptor schema
+ */
+export declare const WorkerAdapterDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    capabilityId: z.ZodOptional<z.ZodString>;
+    requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    config: z.ZodOptional<z.ZodUnknown>;
+    retention: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+        maxEntries: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        cascadeFrom: z.ZodOptional<z.ZodString>;
+        ageField: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        enforcedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    kind: z.ZodLiteral<"workers/adapter">;
+    provider: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodObject<{
+        persistent: z.ZodBoolean;
+        distributed: z.ZodBoolean;
+        priorities: z.ZodBoolean;
+        scheduling: z.ZodBoolean;
+        progress: z.ZodBoolean;
+        crossHardware: z.ZodOptional<z.ZodBoolean>;
+        keyedClaims: z.ZodOptional<z.ZodBoolean>;
+        coalescedEnqueue: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        consumer: "consumer";
+        cloud: "cloud";
+    }>>>;
+    priority: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type WorkerAdapterCapabilities = z.infer<typeof WorkerAdapterCapabilitiesSchema>;
+export type WorkerAdapterRequirements = z.infer<typeof WorkerAdapterRequirementsSchema>;
+export type WorkerAdapterDescriptor = z.infer<typeof WorkerAdapterDescriptorSchema>;
+export declare function workerAdapterSatisfiesRequirements(descriptor: WorkerAdapterDescriptor, requirements?: WorkerAdapterRequirements): boolean;
+/** Whether `id` names a context this host composed (registered and loadable). */
+export declare function hostComposesContext(runtime: Pick<VibesRuntime, 'hasContext' | 'assets'>): (id: string) => boolean;
+/** Every context the adapter declares as required is composed. */
+export declare function workerAdapterContextsComposed(composed: (id: string) => boolean): (descriptor: WorkerAdapterDescriptor) => boolean;
+/**
+ * The `workers/adapter` kind resolver. The kernel hands it the enabled
+ * candidates the query admitted; it never names a provider.
+ *
+ * Order: the requested hosting provider; then the kernel `priority`, highest
+ * first; then hardware fit (distributed on cloud, local persistent on
+ * consumer); then registration order. Declaring a `provider` never excludes
+ * an adapter.
+ */
+export declare function resolveWorkerAdapterDescriptor(candidates: WorkerAdapterDescriptor[], scope: RuntimeScope, requirements?: WorkerAdapterRequirements): WorkerAdapterDescriptor | undefined;
+/**
+ * The kind resolver the kernel calls. The kernel passes its asset context as
+ * the third argument, so requirements never come from here: callers admit
+ * them through the query's filter.
+ */
+export declare function resolveWorkerAdapterKind(candidates: WorkerAdapterDescriptor[], scope: RuntimeScope): WorkerAdapterDescriptor | undefined;
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/schemas/adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;iBA4B1C,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;;;;;;iBAA4C,CAAC;AAEzF;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmBxC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,wBAAgB,kCAAkC,CACjD,UAAU,EAAE,uBAAuB,EACnC,YAAY,GAAE,yBAA8B,GAC1C,OAAO,CAYT;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,QAAQ,CAAC,GAClD,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAEzB;AAED,kEAAkE;AAClE,wBAAgB,6BAA6B,CAC5C,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,GAC/B,CAAC,UAAU,EAAE,uBAAuB,KAAK,OAAO,CAElD;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC7C,UAAU,EAAE,uBAAuB,EAAE,EACrC,KAAK,EAAE,YAAY,EACnB,YAAY,GAAE,yBAA8B,GAC1C,uBAAuB,GAAG,SAAS,CAyBrC;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACvC,UAAU,EAAE,uBAAuB,EAAE,EACrC,KAAK,EAAE,YAAY,GACjB,uBAAuB,GAAG,SAAS,CAErC"}

package/dist/schemas/adapter.js

@@ -0,0 +1,119 @@
+/**
+ * Worker Adapter Descriptor Schema
+ *
+ * Schema for worker/adapter kind descriptors.
+ * Adapters provide queue backend implementations (kafka, ipc, memory, etc.).
+ */
+import * as z from 'zod/v4';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel/schemas/descriptor';
+import { RuntimeHardwareSchema } from '@vibesdotdev/kernel/schemas/scope';
+/**
+ * Adapter capabilities schema
+ */
+export const WorkerAdapterCapabilitiesSchema = z.object({
+    /** Jobs survive process restarts */
+    persistent: z.boolean(),
+    /** Multi-node support */
+    distributed: z.boolean(),
+    /** Job prioritization */
+    priorities: z.boolean(),
+    /** Delayed/scheduled jobs */
+    scheduling: z.boolean(),
+    /** Progress tracking */
+    progress: z.boolean(),
+    /**
+     * A producer and consumer on different runtime hardware can share the same
+     * physical queue. This is required for jobs produced in cloud runtimes and
+     * drained by consumer hosts with native dependencies.
+     */
+    crossHardware: z.boolean().optional(),
+    /**
+     * Its queues implement `claimKeyed`: one owner step that reads a caller key
+     * and writes per the keyed-claim rules, guarded by the key's stored
+     * generation. `WorkersClient.startJobOnce` refuses an adapter without it.
+     */
+    keyedClaims: z.boolean().optional(),
+    /**
+     * Its queues implement `enqueueCoalesced`: at most one delayed or pending
+     * job per coalesce key, decided in one owner step.
+     */
+    coalescedEnqueue: z.boolean().optional()
+});
+export const WorkerAdapterRequirementsSchema = WorkerAdapterCapabilitiesSchema.partial();
+/**
+ * Worker adapter descriptor schema
+ */
+export const WorkerAdapterDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('workers/adapter'),
+    /** Optional provider id used for provider-contributed adapters. */
+    provider: z.string().min(1).optional(),
+    /** Adapter capabilities */
+    capabilities: WorkerAdapterCapabilitiesSchema,
+    /** Hardware targets (consumer, cloud) - empty means all */
+    hardware: z.array(RuntimeHardwareSchema).optional(),
+    /**
+     * The kernel's descriptor `priority` orders adapters (higher wins, default 0).
+     * An adapter that cannot serve without a binding or connection declares it
+     * as the kernel's `requiredContext`; it is a candidate only where every one
+     * is composed. The framework names no provider.
+     */
+    priority: z.number().int().optional()
+});
+export function workerAdapterSatisfiesRequirements(descriptor, requirements = {}) {
+    const caps = new Map(Object.entries(descriptor.capabilities));
+    for (const [capability, required] of Object.entries(requirements)) {
+        if (required === undefined)
+            continue;
+        // Optional capabilities are absent-capability false. Explicit false
+        // requirements remain meaningful and compare against that value.
+        if ((caps.get(capability) ?? false) !== required)
+            return false;
+    }
+    return true;
+}
+/** Whether `id` names a context this host composed (registered and loadable). */
+export function hostComposesContext(runtime) {
+    return (id) => runtime.hasContext(id) && runtime.assets('context').hasDiscoveryImplementation(id);
+}
+/** Every context the adapter declares as required is composed. */
+export function workerAdapterContextsComposed(composed) {
+    return (descriptor) => (descriptor.requiredContext ?? []).every(composed);
+}
+/**
+ * The `workers/adapter` kind resolver. The kernel hands it the enabled
+ * candidates the query admitted; it never names a provider.
+ *
+ * Order: the requested hosting provider; then the kernel `priority`, highest
+ * first; then hardware fit (distributed on cloud, local persistent on
+ * consumer); then registration order. Declaring a `provider` never excludes
+ * an adapter.
+ */
+export function resolveWorkerAdapterDescriptor(candidates, scope, requirements = {}) {
+    const hardware = scope.hardware;
+    const matching = candidates.filter((descriptor) => descriptor.enabled !== false &&
+        workerAdapterSatisfiesRequirements(descriptor, requirements) &&
+        (!descriptor.hardware?.length || descriptor.hardware.includes(hardware)));
+    if (matching.length === 0)
+        return undefined;
+    const requestedProvider = scope.hosting.provider;
+    if (requestedProvider) {
+        const providerMatch = matching.find((descriptor) => descriptor.provider === requestedProvider);
+        if (providerMatch)
+            return providerMatch;
+    }
+    const fits = (descriptor) => (hardware === 'cloud'
+        ? descriptor.capabilities.distributed
+        : descriptor.capabilities.persistent && !descriptor.capabilities.distributed)
+        ? 1
+        : 0;
+    return [...matching].sort((left, right) => (right.priority ?? 0) - (left.priority ?? 0) || fits(right) - fits(left))[0];
+}
+/**
+ * The kind resolver the kernel calls. The kernel passes its asset context as
+ * the third argument, so requirements never come from here: callers admit
+ * them through the query's filter.
+ */
+export function resolveWorkerAdapterKind(candidates, scope) {
+    return resolveWorkerAdapterDescriptor(candidates, scope);
+}
+//# sourceMappingURL=adapter.js.map

package/dist/schemas/adapter.js.map

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

package/dist/schemas/admission.d.ts

@@ -0,0 +1,50 @@
+import * as z from 'zod/v4';
+export declare const AdmissionPolicySchema: z.ZodObject<{
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    pollIntervalMs: z.ZodDefault<z.ZodNumber>;
+    ensureIntervalMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type AdmissionPolicy = z.infer<typeof AdmissionPolicySchema>;
+export declare const AdmissionDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    capabilityId: z.ZodOptional<z.ZodString>;
+    requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    config: z.ZodOptional<z.ZodUnknown>;
+    retention: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+        maxEntries: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        cascadeFrom: z.ZodOptional<z.ZodString>;
+        ageField: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        enforcedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    kind: z.ZodLiteral<"workers/admission">;
+    policy: z.ZodPrefault<z.ZodObject<{
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+        pollIntervalMs: z.ZodDefault<z.ZodNumber>;
+        ensureIntervalMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type AdmissionDescriptor = z.infer<typeof AdmissionDescriptorSchema>;
+/** False means readiness is transient. Permanent refusal must throw its original error. */
+export declare const AdmissionCapabilitySchema: z.ZodObject<{
+    ensure: z.ZodFunction<z.ZodTuple<readonly [z.ZodInstanceOf<AbortSignal>], null>, z.ZodPromise<z.ZodVoid>>;
+    probe: z.ZodFunction<z.ZodTuple<readonly [z.ZodInstanceOf<AbortSignal>], null>, z.ZodPromise<z.ZodBoolean>>;
+}, z.core.$strip>;
+export type AdmissionCapability = z.infer<typeof AdmissionCapabilitySchema>;
+export declare const AdmissionOptionsSchema: z.ZodObject<{
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    pollIntervalMs: z.ZodOptional<z.ZodNumber>;
+    ensureIntervalMs: z.ZodOptional<z.ZodNumber>;
+    signal: z.ZodOptional<z.ZodInstanceOf<AbortSignal>>;
+}, z.core.$strip>;
+export type AdmissionOptions = z.infer<typeof AdmissionOptionsSchema>;
+//# sourceMappingURL=admission.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"admission.d.ts","sourceRoot":"","sources":["../../src/schemas/admission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,2FAA2F;AAC3F,eAAO,MAAM,yBAAyB;;;iBAGpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,eAAO,MAAM,sBAAsB;;;;;iBAKjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/schemas/admission.js

@@ -0,0 +1,23 @@
+import * as z from 'zod/v4';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel';
+export const AdmissionPolicySchema = z.object({
+    timeoutMs: z.number().positive().max(2_147_483_647).default(30_000),
+    pollIntervalMs: z.number().positive().max(2_147_483_647).default(250),
+    ensureIntervalMs: z.number().positive().max(2_147_483_647).default(2_000)
+});
+export const AdmissionDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('workers/admission'),
+    policy: AdmissionPolicySchema.prefault({})
+});
+/** False means readiness is transient. Permanent refusal must throw its original error. */
+export const AdmissionCapabilitySchema = z.object({
+    ensure: z.function({ input: [z.instanceof(AbortSignal)], output: z.promise(z.void()) }),
+    probe: z.function({ input: [z.instanceof(AbortSignal)], output: z.promise(z.boolean()) })
+});
+export const AdmissionOptionsSchema = z.object({
+    timeoutMs: AdmissionPolicySchema.shape.timeoutMs.removeDefault().optional(),
+    pollIntervalMs: AdmissionPolicySchema.shape.pollIntervalMs.removeDefault().optional(),
+    ensureIntervalMs: AdmissionPolicySchema.shape.ensureIntervalMs.removeDefault().optional(),
+    signal: z.instanceof(AbortSignal).optional()
+});
+//# sourceMappingURL=admission.js.map

package/dist/schemas/admission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admission.js","sourceRoot":"","sources":["../../src/schemas/admission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACnE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IACrE,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;CACzE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,uBAAuB,CAAC,MAAM,CAAC;IACvE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC;IACpC,MAAM,EAAE,qBAAqB,CAAC,QAAQ,CAAC,EAAE,CAAC;CAC1C,CAAC,CAAC;AAGH,2FAA2F;AAC3F,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;IACvF,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;CACzF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,SAAS,EAAE,qBAAqB,CAAC,KAAK,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE;IAC3E,cAAc,EAAE,qBAAqB,CAAC,KAAK,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE;IACrF,gBAAgB,EAAE,qBAAqB,CAAC,KAAK,CAAC,gBAAgB,CAAC,aAAa,EAAE,CAAC,QAAQ,EAAE;IACzF,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC"}

package/dist/schemas/cancellation.d.ts

@@ -0,0 +1,96 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { JsonValue } from '@vibesdotdev/kernel/schemas/json';
+import * as z from 'zod/v4';
+export declare const CancellationSourceSchema: z.ZodEnum<{
+    cascade: "cascade";
+    "graph-stop": "graph-stop";
+    "graph-cancel": "graph-cancel";
+    deadline: "deadline";
+    disposal: "disposal";
+    "launcher-exit": "launcher-exit";
+}>;
+export declare const CancellationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    by: z.ZodLiteral<"invocation">;
+    actor: z.ZodObject<{
+        agentId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        harness: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        agentSystemId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        harnessSessionId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        userId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        orgId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        projectId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        teamId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        home: z.ZodOptional<z.ZodEnum<{
+            user: "user";
+            organization: "organization";
+            team: "team";
+        }>>;
+        projectIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>>>;
+        participantId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        sessionId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+    }, z.core.$strip>;
+    reason: z.ZodString;
+    cascadedFrom: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    by: z.ZodLiteral<"system">;
+    source: z.ZodEnum<{
+        cascade: "cascade";
+        "graph-stop": "graph-stop";
+        "graph-cancel": "graph-cancel";
+        deadline: "deadline";
+        disposal: "disposal";
+        "launcher-exit": "launcher-exit";
+    }>;
+    reason: z.ZodString;
+    cascadedFrom: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "by">;
+export type Cancellation = z.output<typeof CancellationSchema>;
+export declare const CancellationAttributionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    by: z.ZodLiteral<"invocation">;
+    actor: z.ZodObject<{
+        agentId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        harness: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        agentSystemId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        harnessSessionId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        userId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        orgId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        projectId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        teamId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        home: z.ZodOptional<z.ZodEnum<{
+            user: "user";
+            organization: "organization";
+            team: "team";
+        }>>;
+        projectIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>>>;
+        participantId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        sessionId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+    }, z.core.$strip>;
+}, z.core.$strict>, z.ZodObject<{
+    by: z.ZodLiteral<"system">;
+    source: z.ZodEnum<{
+        cascade: "cascade";
+        "graph-stop": "graph-stop";
+        "graph-cancel": "graph-cancel";
+        deadline: "deadline";
+        disposal: "disposal";
+        "launcher-exit": "launcher-exit";
+    }>;
+}, z.core.$strict>], "by">;
+export type CancellationAttribution = z.output<typeof CancellationAttributionSchema>;
+export declare const CancelJobOptionsSchema: z.ZodObject<{
+    queueId: z.ZodOptional<z.ZodString>;
+    target: z.ZodOptional<z.ZodString>;
+    reason: z.ZodString;
+}, z.core.$strict>;
+export type CancelJobOptions = z.output<typeof CancelJobOptionsSchema>;
+export declare function parseCancelJobOptions(value: CancelJobOptions | JsonValue | undefined): CancelJobOptions;
+/** Parse an untyped cancellation exactly once and preserve the contract's actor refusal. */
+export declare function parseCancellation(value: Cancellation | JsonValue | undefined): Cancellation;
+/**
+ * Build the admitted cancellation record from a signal's winning cause.
+ * AbortSignal.any preserves the winning source's reason, so lifecycle and
+ * deadline cancellations remain distinguishable after async work settles.
+ */
+export declare function cancellationForSignal(signal: AbortSignal, lifecycleSignal: AbortSignal, attribution: CancellationAttribution | undefined, reason: string): Cancellation;
+export declare function invocationCancellation(runtime: Pick<RuntimeRef, 'scope'>, reason: string): Cancellation;
+//# sourceMappingURL=cancellation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cancellation.d.ts","sourceRoot":"","sources":["../../src/schemas/cancellation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,eAAO,MAAM,wBAAwB;;;;;;;EAOnC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAa7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE/D,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAGxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAErF,eAAO,MAAM,sBAAsB;;;;kBAIxB,CAAC;AACZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEvE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,gBAAgB,CAavG;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,CA2B3F;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,WAAW,EACnB,eAAe,EAAE,WAAW,EAC5B,WAAW,EAAE,uBAAuB,GAAG,SAAS,EAChD,MAAM,EAAE,MAAM,GACZ,YAAY,CAgCd;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAQvG"}

package/dist/schemas/cancellation.js

@@ -0,0 +1,123 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { RuntimeActorSchema } from '@vibesdotdev/kernel/schemas/scope';
+import * as z from 'zod/v4';
+const CancellationReasonSchema = z.string().trim().min(1, 'A cancellation reason is required.');
+export const CancellationSourceSchema = z.enum([
+    'cascade',
+    'graph-stop',
+    'graph-cancel',
+    'deadline',
+    'disposal',
+    'launcher-exit'
+]);
+export const CancellationSchema = z.discriminatedUnion('by', [
+    z.object({
+        by: z.literal('invocation'),
+        actor: RuntimeActorSchema,
+        reason: CancellationReasonSchema,
+        cascadedFrom: z.string().min(1).optional()
+    }).strict(),
+    z.object({
+        by: z.literal('system'),
+        source: CancellationSourceSchema,
+        reason: CancellationReasonSchema,
+        cascadedFrom: z.string().min(1).optional()
+    }).strict()
+]);
+export const CancellationAttributionSchema = z.discriminatedUnion('by', [
+    z.object({ by: z.literal('invocation'), actor: RuntimeActorSchema }).strict(),
+    z.object({ by: z.literal('system'), source: CancellationSourceSchema }).strict()
+]);
+export const CancelJobOptionsSchema = z.object({
+    queueId: z.string().min(1).optional(),
+    target: z.string().min(1).optional(),
+    reason: CancellationReasonSchema
+}).strict();
+export function parseCancelJobOptions(value) {
+    const parsed = CancelJobOptionsSchema.safeParse(value);
+    if (parsed.success)
+        return parsed.data;
+    const reasonInvalid = parsed.error.issues.some((issue) => issue.path.length === 1 && issue.path[0] === 'reason');
+    if (reasonInvalid) {
+        throw new CapabilityError('Cancellation requires a reason.', 'INVALID_INPUT', {
+            reason: 'cancel-reason-required'
+        });
+    }
+    throw new CapabilityError('Invalid cancellation options.', 'INVALID_INPUT', {
+        reason: 'cancel-options-invalid',
+        details: { fields: parsed.error.issues.map((issue) => issue.path.map(String).join('.')) }
+    });
+}
+/** Parse an untyped cancellation exactly once and preserve the contract's actor refusal. */
+export function parseCancellation(value) {
+    const parsed = CancellationSchema.safeParse(value);
+    if (parsed.success)
+        return parsed.data;
+    const actorMissing = parsed.error.issues.some((issue) => issue.path.length === 1 && issue.path[0] === 'actor');
+    if (actorMissing) {
+        throw new CapabilityError('Invocation cancellation requires an actor.', 'INVALID_INPUT', {
+            reason: 'cancel-actor-required'
+        });
+    }
+    const reasonMissing = parsed.error.issues.some((issue) => issue.path.length === 1 && issue.path[0] === 'reason');
+    if (reasonMissing) {
+        throw new CapabilityError('Cancellation requires a reason.', 'INVALID_INPUT', {
+            reason: 'cancel-reason-required'
+        });
+    }
+    throw new CapabilityError('Invalid cancellation record.', 'INVALID_INPUT', {
+        reason: 'cancel-cancellation-invalid',
+        details: {
+            fields: parsed.error.issues.map((issue) => ({
+                path: issue.path.map(String).join('.'),
+                code: issue.code
+            }))
+        }
+    });
+}
+/**
+ * Build the admitted cancellation record from a signal's winning cause.
+ * AbortSignal.any preserves the winning source's reason, so lifecycle and
+ * deadline cancellations remain distinguishable after async work settles.
+ */
+export function cancellationForSignal(signal, lifecycleSignal, attribution, reason) {
+    const signalReason = signal.reason;
+    const waitCause = signalReason instanceof CapabilityError ? signalReason.cause : undefined;
+    const disposalWait = signalReason instanceof CapabilityError &&
+        signalReason.code === 'CANCELLED' &&
+        signalReason.reason === 'wait-aborted' &&
+        (signalReason.details?.cause === 'runtime-disposed' ||
+            (signalReason.details?.cause === 'caller-aborted' &&
+                waitCause instanceof CapabilityError && waitCause.reason === 'runtime-disposed'));
+    const disposed = disposalWait ||
+        (lifecycleSignal.aborted && signalReason === lifecycleSignal.reason);
+    const deadline = (signalReason instanceof CapabilityError && signalReason.code === 'TIMEOUT') ||
+        (signalReason instanceof Error && signalReason.name === 'TimeoutError');
+    if (disposed)
+        return parseCancellation({ by: 'system', source: 'disposal', reason });
+    if (deadline)
+        return parseCancellation({ by: 'system', source: 'deadline', reason });
+    // A cancel the runtime makes because its caller's signal ended, with no invocation naming who, is a
+    // cascade from that caller: a system cancel that names its source. Only untyped edges refuse a
+    // missing actor (`parseCancellation`), never the runtime's own cleanup.
+    if (!attribution)
+        return parseCancellation({ by: 'system', source: 'cascade', reason });
+    const admitted = CancellationAttributionSchema.safeParse(attribution);
+    if (!admitted.success) {
+        throw new CapabilityError('Cancellation attribution is invalid.', 'INVALID_INPUT', {
+            reason: 'cancel-attribution-invalid',
+            cause: admitted.error
+        });
+    }
+    return parseCancellation({ ...admitted.data, reason });
+}
+export function invocationCancellation(runtime, reason) {
+    const actor = runtime.scope.actor;
+    if (!actor) {
+        throw new CapabilityError('Invocation cancellation requires an actor.', 'INVALID_INPUT', {
+            reason: 'cancel-actor-required'
+        });
+    }
+    return { by: 'invocation', actor, reason };
+}
+//# sourceMappingURL=cancellation.js.map

package/dist/schemas/cancellation.js.map

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

package/dist/schemas/claim.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 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 { hostWorkspaceRoot } from '@vibesdotdev/kernel/context/workspace-path.context.impl';
+export declare const WORKER_CLAIM_SCHEMA_VERSION: 1;
+export declare const MAX_PHYSICAL_QUEUE_NAME_LENGTH = 200;
+/** Exact physical-partition contract advertised by a worker descriptor. */
+export declare const WorkerClaimPartitionSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    family: z.ZodString;
+    version: z.ZodNumber;
+    workspaceScoped: z.ZodBoolean;
+}, z.core.$strict>;
+export type WorkerClaimPartition = z.infer<typeof WorkerClaimPartitionSchema>;
+/** Claim contract owned by a workers/job descriptor. */
+export declare const JobClaimRequirementsSchema: 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>;
+export type JobClaimRequirements = z.infer<typeof JobClaimRequirementsSchema>;
+export declare const WorkerSupportedJobSchema: z.ZodObject<{
+    versions: z.ZodArray<z.ZodNumber>;
+    capabilities: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+export type WorkerSupportedJob = z.infer<typeof WorkerSupportedJobSchema>;
+/** Live identity contract for IPC handshakes and durable claim evidence. */
+export declare const WorkerClaimIdentitySchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    workerInstanceId: z.ZodString;
+    workerId: z.ZodString;
+    hardware: z.ZodEnum<{
+        consumer: "consumer";
+        cloud: "cloud";
+    }>;
+    workspaceRoot: z.ZodString;
+    workspaceToolingId: z.ZodString;
+    sourceEntrypoint: z.ZodString;
+    sourceRevision: z.ZodString;
+    startedAt: z.ZodISODateTime;
+    supportedJobs: z.ZodRecord<z.ZodString, z.ZodObject<{
+        versions: z.ZodArray<z.ZodNumber>;
+        capabilities: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type WorkerClaimIdentity = z.infer<typeof WorkerClaimIdentitySchema>;
+/**
+ * Derive a provider-safe physical queue name for an exact claim partition.
+ * Workspace-scoped contracts refuse ambient/default identity.
+ */
+export declare function deriveWorkerClaimQueueName(baseQueue: string, partition: WorkerClaimPartition, workspaceToolingId?: string): string;
+/** The runtime a protected queue contract reads its host workspace from. */
+export type ClaimWorkspaceRuntime = Parameters<typeof hostWorkspaceRoot>[0];
+/**
+ * The host workspace a protected queue contract is scoped to: the declared
+ * root, else the environment's captured binding (rc02-rc03 §2.4). Queue names
+ * are process-level identity, so a call's overlay never moves them. An unbound
+ * host fails closed with `workspace-unbound`.
+ */
+export interface BoundWorkspaceIdentity {
+    workspaceRoot: string;
+    workspaceToolingId: string;
+}
+export declare function resolveBoundWorkspaceIdentity(runtime: ClaimWorkspaceRuntime): BoundWorkspaceIdentity;
+/** Resolve a base queue through an optional protected partition contract. */
+export declare function resolvePhysicalQueueName(baseQueue: string, partition: WorkerClaimPartition | undefined, runtime: ClaimWorkspaceRuntime): string;
+/** Exact family/version/scope equality; no implicit downgrade or version range. */
+export declare function workerClaimPartitionsMatch(worker: WorkerClaimPartition, job: WorkerClaimPartition): boolean;
+//# sourceMappingURL=claim.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claim.d.ts","sourceRoot":"","sources":["../../src/schemas/claim.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,yDAAyD,CAAC;AAE5F,eAAO,MAAM,2BAA2B,EAAG,CAAU,CAAC;AACtD,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAQlD,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B;;;;;kBAO7B,CAAC;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,wDAAwD;AACxD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;kBAkBpC,CAAC;AACJ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,wBAAwB;;;kBAK3B,CAAC;AACX,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,4EAA4E;AAC5E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;kBAa5B,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAqB5E;;;GAGG;AACH,wBAAgB,0BAA0B,CACzC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,oBAAoB,EAC/B,kBAAkB,CAAC,EAAE,MAAM,GACzB,MAAM,CAwBR;AAED,4EAA4E;AAC5E,MAAM,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,qBAAqB,GAAG,sBAAsB,CAMpG;AAED,6EAA6E;AAC7E,wBAAgB,wBAAwB,CACvC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,oBAAoB,GAAG,SAAS,EAC3C,OAAO,EAAE,qBAAqB,GAC5B,MAAM,CAMR;AAED,mFAAmF;AACnF,wBAAgB,0BAA0B,CACzC,MAAM,EAAE,oBAAoB,EAC5B,GAAG,EAAE,oBAAoB,GACvB,OAAO,CAST"}