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

package/dist/runtime/job-result-store.state.js

@@ -0,0 +1,242 @@
+/**
+ * JobResultStore state machine
+ */
+import * as z from 'zod/v4';
+import { settle } from "../core/settle.js";
+import { DurableJobEventSchema, OutcomeSchema } from "./schemas/index.js";
+export { STATE_KEY, DEFAULT_TTL_MS } from "./schemas/index.js";
+const EVENT_LOG_KEY = 'events';
+const EXECUTION_LEASE_KEY = 'execution-lease';
+const MAX_EVENT_COUNT = 1_024;
+const MAX_EVENT_BYTES = 4 * 1024 * 1024;
+const DEFAULT_EVENT_READ_LIMIT = 256;
+const MAX_EVENT_READ_LIMIT = 1_024;
+const EventLogStateSchema = z.object({
+    nextCursor: z.number(),
+    events: z.array(DurableJobEventSchema)
+});
+const ExecutionLeaseSchema = z.object({
+    owner: z.string(),
+    expiresAt: z.number()
+});
+function readStored(stored, schema) {
+    if (stored === undefined || stored === null)
+        return undefined;
+    return schema.parse(stored);
+}
+/** A settled outcome (only `pending` and terminal outcomes are ever stored; `unknown` is a read of no state). */
+function isTerminal(outcome) {
+    return outcome.status !== 'pending' && outcome.status !== 'unknown';
+}
+export class JobResultStoreState {
+    storage;
+    runtime;
+    waiters = new Set();
+    eventWaiters = new Set();
+    /** `runtime` owns the wait deadlines; they end with it. */
+    constructor(storage, runtime) {
+        this.storage = storage;
+        this.runtime = runtime;
+    }
+    async register(_jobId, options) {
+        const existing = await this.peekState();
+        if (existing && existing.status !== 'pending')
+            return;
+        await this.storage.put('state', { status: 'pending' });
+        const eventLog = await this.peekEventLog();
+        if (!eventLog)
+            await this.storage.put(EVENT_LOG_KEY, { nextCursor: 1, events: [] });
+        const ttl = options?.ttlMs ?? 35 * 60_000;
+        await this.storage.setAlarm(Date.now() + ttl);
+    }
+    /**
+     * Durable compare-and-set claim for queue execution. Duplicate queue
+     * messages share a job-id-named Durable Object, so only one reaches the job
+     * implementation. An abandoned claim becomes eligible after the lease.
+     */
+    async claimExecution(_jobId, owner, options) {
+        const outcome = await this.peekState();
+        if (outcome && outcome.status !== 'pending')
+            return false;
+        const now = Date.now();
+        const existing = readStored(await this.storage.get(EXECUTION_LEASE_KEY), ExecutionLeaseSchema);
+        if (existing && existing.expiresAt > now && existing.owner !== owner)
+            return false;
+        await this.storage.put(EXECUTION_LEASE_KEY, ExecutionLeaseSchema.parse({
+            owner,
+            expiresAt: now + (options?.leaseMs ?? 60 * 60_000)
+        }));
+        return true;
+    }
+    async releaseExecution(_jobId, owner) {
+        const existing = readStored(await this.storage.get(EXECUTION_LEASE_KEY), ExecutionLeaseSchema);
+        if (!existing || existing.owner !== owner)
+            return;
+        await this.storage.put(EXECUTION_LEASE_KEY, ExecutionLeaseSchema.parse({ owner, expiresAt: 0 }));
+    }
+    async appendEvent(_jobId, event, data) {
+        const outcome = await this.peekState();
+        if (!outcome || outcome.status === 'unknown') {
+            throw new Error('Cannot append an event before the job is registered.');
+        }
+        if (outcome.status !== 'pending') {
+            throw new Error(`Cannot append an event after the job is ${outcome.status}.`);
+        }
+        const log = (await this.peekEventLog()) ?? { nextCursor: 1, events: [] };
+        const durableEvent = {
+            cursor: log.nextCursor,
+            event,
+            timestamp: new Date().toISOString()
+        };
+        if (data !== undefined)
+            durableEvent.data = data;
+        log.nextCursor += 1;
+        log.events.push(durableEvent);
+        this.trimEventLog(log.events);
+        await this.storage.put(EVENT_LOG_KEY, log);
+        await this.resolveEventWaiters();
+        return durableEvent;
+    }
+    async readEvents(_jobId, options) {
+        const after = Math.max(0, options?.after ?? 0);
+        const limit = Math.min(MAX_EVENT_READ_LIMIT, Math.max(1, options?.limit ?? DEFAULT_EVENT_READ_LIMIT));
+        const waitMs = options?.waitMs;
+        const page = await this.readEventPage(after, limit);
+        if (page.events.length > 0 || page.outcome.status !== 'pending' || !waitMs) {
+            return page;
+        }
+        return new Promise((resolve) => {
+            const waiter = { after, limit, resolve };
+            this.eventWaiters.add(waiter);
+            waiter.cancelTimer = this.runtime.lifecycle.timeout(() => {
+                this.eventWaiters.delete(waiter);
+                void this.readEventPage(after, limit).then(resolve);
+            }, waitMs);
+        });
+    }
+    wait(jobId, options) {
+        const waiter = {
+            resolve: () => { }
+        };
+        const promise = new Promise((resolve) => {
+            // SAFETY: a completed outcome's `result` is the job's own result, and TResult
+            // is the caller's declared result contract for this job; failed and cancelled
+            // outcomes are identical in both types.
+            waiter.resolve = resolve;
+        });
+        this.waiters.add(waiter);
+        const timeoutMs = options?.timeoutMs ?? 35 * 60_000;
+        void settle(() => this.peekState()).then((peeked) => {
+            if (!this.waiters.has(waiter))
+                return;
+            if (!peeked.ok) {
+                // An unreadable state ends the wait as a failure that names it.
+                this.waiters.delete(waiter);
+                const failure = peeked.caught;
+                waiter.resolve({
+                    status: 'failed',
+                    error: failure instanceof Error ? failure.message : failure.description
+                });
+                return;
+            }
+            const current = peeked.value;
+            if (current && isTerminal(current)) {
+                this.waiters.delete(waiter);
+                waiter.resolve(current);
+                return;
+            }
+            waiter.cancelTimer = this.runtime.lifecycle.timeout(() => {
+                this.waiters.delete(waiter);
+                waiter.resolve({
+                    status: 'failed',
+                    error: `Wait timed out after ${timeoutMs}ms: ${jobId}`
+                });
+            }, timeoutMs);
+        });
+        return promise;
+    }
+    async complete(_jobId, result) {
+        await this.settle({ status: 'completed', result });
+    }
+    async fail(_jobId, error) {
+        await this.settle({ status: 'failed', error });
+    }
+    async cancel(_jobId) {
+        await this.settle({ status: 'cancelled' });
+    }
+    async peek(_jobId) {
+        const state = await this.peekState();
+        return state ?? { status: 'unknown' };
+    }
+    async onAlarm() {
+        await this.storage.deleteAll();
+        for (const waiter of this.waiters) {
+            waiter.cancelTimer?.();
+            waiter.resolve({ status: 'cancelled' });
+        }
+        this.waiters.clear();
+        for (const waiter of this.eventWaiters) {
+            waiter.cancelTimer?.();
+            waiter.resolve({
+                events: [],
+                cursor: waiter.after,
+                outcome: { status: 'cancelled' }
+            });
+        }
+        this.eventWaiters.clear();
+    }
+    async peekState() {
+        return readStored(await this.storage.get('state'), OutcomeSchema);
+    }
+    async peekEventLog() {
+        return readStored(await this.storage.get(EVENT_LOG_KEY), EventLogStateSchema);
+    }
+    async readEventPage(after, limit) {
+        const [log, outcome] = await Promise.all([this.peekEventLog(), this.peekState()]);
+        const events = log?.events ?? [];
+        const oldestAvailable = events[0]?.cursor ?? log?.nextCursor ?? 1;
+        const gap = after < oldestAvailable - 1 ? { requestedAfter: after, oldestAvailable } : undefined;
+        const selected = events.filter((entry) => entry.cursor > after).slice(0, limit);
+        const page = {
+            events: selected,
+            cursor: selected.at(-1)?.cursor ?? after,
+            outcome: outcome ?? { status: 'unknown' }
+        };
+        if (gap)
+            page.gap = gap;
+        return page;
+    }
+    trimEventLog(events) {
+        while (events.length > MAX_EVENT_COUNT)
+            events.shift();
+        let bytes = this.eventBytes(events);
+        while (events.length > 1 && bytes > MAX_EVENT_BYTES) {
+            events.shift();
+            bytes = this.eventBytes(events);
+        }
+    }
+    eventBytes(events) {
+        return new TextEncoder().encode(JSON.stringify(events)).byteLength;
+    }
+    async resolveEventWaiters() {
+        const waiters = [...this.eventWaiters];
+        this.eventWaiters.clear();
+        await Promise.all(waiters.map(async (waiter) => {
+            waiter.cancelTimer?.();
+            waiter.resolve(await this.readEventPage(waiter.after, waiter.limit));
+        }));
+    }
+    async settle(outcome) {
+        const existing = await this.peekState();
+        if (existing && existing.status !== 'pending')
+            return;
+        await this.storage.put('state', outcome);
+        for (const waiter of this.waiters) {
+            waiter.cancelTimer?.();
+            waiter.resolve(outcome);
+        }
+        this.waiters.clear();
+        await this.resolveEventWaiters();
+    }
+}
+//# sourceMappingURL=job-result-store.state.js.map

package/dist/runtime/job-result-store.state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-result-store.state.js","sourceRoot":"","sources":["../../src/runtime/job-result-store.state.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EACN,qBAAqB,EACrB,aAAa,EAMb,MAAM,oBAAoB,CAAC;AAU5B,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE/D,MAAM,aAAa,GAAG,QAAQ,CAAC;AAC/B,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAC9C,MAAM,eAAe,GAAG,KAAK,CAAC;AAC9B,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AACxC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AACrC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAEnC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;CACtC,CAAC,CAAC;AAGH,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC;AAEH,SAAS,UAAU,CAClB,MAA6B,EAC7B,MAAc;IAEd,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC9D,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC;AAED,iHAAiH;AACjH,SAAS,UAAU,CAAC,OAAgB;IACnC,OAAO,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC;AACrE,CAAC;AAcD,MAAM,OAAO,mBAAmB;IAMb;IACA;IANV,OAAO,GAAgB,IAAI,GAAG,EAAE,CAAC;IACjC,YAAY,GAAqB,IAAI,GAAG,EAAE,CAAC;IAEnD,2DAA2D;IAC3D,YACkB,OAAyB,EACzB,OAAwC;QADxC,YAAO,GAAP,OAAO,CAAkB;QACzB,YAAO,GAAP,OAAO,CAAiC;IACvD,CAAC;IAEJ,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,OAA4B;QAC1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACxC,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO;QACtD,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC3C,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QACpF,MAAM,GAAG,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,GAAG,MAAM,CAAC;QAC1C,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC;IAC/C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CACnB,MAAc,EACd,KAAa,EACb,OAA8B;QAE9B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACvC,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,oBAAoB,CAAC,CAAC;QAC/F,IAAI,QAAQ,IAAI,QAAQ,CAAC,SAAS,GAAG,GAAG,IAAI,QAAQ,CAAC,KAAK,KAAK,KAAK;YAAE,OAAO,KAAK,CAAC;QACnF,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,oBAAoB,CAAC,KAAK,CAAC;YACtE,KAAK;YACL,SAAS,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,GAAG,MAAM,CAAC;SAClD,CAAC,CAAC,CAAC;QACJ,OAAO,IAAI,CAAC;IACb,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,MAAc,EAAE,KAAa;QACnD,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAAE,oBAAoB,CAAC,CAAC;QAC/F,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,KAAK,KAAK;YAAE,OAAO;QAClD,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,oBAAoB,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAClG,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,KAAa,EAAE,IAA8B;QAC9E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACvC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,2CAA2C,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACzE,MAAM,YAAY,GAAoB;YACrC,MAAM,EAAE,GAAG,CAAC,UAAU;YACtB,KAAK;YACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACnC,CAAC;QACF,IAAI,IAAI,KAAK,SAAS;YAAE,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC;QACjD,GAAG,CAAC,UAAU,IAAI,CAAC,CAAC;QACpB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC9B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QAC3C,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACjC,OAAO,YAAY,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,UAAU,CACf,MAAc,EACd,OAA6D;QAE7D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACrB,oBAAoB,EACpB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,IAAI,wBAAwB,CAAC,CACvD,CAAC;QACF,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACpD,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5E,OAAO,IAAI,CAAC;QACb,CAAC;QAED,OAAO,IAAI,OAAO,CAAsB,CAAC,OAAO,EAAE,EAAE;YACnD,MAAM,MAAM,GAAgB,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;YACtD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC9B,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE;gBACxD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACjC,KAAK,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrD,CAAC,EAAE,MAAM,CAAC,CAAC;QACZ,CAAC,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CACH,KAAa,EACb,OAAgC;QAWhC,MAAM,MAAM,GAAW;YACtB,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;SACjB,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;YAC/C,8EAA8E;YAC9E,8EAA8E;YAC9E,wCAAwC;YACxC,MAAM,CAAC,OAAO,GAAG,OAA4B,CAAC;QAC/C,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEzB,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,EAAE,GAAG,MAAM,CAAC;QAEpD,KAAK,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACnD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,OAAO;YACtC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;gBAChB,gEAAgE;gBAChE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC5B,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;gBAC9B,MAAM,CAAC,OAAO,CAAC;oBACd,MAAM,EAAE,QAAQ;oBAChB,KAAK,EAAE,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW;iBACvE,CAAC,CAAC;gBACH,OAAO;YACR,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;YAC7B,IAAI,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACpC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC5B,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBACxB,OAAO;YACR,CAAC;YACD,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE;gBACxD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC5B,MAAM,CAAC,OAAO,CAAC;oBACd,MAAM,EAAE,QAAQ;oBAChB,KAAK,EAAE,wBAAwB,SAAS,OAAO,KAAK,EAAE;iBACtD,CAAC,CAAC;YACJ,CAAC,EAAE,SAAS,CAAC,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,MAAiB;QAC/C,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAc,EAAE,KAAa;QACvC,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc;QAC1B,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAc;QACxB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACrC,OAAO,KAAK,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,OAAO;QACZ,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QAC/B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACxC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,MAAM,CAAC,OAAO,CAAC;gBACd,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,MAAM,CAAC,KAAK;gBACpB,OAAO,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE;aAChC,CAAC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,SAAS;QACtB,OAAO,UAAU,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;IACnE,CAAC;IAEO,KAAK,CAAC,YAAY;QACzB,OAAO,UAAU,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,mBAAmB,CAAC,CAAC;IAC/E,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,KAAa,EAAE,KAAa;QACvD,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAClF,MAAM,MAAM,GAAG,GAAG,EAAE,MAAM,IAAI,EAAE,CAAC;QACjC,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,GAAG,EAAE,UAAU,IAAI,CAAC,CAAC;QAClE,MAAM,GAAG,GACR,KAAK,GAAG,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACtF,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAChF,MAAM,IAAI,GAAwB;YACjC,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,KAAK;YACxC,OAAO,EAAE,OAAO,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE;SACzC,CAAC;QACF,IAAI,GAAG;YAAE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACxB,OAAO,IAAI,CAAC;IACb,CAAC;IAEO,YAAY,CAAC,MAAyB;QAC7C,OAAO,MAAM,CAAC,MAAM,GAAG,eAAe;YAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QACvD,IAAI,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,GAAG,eAAe,EAAE,CAAC;YACrD,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;IACF,CAAC;IAEO,UAAU,CAAC,MAAyB;QAC3C,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;IACpE,CAAC;IAEO,KAAK,CAAC,mBAAmB;QAChC,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;QACvC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,MAAM,OAAO,CAAC,GAAG,CAChB,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YAC5B,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,CAAC,CAAC,CACF,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,OAAwB;QAC5C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACxC,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO;QAEtD,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACzC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACnC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAClC,CAAC;CACD"}

package/dist/runtime/ledger/job-ledger.record.descriptor.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Workers job ledger — one row per finished job run, inline or queued.
+ *
+ * Queue history lives in the adapter, and the consumer IPC adapter keeps it
+ * in process memory, so a run that happened inline, or before a restart, left
+ * no trace. `vibes workers jobs history` reads this record instead.
+ */
+import * as z from 'zod/v4';
+import type { StorageRecordDescriptorInput } from '@vibesdotdev/storage/schemas/record';
+export declare const JobRunModeSchema: z.ZodEnum<{
+    inline: "inline";
+    background: "background";
+}>;
+export declare const JobRunStatusSchema: z.ZodEnum<{
+    cancelled: "cancelled";
+    failed: "failed";
+    completed: "completed";
+}>;
+export declare const JobFailureClassSchema: z.ZodEnum<{
+    cancelled: "cancelled";
+    timeout: "timeout";
+    invalid_input: "invalid_input";
+    handler_error: "handler_error";
+}>;
+export declare const JobLedgerEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    jobId: z.ZodString;
+    jobType: z.ZodString;
+    mode: z.ZodEnum<{
+        inline: "inline";
+        background: "background";
+    }>;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        failed: "failed";
+        completed: "completed";
+    }>;
+    cancellation: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        by: z.ZodLiteral<"invocation">;
+        actor: z.ZodObject<{
+            agentId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            harness: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            agentSystemId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            harnessSessionId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            userId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            orgId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            projectId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            teamId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            home: z.ZodOptional<z.ZodEnum<{
+                user: "user";
+                organization: "organization";
+                team: "team";
+            }>>;
+            projectIds: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>>>;
+            participantId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            sessionId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+            instanceId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>, z.ZodString>>;
+        }, z.core.$strip>;
+        reason: z.ZodString;
+        cascadedFrom: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        by: z.ZodLiteral<"system">;
+        source: z.ZodEnum<{
+            cascade: "cascade";
+            "graph-stop": "graph-stop";
+            "graph-cancel": "graph-cancel";
+            deadline: "deadline";
+            disposal: "disposal";
+            "launcher-exit": "launcher-exit";
+        }>;
+        reason: z.ZodString;
+        cascadedFrom: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>], "by">>;
+    failureClass: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+        cancelled: "cancelled";
+        timeout: "timeout";
+        invalid_input: "invalid_input";
+        handler_error: "handler_error";
+    }>>>;
+    error: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    attempt: z.ZodNumber;
+    durationMs: z.ZodNumber;
+    hardware: z.ZodString;
+    startedAt: z.ZodUnion<readonly [z.ZodString, z.ZodDate]>;
+    createdAt: z.ZodUnion<readonly [z.ZodString, z.ZodDate]>;
+}, z.core.$strip>;
+export type JobLedgerEntry = z.infer<typeof JobLedgerEntrySchema>;
+export declare const JOB_LEDGER_RECORD_ID = "workers.job-ledger";
+export declare const jobLedgerRecordDescriptor: StorageRecordDescriptorInput;
+export default jobLedgerRecordDescriptor;
+//# sourceMappingURL=job-ledger.record.descriptor.d.ts.map

package/dist/runtime/ledger/job-ledger.record.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-ledger.record.descriptor.d.ts","sourceRoot":"","sources":["../../../src/runtime/ledger/job-ledger.record.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAGxF,eAAO,MAAM,gBAAgB;;;EAAmC,CAAC;AACjE,eAAO,MAAM,kBAAkB;;;;EAA+C,CAAC;AAC/E,eAAO,MAAM,qBAAqB;;;;;EAAqE,CAAC;AAExG,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkB/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AAEzD,eAAO,MAAM,yBAAyB,EAAE,4BAqCvC,CAAC;AAEF,eAAe,yBAAyB,CAAC"}

package/dist/runtime/ledger/job-ledger.record.descriptor.js

@@ -0,0 +1,71 @@
+/**
+ * Workers job ledger — one row per finished job run, inline or queued.
+ *
+ * Queue history lives in the adapter, and the consumer IPC adapter keeps it
+ * in process memory, so a run that happened inline, or before a restart, left
+ * no trace. `vibes workers jobs history` reads this record instead.
+ */
+import * as z from 'zod/v4';
+import { CancellationSchema } from "../../schemas/cancellation.js";
+export const JobRunModeSchema = z.enum(['inline', 'background']);
+export const JobRunStatusSchema = z.enum(['completed', 'failed', 'cancelled']);
+export const JobFailureClassSchema = z.enum(['invalid_input', 'timeout', 'handler_error', 'cancelled']);
+export const JobLedgerEntrySchema = z.object({
+    id: z.string().min(1),
+    /** The queue or inline run id. */
+    jobId: z.string().min(1),
+    /** The `workers/job` descriptor id. */
+    jobType: z.string().min(1),
+    mode: JobRunModeSchema,
+    status: JobRunStatusSchema,
+    /** Cancellation provenance is optional only for historical ledger rows. */
+    cancellation: CancellationSchema.optional(),
+    failureClass: JobFailureClassSchema.nullable().default(null),
+    /** Failure message, never job data or secrets. */
+    error: z.string().nullable().default(null),
+    attempt: z.number().int().positive(),
+    durationMs: z.number().int().nonnegative(),
+    hardware: z.string(),
+    startedAt: z.union([z.string().datetime(), z.date()]),
+    createdAt: z.union([z.string().datetime(), z.date()])
+});
+export const JOB_LEDGER_RECORD_ID = 'workers.job-ledger';
+export const jobLedgerRecordDescriptor = {
+    kind: 'storage/record',
+    id: JOB_LEDGER_RECORD_ID,
+    name: 'Workers Job Ledger',
+    description: 'One row per finished job run, inline or queued, for job history and diagnosis',
+    retention: {
+        maxAgeDays: 30,
+        reason: 'Job history answers "did this run, and how did it end" for recent work. ' +
+            'Thirty days covers a release cycle of diagnosis; older runs have no reader.'
+    },
+    schema: JobLedgerEntrySchema,
+    tableName: 'workers_job_ledger',
+    primaryKey: 'id',
+    relations: {},
+    indexes: [
+        { fields: ['jobType', 'createdAt'], unique: false },
+        { fields: ['status'], unique: false },
+        { fields: ['mode'], unique: false }
+    ],
+    version: 1,
+    timestamps: { createdAt: 'createdAt' },
+    autoId: { field: 'id', strategy: 'uuid' },
+    allowedAdapters: ['storage.localdb'],
+    defaultAdapter: 'storage.localdb',
+    adapterConfig: {
+        'storage.localdb': { dbName: 'workers.db', scope: 'project' }
+    },
+    scope: 'project',
+    validateOnWrite: false,
+    validateOnRead: false,
+    versioning: false,
+    audit: false,
+    changeTracking: false,
+    internal: false,
+    namespace: JOB_LEDGER_RECORD_ID,
+    tags: ['workers', 'ledger', 'tenancy:project']
+};
+export default jobLedgerRecordDescriptor;
+//# sourceMappingURL=job-ledger.record.descriptor.js.map

package/dist/runtime/ledger/job-ledger.record.descriptor.js.map

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

package/dist/runtime/ledger/record-job-run.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Write one ledger row for a finished job run. Recording never changes the
+ * job's outcome: a host without the ledger record says so once and keeps
+ * running jobs.
+ */
+import { type CaughtFailure, type RuntimeRef } from '@vibesdotdev/kernel';
+import { type JobLedgerEntry } from './job-ledger.record.descriptor.ts';
+export type JobRun = Omit<JobLedgerEntry, 'id' | 'createdAt' | 'failureClass' | 'error'> & {
+    /** The run's failure, parsed at its catch boundary. */
+    failure?: CaughtFailure;
+};
+export declare function recordJobRun(runtime: RuntimeRef, run: JobRun): Promise<void>;
+//# sourceMappingURL=record-job-run.d.ts.map

package/dist/runtime/ledger/record-job-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-job-run.d.ts","sourceRoot":"","sources":["../../../src/runtime/ledger/record-job-run.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAoB,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAM5F,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAI9F,MAAM,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,CAAC,GAAG;IAC1F,uDAAuD;IACvD,OAAO,CAAC,EAAE,aAAa,CAAC;CACxB,CAAC;AAUF,wBAAsB,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBlF"}

package/dist/runtime/ledger/record-job-run.js

@@ -0,0 +1,39 @@
+/**
+ * Write one ledger row for a finished job run. Recording never changes the
+ * job's outcome: a host without the ledger record says so once and keeps
+ * running jobs.
+ */
+import { valueFreeFailure } from '@vibesdotdev/kernel';
+import { getLogger } from '@vibesdotdev/logging';
+import { settle } from "../../core/settle.js";
+import { JobInputInvalidError, JobTimeoutError } from "../job-contract.js";
+import { JOB_LEDGER_RECORD_ID } from "./job-ledger.record.descriptor.js";
+const unavailableWarned = new WeakSet();
+function classify(failure) {
+    if (failure === undefined)
+        return { failureClass: null, error: null };
+    const error = failure instanceof Error ? failure.message : failure.description;
+    if (failure instanceof JobInputInvalidError)
+        return { failureClass: 'invalid_input', error };
+    if (failure instanceof JobTimeoutError)
+        return { failureClass: 'timeout', error };
+    return { failureClass: 'handler_error', error };
+}
+export async function recordJobRun(runtime, run) {
+    const { failure, ...rest } = run;
+    const outcome = run.status === 'cancelled' ? { failureClass: 'cancelled', error: null } : classify(failure);
+    const entry = { ...rest, ...outcome };
+    const recorded = await settle(() => runtime
+        .query('storage/record')
+        .withId(JOB_LEDGER_RECORD_ID)
+        .resolve()
+        .then((ledger) => ledger.create(entry)));
+    // Recording never changes the job's outcome: a host without the ledger says so once.
+    if (recorded.ok || unavailableWarned.has(runtime))
+        return;
+    unavailableWarned.add(runtime);
+    getLogger('worker-runtime', runtime).child('job-ledger').warn('Job ledger unavailable on this host; job history is not recorded', {
+        error: valueFreeFailure(recorded.caught)
+    });
+}
+//# sourceMappingURL=record-job-run.js.map

package/dist/runtime/ledger/record-job-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-job-run.js","sourceRoot":"","sources":["../../../src/runtime/ledger/record-job-run.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAuC,MAAM,qBAAqB,CAAC;AAE5F,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAuB,MAAM,mCAAmC,CAAC;AAE9F,MAAM,iBAAiB,GAAG,IAAI,OAAO,EAAU,CAAC;AAOhD,SAAS,QAAQ,CAAC,OAAkC;IACnD,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACtE,MAAM,KAAK,GAAG,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC/E,IAAI,OAAO,YAAY,oBAAoB;QAAE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;IAC7F,IAAI,OAAO,YAAY,eAAe;QAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAClF,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAmB,EAAE,GAAW;IAClE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,CAAC;IACjC,MAAM,OAAO,GACZ,GAAG,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC7F,MAAM,KAAK,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAC5B,GAAG,EAAE,CAAC,OAAO;SACX,KAAK,CAA4D,gBAAgB,CAAC;SAClF,MAAM,CAAC,oBAAoB,CAAC;SAC5B,OAAO,EAAE;SACT,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CACxC,CAAC;IACF,qFAAqF;IACrF,IAAI,QAAQ,CAAC,EAAE,IAAI,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAC1D,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,kEAAkE,EAAE;QACjI,KAAK,EAAE,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC;KACxC,CAAC,CAAC;AACJ,CAAC"}

package/dist/runtime/schedule-registration.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Register the schedules that job descriptors declare.
+ *
+ * WHY THIS EXISTS — the failure it closes.
+ *
+ * Scheduling used to live in `maintenance/default-schedules.ts`: a hand-written
+ * list of four `{ jobType, cronPattern }` pairs, exported, re-exported, and read
+ * by nothing. `schedules.json` in the Vibes home — the file the IPC adapter
+ * persists registered schedules to — did not exist on a workstation that had been running
+ * the stack for months, because no code path ever called `scheduleRepeatable`.
+ * The scheduler started, logged "Worker scheduler started", and polled an empty
+ * set forever.
+ *
+ * The cost was not four idle jobs. `awareness.prune` — a job written expressly
+ * to fix retention that never runs — was never added to that second list, so it
+ * was doubly unscheduled: no `schedule` on its descriptor AND no entry in the
+ * list. Two tables reached 610k and 720k rows, 1.2GB, with 719,597 of 719,834
+ * staged items already processed and nothing draining them.
+ *
+ * A second registry that must be hand-synced with the first will drift, and the
+ * drift is silent — a job that never runs looks exactly like a job with nothing
+ * to do. So the cadence now lives on the descriptor that owns the job, and this
+ * module is the single reader. Declaring a schedule IS registering it.
+ *
+ * IDEMPOTENCE. `scheduleRepeatable` keys stored entries on
+ * `queue:name:pattern`, so re-registering a job whose cron CHANGED would leave
+ * the old entry behind and fire twice. Every registration therefore removes all
+ * entries for `(queue, jobId)` first — the no-repeat form of `removeSchedule` —
+ * and then writes exactly one. Restarting the runtime converges; it never
+ * accumulates.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { RuntimeLogger } from '@vibesdotdev/logging';
+import type { JobAssetDescriptor } from '../schemas/descriptors.ts';
+import type { QueueAdapter } from '../core/queue-adapter.ts';
+/** Per-job schedule switches from the `workers` config manifest, keyed by job id. */
+export type ScheduleSwitches = Record<string, {
+    enabled: boolean;
+}>;
+/**
+ * Is this job's schedule active? The `workers` manifest wins over the
+ * descriptor, so a user can silence one job without editing code. A job that
+ * declares a schedule is on by default: declaring is enough.
+ */
+export declare function scheduleIsEnabled(descriptor: Pick<JobAssetDescriptor, 'id'> & {
+    scheduleEnabled?: boolean;
+}, schedules: ScheduleSwitches): boolean;
+/** A job descriptor that declares a cadence and the queue it runs on. */
+export type SchedulableJobDescriptor = JobAssetDescriptor & {
+    schedule: string;
+    queue: string;
+};
+export declare function selectSchedulableJobs(runtime: VibesRuntime, hardware: 'consumer' | 'cloud', schedules: ScheduleSwitches): SchedulableJobDescriptor[];
+export interface RegisterDeclaredSchedulesInput {
+    runtime: VibesRuntime;
+    hardware: 'consumer' | 'cloud';
+    /** Physical queue name → adapter, for the queues this runtime actually serves. */
+    queues: Map<string, QueueAdapter>;
+    logger: RuntimeLogger;
+    /** Per-job switches from the `workers` config manifest. */
+    schedules: ScheduleSwitches;
+}
+export interface RegisterDeclaredSchedulesResult {
+    registered: string[];
+    /** Declared a schedule but this runtime serves no queue for it. */
+    unserved: string[];
+    failed: string[];
+}
+/**
+ * Write every declared schedule into the adapter's schedule store.
+ *
+ * Never throws: a runtime that cannot register housekeeping must still come up
+ * and serve jobs. Failures are logged individually and returned, so the caller
+ * can report a partial result rather than a silent one.
+ */
+export declare function registerDeclaredSchedules(input: RegisterDeclaredSchedulesInput): Promise<RegisterDeclaredSchedulesResult>;
+//# sourceMappingURL=schedule-registration.d.ts.map

package/dist/runtime/schedule-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-registration.d.ts","sourceRoot":"","sources":["../../src/runtime/schedule-registration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D,qFAAqF;AACrF,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAEpE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,UAAU,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,GAAG;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,EAC1E,SAAS,EAAE,gBAAgB,GACzB,OAAO,CAIT;AAED,yEAAyE;AACzE,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAkChG,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,UAAU,GAAG,OAAO,EAC9B,SAAS,EAAE,gBAAgB,GACzB,wBAAwB,EAAE,CAG5B;AAED,MAAM,WAAW,8BAA8B;IAC9C,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC;IAC/B,kFAAkF;IAClF,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAClC,MAAM,EAAE,aAAa,CAAC;IACtB,2DAA2D;IAC3D,SAAS,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,+BAA+B;IAC/C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC9C,KAAK,EAAE,8BAA8B,GACnC,OAAO,CAAC,+BAA+B,CAAC,CA0F1C"}