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

package/dist/adapters/ipc/internal/adapter-rpc.js

@@ -0,0 +1,213 @@
+/**
+ * Adapter RPC Operations
+ * Client-side RPC method implementations for BunIPCAdapter
+ */
+import { isCapabilityError } from '@vibesdotdev/kernel';
+import { settle } from "../../../core/settle.js";
+import { INLINE_RESULT_CHARS, parseResultText, resultChanged, resultPage, resultText } from "./result-pages.js";
+function optionalDate(value) {
+    return value == null ? value : new Date(value);
+}
+/** A job as it crossed the socket, whose JSON carried its dates as ISO strings, with the Dates the QueueAdapter contract answers. */
+function jobFromWire(job) {
+    return {
+        ...job,
+        createdAt: new Date(job.createdAt),
+        startedAt: optionalDate(job.startedAt),
+        completedAt: optionalDate(job.completedAt),
+        retiredAt: optionalDate(job.retiredAt)
+    };
+}
+export function createRpcOperations(rpc) {
+    /** A deferred result, read page by page at the revision the answer named, and parsed whole. */
+    async function readResult(jobId, deferred) {
+        const pages = [];
+        for (let offset = 0; offset < deferred.chars;) {
+            const page = await rpc({ type: 'read_job_result', jobId, revision: deferred.revision, offset });
+            if (page.text.length === 0)
+                break;
+            pages.push(page.text);
+            offset += page.text.length;
+        }
+        const text = pages.join('');
+        if (text.length !== deferred.chars)
+            throw resultChanged(jobId);
+        return parseResultText(text);
+    }
+    return {
+        async enqueue(jobId, data, options) {
+            const response = await rpc({
+                type: 'enqueue',
+                jobId,
+                data,
+                options
+            });
+            return response.jobId;
+        },
+        async claimKeyed(data, options) {
+            const response = await rpc({
+                type: 'claim_keyed',
+                jobId: options.jobId,
+                data,
+                options
+            });
+            return { ...response.receipt, job: jobFromWire(response.receipt.job) };
+        },
+        async enqueueCoalesced(jobId, data, options) {
+            const response = await rpc({
+                type: 'enqueue_coalesced',
+                jobId,
+                data,
+                options
+            });
+            return response.receipt;
+        },
+        async dequeue(queueName, options) {
+            const response = await rpc({
+                type: 'dequeue',
+                queueName,
+                options
+            });
+            return response.job && jobFromWire(response.job);
+        },
+        async getJob(jobId) {
+            // A result that changed while its pages were read is read once more from the job's new revision.
+            for (let attempt = 0;; attempt++) {
+                const response = await rpc({
+                    type: 'get_job',
+                    jobId,
+                    bounded: true
+                });
+                if (!response.job)
+                    return null;
+                const job = jobFromWire(response.job);
+                if (!response.deferredResult)
+                    return job;
+                const read = await settle(() => readResult(jobId, response.deferredResult));
+                if (read.ok)
+                    return { ...job, result: read.value };
+                if (attempt > 0 || !isCapabilityError(read.caught) || read.caught.reason !== 'job-result-changed')
+                    throw read.thrown;
+            }
+        },
+        async updateJob(jobId, update, guard) {
+            const text = update.result === undefined ? undefined : resultText(update.result);
+            if (text === undefined || text.length <= INLINE_RESULT_CHARS) {
+                const response = await rpc({ type: 'update_job', jobId, update, guard });
+                return response.stamp;
+            }
+            // A result past the inline budget is staged in pages, then committed by the guarded update that names it.
+            const uploadId = crypto.randomUUID();
+            for (let offset = 0; offset < text.length;) {
+                const page = resultPage(text, offset);
+                await rpc({ type: 'stage_job_result', jobId, uploadId, offset, text: page });
+                offset += page.length;
+            }
+            const { result: _staged, ...withoutResult } = update;
+            const response = await rpc({
+                type: 'update_job', jobId, update: withoutResult, guard, stagedResult: { uploadId, chars: text.length }
+            });
+            return response.stamp;
+        },
+        async renewExecution(jobId, claim) {
+            await rpc({ type: 'renew_execution', jobId, claim });
+        },
+        async releaseExecution(jobId, claim) {
+            await rpc({ type: 'release_execution', jobId, claim });
+        },
+        async broadcastEvent(jobId, event, guard, data) {
+            await rpc({ type: 'broadcast_event', jobId, event, guard, data });
+        },
+        async cancelJob(jobId, cancellation) {
+            const response = await rpc({
+                type: 'cancel_job',
+                jobId,
+                cancellation
+            });
+            return response.success;
+        },
+        async cancelJobGuarded(jobId, cancellation, guard) {
+            const response = await rpc({
+                type: 'cancel_job_guarded', jobId, cancellation, guard
+            });
+            return response.success;
+        },
+        async retryJob(jobId, options) {
+            const response = await rpc({
+                type: 'retry_job', jobId, options
+            });
+            return response.newJobId;
+        },
+        async getStatus(jobId) {
+            const response = await rpc({
+                type: 'get_status',
+                jobId
+            });
+            return response.status;
+        },
+        async listJobs(state, options) {
+            const response = await rpc({
+                type: 'list_jobs',
+                state,
+                options,
+                bounded: true
+            });
+            const jobs = response.jobs.map(jobFromWire);
+            const deferred = response.deferredResults;
+            if (!deferred)
+                return jobs;
+            // Each deferred result is read from its job (paged, retried once if the job changed meanwhile).
+            return Promise.all(jobs.map(async (job) => {
+                if (!deferred[job.id])
+                    return job;
+                const whole = await this.getJob(job.id);
+                return whole ? { ...job, result: whole.result } : job;
+            }));
+        },
+        async getMetrics(queueName) {
+            const response = await rpc({
+                type: 'get_metrics',
+                queueName
+            });
+            return response.metrics;
+        },
+        async getVersion() {
+            const response = await rpc({
+                type: 'get_version'
+            });
+            return response.version;
+        },
+        async scheduleRepeatable(name, data, options) {
+            const response = await rpc({
+                type: 'schedule_repeatable',
+                name,
+                data,
+                options
+            });
+            return response.scheduleKey;
+        },
+        async removeSchedule(name, repeat) {
+            const response = await rpc({
+                type: 'remove_schedule',
+                name,
+                repeat
+            });
+            return response.success;
+        },
+        async getSchedules() {
+            const response = await rpc({
+                type: 'get_schedules'
+            });
+            return response.schedules;
+        },
+        async restoreArchivedSchedules(queueName, ids) {
+            const response = await rpc({
+                type: 'restore_schedules',
+                queueName,
+                ids: ids === undefined ? undefined : [...ids]
+            });
+            return response.count;
+        }
+    };
+}
+//# sourceMappingURL=adapter-rpc.js.map

package/dist/adapters/ipc/internal/adapter-rpc.js.map

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

package/dist/adapters/ipc/internal/result-pages.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Bounded job results over the worker socket.
+ *
+ * One socket record carries at most `RPC_MAX_MESSAGE_BYTES` (32 MiB), and the
+ * structured RPC encoding of a JSON value is several times its JSON length. A
+ * job result has no such bound: a graph run over hundreds of packages records
+ * every package's findings. So a result crosses the socket inline only while
+ * the answer stays small; past that it crosses as JSON text pages, each a
+ * plain string well under the record ceiling, read (or, for a completion
+ * write, staged) by the client and reassembled. Callers of the queue never see
+ * the pages: `getJob`, `listJobs` and `updateJob` keep their contracts.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { type JsonValue } from '@vibesdotdev/kernel/schemas/json';
+import type { JobExtended } from '../../../core/schemas/index.ts';
+/** A job's result as the queue holds it. */
+export type JobResult = JobExtended['result'];
+/** JSON characters of job results one answer (or one update) carries inline. */
+export declare const INLINE_RESULT_CHARS: number;
+/**
+ * JSON characters in one result page. A page crosses as one string: even if
+ * every character escaped to six bytes it stays under the 32 MiB record ceiling.
+ */
+export declare const RESULT_PAGE_CHARS: number;
+/** A job result left out of an answer, to be read in pages at this job revision. */
+export interface DeferredResult {
+    /** Length of the result's JSON text. */
+    chars: number;
+    /** The job revision the text belongs to; a page read at another revision is refused. */
+    revision: number;
+}
+/** A result's JSON text, parsed back at the socket boundary. */
+export declare function parseResultText(text: string): JsonValue;
+/** The JSON text a result crosses as. */
+export declare function resultText(result: JobResult): string;
+/** The page of `text` starting at `offset`; a page never ends between the halves of a surrogate pair. */
+export declare function resultPage(text: string, offset: number): string;
+/** The refusal of a page read whose job changed since the read began. */
+export declare function resultChanged(jobId: string): CapabilityError;
+/** The refusal of a staged completion whose pages do not add up to the result it names. */
+export declare function stagedResultInvalid(jobId: string, reason: string): CapabilityError;
+/** One answer's result budget: results are inlined in order until it is spent; the rest are deferred. */
+export declare class InlineResultBudget {
+    private spent;
+    /** Whether `text` still fits inline; a result that fits is charged to the budget. */
+    admit(text: string): boolean;
+}
+/**
+ * Completion results staged in pages by clients, held by the server until the
+ * `update_job` that names them commits (or until they expire unclaimed).
+ */
+export declare class StagedResults {
+    private readonly uploads;
+    stage(jobId: string, uploadId: string, offset: number, text: string): void;
+    /** Take the whole staged result (once) and parse it. */
+    take(jobId: string, uploadId: string, chars: number): JsonValue;
+    private sweep;
+}
+//# sourceMappingURL=result-pages.d.ts.map

package/dist/adapters/ipc/internal/result-pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-pages.d.ts","sourceRoot":"","sources":["../../../../src/adapters/ipc/internal/result-pages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAElE,4CAA4C;AAC5C,MAAM,MAAM,SAAS,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;AAE9C,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,QAAkB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,QAAkB,CAAC;AAEjD,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC9B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAEvD;AAED,yCAAyC;AACzC,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAEpD;AAED,yGAAyG;AACzG,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAO/D;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAM5D;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,eAAe,CAMlF;AAED,yGAAyG;AACzG,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,KAAK,CAAK;IAElB,qFAAqF;IACrF,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAK5B;AAKD;;;GAGG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2F;IAEnH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAW1E,wDAAwD;IACxD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS;IAQ/D,OAAO,CAAC,KAAK;CAIb"}

package/dist/adapters/ipc/internal/result-pages.js

@@ -0,0 +1,104 @@
+/**
+ * Bounded job results over the worker socket.
+ *
+ * One socket record carries at most `RPC_MAX_MESSAGE_BYTES` (32 MiB), and the
+ * structured RPC encoding of a JSON value is several times its JSON length. A
+ * job result has no such bound: a graph run over hundreds of packages records
+ * every package's findings. So a result crosses the socket inline only while
+ * the answer stays small; past that it crosses as JSON text pages, each a
+ * plain string well under the record ceiling, read (or, for a completion
+ * write, staged) by the client and reassembled. Callers of the queue never see
+ * the pages: `getJob`, `listJobs` and `updateJob` keep their contracts.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { JsonValueSchema } from '@vibesdotdev/kernel/schemas/json';
+/** JSON characters of job results one answer (or one update) carries inline. */
+export const INLINE_RESULT_CHARS = 2 * 1024 * 1024;
+/**
+ * JSON characters in one result page. A page crosses as one string: even if
+ * every character escaped to six bytes it stays under the 32 MiB record ceiling.
+ */
+export const RESULT_PAGE_CHARS = 4 * 1024 * 1024;
+/** A result's JSON text, parsed back at the socket boundary. */
+export function parseResultText(text) {
+    return JsonValueSchema.parse(JSON.parse(text));
+}
+/** The JSON text a result crosses as. */
+export function resultText(result) {
+    return JSON.stringify(result) ?? 'null';
+}
+/** The page of `text` starting at `offset`; a page never ends between the halves of a surrogate pair. */
+export function resultPage(text, offset) {
+    let end = Math.min(text.length, offset + RESULT_PAGE_CHARS);
+    if (end < text.length && end > offset + 1) {
+        const last = text.charCodeAt(end - 1);
+        if (last >= 0xd800 && last <= 0xdbff)
+            end -= 1;
+    }
+    return text.slice(offset, end);
+}
+/** The refusal of a page read whose job changed since the read began. */
+export function resultChanged(jobId) {
+    return new CapabilityError('The job changed while its result was being read.', 'CONFLICT', {
+        reason: 'job-result-changed',
+        retryable: true,
+        details: { jobId }
+    });
+}
+/** The refusal of a staged completion whose pages do not add up to the result it names. */
+export function stagedResultInvalid(jobId, reason) {
+    return new CapabilityError(`The staged result for the job is not whole: ${reason}.`, 'INVALID_INPUT', {
+        reason: 'job-result-staging-invalid',
+        retryable: false,
+        details: { jobId }
+    });
+}
+/** One answer's result budget: results are inlined in order until it is spent; the rest are deferred. */
+export class InlineResultBudget {
+    spent = 0;
+    /** Whether `text` still fits inline; a result that fits is charged to the budget. */
+    admit(text) {
+        if (this.spent + text.length > INLINE_RESULT_CHARS)
+            return false;
+        this.spent += text.length;
+        return true;
+    }
+}
+/** How long a staged upload that was never committed is kept. */
+const STAGED_UPLOAD_TTL_MS = 10 * 60_000;
+/**
+ * Completion results staged in pages by clients, held by the server until the
+ * `update_job` that names them commits (or until they expire unclaimed).
+ */
+export class StagedResults {
+    uploads = new Map();
+    stage(jobId, uploadId, offset, text) {
+        this.sweep();
+        const upload = this.uploads.get(uploadId) ?? { jobId, parts: [], chars: 0, touchedAt: Date.now() };
+        if (upload.jobId !== jobId)
+            throw stagedResultInvalid(jobId, 'the upload belongs to another job');
+        if (offset !== upload.chars)
+            throw stagedResultInvalid(jobId, `page at ${offset} does not follow ${upload.chars}`);
+        upload.parts.push(text);
+        upload.chars += text.length;
+        upload.touchedAt = Date.now();
+        this.uploads.set(uploadId, upload);
+    }
+    /** Take the whole staged result (once) and parse it. */
+    take(jobId, uploadId, chars) {
+        const upload = this.uploads.get(uploadId);
+        this.uploads.delete(uploadId);
+        if (!upload || upload.jobId !== jobId)
+            throw stagedResultInvalid(jobId, 'no upload was staged for it');
+        if (upload.chars !== chars)
+            throw stagedResultInvalid(jobId, `${upload.chars} of ${chars} characters arrived`);
+        return parseResultText(upload.parts.join(''));
+    }
+    sweep() {
+        const now = Date.now();
+        for (const [id, upload] of this.uploads)
+            if (now - upload.touchedAt > STAGED_UPLOAD_TTL_MS)
+                this.uploads.delete(id);
+    }
+}
+//# sourceMappingURL=result-pages.js.map

package/dist/adapters/ipc/internal/result-pages.js.map

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

package/dist/adapters/ipc/internal/rpc/client.d.ts

@@ -0,0 +1,29 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+/**
+ * Worker HTTP Client
+ * fetch with unix option + SSE event subscription
+ */
+import type { JobEvent } from '../../../../core/queue-adapter.ts';
+import type { IPCMessage, IPCResponse } from '../../schemas/messages.ts';
+export declare class WorkerRpcClient {
+    private readonly runtime;
+    /** `runtime` is the one whose socket service every request and the event stream connect through. */
+    constructor(runtime: RuntimeRef);
+    private socketPath?;
+    private eventSource?;
+    private eventTask?;
+    private eventHandlers;
+    connect(socketPath: string): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    /** Every queue connection to this admitted socket receives the same host-wide feed. */
+    get eventSubscriptionIdentity(): string | undefined;
+    rpc<T extends IPCResponse>(message: IPCMessage, timeoutMs?: number): Promise<T>;
+    private request;
+    subscribeToEvents(jobId: string, handler: (event: JobEvent) => void): () => void;
+    private startEventStream;
+    private handleReplayGap;
+    private handleEvent;
+    private wrapError;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/adapters/ipc/internal/rpc/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/ipc/internal/rpc/client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuC,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAG3F;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAIlE,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AA2BzE,qBAAa,eAAe;IAEf,OAAO,CAAC,QAAQ,CAAC,OAAO;IADpC,oGAAoG;gBACvE,OAAO,EAAE,UAAU;IAEhD,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAC,CAAkB;IACtC,OAAO,CAAC,SAAS,CAAC,CAAgB;IAClC,OAAO,CAAC,aAAa,CAA0D;IAEzE,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC,WAAW,IAAI,OAAO;IAItB,uFAAuF;IACvF,IAAI,yBAAyB,IAAI,MAAM,GAAG,SAAS,CAElD;IAEK,GAAG,CAAC,CAAC,SAAS,WAAW,EAC9B,OAAO,EAAE,UAAU,EACnB,SAAS,SAAqB,GAC5B,OAAO,CAAC,CAAC,CAAC;YAoBC,OAAO;IA2CrB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,MAAM,IAAI;IAehF,OAAO,CAAC,gBAAgB;IA4CxB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,WAAW;IA0BnB,OAAO,CAAC,SAAS;CA2BjB"}