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

package/dist/core/keyed-dispatch.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Keyed dispatch: a job dispatched while another job executes is admitted under an id derived from
+ * the executing job, so that job, re-entered after a restart or retried, finds each child it already
+ * started instead of starting it again (`keepsCallerAdmission` under `resume`).
+ *
+ * A child's key is the executing job's id, the child's job id, a digest of its data and its
+ * occurrence: the n-th identical dispatch in one execution gets the n-th child, so a body that
+ * checks, fixes and checks again with one input runs the second check. An identical dispatch is the
+ * same work, so in a parallel body which identical child a dispatch reattaches to does not matter,
+ * and distinct dispatches never share a key whatever order they run in. The key is shaped as a UUID
+ * (version 8, RFC 9562) through the runtime's `crypto/hash` implementation.
+ *
+ * Every executor of queued jobs runs the handler inside `runAsExecutingJob`; an inline job runs as
+ * part of its caller and does not rebind, so its children belong to the enclosing job.
+ */
+import * as z from 'zod/v4';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { type ResumeAdmission } from './schemas/resume.ts';
+import type { JobMetadataRecord } from './schemas/index.ts';
+import type { JobExecutionEvents } from '@vibesdotdev/kernel/kinds';
+export { ADMITTED_BY_METADATA_KEY, ResumeAdmissionSchema, type ResumeAdmission } from './schemas/resume.ts';
+/** The admission a dispatch inside an executing job takes. */
+export interface KeyedAdmission {
+    readonly jobId: string;
+    readonly resume: ResumeAdmission;
+}
+/** Derives the admission of the next dispatch of `jobType` with `data` in one execution. */
+export type KeyedAdmitter = <TData>(jobType: string, data: TData) => Promise<KeyedAdmission>;
+/** Actual selected adapter and physical queue; job catalog edits cannot retarget a receipt. */
+export declare const JobQueueOwnerSchema: z.ZodObject<{
+    adapterId: z.ZodString;
+    queueId: z.ZodString;
+}, z.core.$strict>;
+export declare const ExecutingJobReceiptSchema: z.ZodObject<{
+    adapterId: z.ZodString;
+    queueId: z.ZodString;
+    generation: z.ZodNumber;
+}, z.core.$strict>;
+declare const ExecutingJobSchema: z.ZodObject<{
+    jobId: z.ZodString;
+    attempt: z.ZodNumber;
+    receipt: z.ZodOptional<z.ZodObject<{
+        adapterId: z.ZodString;
+        queueId: z.ZodString;
+        generation: z.ZodNumber;
+    }, z.core.$strict>>;
+    admit: z.ZodCustom<KeyedAdmitter, KeyedAdmitter>;
+    park: z.ZodOptional<z.ZodCustom<(<T>(work: () => Promise<T>) => Promise<T>), <T>(work: () => Promise<T>) => Promise<T>>>;
+    emit: z.ZodOptional<z.ZodCustom<(event: string, data?: import("@vibesdotdev/kernel/bootstrap").JsonValue) => Promise<void>, (event: string, data?: import("@vibesdotdev/kernel/bootstrap").JsonValue) => Promise<void>>>;
+    changed: z.ZodOptional<z.ZodCustom<() => Promise<void>, () => Promise<void>>>;
+}, z.core.$strip>;
+type ExecutingJob = z.output<typeof ExecutingJobSchema>;
+/** The UUID (version 8, RFC 9562) `key`'s sha256 names, so one key always admits the same job. */
+export declare function keyedJobId(runtime: Pick<RuntimeRef, 'query'>, key: string): Promise<string>;
+/** Run one execution of a queued job's handler with its children keyed by that execution. */
+export declare function runAsExecutingJob<TResult>(runtime: Pick<RuntimeRef, 'hasKind' | 'query'>, job: {
+    readonly jobId: string;
+    readonly attempt: number;
+    readonly park?: ExecutingJob['park'];
+    readonly emit?: ExecutingJob['emit'];
+    readonly changed?: ExecutingJob['changed'];
+    readonly receipt?: ExecutingJob['receipt'];
+}, handle: () => Promise<TResult>): Promise<TResult>;
+/** Saved by the actual receiver, never inferred from a caller or the current job catalog. */
+export declare function executingJobReceipt(runtime: Pick<RuntimeRef, 'hasKind' | 'query'>): Promise<z.output<typeof ExecutingJobReceiptSchema> | undefined>;
+/** Notification lifetime is independent of a processing mutation lease. */
+export declare function notifyExecutingJobChanged(runtime: Pick<RuntimeRef, 'hasKind' | 'query'>): Promise<boolean>;
+/** Publish through the actual admitted job's guarded event port; outside a job there is no job authority. */
+export declare function emitExecutingJobEvent(runtime: Pick<RuntimeRef, 'hasKind' | 'query'>, ...args: Parameters<JobExecutionEvents['emit']>): Promise<void>;
+/** Waiting adapters release the current job's slot through its execution owner. */
+export declare function withExecutingJobPark<T>(runtime: Pick<RuntimeRef, 'hasKind' | 'query'>, work: () => Promise<T>): Promise<T>;
+/** The admission of a dispatch made inside an executing job, or none outside one. */
+export declare function keyedAdmissionFor<TData>(runtime: Pick<RuntimeRef, 'hasKind' | 'query'>, jobType: string, data: TData): Promise<KeyedAdmission | undefined>;
+/** Current parent attempt, for owner-recorded graph identities that already have a stable child id. */
+export declare function executingJobAdmission(runtime: Pick<RuntimeRef, 'hasKind' | 'query'>): Promise<ResumeAdmission | undefined>;
+/** The enqueue options a dispatch takes: the caller's id when it names one, else the executing job's key for it. */
+export declare function keyedEnqueueOptions<TOptions extends {
+    jobId?: string;
+    resume?: ResumeAdmission;
+    metadata?: JobMetadataRecord;
+}, TData>(runtime: Pick<RuntimeRef, 'hasKind' | 'query'>, jobType: string, data: TData, options: TOptions): Promise<TOptions>;
+//# sourceMappingURL=keyed-dispatch.d.ts.map

package/dist/core/keyed-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed-dispatch.d.ts","sourceRoot":"","sources":["../../src/core/keyed-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAkF,KAAK,UAAU,EAA4B,MAAM,qBAAqB,CAAC;AAEhK,OAAO,EAAmD,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC5G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAuB,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEzF,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE5G,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CACjC;AAED,4FAA4F;AAC5F,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7F,+FAA+F;AAC/F,eAAO,MAAM,mBAAmB;;;kBAA+E,CAAC;AAChH,eAAO,MAAM,yBAAyB;;;;kBAA6E,CAAC;AAEpH,QAAA,MAAM,kBAAkB;;;;;;;;;;;6CAOC,OAAO,CAAC,IAAI,CAAC,QAAb,OAAO,CAAC,IAAI,CAAC;iBACpC,CAAC;AACH,KAAK,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAIxD,kGAAkG;AAClG,wBAAsB,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIjG;AAuBD,6FAA6F;AAC7F,wBAAsB,iBAAiB,CAAC,OAAO,EAC9C,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,EAC9C,GAAG,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,CAAA;CAAE,EAC7N,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED,6FAA6F;AAC7F,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,GAAG,SAAS,CAAC,CAEzJ;AAED,2EAA2E;AAC3E,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAKhH;AAED,6GAA6G;AAC7G,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1J;AAED,mFAAmF;AACnF,wBAAsB,oBAAoB,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAGhI;AAED,qFAAqF;AACrF,wBAAsB,iBAAiB,CAAC,KAAK,EAC5C,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,EAC9C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,KAAK,GACT,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAErC;AAED,uGAAuG;AACvG,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAGhI;AAED,oHAAoH;AACpH,wBAAsB,mBAAmB,CAAC,QAAQ,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAAE,EAAE,KAAK,EAC3I,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,EAC9C,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,QAAQ,GACf,OAAO,CAAC,QAAQ,CAAC,CASnB"}

package/dist/core/keyed-dispatch.js

@@ -0,0 +1,110 @@
+/**
+ * Keyed dispatch: a job dispatched while another job executes is admitted under an id derived from
+ * the executing job, so that job, re-entered after a restart or retried, finds each child it already
+ * started instead of starting it again (`keepsCallerAdmission` under `resume`).
+ *
+ * A child's key is the executing job's id, the child's job id, a digest of its data and its
+ * occurrence: the n-th identical dispatch in one execution gets the n-th child, so a body that
+ * checks, fixes and checks again with one input runs the second check. An identical dispatch is the
+ * same work, so in a parallel body which identical child a dispatch reattaches to does not matter,
+ * and distinct dispatches never share a key whatever order they run in. The key is shaped as a UUID
+ * (version 8, RFC 9562) through the runtime's `crypto/hash` implementation.
+ *
+ * Every executor of queued jobs runs the handler inside `runAsExecutingJob`; an inline job runs as
+ * part of its caller and does not rebind, so its children belong to the enclosing job.
+ */
+import * as z from 'zod/v4';
+import { createRuntimeScopedValueKey, getRuntimeScopedValues, isCapabilityError, settle } from '@vibesdotdev/kernel';
+import { hashHex } from '@vibesdotdev/crypto/hash';
+import { ADMITTED_BY_METADATA_KEY, ResumeAdmissionSchema } from "./schemas/resume.js";
+export { ADMITTED_BY_METADATA_KEY, ResumeAdmissionSchema } from "./schemas/resume.js";
+/** Actual selected adapter and physical queue; job catalog edits cannot retarget a receipt. */
+export const JobQueueOwnerSchema = z.strictObject({ adapterId: z.string().min(1), queueId: z.string().min(1) });
+export const ExecutingJobReceiptSchema = JobQueueOwnerSchema.extend({ generation: z.number().int().nonnegative() });
+const ExecutingJobSchema = z.object({
+    jobId: z.string().min(1),
+    attempt: z.number().int().min(1),
+    receipt: ExecutingJobReceiptSchema.optional(),
+    admit: z.custom((value) => value instanceof Function),
+    park: z.custom((value) => value instanceof Function).optional(),
+    emit: z.custom((value) => value instanceof Function).optional(),
+    changed: z.custom((value) => value instanceof Function).optional()
+});
+const executingJobKey = createRuntimeScopedValueKey(ExecutingJobSchema);
+/** The UUID (version 8, RFC 9562) `key`'s sha256 names, so one key always admits the same job. */
+export async function keyedJobId(runtime, key) {
+    const hex = await hashHex(runtime, 'sha256', key);
+    const variant = ((Number.parseInt(hex.slice(16, 17), 16) & 0x3) | 0x8).toString(16);
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-8${hex.slice(13, 16)}-${variant}${hex.slice(17, 20)}-${hex.slice(20, 32)}`;
+}
+function executingJob(runtime, jobId, attempt, park, emit, changed, receipt) {
+    const occurrences = new Map();
+    const resume = { parentJobId: jobId, parentAttempt: attempt };
+    const admit = async (jobType, data) => {
+        const digest = await hashHex(runtime, 'sha256', JSON.stringify(data ?? null));
+        const call = JSON.stringify([jobId, jobType, digest]);
+        const occurrence = occurrences.get(call) ?? 0;
+        occurrences.set(call, occurrence + 1);
+        return { jobId: await keyedJobId(runtime, `${call}:${occurrence}`), resume };
+    };
+    return { jobId, attempt, admit, park, emit, changed, receipt };
+}
+/** The host's request values, or none on a host without them: it binds no executing job, so it keys nothing. */
+async function requestValues(runtime) {
+    const selected = await settle(() => getRuntimeScopedValues(runtime));
+    if (selected.ok)
+        return selected.value;
+    if (isCapabilityError(selected.cause) && selected.cause.reason === 'scoped-values-unavailable')
+        return undefined;
+    throw selected.cause;
+}
+/** Run one execution of a queued job's handler with its children keyed by that execution. */
+export async function runAsExecutingJob(runtime, job, handle) {
+    const values = await requestValues(runtime);
+    return values ? values.run(executingJobKey, executingJob(runtime, job.jobId, job.attempt, job.park, job.emit, job.changed, job.receipt), handle) : handle();
+}
+/** Saved by the actual receiver, never inferred from a caller or the current job catalog. */
+export async function executingJobReceipt(runtime) {
+    return (await requestValues(runtime))?.get(executingJobKey)?.receipt;
+}
+/** Notification lifetime is independent of a processing mutation lease. */
+export async function notifyExecutingJobChanged(runtime) {
+    const current = (await requestValues(runtime))?.get(executingJobKey);
+    if (!current?.changed)
+        return false;
+    await current.changed();
+    return true;
+}
+/** Publish through the actual admitted job's guarded event port; outside a job there is no job authority. */
+export async function emitExecutingJobEvent(runtime, ...args) {
+    const parent = (await requestValues(runtime))?.get(executingJobKey);
+    await parent?.emit?.(...args);
+}
+/** Waiting adapters release the current job's slot through its execution owner. */
+export async function withExecutingJobPark(runtime, work) {
+    const parent = (await requestValues(runtime))?.get(executingJobKey);
+    return parent?.park ? parent.park(work) : work();
+}
+/** The admission of a dispatch made inside an executing job, or none outside one. */
+export async function keyedAdmissionFor(runtime, jobType, data) {
+    return (await requestValues(runtime))?.get(executingJobKey)?.admit(jobType, data);
+}
+/** Current parent attempt, for owner-recorded graph identities that already have a stable child id. */
+export async function executingJobAdmission(runtime) {
+    const parent = (await requestValues(runtime))?.get(executingJobKey);
+    return parent ? { parentJobId: parent.jobId, parentAttempt: parent.attempt } : undefined;
+}
+/** The enqueue options a dispatch takes: the caller's id when it names one, else the executing job's key for it. */
+export async function keyedEnqueueOptions(runtime, jobType, data, options) {
+    if (options.jobId) {
+        if (!options.resume)
+            return options;
+        const resume = ResumeAdmissionSchema.parse(options.resume);
+        return { ...options, resume, metadata: { ...options.metadata, [ADMITTED_BY_METADATA_KEY]: resume } };
+    }
+    const admission = await keyedAdmissionFor(runtime, jobType, data);
+    if (!admission)
+        return options;
+    return { ...options, jobId: admission.jobId, resume: admission.resume, metadata: { ...options.metadata, [ADMITTED_BY_METADATA_KEY]: admission.resume } };
+}
+//# sourceMappingURL=keyed-dispatch.js.map

package/dist/core/keyed-dispatch.js.map

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

package/dist/core/logger.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Workers logging is the shared `getLogger` contract, not a feature-local logger.
+ */
+import { getLogger, type LogContext, type RuntimeLogger } from '@vibesdotdev/logging';
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+export { getLogger, type LogContext, type RuntimeLogger };
+export declare function createWorkerLogger(runtime: VibesRuntime, options?: {
+    namespace?: string;
+    context?: LogContext;
+}): RuntimeLogger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,CAAC;AAE1D,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,UAAU,CAAA;CAAO,GACxD,aAAa,CAOf"}

package/dist/core/logger.js

@@ -0,0 +1,15 @@
+/**
+ * Workers logging is the shared `getLogger` contract, not a feature-local logger.
+ */
+import { getLogger } from '@vibesdotdev/logging';
+export { getLogger };
+export function createWorkerLogger(runtime, options = {}) {
+    let logger = getLogger('worker-core', runtime);
+    if (options.namespace)
+        logger = logger.child({ namespace: options.namespace });
+    if (options.context && Object.keys(options.context).length > 0) {
+        logger = logger.withContext(options.context);
+    }
+    return logger;
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,SAAS,EAAuC,MAAM,sBAAsB,CAAC;AAGtF,OAAO,EAAE,SAAS,EAAuC,CAAC;AAE1D,MAAM,UAAU,kBAAkB,CACjC,OAAqB,EACrB,UAAwD,EAAE;IAE1D,IAAI,MAAM,GAAG,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAC/C,IAAI,OAAO,CAAC,SAAS;QAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC/E,IAAI,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChE,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/core/manifest/factory.d.ts

@@ -0,0 +1,3 @@
+import type { WorkerManifest, WorkerManifestOptions, WorkerLoader } from './types.ts';
+export declare function createWorkerManifest(options: WorkerManifestOptions, loader: WorkerLoader): WorkerManifest;
+//# sourceMappingURL=factory.d.ts.map

package/dist/core/manifest/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/core/manifest/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEtF,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,YAAY,GAClB,cAAc,CA6BhB"}

package/dist/core/manifest/factory.js

@@ -0,0 +1,28 @@
+export function createWorkerManifest(options, loader) {
+    // Validate required fields
+    if (!options.id?.trim()) {
+        throw new Error('Worker manifest id is required');
+    }
+    if (!options.hardware?.length) {
+        throw new Error(`Worker "${options.id}" must specify at least one hardware target`);
+    }
+    // Cache the loader promise
+    let cachedPromise = null;
+    const load = () => {
+        if (!cachedPromise) {
+            cachedPromise = loader();
+        }
+        return cachedPromise;
+    };
+    // Freeze handler module paths if provided
+    const handlerModulePaths = options.handlerModulePaths
+        ? Object.freeze({ ...options.handlerModulePaths })
+        : undefined;
+    return Object.freeze({
+        ...options,
+        hardware: Object.freeze([...options.hardware]),
+        handlerModulePaths,
+        load
+    });
+}
+//# sourceMappingURL=factory.js.map

package/dist/core/manifest/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/core/manifest/factory.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CACnC,OAA8B,EAC9B,MAAoB;IAEpB,2BAA2B;IAC3B,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,WAAW,OAAO,CAAC,EAAE,6CAA6C,CAAC,CAAC;IACrF,CAAC;IAED,2BAA2B;IAC3B,IAAI,aAAa,GAAoC,IAAI,CAAC;IAC1D,MAAM,IAAI,GAAG,GAAG,EAAE;QACjB,IAAI,CAAC,aAAa,EAAE,CAAC;YACpB,aAAa,GAAG,MAAM,EAAE,CAAC;QAC1B,CAAC;QACD,OAAO,aAAa,CAAC;IACtB,CAAC,CAAC;IAEF,0CAA0C;IAC1C,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB;QACpD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAClD,CAAC,CAAC,SAAS,CAAC;IAEb,OAAO,MAAM,CAAC,MAAM,CAAC;QACpB,GAAG,OAAO;QACV,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC9C,kBAAkB;QAClB,IAAI;KACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/core/manifest/index.d.ts

@@ -0,0 +1,3 @@
+export type { WorkerLoader, HandlerModulePaths, WorkerManifestOptions, WorkerManifest } from './types.ts';
+export { createWorkerManifest } from './factory.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/manifest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/manifest/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1G,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/core/manifest/index.js

@@ -0,0 +1,2 @@
+export { createWorkerManifest } from "./factory.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/manifest/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,45 @@
+import type { HardwareType, AdapterType } from '../schemas/config.ts';
+import type { Worker } from '../worker.ts';
+export type WorkerLoader = () => Promise<Worker>;
+/**
+ * Handler module path mapping for isolated execution
+ * Maps handler ID to module path for dynamic import in worker threads
+ */
+export type HandlerModulePaths = Record<string, string>;
+export interface WorkerManifestOptions {
+    id: string;
+    description: string;
+    hardware: HardwareType[];
+    queueId: string;
+    concurrency?: number;
+    supportedAdapters?: AdapterType[];
+    tags?: string[];
+    /**
+     * Handler module paths for isolated execution in Bun Worker threads.
+     * Maps handler ID to the module path for dynamic import.
+     *
+     * Required for handlers with `isolation: 'worker'` config.
+     * Paths should be absolute or use $lib aliases.
+     *
+     * @example
+     * ```ts
+     * handlerModulePaths: {
+     *   'dev.atlas.index': '$lib/vibes/dev/workspace/codegraph/worker/jobs/atlas-index-job',
+     *   'dev.atlas.embedding': '$lib/vibes/dev/workspace/codegraph/worker/jobs/atlas-embedding-job'
+     * }
+     * ```
+     */
+    handlerModulePaths?: HandlerModulePaths;
+}
+export interface WorkerManifest {
+    readonly id: string;
+    readonly description: string;
+    readonly hardware: readonly HardwareType[];
+    readonly queueId: string;
+    readonly concurrency?: number;
+    readonly supportedAdapters?: readonly AdapterType[];
+    readonly tags?: readonly string[];
+    readonly handlerModulePaths?: Readonly<HandlerModulePaths>;
+    load: () => Promise<Worker>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/manifest/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,WAAW,EAAE,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB;;;;;;;;;;;;;;OAcG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACxC;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACpD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAC3D,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5B"}

package/dist/core/manifest/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

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

package/dist/core/priority-order.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Pending-queue ordering by priority, shared by every in-process queue adapter.
+ *
+ * A queue is ordered highest priority first, first-in first-out within a priority.
+ * A job with no priority counts as priority 0, so a negative priority (dispatch
+ * bounds admit -10..100) sorts behind unprioritized jobs and a positive one ahead.
+ */
+/** The priority range a dispatch (and the HTTP submit schema) admits: -10..100 inclusive. */
+export declare const DISPATCH_PRIORITY_BOUNDS: {
+    readonly min: -10;
+    readonly max: 100;
+};
+/** The index at which a job of `priority` joins `queue` (already ordered) to keep it ordered. */
+export declare function priorityInsertIndex<T>(queue: readonly T[], priorityOf: (entry: T) => number | undefined, priority: number | undefined): number;
+//# sourceMappingURL=priority-order.d.ts.map

package/dist/core/priority-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority-order.d.ts","sourceRoot":"","sources":["../../src/core/priority-order.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,6FAA6F;AAC7F,eAAO,MAAM,wBAAwB;;;CAAkC,CAAC;AAExE,iGAAiG;AACjG,wBAAgB,mBAAmB,CAAC,CAAC,EACpC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,EAC5C,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC1B,MAAM,CAMR"}

package/dist/core/priority-order.js

@@ -0,0 +1,19 @@
+/**
+ * Pending-queue ordering by priority, shared by every in-process queue adapter.
+ *
+ * A queue is ordered highest priority first, first-in first-out within a priority.
+ * A job with no priority counts as priority 0, so a negative priority (dispatch
+ * bounds admit -10..100) sorts behind unprioritized jobs and a positive one ahead.
+ */
+/** The priority range a dispatch (and the HTTP submit schema) admits: -10..100 inclusive. */
+export const DISPATCH_PRIORITY_BOUNDS = { min: -10, max: 100 };
+/** The index at which a job of `priority` joins `queue` (already ordered) to keep it ordered. */
+export function priorityInsertIndex(queue, priorityOf, priority) {
+    const incoming = priority ?? 0;
+    let index = queue.length;
+    // Scan from the tail: the common case (equal or lower priority) is O(1), and equal priorities stay FIFO.
+    while (index > 0 && (priorityOf(queue[index - 1]) ?? 0) < incoming)
+        index--;
+    return index;
+}
+//# sourceMappingURL=priority-order.js.map

package/dist/core/priority-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority-order.js","sourceRoot":"","sources":["../../src/core/priority-order.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,6FAA6F;AAC7F,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAW,CAAC;AAExE,iGAAiG;AACjG,MAAM,UAAU,mBAAmB,CAClC,KAAmB,EACnB,UAA4C,EAC5C,QAA4B;IAE5B,MAAM,QAAQ,GAAG,QAAQ,IAAI,CAAC,CAAC;IAC/B,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;IACzB,yGAAyG;IACzG,OAAO,KAAK,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,GAAG,QAAQ;QAAE,KAAK,EAAE,CAAC;IAC7E,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/core/queue-adapter.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Queue Adapter Abstraction
+ *
+ * Core interface for queue implementations contributed by host-composed
+ * adapters. Workers owns the contract and resolves implementations at runtime.
+ */
+import { type JobListOmittableField } from './schemas/index.ts';
+import { type ResumeAdmission } from './schemas/resume.ts';
+/** Post-persistence invalidation; it carries no execution attempt or mutation-order claim. */
+export declare const JOB_ENQUEUED_EVENT = "enqueued";
+export declare const JOB_CHANGED_EVENT = "owner.changed";
+export { stampRetryPolicy, retryDelayMs, withRetryAvailability, isDueAt } from './enqueue-metadata.ts';
+import type { QueueAdapterExtended as QueueAdapter, JobExtended as AdapterJob, JobUpdateExtended as JobUpdate, JobEventExtended as JobEvent } from './schemas/index.ts';
+import type { JobUpdateExtended, QueueMetricsExtended, EnqueueOptionsExtended, DequeueOptionsExtended, JobExtended, QueueAdapterExtended, JobStatusExtended, JobStateExtended, JobExecutionClaim, JobWriteGuard, JobRetryOptions, JobMutationStamp, JobExecutionClaimState, JobExecutionRecord, JobDataEquals, JobListOptions, Cancellation } from './schemas/index.ts';
+export type { RepeatOptions, JobExecutionClaim, JobExecutionClaimState, JobWriteGuard, JobRetryOptions, JobMutationStamp, JobExecutionRecord, JobUpdateExtended as JobUpdate, QueueMetricsExtended as QueueMetrics, EnqueueOptionsExtended as EnqueueOptions, DequeueOptionsExtended as DequeueOptions, ScheduleInfoExtended as ScheduleInfo, CleanupOptionsExtended as CleanupOptions, CleanupResultExtended as CleanupResult, JobEventExtended as JobEvent, JobExtended as Job, QueueAdapterExtended as QueueAdapter, JobStatusExtended as JobStatus, JobStateExtended as JobState, KeyedClaimOptionsExtended as KeyedClaimOptions, KeyedClaimOutcomeExtended as KeyedClaimOutcome, KeyedClaimReceiptExtended as KeyedClaimReceipt, CoalescedEnqueueOptionsExtended as CoalescedEnqueueOptions, CoalescedEnqueueReceiptExtended as CoalescedEnqueueReceipt, JobDataEquals, JobListOptions, JobListOmittableField, Cancellation } from './schemas/index.ts';
+/** The `listJobs` order: newest `createdAt` first, then `id` descending among jobs created in the same instant. */
+export declare function compareJobsNewestFirst(a: Pick<JobExtended, 'id' | 'createdAt'>, b: Pick<JobExtended, 'id' | 'createdAt'>): number;
+/** A test of whether a job's data is an object carrying every field of `dataEquals` with exactly that value. */
+export declare function jobDataSelector(dataEquals: JobDataEquals): (job: Pick<JobExtended, 'data'>) => boolean;
+/**
+ * One `listJobs` page of jobs held in memory: select by `state` and
+ * `dataEquals`, order newest first, then cut `offset` and `limit`.
+ */
+export declare function pageJobList<TJob extends Pick<JobExtended, 'id' | 'createdAt' | 'status' | 'data'>>(jobs: Iterable<TJob>, state: JobStateExtended | undefined, options: JobListOptions | undefined): TJob[];
+/**
+ * A listed row without the fields `omit` names (`JobListOptions.omit`): the
+ * row is a copy, and an omitted field is absent from it, never `undefined`.
+ */
+export declare function omitJobFields<TJob extends Pick<JobExtended, 'result' | 'progress'>>(job: TJob, omit: readonly JobListOmittableField[] | undefined): TJob;
+/** Capture once; a later job read cannot grant an old producer new authority. */
+export declare function jobWriteGuard(job: JobExtended): JobWriteGuard;
+export declare function jobMutationStamp(job: JobExtended): JobMutationStamp;
+/** A current-state projection advances only through queue-authored admission/revision order. */
+export declare function isNewerJobMutationStamp(current: JobMutationStamp, next: JobMutationStamp): boolean;
+/** Detach owner fields while preserving in-memory input/result capabilities. */
+export declare function snapshotJob<TJob>(job: JobExtended<TJob>): JobExtended<TJob>;
+/** Call in the owner's atomic mutation, not before an unrelated awaited write. */
+export declare function assertJobWriteGuard(job: JobExtended, guard: JobWriteGuard): void;
+export declare function assertJobMutationGuard(job: JobExtended, guard: JobWriteGuard): void;
+export declare function assertExecutionClaim(job: JobExtended, claim: JobExecutionClaim): JobExecutionClaim;
+/**
+ * Whether an enqueue under a caller-supplied id leaves the existing job as it is. A caller id is a
+ * dedupe key in every adapter: a pending, delayed, processing or completed job stays (the caller
+ * reattaches to it and reads its result), and a job that ended failed or cancelled is admitted again
+ * with the new input. Under `resume` (a keyed child of an executing job, `keyed-dispatch.ts`) the
+ * child's outcome stands for the run that is resuming: a cancellation stands unless shutdown made it
+ * (system `disposal`, an interruption), and a failure stands unless the job that admitted the child
+ * has retried since, so a restart never hands a failed child a fresh attempt budget.
+ */
+export declare function keepsCallerAdmission(job: Pick<JobExtended, 'status' | 'cancellation' | 'metadata'>, resume?: ResumeAdmission): boolean;
+/** Re-admission cannot retire a producer, even after a logical terminal result. */
+export declare function assertJobReadmission(job: JobExtended, expectedGeneration: number, expectedRevision?: number, expectedStatus?: JobRetryOptions['expectedStatus']): void;
+export declare function createJobExecutionClaim(job: JobExtended, owner: string): JobExecutionClaim;
+export declare function jobExecutionRecord(job: JobExtended): JobExecutionRecord;
+/** Historical absence is unresolved; malformed modern ownership is an error. */
+export declare function executionClaimFromRecord(row: JobExecutionRecord): JobExecutionClaimState;
+/**
+ * Restore one stored claim for an owner that keeps serving its other jobs.
+ * Malformed ownership stays that job's error: the job is unresolved, carrying
+ * its typed fault, so every takeover, cancel, retry and cleanup refuses it;
+ * the row is left as stored for repair.
+ */
+export declare function restoreExecutionClaim(row: JobExecutionRecord): JobExecutionClaimState;
+export declare abstract class BaseQueueAdapter<TJob = unknown, TResult = unknown> implements QueueAdapterExtended<TJob, TResult> {
+    protected queueName: string;
+    get queueId(): string;
+    constructor(queueName: string);
+    private executionOwner?;
+    protected createExecutionClaim(job: JobExtended, options?: DequeueOptionsExtended): JobExecutionClaim;
+    abstract enqueue(data: TJob, options?: EnqueueOptionsExtended): Promise<string>;
+    abstract dequeue(options?: DequeueOptionsExtended): Promise<JobExtended<TJob> | null>;
+    abstract getJob(jobId: string): Promise<JobExtended<TJob> | null>;
+    abstract updateJob(jobId: string, update: JobUpdateExtended, guard: JobWriteGuard): Promise<JobMutationStamp>;
+    abstract renewExecution(jobId: string, claim: JobExecutionClaim): Promise<void>;
+    abstract releaseExecution(jobId: string, claim: JobExecutionClaim): Promise<void>;
+    abstract cancelJob(jobId: string, cancellation: Cancellation): Promise<boolean>;
+    abstract retryJob(jobId: string, options: JobRetryOptions): Promise<string>;
+    abstract getStatus(jobId: string): Promise<JobStatusExtended>;
+    abstract listJobs(state?: JobStateExtended, options?: JobListOptions): Promise<JobExtended<TJob>[]>;
+    abstract getMetrics(): Promise<QueueMetricsExtended>;
+    abstract connect(): Promise<void>;
+    abstract disconnect(): Promise<void>;
+    protected generateJobId(): string;
+    protected calculateRetryDelay(attempt: number, backoff?: {
+        type: 'fixed' | 'exponential';
+        delay: number;
+    }): number;
+}
+/** The admitted attempt owns every issued queue write, including writes its handler does not await. */
+export declare class JobExecutionOperations {
+    private readonly queue;
+    readonly guard: JobWriteGuard;
+    private readonly jobId;
+    private readonly claim;
+    private tail;
+    private readonly work;
+    private closed;
+    private failures;
+    constructor(queue: QueueAdapter, job: AdapterJob);
+    private issue;
+    /** Keep issued context work alive after a logical deadline abandons its wait. */
+    own<T>(start: () => Promise<T>): Promise<T>;
+    update(update: JobUpdate): Promise<JobMutationStamp>;
+    emit(event: string, data?: JobEvent['data'], guard?: JobWriteGuard): Promise<void>;
+    renew(): Promise<void>;
+    joinWork(): Promise<void>;
+    /** Closing admission and joining the actual tail does not erase an earlier write failure. */
+    retire(): Promise<void>;
+}
+//# sourceMappingURL=queue-adapter.d.ts.map

package/dist/core/queue-adapter.d.ts.map

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