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

package/dist/client/operations/inline.js

@@ -0,0 +1,91 @@
+import { cancellationForSignal } from "../../schemas/cancellation.js";
+import {} from "../../schemas/client.js";
+import { parseJobInput, readJobTimeoutMs, runWithJobTimeout } from "../../runtime/job-contract.js";
+import { recordJobRun } from "../../runtime/ledger/record-job-run.js";
+import { CaughtFailureSchema } from '@vibesdotdev/kernel';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+import {} from "../../schemas/descriptors.js";
+import {} from "../../kinds/schemas/index.js";
+import { getJobDescriptor } from "./catalog.js";
+import { jobCancelledBeforeStart, invocationCancellationAttribution, abortCancellationReason } from "./control/signals.js";
+import { parseContract } from "./schemas/contract.js";
+import {} from "./schemas/ports.js";
+import * as z from 'zod/v4';
+export async function invokeInlineJob(owner, jobId, jobData, options = {}) {
+    if (options.signal?.aborted)
+        throw jobCancelledBeforeStart(jobId);
+    const impl = await owner.runtime()
+        .query('workers/job')
+        .withId(jobId)
+        .enabled()
+        .resolve();
+    // Inline runs honor the same contract as queued runs: the job's input
+    // schema (with its defaults) and its declared timeout, read from the
+    // registered descriptor. Every run, including one rejected for invalid
+    // input, leaves a ledger row.
+    const descriptor = getJobDescriptor(owner, jobId);
+    const runId = options.jobId ?? `${jobId}-${crypto.randomUUID()}`;
+    const attempt = options.attempt ?? 1;
+    const startedAt = new Date();
+    const run = {
+        jobId: runId,
+        jobType: jobId,
+        mode: 'inline',
+        attempt,
+        hardware: String(owner.runtime().scope?.hardware ?? 'unknown'),
+        startedAt: startedAt.toISOString()
+    };
+    const elapsed = () => Math.round(Date.now() - startedAt.getTime());
+    let context;
+    try {
+        if (options.signal?.aborted)
+            throw jobCancelledBeforeStart(jobId);
+        const parsedContext = {
+            // Inline work holds no queue slot, so waiting on a child needs no handover.
+            park: (work) => work(),
+            jobId: runId,
+            // SAFETY: parseJobInput just validated/transformed the input with this job descriptor; TData is the matching implementation contract selected above.
+            data: parseJobInput(descriptor, jobId, jobData),
+            attempt,
+            maxAttempts: options.maxAttempts ?? 1,
+            metadata: parseContract(z.record(z.string(), JsonValueSchema), options.metadata ?? {}),
+            signal: options.signal
+        };
+        if (options.events)
+            parsedContext.events = options.events;
+        context = parsedContext;
+        if (impl.beforeHandle)
+            await impl.beforeHandle(parsedContext);
+        if (options.signal?.aborted)
+            throw jobCancelledBeforeStart(jobId);
+        const result = await runWithJobTimeout(owner.runtime().lifecycle, jobId, readJobTimeoutMs(descriptor), parsedContext.signal, (signal) => impl.handle({ ...parsedContext, signal }));
+        if (impl.afterHandle)
+            await impl.afterHandle(parsedContext, result);
+        await recordJobRun(owner.runtime(), { ...run, status: 'completed', durationMs: elapsed() });
+        return result;
+    }
+    catch (error) {
+        if (context && impl.onError) {
+            await impl.onError(context, error instanceof Error ? error : new Error(String(error)));
+        }
+        const failureRecord = {
+            ...run,
+            status: 'failed',
+            durationMs: elapsed(),
+            failure: CaughtFailureSchema.parse(error)
+        };
+        if (options.signal?.aborted) {
+            await recordJobRun(owner.runtime(), {
+                ...failureRecord,
+                status: 'cancelled',
+                // An actor-less scope records a system cascade; refusing here would replace the handler's failure.
+                cancellation: cancellationForSignal(options.signal, owner.runtime().lifecycle.signal, invocationCancellationAttribution(owner.runtime()), abortCancellationReason(options.signal, 'Inline job execution was cancelled.'))
+            });
+        }
+        else {
+            await recordJobRun(owner.runtime(), failureRecord);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=inline.js.map

package/dist/client/operations/inline.js.map

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

package/dist/client/operations/schedules/read.d.ts

@@ -0,0 +1,32 @@
+import { type QueueSchedules } from '../../../schemas/client.ts';
+import { type ScheduleInfo } from '../../../core/queue-adapter.ts';
+import { type Settled } from '../../../core/settle.ts';
+import { type ClientOperations } from '../schemas/ports.ts';
+/** Restore archived schedule definitions for a queue that supports recovery. */
+export declare function restoreArchivedSchedules(owner: ClientOperations, queueName: string, ids?: readonly string[]): Promise<number>;
+/**
+ * Retrieve all registered schedules across worker queues or for a specific
+ * queue. A queue whose schedules cannot be read refuses the listing
+ * (`UNAVAILABLE workers-schedule-listing-incomplete`, naming every unreadable
+ * queue, with each failure as the cause) rather than reading as a queue with
+ * no schedules. A queue whose adapter keeps no schedules lists none.
+ */
+export declare function getSchedules(owner: ClientOperations, options?: {
+    queue?: string;
+}): Promise<ScheduleInfo[]>;
+/**
+ * Schedules per queue, across worker queues or for one: each queue answers
+ * its schedules or the value-free failure that kept them unread, so a
+ * listing can show every readable queue and name each unreadable one.
+ */
+export declare function getSchedulesByQueue(owner: ClientOperations, options?: {
+    queue?: string;
+}): Promise<QueueSchedules[]>;
+/** One read of each requested queue's schedules; an adapter that keeps none answers []. */
+export declare function readSchedulesByQueue(owner: ClientOperations, options: {
+    queue?: string;
+}): Promise<Array<{
+    queueId: string;
+    outcome: Settled<ScheduleInfo[]>;
+}>>;
+//# sourceMappingURL=read.d.ts.map

package/dist/client/operations/schedules/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../../src/client/operations/schedules/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,gFAAgF;AAChF,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CASnI;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAWrH;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAK9H;AAED,2FAA2F;AAC3F,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC,CAQtK"}

package/dist/client/operations/schedules/read.js

@@ -0,0 +1,54 @@
+import {} from "../../../schemas/client.js";
+import { CapabilityError, valueFreeFailure } from '@vibesdotdev/kernel';
+import {} from "../../../core/queue-adapter.js";
+import { settle } from "../../../core/settle.js";
+import { listQueueIds } from "../catalog.js";
+import {} from "../schemas/ports.js";
+/** Restore archived schedule definitions for a queue that supports recovery. */
+export async function restoreArchivedSchedules(owner, queueName, ids) {
+    const queue = await owner.client.getQueue(queueName);
+    if (!queue.restoreArchivedSchedules) {
+        throw new CapabilityError('The selected queue cannot restore archived schedules.', 'UNAVAILABLE', {
+            reason: 'workers-schedule-recovery-unavailable',
+            details: { queueName }
+        });
+    }
+    return queue.restoreArchivedSchedules(queueName, ids);
+}
+/**
+ * Retrieve all registered schedules across worker queues or for a specific
+ * queue. A queue whose schedules cannot be read refuses the listing
+ * (`UNAVAILABLE workers-schedule-listing-incomplete`, naming every unreadable
+ * queue, with each failure as the cause) rather than reading as a queue with
+ * no schedules. A queue whose adapter keeps no schedules lists none.
+ */
+export async function getSchedules(owner, options = {}) {
+    const listed = await readSchedulesByQueue(owner, options);
+    const unreadable = listed.filter((entry) => !entry.outcome.ok);
+    if (unreadable.length > 0) {
+        throw new CapabilityError('Schedules could not be read from every requested queue.', 'UNAVAILABLE', {
+            reason: 'workers-schedule-listing-incomplete',
+            details: { unreadableQueues: unreadable.map((entry) => entry.queueId) },
+            cause: new AggregateError(unreadable.map((entry) => (entry.outcome.ok ? undefined : entry.outcome.thrown)), 'Schedule listing failed.')
+        });
+    }
+    return listed.flatMap((entry) => (entry.outcome.ok ? entry.outcome.value : []));
+}
+/**
+ * Schedules per queue, across worker queues or for one: each queue answers
+ * its schedules or the value-free failure that kept them unread, so a
+ * listing can show every readable queue and name each unreadable one.
+ */
+export async function getSchedulesByQueue(owner, options = {}) {
+    const listed = await readSchedulesByQueue(owner, options);
+    return listed.map(({ queueId, outcome }) => outcome.ok ? { queueId, schedules: outcome.value } : { queueId, failure: valueFreeFailure(outcome.caught) });
+}
+/** One read of each requested queue's schedules; an adapter that keeps none answers []. */
+export async function readSchedulesByQueue(owner, options) {
+    const queueIds = options.queue ? [options.queue] : listQueueIds(owner);
+    return Promise.all(queueIds.map(async (queueId) => ({
+        queueId,
+        outcome: await settle(() => owner.client.getQueue(queueId).then(async (queue) => (await queue.getSchedules?.()) ?? []))
+    })));
+}
+//# sourceMappingURL=read.js.map

package/dist/client/operations/schedules/read.js.map

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

package/dist/client/operations/schedules/write.d.ts

@@ -0,0 +1,18 @@
+import { type ScheduleJobOptions, type RemoveRepeatableOptions } from '../../../schemas/client.ts';
+import { type ClientOperations } from '../schemas/ports.ts';
+/**
+ * Canonical scheduling API.
+ *
+ * Registers a scheduled/repeatable job on the resolved queue adapter.
+ * If name matches a declared workers/job descriptor, its declared queue
+ * and adapter requirements are used automatically unless overridden.
+ */
+export declare function scheduleJob<TData = unknown>(owner: ClientOperations, name: string, jobData: TData, options?: ScheduleJobOptions): Promise<string>;
+/**
+ * Canonical schedule removal API.
+ *
+ * Removes a scheduled/repeatable job by repeat options, cron pattern, `jobId`,
+ * or all schedules matching `name`.
+ */
+export declare function removeRepeatable(owner: ClientOperations, name: string, options?: RemoveRepeatableOptions): Promise<boolean>;
+//# sourceMappingURL=write.d.ts.map

package/dist/client/operations/schedules/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../../../src/client/operations/schedules/write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAOrH,OAAO,EAAE,KAAK,gBAAgB,EAAiC,MAAM,qBAAqB,CAAC;AAE3F;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4E3J;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,OAAO,CAAC,CA4CrI"}

package/dist/client/operations/schedules/write.js

@@ -0,0 +1,136 @@
+import {} from "../../../schemas/client.js";
+import { CapabilityError } from '@vibesdotdev/kernel';
+import {} from "../../../core/queue-adapter.js";
+import {} from "../../../schemas/adapter.js";
+import {} from "../../../schemas/claim.js";
+import { getJobDescriptor } from "../catalog.js";
+import { resolveEnqueueTarget } from "../dispatch/target.js";
+import {} from "../schemas/ports.js";
+/**
+ * Canonical scheduling API.
+ *
+ * Registers a scheduled/repeatable job on the resolved queue adapter.
+ * If name matches a declared workers/job descriptor, its declared queue
+ * and adapter requirements are used automatically unless overridden.
+ */
+export async function scheduleJob(owner, name, jobData, options = {}) {
+    let targetQueue;
+    let targetAdapterRequirements;
+    let targetClaim;
+    if (options.queue) {
+        targetQueue = options.queue;
+    }
+    else if (owner.runtime().hasKind('workers/job') &&
+        owner.runtime().query('workers/job').withId(name).enabled().firstDescriptor()) {
+        const descriptor = getJobDescriptor(owner, name);
+        if (!descriptor.queue) {
+            throw new CapabilityError(`Job '${name}' is missing descriptor.queue and cannot be scheduled.`, 'NOT_FOUND', { reason: 'worker-undeclared' });
+        }
+        const target = resolveEnqueueTarget(owner, descriptor.queue, name);
+        targetQueue = target.queueId;
+        targetAdapterRequirements = target.adapterRequirements;
+        targetClaim = target.claim;
+    }
+    else {
+        targetQueue = name;
+    }
+    const pattern = options.repeat?.pattern ?? options.repeat?.cron ?? options.pattern ?? options.cron;
+    const tz = options.repeat?.tz ?? options.repeat?.timezone ?? options.tz ?? options.timezone ?? 'UTC';
+    const enabled = options.repeat?.enabled ?? options.enabled ?? true;
+    const maxFailures = options.repeat?.maxFailures ?? options.maxFailures;
+    const startDate = options.repeat?.startDate ?? options.startDate;
+    const endDate = options.repeat?.endDate ?? options.endDate;
+    const limit = options.repeat?.limit ?? options.limit;
+    // The caller's jobId scopes the schedule's identity (see core/schedule-identity.ts).
+    const scheduleJobId = options.repeat?.jobId ?? options.jobId;
+    const repeat = {
+        ...options.repeat,
+        tz,
+        timezone: tz,
+        enabled
+    };
+    if (pattern) {
+        repeat.pattern = pattern;
+        repeat.cron = pattern;
+    }
+    if (maxFailures !== undefined)
+        repeat.maxFailures = maxFailures;
+    if (startDate)
+        repeat.startDate = startDate;
+    if (endDate)
+        repeat.endDate = endDate;
+    if (limit !== undefined)
+        repeat.limit = limit;
+    if (scheduleJobId)
+        repeat.jobId = scheduleJobId;
+    const queue = await owner.client.getQueue(targetQueue, targetAdapterRequirements);
+    const metadata = {
+        ...options.metadata,
+        type: name
+    };
+    if (targetClaim)
+        metadata.workerClaim = targetClaim;
+    const enqueueOptions = {
+        ...options,
+        repeat,
+        metadata
+    };
+    if (queue.scheduleJob) {
+        return queue.scheduleJob(name, jobData, enqueueOptions);
+    }
+    if (queue.scheduleRepeatable) {
+        return queue.scheduleRepeatable(name, jobData, enqueueOptions);
+    }
+    throw new CapabilityError(`Queue '${targetQueue}' does not support scheduling.`, 'UNAVAILABLE', { reason: 'scheduling-unsupported' });
+}
+/**
+ * Canonical schedule removal API.
+ *
+ * Removes a scheduled/repeatable job by repeat options, cron pattern, `jobId`,
+ * or all schedules matching `name`.
+ */
+export async function removeRepeatable(owner, name, options = {}) {
+    let targetQueue;
+    let targetAdapterRequirements;
+    if (options.queue) {
+        targetQueue = options.queue;
+    }
+    else if (owner.runtime().hasKind('workers/job') &&
+        owner.runtime().query('workers/job').withId(name).enabled().firstDescriptor()) {
+        const descriptor = getJobDescriptor(owner, name);
+        if (descriptor.queue) {
+            const target = resolveEnqueueTarget(owner, descriptor.queue, name);
+            targetQueue = target.queueId;
+            targetAdapterRequirements = target.adapterRequirements;
+        }
+        else {
+            targetQueue = name;
+        }
+    }
+    else {
+        targetQueue = name;
+    }
+    const queue = await owner.client.getQueue(targetQueue, targetAdapterRequirements);
+    const pattern = options.repeat?.pattern ?? options.repeat?.cron ?? options.pattern ?? options.cron;
+    // The jobId scopes which schedule is removed: one of two same-cadence schedules goes, the other stays.
+    const scheduleJobId = options.repeat?.jobId ?? options.jobId;
+    let repeat = options.repeat;
+    if (pattern || scheduleJobId) {
+        const next = { ...options.repeat };
+        if (pattern) {
+            next.pattern = pattern;
+            next.cron = pattern;
+        }
+        if (scheduleJobId)
+            next.jobId = scheduleJobId;
+        repeat = next;
+    }
+    if (queue.removeRepeatable) {
+        return queue.removeRepeatable(name, repeat);
+    }
+    if (queue.removeSchedule) {
+        return queue.removeSchedule(name, repeat);
+    }
+    return false;
+}
+//# sourceMappingURL=write.js.map

package/dist/client/operations/schedules/write.js.map

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

package/dist/client/operations/schemas/contract.d.ts

@@ -0,0 +1,3 @@
+import * as z from 'zod/v4';
+export declare function parseContract<T>(schema: z.ZodType<T>, value: unknown): T;
+//# sourceMappingURL=contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../../src/client/operations/schemas/contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CASxE"}

package/dist/client/operations/schemas/contract.js

@@ -0,0 +1,13 @@
+import { CapabilityError } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+export function parseContract(schema, value) {
+    const parsed = schema.safeParse(value);
+    if (!parsed.success) {
+        throw new CapabilityError('Invalid workers client contract value.', 'INTERNAL', {
+            reason: 'worker-contract-invalid',
+            details: { issues: parsed.error.message }
+        });
+    }
+    return parsed.data;
+}
+//# sourceMappingURL=contract.js.map

package/dist/client/operations/schemas/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../../src/client/operations/schemas/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,MAAM,UAAU,aAAa,CAAI,MAAoB,EAAE,KAAc;IACpE,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,eAAe,CAAC,wCAAwC,EAAE,UAAU,EAAE;YAC/E,MAAM,EAAE,yBAAyB;YACjC,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;SACzC,CAAC,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACpB,CAAC"}

package/dist/client/operations/schemas/ports.d.ts

@@ -0,0 +1,47 @@
+import { type JobMetadata } from '../../../schemas/client.ts';
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import { type WorkerAdapterInterface } from '../../../interfaces/adapter.ts';
+import { type Settled } from '../../../core/settle.ts';
+import { type WorkerAdapterRequirements } from '../../../schemas/adapter.ts';
+import { type JobAssetDescriptor } from '../../../schemas/descriptors.ts';
+import { type JobClaimRequirements } from '../../../schemas/claim.ts';
+import { type ResumeAdmission } from '../../../core/keyed-dispatch.ts';
+import { type WorkersClient } from '../../runtime-client.ts';
+export interface WorkersClientState {
+    adapterPromises: Map<string, Promise<WorkerAdapterInterface>>;
+    inlineFallbackWarned: Set<string>;
+    activeOperations: Set<Promise<unknown>>;
+}
+export interface ClientOperations {
+    readonly runtime: () => VibesRuntime;
+    readonly client: WorkersClient;
+    readonly state: WorkersClientState;
+    readonly disposalCompletion: () => Promise<void> | undefined;
+}
+export interface EnqueueTarget {
+    queueId: string;
+    claim?: JobClaimRequirements;
+    adapterRequirements?: WorkerAdapterRequirements;
+}
+export interface EnqueueMetadataOptions {
+    jobId?: string;
+    metadata: JobMetadata;
+    resume?: ResumeAdmission;
+}
+export interface DispatchEnqueueOptions {
+    jobId?: string;
+    resume?: ResumeAdmission;
+    delay?: number;
+    priority?: number;
+    attempts?: number;
+    backoff?: number | {
+        type: 'fixed' | 'exponential';
+        delay: number;
+    };
+    metadata: JobMetadata;
+}
+export type JobDescriptorForDispatch = JobAssetDescriptor;
+export interface InlineStreamRun<T> {
+    outcome: Settled<T> | undefined;
+}
+//# sourceMappingURL=ports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../../src/client/operations/schemas/ports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IAClC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAC9D,oBAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,gBAAgB,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,YAAY,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;CAC7D;AAED,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,mBAAmB,CAAC,EAAE,yBAAyB,CAAC;CAChD;AAED,MAAM,WAAW,sBAAsB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,OAAO,GAAG,aAAa,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,QAAQ,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AAE1D,MAAM,WAAW,eAAe,CAAC,CAAC;IACjC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;CAChC"}

package/dist/client/operations/schemas/ports.js

@@ -0,0 +1,10 @@
+import {} from "../../../schemas/client.js";
+import {} from '@vibesdotdev/kernel';
+import {} from "../../../interfaces/adapter.js";
+import {} from "../../../core/settle.js";
+import {} from "../../../schemas/adapter.js";
+import {} from "../../../schemas/descriptors.js";
+import {} from "../../../schemas/claim.js";
+import {} from "../../../core/keyed-dispatch.js";
+import {} from "../../runtime-client.js";
+//# sourceMappingURL=ports.js.map

package/dist/client/operations/schemas/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../../src/client/operations/schemas/ports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAqB,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAA+B,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EAAgB,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAkC,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAA2B,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAA6B,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAwB,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAsB,MAAM,yBAAyB,CAAC"}

package/dist/client/operations/waiting.d.ts

@@ -0,0 +1,29 @@
+import { type CaughtFailure } from '@vibesdotdev/kernel';
+import { type QueueAdapter } from '../../core/queue-adapter.ts';
+import { type ClientOperations } from './schemas/ports.ts';
+export declare const PER_POLL_CEILING_MS = 30000;
+export declare const DEFAULT_POLL_INTERVAL_MS = 1000;
+export declare function pollForJobResult<T>(owner: ClientOperations, queue: QueueAdapter, jobId: string, timeoutOverrideMs?: number): Promise<T>;
+/**
+ * Wait, bounded by `timeoutMs` on this runtime's lifecycle, for `jobId` to
+ * reach a terminal status (completed, failed or cancelled). A queue that
+ * emits job events wakes the wait on the job's own terminal event; a queue
+ * without them is read every `pollIntervalMs` — the missing event is the
+ * adapter's `subscribeToEvents`. Each read is itself bounded by
+ * {@link PER_POLL_CEILING_MS} so one hung read cannot consume the whole
+ * wait. Returns `null` when the deadline passes first.
+ */
+export declare function waitForTerminalJob(owner: ClientOperations, queue: QueueAdapter, jobId: string, options: {
+    timeoutMs: number;
+    pollIntervalMs: number;
+    reason: string;
+    signal?: AbortSignal;
+}): Promise<Awaited<ReturnType<QueueAdapter['getJob']>> | null>;
+/**
+ * Pause up to `ms` on this runtime's lifecycle, returning early when the
+ * registered resume callback fires (the queue's own event). Cancellation of
+ * `signal` propagates as the lifecycle's `CANCELLED wait-aborted`.
+ */
+export declare function pauseUntilWoken(owner: ClientOperations, ms: number, signal: AbortSignal | undefined, register: (resume: () => void) => void): Promise<void>;
+export declare function isWaitTimeout(failure: CaughtFailure): boolean;
+//# sourceMappingURL=waiting.d.ts.map

package/dist/client/operations/waiting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiting.d.ts","sourceRoot":"","sources":["../../../src/client/operations/waiting.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE5E,OAAO,EAAE,KAAK,YAAY,EAAiB,MAAM,6BAA6B,CAAC;AAG/E,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAE1C,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAE9C,wBAAsB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAe7I;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAqC/P;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,IAAI,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CASjK;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAE7D"}

package/dist/client/operations/waiting.js

@@ -0,0 +1,92 @@
+import { readWorkersConfig } from "../../config/read.js";
+import { isCapabilityError } from '@vibesdotdev/kernel';
+import { WorkerJobFailedError, WorkerTimeoutError } from '@vibesdotdev/pm/errors';
+import {} from "../../core/queue-adapter.js";
+import { settle } from "../../core/settle.js";
+import { COMPLETION_EVENTS, FAILURE_EVENTS, TERMINAL_STATUSES } from "./control/events.js";
+import {} from "./schemas/ports.js";
+export const PER_POLL_CEILING_MS = 30_000;
+export const DEFAULT_POLL_INTERVAL_MS = 1_000;
+export async function pollForJobResult(owner, queue, jobId, timeoutOverrideMs) {
+    const timeoutMs = timeoutOverrideMs ?? (await readWorkersConfig(owner.runtime())).client.jobTimeoutMs;
+    const job = await waitForTerminalJob(owner, queue, jobId, {
+        timeoutMs,
+        pollIntervalMs: DEFAULT_POLL_INTERVAL_MS,
+        reason: `job ${jobId} result`
+    });
+    if (!job)
+        throw new WorkerTimeoutError(jobId, timeoutMs);
+    if (job.status === 'completed') {
+        // SAFETY: The completed queue job preserves its handler result; T is the caller-selected result contract for this queue.
+        return job.result;
+    }
+    if (job.status === 'failed')
+        throw new WorkerJobFailedError(jobId, job.error || 'Unknown error');
+    // Cancelled is terminal. Polling on would block the caller until timeout.
+    throw new WorkerJobFailedError(jobId, 'Job cancelled');
+}
+/**
+ * Wait, bounded by `timeoutMs` on this runtime's lifecycle, for `jobId` to
+ * reach a terminal status (completed, failed or cancelled). A queue that
+ * emits job events wakes the wait on the job's own terminal event; a queue
+ * without them is read every `pollIntervalMs` — the missing event is the
+ * adapter's `subscribeToEvents`. Each read is itself bounded by
+ * {@link PER_POLL_CEILING_MS} so one hung read cannot consume the whole
+ * wait. Returns `null` when the deadline passes first.
+ */
+export async function waitForTerminalJob(owner, queue, jobId, options) {
+    const lifecycle = owner.runtime().lifecycle;
+    let wake;
+    const unsubscribe = queue.subscribeToEvents?.(jobId, (event) => {
+        if (COMPLETION_EVENTS.has(event.event) || FAILURE_EVENTS.has(event.event) || event.event === 'cancelled') {
+            wake?.();
+        }
+    });
+    try {
+        const waited = await settle(() => lifecycle.wait(async (signal) => {
+            for (;;) {
+                const read = await settle(() => lifecycle.wait(() => queue.getJob(jobId), {
+                    timeoutMs: PER_POLL_CEILING_MS,
+                    reason: `${options.reason} (one status read)`,
+                    signal
+                }));
+                // A hung read: try again next window; the outer deadline still holds.
+                if (!read.ok && !isWaitTimeout(read.caught))
+                    throw read.thrown;
+                const job = read.ok ? read.value : null;
+                if (job && TERMINAL_STATUSES.has(job.status))
+                    return job;
+                await pauseUntilWoken(owner, options.pollIntervalMs, signal, (resume) => {
+                    wake = resume;
+                });
+                wake = undefined;
+            }
+        }, { timeoutMs: options.timeoutMs, reason: options.reason, signal: options.signal }));
+        if (waited.ok)
+            return waited.value;
+        if (isWaitTimeout(waited.caught))
+            return null;
+        throw waited.thrown;
+    }
+    finally {
+        unsubscribe?.();
+    }
+}
+/**
+ * Pause up to `ms` on this runtime's lifecycle, returning early when the
+ * registered resume callback fires (the queue's own event). Cancellation of
+ * `signal` propagates as the lifecycle's `CANCELLED wait-aborted`.
+ */
+export async function pauseUntilWoken(owner, ms, signal, register) {
+    const woken = new AbortController();
+    register(() => woken.abort());
+    const paused = await settle(() => owner.runtime().lifecycle.delay(ms, signal ? AbortSignal.any([signal, woken.signal]) : woken.signal));
+    // Woken early by the queue's own event: the cancelled pause is the wake, not a failure.
+    if (paused.ok || (woken.signal.aborted && !signal?.aborted))
+        return;
+    throw paused.thrown;
+}
+export function isWaitTimeout(failure) {
+    return isCapabilityError(failure) && failure.code === 'TIMEOUT' && failure.reason === 'wait-timeout';
+}
+//# sourceMappingURL=waiting.js.map

package/dist/client/operations/waiting.js.map

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