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

package/dist/client/operations/control/signals.js

@@ -0,0 +1,20 @@
+import {} from "../../../schemas/cancellation.js";
+import { CapabilityError } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+export function jobCancelledBeforeStart(jobId) {
+    return new CapabilityError(`Job ${jobId} was not started: its caller was cancelled.`, 'CANCELLED', { reason: 'job-cancelled-before-start', details: { jobId } });
+}
+export function invocationCancellationAttribution(runtime) {
+    const actor = runtime.scope.actor;
+    return actor ? { by: 'invocation', actor } : undefined;
+}
+export function abortCancellationReason(signal, fallback) {
+    const reason = signal?.reason;
+    if (reason instanceof Error && reason.message.trim())
+        return reason.message.trim();
+    const parsedReason = z.string().trim().safeParse(reason);
+    if (parsedReason.success && parsedReason.data)
+        return parsedReason.data;
+    return fallback;
+}
+//# sourceMappingURL=signals.js.map

package/dist/client/operations/control/signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.js","sourceRoot":"","sources":["../../../../src/client/operations/control/signals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,MAAM,kCAAkC,CAAC;AAChF,OAAO,EAAE,eAAe,EAAqB,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACpD,OAAO,IAAI,eAAe,CAAC,OAAO,KAAK,6CAA6C,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,4BAA4B,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;AAClK,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,OAAqB;IACtE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAClC,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAA+B,EAAE,QAAgB;IACxF,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC;IAC9B,IAAI,MAAM,YAAY,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACnF,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACzD,IAAI,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,IAAI;QAAE,OAAO,YAAY,CAAC,IAAI,CAAC;IACxE,OAAO,QAAQ,CAAC;AACjB,CAAC"}

package/dist/client/operations/control/status.d.ts

@@ -0,0 +1,21 @@
+import { type ClientOperations } from '../schemas/ports.ts';
+export declare const CLOUD_WORKER_PROCESS_ID = "vibes-workers-cloud";
+export declare const CONSUMER_WORKER_PROCESS_ID = "vibes-workers-consumer";
+/**
+ * Is the worker runtime currently running? Looks at the resolved
+ * adapter; for IPC (consumer) this reflects PM's view via the
+ * workerManager. Subsumes `pm.workers.isRunning`.
+ */
+export declare function isRunning(owner: ClientOperations): Promise<boolean>;
+/**
+ * For IPC consumer scope: the active socket path PM reports for the
+ * worker process. Returns `undefined` on other scopes or when PM has
+ * no live worker. Subsumes `pm.workers.getSocketPath`.
+ */
+export declare function getSocketPath(owner: ClientOperations): Promise<string | undefined>;
+export declare function resolvePMHandle(owner: ClientOperations): Promise<{
+    getStatus: (processId: string) => Promise<{
+        socketPath?: string;
+    } | undefined>;
+} | undefined>;
+//# sourceMappingURL=status.d.ts.map

package/dist/client/operations/control/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/client/operations/control/status.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,eAAO,MAAM,uBAAuB,wBAAwB,CAAC;AAE7D,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AAEnE;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAMzE;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAYxF;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CACnE;IACA,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC;CAC9E,GACD,SAAS,CACX,CAUD"}

package/dist/client/operations/control/status.js

@@ -0,0 +1,52 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { WorkerUnavailableError } from '@vibesdotdev/pm/errors';
+import { settle } from "../../../core/settle.js";
+import {} from "../schemas/ports.js";
+export const CLOUD_WORKER_PROCESS_ID = 'vibes-workers-cloud';
+export const CONSUMER_WORKER_PROCESS_ID = 'vibes-workers-consumer';
+/**
+ * Is the worker runtime currently running? Looks at the resolved
+ * adapter; for IPC (consumer) this reflects PM's view via the
+ * workerManager. Subsumes `pm.workers.isRunning`.
+ */
+export async function isRunning(owner) {
+    const probe = await settle(() => owner.client.getAdapter().then((adapter) => adapter.isConnected()));
+    if (probe.ok)
+        return probe.value;
+    // No reachable worker runtime is "not running"; a probe that could not decide says so.
+    if (probe.thrown instanceof WorkerUnavailableError)
+        return false;
+    throw probe.thrown;
+}
+/**
+ * For IPC consumer scope: the active socket path PM reports for the
+ * worker process. Returns `undefined` on other scopes or when PM has
+ * no live worker. Subsumes `pm.workers.getSocketPath`.
+ */
+export async function getSocketPath(owner) {
+    const hardware = owner.runtime().scope.hardware;
+    const processId = hardware === 'cloud' ? CLOUD_WORKER_PROCESS_ID : CONSUMER_WORKER_PROCESS_ID;
+    const pm = await resolvePMHandle(owner);
+    if (!pm)
+        return undefined;
+    const state = await settle(() => pm.getStatus(processId));
+    if (state.ok)
+        return state.value?.socketPath;
+    throw new CapabilityError('PM could not report the worker process status.', 'UNAVAILABLE', {
+        reason: 'workers-pm-status-unavailable',
+        details: { processId },
+        cause: state.thrown
+    });
+}
+export async function resolvePMHandle(owner) {
+    try {
+        return await owner.runtime().context('pm/client');
+    }
+    catch (error) {
+        // Only an unregistered pm/client means "no PM here"; any other failure surfaces.
+        if (error instanceof Error && CapabilityError.isAbsenceOf(error, 'context', 'pm/client'))
+            return undefined;
+        throw error;
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/client/operations/control/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/client/operations/control/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAyB,MAAM,qBAAqB,CAAC;AAE5D,MAAM,CAAC,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAE7D,MAAM,CAAC,MAAM,0BAA0B,GAAG,wBAAwB,CAAC;AAEnE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAuB;IACtD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACrG,IAAI,KAAK,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC;IACjC,uFAAuF;IACvF,IAAI,KAAK,CAAC,MAAM,YAAY,sBAAsB;QAAE,OAAO,KAAK,CAAC;IACjE,MAAM,KAAK,CAAC,MAAM,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAuB;IAC1D,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC;IAChD,MAAM,SAAS,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,0BAA0B,CAAC;IAC9F,MAAM,EAAE,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,CAAC,EAAE;QAAE,OAAO,SAAS,CAAC;IAC1B,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1D,IAAI,KAAK,CAAC,EAAE;QAAE,OAAO,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC;IAC7C,MAAM,IAAI,eAAe,CAAC,gDAAgD,EAAE,aAAa,EAAE;QAC1F,MAAM,EAAE,+BAA+B;QACvC,OAAO,EAAE,EAAE,SAAS,EAAE;QACtB,KAAK,EAAE,KAAK,CAAC,MAAM;KACnB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAuB;IAM5D,IAAI,CAAC;QACJ,OAAO,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,OAAO,CAEjC,WAAW,CAAC,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,iFAAiF;QACjF,IAAI,KAAK,YAAY,KAAK,IAAI,eAAe,CAAC,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3G,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC"}

package/dist/client/operations/dispatch/enqueue.d.ts

@@ -0,0 +1,24 @@
+import { type EnqueueOptions, type EnqueueWithTimeoutResult, type WorkerEnqueueFailureClass, type EnqueueJobRetryOptions } from '../../../schemas/client.ts';
+import { type CaughtFailure } from '@vibesdotdev/kernel';
+import { type ClientOperations } from '../schemas/ports.ts';
+/**
+ * Enqueue a job and wait for completion. Subsumes `pm.workers.enqueue`.
+ */
+export declare function enqueue<T = unknown, TData = unknown>(owner: ClientOperations, queueId: string, jobData: TData, options?: EnqueueOptions): Promise<T>;
+/**
+ * Descriptor-aware async dispatch. Resolves the `workers/job` descriptor,
+ * enqueues onto its declared queue, and stamps metadata.type with the job id.
+ * Use this from schedulers and web/API surfaces that know the job descriptor
+ * id but should not duplicate queue-name routing tables.
+ */
+export declare function enqueueJobWithTimeout<T = unknown, TData = unknown>(owner: ClientOperations, jobId: string, jobData: TData, options?: Omit<EnqueueOptions, 'jobType'>): Promise<EnqueueWithTimeoutResult<T>>;
+export declare function enqueueJobWithRetry<T = unknown, TData = unknown>(owner: ClientOperations, jobId: string, jobData: TData, options?: EnqueueJobRetryOptions): Promise<EnqueueWithTimeoutResult<T>>;
+/**
+ * Enqueue and optionally wait with timeout. Subsumes
+ * `pm.workers.enqueueWithTimeout`. With `timeoutMs <= 0`, returns
+ * immediately with `{ status: 'pending' }`.
+ */
+export declare function enqueueWithTimeout<T = unknown, TData = unknown>(owner: ClientOperations, queueId: string, jobData: TData, options?: EnqueueOptions): Promise<EnqueueWithTimeoutResult<T>>;
+export declare function classifyWorkerEnqueueFailure(error: CaughtFailure): WorkerEnqueueFailureClass;
+export declare function queueIdToJobType(queueId: string): string;
+//# sourceMappingURL=enqueue.d.ts.map

package/dist/client/operations/dispatch/enqueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enqueue.d.ts","sourceRoot":"","sources":["../../../../src/client/operations/dispatch/enqueue.ts"],"names":[],"mappings":"AACA,OAAO,EACN,KAAK,cAAc,EAAoB,KAAK,wBAAwB,EAAE,KAAK,yBAAyB,EACpG,KAAK,sBAAsB,EAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMzD,OAAO,EAAE,KAAK,gBAAgB,EAA+B,MAAM,qBAAqB,CAAC;AAEzF;;GAEG;AACH,wBAAsB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAgB1J;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAMrN;AAED,wBAAsB,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAkB1M;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,GAAG,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAuCnM;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,aAAa,GAAG,yBAAyB,CAI5F;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/client/operations/dispatch/enqueue.js

@@ -0,0 +1,116 @@
+import { stampQueuedInvocation } from "../../../core/queued-invocation.js";
+import {} from "../../../schemas/client.js";
+import {} from '@vibesdotdev/kernel';
+import { WorkerTimeoutError, WorkerUnavailableError } from '@vibesdotdev/pm/errors';
+import { settle } from "../../../core/settle.js";
+import { keyedEnqueueOptions } from "../../../core/keyed-dispatch.js";
+import { pollForJobResult, waitForTerminalJob } from "../waiting.js";
+import { resolveEnqueueTarget } from "./target.js";
+import {} from "../schemas/ports.js";
+/**
+ * Enqueue a job and wait for completion. Subsumes `pm.workers.enqueue`.
+ */
+export async function enqueue(owner, queueId, jobData, options) {
+    const type = options?.jobType ?? queueIdToJobType(queueId);
+    const target = resolveEnqueueTarget(owner, queueId, options?.jobType);
+    const queue = await owner.client.getQueue(target.queueId, target.adapterRequirements);
+    const metadata = {
+        ...options?.metadata,
+        type
+    };
+    stampQueuedInvocation(owner.runtime(), metadata);
+    if (target.claim)
+        metadata.workerClaim = target.claim;
+    const enqueueOptions = { metadata };
+    if (options?.jobId)
+        enqueueOptions.jobId = options.jobId;
+    if (options?.resume)
+        enqueueOptions.resume = options.resume;
+    // A dispatch inside an executing job without a caller id is keyed by that job (keyed-dispatch.ts).
+    const jobId = await queue.enqueue(jobData, await keyedEnqueueOptions(owner.runtime(), type, jobData, enqueueOptions));
+    return pollForJobResult(owner, queue, jobId, options?.timeoutMs);
+}
+/**
+ * Descriptor-aware async dispatch. Resolves the `workers/job` descriptor,
+ * enqueues onto its declared queue, and stamps metadata.type with the job id.
+ * Use this from schedulers and web/API surfaces that know the job descriptor
+ * id but should not duplicate queue-name routing tables.
+ */
+export async function enqueueJobWithTimeout(owner, jobId, jobData, options = {}) {
+    const identity = owner.client.getJobQueueIdentity(jobId);
+    return owner.client.enqueueWithTimeout(identity.logicalQueue, jobData, {
+        ...options,
+        jobType: jobId
+    });
+}
+export async function enqueueJobWithRetry(owner, jobId, jobData, options = {}) {
+    const { maxAttempts = 3, delayMs = 250, classify = classifyWorkerEnqueueFailure, ...enqueueOptions } = options;
+    if (!Number.isInteger(maxAttempts) || maxAttempts < 1) {
+        throw new Error('maxAttempts must be a positive integer');
+    }
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        const enqueued = await settle(() => owner.client.enqueueJobWithTimeout(jobId, jobData, enqueueOptions));
+        if (enqueued.ok)
+            return enqueued.value;
+        if (attempt === maxAttempts || classify(enqueued.caught) !== 'transient')
+            throw enqueued.thrown;
+        // The declared policy's pause, owned by this runtime's lifecycle.
+        if (delayMs > 0)
+            await owner.runtime().lifecycle.delay(delayMs);
+    }
+    throw new Error(`Failed to enqueue job '${jobId}'`);
+}
+/**
+ * Enqueue and optionally wait with timeout. Subsumes
+ * `pm.workers.enqueueWithTimeout`. With `timeoutMs <= 0`, returns
+ * immediately with `{ status: 'pending' }`.
+ */
+export async function enqueueWithTimeout(owner, queueId, jobData, options = {}) {
+    const { jobType, timeoutMs = 5_000 } = options;
+    const type = jobType ?? queueIdToJobType(queueId);
+    const target = resolveEnqueueTarget(owner, queueId, jobType);
+    const queue = await owner.client.getQueue(target.queueId, target.adapterRequirements);
+    const metadata = {
+        ...options.metadata,
+        type
+    };
+    stampQueuedInvocation(owner.runtime(), metadata);
+    if (target.claim)
+        metadata.workerClaim = target.claim;
+    const enqueueOptions = { metadata };
+    if (options.jobId)
+        enqueueOptions.jobId = options.jobId;
+    // A dispatch inside an executing job without a caller id is keyed by that job (keyed-dispatch.ts).
+    const jobId = await queue.enqueue(jobData, await keyedEnqueueOptions(owner.runtime(), type, jobData, enqueueOptions));
+    if (timeoutMs <= 0)
+        return { jobId, status: 'pending' };
+    const settled = await waitForTerminalJob(owner, queue, jobId, {
+        timeoutMs,
+        pollIntervalMs: 250,
+        reason: `job ${jobId} to finish`
+    });
+    if (settled?.status === 'completed') {
+        // SAFETY: The completed job is from the queue selected for this caller's T result contract; the queue stores the handler's result without transforming it.
+        return { jobId, status: 'completed', result: settled.result };
+    }
+    if (settled?.status === 'failed') {
+        return { jobId, status: 'failed', error: settled.error || 'Unknown error' };
+    }
+    const finalJob = settled ?? (await queue.getJob(jobId));
+    const status = finalJob?.status;
+    return {
+        jobId,
+        status: status === 'completed' || status === 'failed' || status === 'processing'
+            ? status
+            : 'pending'
+    };
+}
+export function classifyWorkerEnqueueFailure(error) {
+    return error instanceof WorkerUnavailableError || error instanceof WorkerTimeoutError
+        ? 'transient'
+        : 'permanent';
+}
+export function queueIdToJobType(queueId) {
+    return queueId.replace(/-jobs$/, '').replace(/-/g, '.');
+}
+//# sourceMappingURL=enqueue.js.map

package/dist/client/operations/dispatch/enqueue.js.map

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

package/dist/client/operations/dispatch/keyed.d.ts

@@ -0,0 +1,26 @@
+import { type ClaimedJob, type FailedKeyedJob, type StartJobOnceOptions } from '../../../schemas/client.ts';
+import { type KeyedClaimReceipt } from '../../../core/queue-adapter.ts';
+import { type ClientOperations } from '../schemas/ports.ts';
+/**
+ * Idempotent claim on a caller-keyed job, decided in one step by the queue
+ * owner (`QueueAdapter.claimKeyed`): start it unless the job with this id is
+ * delayed, pending or running (`already-active`), or ended failed or
+ * cancelled (`terminal`, left to the dead-letter and cancel owners). An
+ * absent or completed job is started again. A failed job is started again
+ * (`restarted`) only when `restartFailed` admits it and only while it is
+ * still the failed admission that was judged; concurrent claims on one key
+ * start it once. Durable record delivery and its reconciliation use this so
+ * repeated dispatch of one record never runs its job twice at once. A queue
+ * whose adapter does not declare `keyedClaims` is refused `UNAVAILABLE`
+ * `workers-keyed-claim-unsupported` and nothing is enqueued.
+ */
+export declare function startJobOnce<TData = unknown>(owner: ClientOperations, jobId: string, jobData: TData, options: StartJobOnceOptions): Promise<ClaimedJob>;
+/**
+ * Record on the dead letter of a keyed job that a new attempt replaced it
+ * under the same key. A host that keeps no dead letters, or a failed job
+ * that never reached the store, has nothing to mark (confirmed absence).
+ */
+export declare function markDeadLetterRestarted(owner: ClientOperations, keyedJobId: string): Promise<void>;
+export declare function failedKeyedJob(jobId: string, receipt: KeyedClaimReceipt): FailedKeyedJob;
+export declare function claimedJob(jobId: string, queueId: string, receipt: KeyedClaimReceipt): ClaimedJob;
+//# sourceMappingURL=keyed.d.ts.map

package/dist/client/operations/dispatch/keyed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed.d.ts","sourceRoot":"","sources":["../../../../src/client/operations/dispatch/keyed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAE5G,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAGxE,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAkB7J;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOxG;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,cAAc,CASxF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAYjG"}

package/dist/client/operations/dispatch/keyed.js

@@ -0,0 +1,77 @@
+import {} from "../../../schemas/client.js";
+import { CapabilityError } from '@vibesdotdev/kernel';
+import {} from "../../../core/queue-adapter.js";
+import { getJobDescriptor } from "../catalog.js";
+import { prepareStart } from "./target.js";
+import {} from "../schemas/ports.js";
+/**
+ * Idempotent claim on a caller-keyed job, decided in one step by the queue
+ * owner (`QueueAdapter.claimKeyed`): start it unless the job with this id is
+ * delayed, pending or running (`already-active`), or ended failed or
+ * cancelled (`terminal`, left to the dead-letter and cancel owners). An
+ * absent or completed job is started again. A failed job is started again
+ * (`restarted`) only when `restartFailed` admits it and only while it is
+ * still the failed admission that was judged; concurrent claims on one key
+ * start it once. Durable record delivery and its reconciliation use this so
+ * repeated dispatch of one record never runs its job twice at once. A queue
+ * whose adapter does not declare `keyedClaims` is refused `UNAVAILABLE`
+ * `workers-keyed-claim-unsupported` and nothing is enqueued.
+ */
+export async function startJobOnce(owner, jobId, jobData, options) {
+    const { restartFailed, ...startOptions } = options;
+    const adapter = await owner.client.getAdapter(getJobDescriptor(owner, jobId).adapterRequirements);
+    const unsupported = () => new CapabilityError(`Job '${jobId}': worker adapter '${adapter.id}' cannot claim a caller key in one step.`, 'UNAVAILABLE', { reason: 'workers-keyed-claim-unsupported', retryable: false, details: { jobId, adapter: adapter.id } });
+    if (adapter.descriptor.capabilities.keyedClaims !== true)
+        throw unsupported();
+    const { queue, queueId, enqueueOptions } = await prepareStart(owner, jobId, startOptions);
+    if (!queue.claimKeyed)
+        throw unsupported();
+    const claim = { ...enqueueOptions, jobId: options.jobId };
+    let receipt = await queue.claimKeyed(jobData, claim);
+    if (receipt.outcome === 'failed' && restartFailed?.(failedKeyedJob(options.jobId, receipt)) === true) {
+        receipt = await queue.claimKeyed(jobData, { ...claim, restartGeneration: receipt.generation });
+        if (receipt.outcome === 'restarted')
+            await markDeadLetterRestarted(owner, options.jobId);
+    }
+    return claimedJob(options.jobId, queueId, receipt);
+}
+/**
+ * Record on the dead letter of a keyed job that a new attempt replaced it
+ * under the same key. A host that keeps no dead letters, or a failed job
+ * that never reached the store, has nothing to mark (confirmed absence).
+ */
+export async function markDeadLetterRestarted(owner, keyedJobId) {
+    if (!owner.runtime().hasKind('workers/dead-letter-store'))
+        return;
+    const { resolveDeadLetterStore } = await import("../../../dead-letter/dead-letters.js");
+    const store = await resolveDeadLetterStore(owner.runtime());
+    const entry = await store.get(keyedJobId);
+    if (!entry || entry.status === 'purged')
+        return;
+    await store.markReplayed(keyedJobId, keyedJobId);
+}
+export function failedKeyedJob(jobId, receipt) {
+    const failed = {
+        jobId,
+        status: 'failed',
+        metadata: receipt.job.metadata ?? {},
+        attemptsMade: receipt.job.attemptsMade
+    };
+    if (receipt.job.error)
+        failed.error = receipt.job.error;
+    return failed;
+}
+export function claimedJob(jobId, queueId, receipt) {
+    switch (receipt.outcome) {
+        case 'started':
+            return { jobId, queueId, claim: 'started' };
+        case 'restarted':
+            return { jobId, queueId, claim: 'restarted', existingStatus: 'failed' };
+        case 'active':
+            return { jobId, queueId, claim: 'already-active', existingStatus: receipt.job.status };
+        case 'cancelled':
+        case 'failed':
+            return { jobId, queueId, claim: 'terminal', existingStatus: receipt.job.status };
+    }
+}
+//# sourceMappingURL=keyed.js.map

package/dist/client/operations/dispatch/keyed.js.map

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

package/dist/client/operations/dispatch/queued-stream.d.ts

@@ -0,0 +1,9 @@
+import { type EnqueueStreamingOptions, type StreamingEvent } from '../../../schemas/client.ts';
+import { type ClientOperations } from '../schemas/ports.ts';
+/**
+ * Enqueue and stream events from the worker as the job runs. Subsumes
+ * `pm.workers.enqueueStreaming`. Yields `{ type, data }` events; raises
+ * `WorkerTimeoutError` past the configured deadline; honors `signal`.
+ */
+export declare function enqueueStreaming<TData = unknown>(owner: ClientOperations, queueId: string, jobData: TData, options?: EnqueueStreamingOptions): AsyncIterable<StreamingEvent>;
+//# sourceMappingURL=queued-stream.d.ts.map

package/dist/client/operations/dispatch/queued-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queued-stream.d.ts","sourceRoot":"","sources":["../../../../src/client/operations/dispatch/queued-stream.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,uBAAuB,EAAE,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAYjH,OAAO,EAAE,KAAK,gBAAgB,EAA+B,MAAM,qBAAqB,CAAC;AAEzF;;;;GAIG;AACH,wBAAuB,gBAAgB,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAE,uBAA4B,GAAG,aAAa,CAAC,cAAc,CAAC,CAsHvL"}

package/dist/client/operations/dispatch/queued-stream.js

@@ -0,0 +1,143 @@
+import { stampQueuedInvocation } from "../../../core/queued-invocation.js";
+import { cancellationForSignal } from "../../../schemas/cancellation.js";
+import {} from "../../../schemas/client.js";
+import { readWorkersConfig } from "../../../config/read.js";
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { WorkerJobFailedError, WorkerTimeoutError } from '@vibesdotdev/pm/errors';
+import {} from "../../../core/queue-adapter.js";
+import { settle } from "../../../core/settle.js";
+import { keyedEnqueueOptions } from "../../../core/keyed-dispatch.js";
+import { pauseUntilWoken, DEFAULT_POLL_INTERVAL_MS } from "../waiting.js";
+import { jobCancelledBeforeStart, invocationCancellationAttribution, abortCancellationReason } from "../control/signals.js";
+import { resolveEnqueueTarget } from "./target.js";
+import { queueIdToJobType } from "./enqueue.js";
+import { COMPLETION_EVENTS, FAILURE_EVENTS } from "../control/events.js";
+import {} from "../schemas/ports.js";
+/**
+ * Enqueue and stream events from the worker as the job runs. Subsumes
+ * `pm.workers.enqueueStreaming`. Yields `{ type, data }` events; raises
+ * `WorkerTimeoutError` past the configured deadline; honors `signal`.
+ */
+export async function* enqueueStreaming(owner, queueId, jobData, options = {}) {
+    const target = resolveEnqueueTarget(owner, queueId, options.jobType);
+    const queue = await owner.client.getQueue(target.queueId, target.adapterRequirements);
+    if (!queue.subscribeToEvents) {
+        throw new Error(`Queue adapter for "${queueId}" does not support event subscriptions; cannot stream.`);
+    }
+    const type = options.jobType ?? queueIdToJobType(queueId);
+    // A dispatch inside an executing job is keyed by that job (keyed-dispatch.ts); the stream subscribes under the id first.
+    const keyed = await keyedEnqueueOptions(owner.runtime(), type, jobData, { metadata: {} });
+    const jobId = keyed.jobId ?? crypto.randomUUID();
+    const events = [];
+    let jobCompleted = false;
+    // Woken by the queue's own events; the lifecycle-paced poll below is
+    // only the fallback for the authoritative `getJob` read.
+    let wake;
+    const onEvent = (event) => {
+        // Events wake the authoritative queue read. A historical, delayed or
+        // reordered terminal marker cannot finish the current admission.
+        // Other events remain readable history in their received order.
+        if (COMPLETION_EVENTS.has(event.event) || FAILURE_EVENTS.has(event.event) || event.event === 'cancelled')
+            return;
+        events.push({ type: event.event, data: event.data });
+    };
+    const unsubscribe = queue.subscribeToEvents(jobId, (event) => {
+        try {
+            onEvent(event);
+        }
+        finally {
+            wake?.();
+        }
+    });
+    const callerSignal = options.signal;
+    const signal = callerSignal
+        ? AbortSignal.any([callerSignal, owner.runtime().lifecycle.signal])
+        : owner.runtime().lifecycle.signal;
+    if (signal.aborted)
+        throw jobCancelledBeforeStart(jobId);
+    const cancellationAttribution = callerSignal ? invocationCancellationAttribution(owner.runtime()) : undefined;
+    const metadata = { type };
+    stampQueuedInvocation(owner.runtime(), metadata);
+    if (target.claim)
+        metadata.workerClaim = target.claim;
+    const admission = { jobId, metadata: { ...keyed.metadata, ...metadata } };
+    if (keyed.resume)
+        admission.resume = keyed.resume;
+    await queue.enqueue(jobData, admission);
+    let abortHandler;
+    let jobCancelled = false;
+    // The queue's answer to the caller's abort, awaited before anything is
+    // reported as cancelled. A stream must not claim a cancellation the queue
+    // has not accepted while the queued work keeps running.
+    let cancellation;
+    if (signal) {
+        abortHandler = () => {
+            if (jobCompleted || jobCancelled)
+                return;
+            jobCancelled = true;
+            // Wake the loop so it settles the cancellation and reports its outcome.
+            wake?.();
+            const reason = abortCancellationReason(signal, 'Streaming job was cancelled by its caller.');
+            const record = cancellationForSignal(signal, owner.runtime().lifecycle.signal, cancellationAttribution, reason);
+            cancellation = Promise.resolve(queue.cancelJob?.(jobId, record) ?? Promise.resolve(false));
+        };
+        signal.addEventListener('abort', abortHandler);
+        if (signal.aborted)
+            abortHandler();
+    }
+    const jobTimeoutMs = (await readWorkersConfig(owner.runtime())).client.jobTimeoutMs;
+    const deadline = Date.now() + jobTimeoutMs;
+    try {
+        while (!jobCompleted) {
+            if (jobCancelled || signal?.aborted) {
+                // Await the queue's answer rather than yielding a cancellation that
+                // has not happened. A refusal is surfaced as the failure it is; only
+                // an accepted cancel reports `cancelled`.
+                const outcome = await settle(() => cancellation ?? Promise.resolve(false));
+                if (!outcome.ok)
+                    throw outcome.thrown;
+                if (!outcome.value) {
+                    throw new CapabilityError('Queue did not cancel the streaming job its caller stopped; its work may still be running.', 'UNAVAILABLE', { reason: 'job-cancellation-refused', details: { jobId, queueId } });
+                }
+                yield { type: 'cancelled', data: { jobId, reason: 'AbortSignal triggered' } };
+                break;
+            }
+            if (Date.now() > deadline) {
+                throw new WorkerTimeoutError(jobId, jobTimeoutMs);
+            }
+            if (events.length > 0) {
+                yield events.shift();
+            }
+            else {
+                // Caller abort wakes this pause (abortHandler) rather than
+                // cancelling it, so the loop reports `cancelled` itself.
+                await pauseUntilWoken(owner, DEFAULT_POLL_INTERVAL_MS, undefined, (resume) => {
+                    wake = resume;
+                });
+                wake = undefined;
+            }
+            const job = await queue.getJob(jobId);
+            if (job?.status === 'completed') {
+                jobCompleted = true;
+                if (job.result !== undefined)
+                    yield { type: 'completed', data: job.result };
+            }
+            else if (job?.status === 'failed') {
+                jobCompleted = true;
+                throw new WorkerJobFailedError(jobId, job.error || 'Unknown error');
+            }
+            else if (job?.status === 'cancelled') {
+                jobCompleted = true;
+                yield { type: 'cancelled', data: { jobId, reason: 'Job cancelled' } };
+            }
+        }
+        while (events.length > 0)
+            yield events.shift();
+    }
+    finally {
+        if (signal && abortHandler)
+            signal.removeEventListener('abort', abortHandler);
+        unsubscribe();
+    }
+}
+//# sourceMappingURL=queued-stream.js.map

package/dist/client/operations/dispatch/queued-stream.js.map

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

package/dist/client/operations/dispatch/run.d.ts

@@ -0,0 +1,21 @@
+import { type RunJobOptions } from '../../../schemas/client.ts';
+import { type Flow } from '../../../runtime/flow.ts';
+import { type ClientOperations } from '../schemas/ports.ts';
+/**
+ * Descriptor-aware job dispatch. Reads `descriptor.dispatch` and picks
+ * between inline (resolve `workers/job` impl, call `handle()` in-process,
+ * return the result) and queued (delegate to `enqueue` + poll).
+ *
+ * Apps should prefer this over `enqueue(...)` for jobs whose delivery
+ * policy belongs to the job — not the caller. The intent: a feature
+ * declares `isolation: 'inline'` once on its job descriptor, every
+ * caller invokes `client.run(jobId, data)`, and the runtime picks the
+ * right execution mode without app-level branching.
+ *
+ * @param jobId — `workers/job` descriptor id (e.g. `ai.generation.image.execute`)
+ * @param jobData — job input (validated against the descriptor's schema by the impl)
+ * @param options — `metadata` is forwarded to the JobExecutionContext.
+ */
+export declare function runJob<TData = unknown, TResult = unknown>(owner: ClientOperations, jobId: string, jobData: TData, options?: RunJobOptions): Promise<TResult>;
+export declare function getFlow(owner: ClientOperations, jobId: string, dispatch: 'background' | 'prefer-background'): Promise<Flow | undefined>;
+//# sourceMappingURL=run.d.ts.map

package/dist/client/operations/dispatch/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../../src/client/operations/dispatch/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAKhE,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAIrD,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,MAAM,CAAC,KAAK,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAuCtK;AAED,wBAAsB,OAAO,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,mBAAmB,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAuB7I"}