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

package/dist/core/queue-adapter.js

@@ -0,0 +1,332 @@
+/**
+ * Queue Adapter Abstraction
+ *
+ * Core interface for queue implementations contributed by host-composed
+ * adapters. Workers owns the contract and resolves implementations at runtime.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { JobExecutionClaimStateSchema, jobDataSelectorSchema } from "./schemas/index.js";
+import { settle } from "./settle.js";
+import { ADMITTED_BY_METADATA_KEY, ResumeAdmissionSchema } from "./schemas/resume.js";
+/** Post-persistence invalidation; it carries no execution attempt or mutation-order claim. */
+export const JOB_ENQUEUED_EVENT = 'enqueued';
+export const JOB_CHANGED_EVENT = 'owner.changed';
+export { stampRetryPolicy, retryDelayMs, withRetryAvailability, isDueAt } from "./enqueue-metadata.js";
+/** The `listJobs` order: newest `createdAt` first, then `id` descending among jobs created in the same instant. */
+export function compareJobsNewestFirst(a, b) {
+    const byTime = b.createdAt.getTime() - a.createdAt.getTime();
+    if (byTime !== 0)
+        return byTime;
+    return a.id < b.id ? 1 : a.id > b.id ? -1 : 0;
+}
+/** A test of whether a job's data is an object carrying every field of `dataEquals` with exactly that value. */
+export function jobDataSelector(dataEquals) {
+    const selector = jobDataSelectorSchema(dataEquals);
+    return (job) => selector.safeParse(job.data).success;
+}
+/**
+ * One `listJobs` page of jobs held in memory: select by `state` and
+ * `dataEquals`, order newest first, then cut `offset` and `limit`.
+ */
+export function pageJobList(jobs, state, options) {
+    const matches = options?.dataEquals ? jobDataSelector(options.dataEquals) : undefined;
+    const selected = [];
+    for (const job of jobs) {
+        if (state && job.status !== state)
+            continue;
+        if (matches && !matches(job))
+            continue;
+        selected.push(job);
+    }
+    selected.sort(compareJobsNewestFirst);
+    const offset = options?.offset ?? 0;
+    return options?.limit === undefined ? selected.slice(offset) : selected.slice(offset, offset + options.limit);
+}
+/**
+ * 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 function omitJobFields(job, omit) {
+    if (!omit || omit.length === 0)
+        return job;
+    const row = { ...job };
+    for (const field of omit)
+        delete row[field];
+    return row;
+}
+/** Capture once; a later job read cannot grant an old producer new authority. */
+export function jobWriteGuard(job) {
+    if (job.executionClaim.state === 'unknown') {
+        throw new CapabilityError('Job execution retirement is unconfirmed.', 'UNAVAILABLE', {
+            reason: 'job-execution-exit-unconfirmed', retryable: false
+        });
+    }
+    return Object.freeze({
+        generation: job.generation,
+        claimToken: job.executionClaim.state === 'held' ? job.executionClaim.identity.token : null,
+        expectedStatus: job.status
+    });
+}
+export function jobMutationStamp(job) {
+    return Object.freeze({ generation: job.generation, revision: job.revision, status: job.status });
+}
+/** A current-state projection advances only through queue-authored admission/revision order. */
+export function isNewerJobMutationStamp(current, next) {
+    return next.generation > current.generation ||
+        next.generation === current.generation && next.revision > current.revision;
+}
+/** Detach owner fields while preserving in-memory input/result capabilities. */
+export function snapshotJob(job) {
+    return {
+        ...job,
+        metadata: job.metadata && { ...job.metadata },
+        executionClaim: Object.freeze({ ...job.executionClaim }),
+        createdAt: new Date(job.createdAt.getTime()),
+        startedAt: job.startedAt && new Date(job.startedAt.getTime()),
+        completedAt: job.completedAt && new Date(job.completedAt.getTime()),
+        retiredAt: job.retiredAt && new Date(job.retiredAt.getTime())
+    };
+}
+/** Call in the owner's atomic mutation, not before an unrelated awaited write. */
+export function assertJobWriteGuard(job, guard) {
+    const current = job.executionClaim;
+    const token = current.state === 'held' ? current.identity.token : null;
+    if (current.state === 'unknown' || job.generation !== guard.generation ||
+        token !== guard.claimToken || job.status !== guard.expectedStatus) {
+        throw new CapabilityError('The intended job admission or phase is no longer held.', 'CONFLICT', {
+            reason: 'job-write-stale', retryable: false
+        });
+    }
+}
+export function assertJobMutationGuard(job, guard) {
+    assertJobWriteGuard(job, guard);
+    if (job.status === 'completed' || job.status === 'failed' || job.status === 'cancelled' ||
+        (job.executionClaim.state === 'held' && job.status !== 'processing')) {
+        throw new CapabilityError('The producer logical outcome is already terminal.', 'CONFLICT', {
+            reason: 'job-write-after-terminal', retryable: false
+        });
+    }
+}
+export function assertExecutionClaim(job, claim) {
+    const current = job.executionClaim;
+    if (current.state !== 'held' || job.generation !== claim.generation ||
+        current.identity.generation !== claim.generation ||
+        current.identity.token !== claim.token || current.identity.attempt !== claim.attempt ||
+        current.identity.owner !== claim.owner) {
+        throw new CapabilityError('The intended job execution claim is no longer held.', 'CONFLICT', {
+            reason: 'job-execution-claim-stale', retryable: false
+        });
+    }
+    return current.identity;
+}
+/**
+ * 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 function keepsCallerAdmission(job, resume) {
+    if (job.status !== 'failed' && job.status !== 'cancelled')
+        return true;
+    if (!resume)
+        return false;
+    if (job.status === 'cancelled')
+        return !(job.cancellation?.by === 'system' && job.cancellation.source === 'disposal');
+    const admitted = ResumeAdmissionSchema.safeParse(job.metadata?.[ADMITTED_BY_METADATA_KEY]);
+    // Without the admitting attempt on record the failure stands: only a recorded earlier attempt re-runs it.
+    return !admitted.success || admitted.data.parentAttempt >= resume.parentAttempt;
+}
+/** Re-admission cannot retire a producer, even after a logical terminal result. */
+export function assertJobReadmission(job, expectedGeneration, expectedRevision, expectedStatus) {
+    if (job.generation !== expectedGeneration ||
+        (expectedRevision !== undefined && job.revision !== expectedRevision) ||
+        (expectedStatus !== undefined && job.status !== expectedStatus)) {
+        throw new CapabilityError('The intended job admission is no longer current.', 'CONFLICT', {
+            reason: 'job-readmission-stale', retryable: false
+        });
+    }
+    if (job.executionClaim.state !== 'none') {
+        throw new CapabilityError('Job execution retirement is unconfirmed.', 'UNAVAILABLE', {
+            reason: 'job-execution-exit-unconfirmed', retryable: false
+        });
+    }
+}
+export function createJobExecutionClaim(job, owner) {
+    return Object.freeze({
+        token: crypto.randomUUID(), generation: job.generation, attempt: job.attemptsMade + 1, owner
+    });
+}
+export function jobExecutionRecord(job) {
+    const held = job.executionClaim.state === 'held' ? job.executionClaim : undefined;
+    return {
+        generation: job.generation,
+        revision: job.revision,
+        executionState: job.executionClaim.state,
+        claimToken: held?.identity.token ?? null,
+        claimAttempt: held?.identity.attempt ?? null,
+        claimOwner: held?.identity.owner ?? null,
+        claimHeartbeatAt: held?.heartbeatAt ?? null,
+        retiredAt: job.retiredAt ?? null
+    };
+}
+/** The stored column behind each field of a held claim. */
+const HELD_CLAIM_COLUMNS = new Map([
+    ['heartbeatAt', 'claimHeartbeatAt'],
+    ['identity.token', 'claimToken'],
+    ['identity.generation', 'generation'],
+    ['identity.attempt', 'claimAttempt'],
+    ['identity.owner', 'claimOwner']
+]);
+function readExecutionRecord(row) {
+    if (row.executionState == null || row.executionState === 'unknown' ||
+        row.generation == null || row.revision == null) {
+        return { ok: true, claim: Object.freeze({ state: 'unknown' }) };
+    }
+    if (row.executionState === 'none') {
+        const fields = ['claimToken', 'claimAttempt', 'claimOwner', 'claimHeartbeatAt']
+            .filter((field) => row[field] != null);
+        return fields.length > 0
+            ? { ok: false, message: 'Stored job ownership is inconsistent.', fault: { reason: 'job-execution-record-invalid', fields } }
+            : { ok: true, claim: Object.freeze({ state: 'none' }) };
+    }
+    const parsed = JobExecutionClaimStateSchema.safeParse({
+        state: 'held',
+        identity: { token: row.claimToken, generation: row.generation, attempt: row.claimAttempt, owner: row.claimOwner },
+        heartbeatAt: row.claimHeartbeatAt
+    });
+    if (parsed.success)
+        return { ok: true, claim: parsed.data };
+    const fields = [...new Set(parsed.error.issues.map((issue) => {
+            const path = issue.path.join('.');
+            return HELD_CLAIM_COLUMNS.get(path) ?? (path || 'executionState');
+        }))];
+    return {
+        ok: false, message: 'Stored job ownership is invalid.',
+        fault: { reason: 'job-execution-record-invalid', fields }, cause: parsed.error
+    };
+}
+/** Historical absence is unresolved; malformed modern ownership is an error. */
+export function executionClaimFromRecord(row) {
+    const reading = readExecutionRecord(row);
+    if (reading.ok)
+        return reading.claim;
+    throw new CapabilityError(reading.message, 'INTERNAL', {
+        reason: 'job-execution-record-invalid', retryable: false,
+        details: { fields: reading.fault.fields }, cause: reading.cause
+    });
+}
+/**
+ * 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 function restoreExecutionClaim(row) {
+    const reading = readExecutionRecord(row);
+    return reading.ok ? reading.claim : Object.freeze({ state: 'unknown', invalidRecord: reading.fault });
+}
+// Re-export class (classes can stay in implementation files)
+export class BaseQueueAdapter {
+    queueName;
+    get queueId() { return this.queueName; }
+    constructor(queueName) {
+        this.queueName = queueName;
+    }
+    executionOwner;
+    createExecutionClaim(job, options) {
+        return createJobExecutionClaim(job, options?.executionOwner ?? (this.executionOwner ??= crypto.randomUUID()));
+    }
+    generateJobId() {
+        return crypto.randomUUID();
+    }
+    calculateRetryDelay(attempt, backoff) {
+        if (!backoff)
+            return 0;
+        if (backoff.type === 'exponential') {
+            return backoff.delay * Math.pow(2, attempt - 1);
+        }
+        return backoff.delay;
+    }
+}
+/** The admitted attempt owns every issued queue write, including writes its handler does not await. */
+export class JobExecutionOperations {
+    queue;
+    guard;
+    jobId;
+    claim;
+    tail = Promise.resolve();
+    work = new Set();
+    closed = false;
+    failures = null;
+    constructor(queue, job) {
+        this.queue = queue;
+        if (job.executionClaim.state !== 'held')
+            throw new CapabilityError('An execution requires its admitted claim.', 'INTERNAL', {
+                reason: 'job-execution-claim-missing'
+            });
+        this.jobId = job.id;
+        this.claim = job.executionClaim.identity;
+        this.guard = jobWriteGuard(job);
+    }
+    issue(write) {
+        if (this.closed)
+            return Promise.reject(new CapabilityError('The job execution has retired.', 'CONFLICT', {
+                reason: 'job-execution-retired', retryable: false
+            }));
+        const issued = this.tail.then(write);
+        this.tail = settle(() => issued).then((outcome) => {
+            if (!outcome.ok)
+                (this.failures ??= []).push(outcome);
+        });
+        return issued;
+    }
+    /** Keep issued context work alive after a logical deadline abandons its wait. */
+    own(start) {
+        if (this.closed)
+            return Promise.reject(new CapabilityError('The job execution has retired.', 'CONFLICT', {
+                reason: 'job-execution-retired', retryable: false
+            }));
+        const issued = Promise.resolve().then(start);
+        const joined = settle(() => issued).then((outcome) => {
+            if (!outcome.ok)
+                (this.failures ??= []).push(outcome);
+        }).finally(() => { this.work.delete(joined); });
+        this.work.add(joined);
+        return issued;
+    }
+    update(update) {
+        const captured = { ...update, metadata: update.metadata && { ...update.metadata } };
+        return this.issue(() => this.queue.updateJob(this.jobId, captured, this.guard));
+    }
+    emit(event, data, guard = this.guard) {
+        return this.issue(async () => {
+            if (this.queue.broadcastEvent)
+                await this.queue.broadcastEvent(this.jobId, event, guard, data);
+        });
+    }
+    renew() {
+        return this.issue(() => this.queue.renewExecution(this.jobId, this.claim));
+    }
+    async joinWork() {
+        while (this.work.size > 0)
+            await Promise.all(this.work);
+    }
+    /** Closing admission and joining the actual tail does not erase an earlier write failure. */
+    async retire() {
+        do {
+            await this.joinWork();
+        } while (this.work.size > 0);
+        this.closed = true;
+        await this.tail;
+        if (this.failures?.length === 1)
+            throw this.failures[0].thrown;
+        if (this.failures)
+            throw new AggregateError(this.failures.map((failure) => failure.thrown), 'Job execution operations failed.', {
+                cause: this.failures[0].thrown
+            });
+    }
+}
+//# sourceMappingURL=queue-adapter.js.map

package/dist/core/queue-adapter.js.map

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

package/dist/core/queued-invocation.d.ts

@@ -0,0 +1,39 @@
+import * as z from 'zod/v4';
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { JobMetadataRecord } from './schemas/index.ts';
+export declare const QUEUED_INVOCATION_METADATA_KEY = "workers.invocation";
+export declare const QueuedInvocationSchema: z.ZodObject<{
+    actor: z.ZodOptional<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>>;
+    workspace: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        root: z.ZodOptional<z.ZodString>;
+        sessionId: z.ZodOptional<z.ZodString>;
+        target: z.ZodOptional<z.ZodString>;
+        remoteHostId: z.ZodOptional<z.ZodString>;
+        access: z.ZodOptional<z.ZodEnum<{
+            read: "read";
+            write: "write";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** Only the producing runtime supplies invocation authority; caller metadata cannot replace it. */
+export declare function stampQueuedInvocation(runtime: RuntimeRef, metadata: JobMetadataRecord): void;
+//# sourceMappingURL=queued-invocation.d.ts.map

package/dist/core/queued-invocation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queued-invocation.d.ts","sourceRoot":"","sources":["../../src/core/queued-invocation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAA2B,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAG/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,eAAO,MAAM,8BAA8B,uBAAuB,CAAC;AACnE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAGjC,CAAC;AAEH,mGAAmG;AACnG,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAO5F"}

package/dist/core/queued-invocation.js

@@ -0,0 +1,21 @@
+import * as z from 'zod/v4';
+import { captureRuntimeWorkspace } from '@vibesdotdev/kernel';
+import { RuntimeActorSchema, RuntimeInvokeWorkspaceSchema } from '@vibesdotdev/kernel/schemas/scope';
+import { JsonValueFromReaderSchema } from '@vibesdotdev/kernel/schemas/json';
+export const QUEUED_INVOCATION_METADATA_KEY = 'workers.invocation';
+export const QueuedInvocationSchema = z.strictObject({
+    actor: RuntimeActorSchema.optional(),
+    workspace: RuntimeInvokeWorkspaceSchema.optional()
+});
+/** Only the producing runtime supplies invocation authority; caller metadata cannot replace it. */
+export function stampQueuedInvocation(runtime, metadata) {
+    const actor = runtime.scope.actor;
+    const workspace = captureRuntimeWorkspace(runtime);
+    const invocation = {};
+    if (actor)
+        invocation.actor = actor;
+    if (workspace)
+        invocation.workspace = workspace;
+    metadata[QUEUED_INVOCATION_METADATA_KEY] = QueuedInvocationSchema.parse(JsonValueFromReaderSchema.parse(invocation));
+}
+//# sourceMappingURL=queued-invocation.js.map

package/dist/core/queued-invocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queued-invocation.js","sourceRoot":"","sources":["../../src/core/queued-invocation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAmB,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AACrG,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAG7E,MAAM,CAAC,MAAM,8BAA8B,GAAG,oBAAoB,CAAC;AACnE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,YAAY,CAAC;IACpD,KAAK,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IACpC,SAAS,EAAE,4BAA4B,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC;AAEH,mGAAmG;AACnG,MAAM,UAAU,qBAAqB,CAAC,OAAmB,EAAE,QAA2B;IACrF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAClC,MAAM,SAAS,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,UAAU,GAA2C,EAAE,CAAC;IAC9D,IAAI,KAAK;QAAE,UAAU,CAAC,KAAK,GAAG,KAAK,CAAC;IACpC,IAAI,SAAS;QAAE,UAAU,CAAC,SAAS,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,8BAA8B,CAAC,GAAG,sBAAsB,CAAC,KAAK,CAAC,yBAAyB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;AACtH,CAAC"}

package/dist/core/schedule-identity.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Schedule identity, shared by every queue adapter.
+ *
+ * A schedule is identified by its queue, job name, cadence (cron pattern or
+ * interval) and, when the caller scopes it, a `jobId`. Two schedules of the same
+ * job with the same cadence but different `jobId`s are distinct entries, so
+ * removing one leaves the other. A schedule with no `jobId` keeps the unscoped
+ * key, so existing entries and callers are unchanged.
+ */
+import type { RepeatOptions } from './queue-adapter.ts';
+/** The cadence part of a repeat: cron pattern, or interval when no pattern. */
+export declare function repeatCadence(repeat: Pick<RepeatOptions, 'pattern' | 'cron' | 'every'>): string | number | undefined;
+/** The stored key of a schedule: `queue:name:cadence`, plus `:jobId` when scoped. */
+export declare function scheduleKey(queueName: string, name: string, repeat: RepeatOptions): string;
+/** The part of a stored schedule removal needs. */
+export interface RemovableSchedule {
+    id: string;
+    jobName: string;
+    jobId?: string;
+}
+/**
+ * The stored schedules `removeSchedule(name, repeat)` deletes:
+ * - no `repeat`: every schedule of `name` (converge after a cadence change);
+ * - `repeat` with a cadence: exactly the schedule with that key (jobId-scoped when
+ *   `repeat.jobId` is set);
+ * - `repeat` with only a `jobId`: every schedule of `name` scoped to that `jobId`.
+ */
+export declare function schedulesToRemove<T extends RemovableSchedule>(schedules: readonly T[], queueName: string, name: string, repeat?: RepeatOptions): T[];
+//# sourceMappingURL=schedule-identity.d.ts.map

package/dist/core/schedule-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-identity.d.ts","sourceRoot":"","sources":["../../src/core/schedule-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpH;AAED,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAG1F;AAED,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,iBAAiB,EAC5D,SAAS,EAAE,SAAS,CAAC,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,aAAa,GACpB,CAAC,EAAE,CAQL"}

package/dist/core/schedule-identity.js

@@ -0,0 +1,37 @@
+/**
+ * Schedule identity, shared by every queue adapter.
+ *
+ * A schedule is identified by its queue, job name, cadence (cron pattern or
+ * interval) and, when the caller scopes it, a `jobId`. Two schedules of the same
+ * job with the same cadence but different `jobId`s are distinct entries, so
+ * removing one leaves the other. A schedule with no `jobId` keeps the unscoped
+ * key, so existing entries and callers are unchanged.
+ */
+/** The cadence part of a repeat: cron pattern, or interval when no pattern. */
+export function repeatCadence(repeat) {
+    return repeat.pattern || repeat.cron || repeat.every;
+}
+/** The stored key of a schedule: `queue:name:cadence`, plus `:jobId` when scoped. */
+export function scheduleKey(queueName, name, repeat) {
+    const base = `${queueName}:${name}:${repeatCadence(repeat)}`;
+    return repeat.jobId ? `${base}:${repeat.jobId}` : base;
+}
+/**
+ * The stored schedules `removeSchedule(name, repeat)` deletes:
+ * - no `repeat`: every schedule of `name` (converge after a cadence change);
+ * - `repeat` with a cadence: exactly the schedule with that key (jobId-scoped when
+ *   `repeat.jobId` is set);
+ * - `repeat` with only a `jobId`: every schedule of `name` scoped to that `jobId`.
+ */
+export function schedulesToRemove(schedules, queueName, name, repeat) {
+    if (!repeat)
+        return schedules.filter((s) => s.jobName === name);
+    if (repeatCadence(repeat) === undefined) {
+        if (!repeat.jobId)
+            return schedules.filter((s) => s.jobName === name);
+        return schedules.filter((s) => s.jobName === name && s.jobId === repeat.jobId);
+    }
+    const key = scheduleKey(queueName, name, repeat);
+    return schedules.filter((s) => s.id === key);
+}
+//# sourceMappingURL=schedule-identity.js.map

package/dist/core/schedule-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-identity.js","sourceRoot":"","sources":["../../src/core/schedule-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,+EAA+E;AAC/E,MAAM,UAAU,aAAa,CAAC,MAAyD;IACtF,OAAO,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC;AACtD,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,IAAY,EAAE,MAAqB;IACjF,MAAM,IAAI,GAAG,GAAG,SAAS,IAAI,IAAI,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;IAC7D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACxD,CAAC;AASD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAChC,SAAuB,EACvB,SAAiB,EACjB,IAAY,EACZ,MAAsB;IAEtB,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;IAChE,IAAI,aAAa,CAAC,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;QACtE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,GAAG,GAAG,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACjD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC;AAC9C,CAAC"}

package/dist/core/schedule-manager.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Base Schedule Manager
+ *
+ * Abstract base class for managing schedules from any source (DB, config, etc.)
+ * and synchronizing them with the queue adapter's scheduling system. Subclasses
+ * provide a `resolveQueue()` factory that returns the `QueueAdapter` to use —
+ * typically via `WorkersClient.getQueue(name)`, which owns adapter selection,
+ * PM autostart, and socket resolution.
+ */
+import type { QueueAdapter } from './queue-adapter.ts';
+import type { ScheduleConfig } from './schemas/index.ts';
+import { type RuntimeLogger } from '@vibesdotdev/logging';
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+export type { ScheduleConfig } from './schemas/index.ts';
+export declare abstract class BaseScheduleManager<TSource extends object, TJobData extends object> {
+    protected runtime: RuntimeRef;
+    protected managerName: string;
+    protected logger: RuntimeLogger;
+    private activeSchedules;
+    private queuePromise;
+    constructor(runtime: RuntimeRef, managerName: string);
+    /**
+     * Subclasses provide the queue adapter. Called once per manager
+     * lifetime; result is cached. The queue is expected to be connected
+     * by the time it's returned (which `WorkersClient.getQueue` guarantees).
+     */
+    protected abstract resolveQueue(): Promise<QueueAdapter<TJobData, object>>;
+    protected abstract loadSchedulesFromSource(): Promise<TSource[]>;
+    protected abstract mapSourceToConfig(source: TSource): ScheduleConfig<TJobData>;
+    protected onScheduleExecuted?(scheduleId: string, timestamp: Date): Promise<void>;
+    protected getQueue(): Promise<QueueAdapter<TJobData, object>>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    addSchedule(config: ScheduleConfig<TJobData>): Promise<void>;
+    removeSchedule(scheduleId: string): Promise<void>;
+    updateSchedule(scheduleId: string, newConfig: ScheduleConfig<TJobData>): Promise<void>;
+    reload(): Promise<void>;
+    getActiveCount(): number;
+    getActiveScheduleIds(): string[];
+    isScheduleActive(scheduleId: string): boolean;
+}
+//# sourceMappingURL=schedule-manager.d.ts.map

package/dist/core/schedule-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-manager.d.ts","sourceRoot":"","sources":["../../src/core/schedule-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,8BAAsB,mBAAmB,CAAC,OAAO,SAAS,MAAM,EAAE,QAAQ,SAAS,MAAM;IAK5E,SAAS,CAAC,OAAO,EAAE,UAAU;IAAE,SAAS,CAAC,WAAW,EAAE,MAAM;IAJxE,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC;IAChC,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,YAAY,CAAwD;gBAEtD,OAAO,EAAE,UAAU,EAAY,WAAW,EAAE,MAAM;IAMxE;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE1E,SAAS,CAAC,QAAQ,CAAC,uBAAuB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAChE,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC;cAC/D,kBAAkB,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;cAEvE,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAU7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAe5D,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjD,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtF,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B,cAAc,IAAI,MAAM;IAIxB,oBAAoB,IAAI,MAAM,EAAE;IAIhC,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;CAG7C"}