@agentsean/scheduler 1.0.0

package/dist/insights.js

@@ -0,0 +1,106 @@
+/** GSC insights for the Search performance screen. Default metric is clicks. */
+const IMPRESSIONS_BUG_BEGIN = "2025-05-13";
+const IMPRESSIONS_BUG_END = "2026-04-27";
+export function impressionsWindowContaminated(dates) {
+    return dates.some((d) => d >= IMPRESSIONS_BUG_BEGIN && d <= IMPRESSIONS_BUG_END);
+}
+export function computeGscInsights(opts) {
+    const now = opts.now ?? new Date();
+    const today = now.toISOString().slice(0, 10);
+    const weekAgo = new Date(now.getTime() - 7 * 86400000).toISOString().slice(0, 10);
+    const twoWeeks = new Date(now.getTime() - 14 * 86400000).toISOString().slice(0, 10);
+    const pageAgg = new Map();
+    for (const row of opts.pages) {
+        if (row.date < weekAgo || row.date > today)
+            continue;
+        const cur = pageAgg.get(row.page) ?? { clicks: 0, position: 0, n: 0 };
+        cur.clicks += row.clicks;
+        if (row.position !== null) {
+            cur.position += row.position;
+            cur.n++;
+        }
+        pageAgg.set(row.page, cur);
+    }
+    const strikingDistance = [...pageAgg.entries()]
+        .map(([page, v]) => ({
+        page,
+        clicks: v.clicks,
+        position: v.n ? v.position / v.n : 0,
+    }))
+        .filter((r) => r.position >= 8 && r.position <= 20)
+        .toSorted((a, b) => b.clicks - a.clicks)
+        .slice(0, 25);
+    const currentClicks = opts.days
+        .filter((d) => d.date > weekAgo && d.date <= today)
+        .reduce((s, d) => s + d.clicks, 0);
+    const previousClicks = opts.days
+        .filter((d) => d.date > twoWeeks && d.date <= weekAgo)
+        .reduce((s, d) => s + d.clicks, 0);
+    const delta = currentClicks - previousClicks;
+    const deltaPct = previousClicks > 0 ? delta / previousClicks : null;
+    const queryAgg = new Map();
+    for (const row of opts.queries) {
+        if (row.date < weekAgo)
+            continue;
+        const cur = queryAgg.get(row.query) ?? { clicks: 0, impressions: 0 };
+        cur.clicks += row.clicks;
+        cur.impressions += row.impressions;
+        queryAgg.set(row.query, cur);
+    }
+    const ctrOutliers = [...queryAgg.entries()]
+        .map(([query, v]) => ({
+        query,
+        clicks: v.clicks,
+        impressions: v.impressions,
+        ctr: v.impressions > 0 ? v.clicks / v.impressions : 0,
+    }))
+        .filter((r) => r.impressions >= 100 && r.ctr < 0.02 && r.clicks < 5)
+        .toSorted((a, b) => b.impressions - a.impressions)
+        .slice(0, 25);
+    const terms = opts.brandTerms.map((t) => t.toLowerCase()).filter(Boolean);
+    let brandClicks = 0;
+    let nonBrandClicks = 0;
+    for (const [query, v] of queryAgg) {
+        const q = query.toLowerCase();
+        if (terms.some((t) => q.includes(t)))
+            brandClicks += v.clicks;
+        else
+            nonBrandClicks += v.clicks;
+    }
+    const total = brandClicks + nonBrandClicks;
+    const dates = [
+        ...opts.days.map((d) => d.date),
+        ...opts.pages.map((p) => p.date),
+        ...opts.queries.map((q) => q.date),
+    ];
+    return {
+        metric: "clicks",
+        impressionsContaminated: impressionsWindowContaminated(dates),
+        strikingDistance,
+        decay: {
+            previousClicks,
+            currentClicks,
+            delta,
+            deltaPct,
+        },
+        cannibalization: [],
+        cannibalizationNote: "Query×page GSC pull is required for cannibalization; weekly query and page totals are stored separately.",
+        ctrOutliers,
+        brand: {
+            brandClicks,
+            nonBrandClicks,
+            brandShare: total > 0 ? brandClicks / total : null,
+        },
+    };
+}
+export function brandTermsFromOrigin(origin) {
+    try {
+        const host = new URL(origin).hostname.replace(/^www\./, "");
+        const head = host.split(".")[0] ?? host;
+        return head.length >= 3 ? [head] : [];
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=insights.js.map

package/dist/insights.js.map

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

package/dist/pg-boss.d.ts

@@ -0,0 +1,27 @@
+import type { JobKind, JobQueue } from "./types.js";
+/**
+ * Duck-typed pg-boss surface. Hosted tier constructs `new PgBoss(DATABASE_URL)`
+ * and passes it here. Local installs never import pg-boss — they use the jobs table.
+ */
+export type PgBossLike = {
+    send(name: string, data: object, options?: {
+        singletonKey?: string;
+        startAfter?: number | Date | string;
+    }): Promise<string | null>;
+    fetch(name: string, batchSize?: number): Promise<Array<{
+        id: string;
+        data: object;
+        retrycount?: number;
+    }> | null>;
+    complete(id: string, data?: object): Promise<void>;
+    fail(id: string, data?: object | Error): Promise<void>;
+    cancel(id: string): Promise<void>;
+};
+/**
+ * pg-boss adapter behind the same JobQueue interface as the SQLite queue.
+ */
+export declare function createPgBossQueue(boss: PgBossLike, options?: {
+    now?: (() => Date) | undefined;
+}): JobQueue;
+export declare function assertJobKind(kind: string): JobKind;
+//# sourceMappingURL=pg-boss.d.ts.map

package/dist/pg-boss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-boss.d.ts","sourceRoot":"","sources":["../src/pg-boss.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,OAAO,EAEP,QAAQ,EAET,MAAM,YAAY,CAAC;AAIpB;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAA;KAAE,GACvE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1B,KAAK,CACH,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5E,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC,CAAC;AASF;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAA;CAAE,GAC3C,QAAQ,CAmIV;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGnD"}

package/dist/pg-boss.js

@@ -0,0 +1,134 @@
+import { JOB_KINDS } from "./types.js";
+import { isJobKind } from "./cadence.js";
+/**
+ * pg-boss adapter behind the same JobQueue interface as the SQLite queue.
+ */
+export function createPgBossQueue(boss, options) {
+    const clock = () => options?.now?.() ?? new Date();
+    const byId = new Map();
+    const stamp = (kind, row, status) => {
+        const data = row.data;
+        const job = {
+            id: row.id,
+            siteId: data.siteId ?? null,
+            kind,
+            status,
+            idempotencyKey: data.idempotencyKey ?? row.id,
+            payload: data.payload ?? {},
+            attempts: row.retrycount ?? 0,
+            runAt: clock().toISOString(),
+            heartbeatAt: clock().toISOString(),
+            error: null,
+            createdAt: data.createdAt ?? clock().toISOString(),
+            completedAt: null,
+        };
+        byId.set(job.id, job);
+        return job;
+    };
+    return {
+        async enqueue(input) {
+            const createdAt = clock().toISOString();
+            const data = {
+                siteId: input.siteId ?? null,
+                idempotencyKey: input.idempotencyKey,
+                payload: input.payload ?? {},
+                createdAt,
+            };
+            const startAfter = input.runAt
+                ? input.runAt instanceof Date
+                    ? input.runAt
+                    : new Date(input.runAt)
+                : undefined;
+            const id = (await boss.send(input.kind, data, {
+                singletonKey: input.idempotencyKey,
+                ...(startAfter ? { startAfter } : {}),
+            })) ?? input.idempotencyKey;
+            const job = {
+                id,
+                siteId: input.siteId ?? null,
+                kind: input.kind,
+                status: "queued",
+                idempotencyKey: input.idempotencyKey,
+                payload: input.payload ?? {},
+                attempts: 0,
+                runAt: startAfter ? startAfter.toISOString() : createdAt,
+                heartbeatAt: null,
+                error: null,
+                createdAt,
+                completedAt: null,
+            };
+            byId.set(id, job);
+            return job;
+        },
+        async claimDue(limit) {
+            const out = [];
+            for (const kind of JOB_KINDS) {
+                if (out.length >= limit)
+                    break;
+                const batch = (await boss.fetch(kind, limit - out.length)) ?? [];
+                for (const row of batch)
+                    out.push(stamp(kind, row, "running"));
+            }
+            return out;
+        },
+        async heartbeat(id) {
+            const job = byId.get(id);
+            if (job)
+                byId.set(id, { ...job, heartbeatAt: clock().toISOString() });
+        },
+        async checkpoint(id, payload) {
+            const job = byId.get(id);
+            if (job) {
+                byId.set(id, {
+                    ...job,
+                    payload: { ...job.payload, ...payload },
+                    heartbeatAt: clock().toISOString(),
+                });
+            }
+        },
+        async complete(id, result) {
+            await boss.complete(id, result ? { result } : undefined);
+            const job = byId.get(id);
+            if (job) {
+                byId.set(id, {
+                    ...job,
+                    status: "completed",
+                    completedAt: clock().toISOString(),
+                });
+            }
+        },
+        async fail(id, error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            await boss.fail(id, err);
+            const job = byId.get(id);
+            if (job)
+                byId.set(id, { ...job, status: "queued", error: err.message });
+        },
+        async recoverStale() {
+            return 0;
+        },
+        async cancel(id) {
+            await boss.cancel(id);
+            const job = byId.get(id);
+            if (job)
+                byId.set(id, { ...job, status: "cancelled" });
+        },
+        async get(id) {
+            return byId.get(id) ?? null;
+        },
+        async list(filter) {
+            let rows = [...byId.values()];
+            if (filter?.siteId)
+                rows = rows.filter((j) => j.siteId === filter.siteId);
+            if (filter?.status)
+                rows = rows.filter((j) => j.status === filter.status);
+            return rows;
+        },
+    };
+}
+export function assertJobKind(kind) {
+    if (!isJobKind(kind))
+        throw new Error(`unknown job kind ${kind}`);
+    return kind;
+}
+//# sourceMappingURL=pg-boss.js.map

package/dist/pg-boss.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,31 @@
+import { type SqliteDatabase } from "@agentsean/db";
+import { type JobHandler, type JobKind, type JobQueue } from "./types.js";
+export type TickResult = {
+    recovered: number;
+    scheduled: number;
+    ran: number;
+    errors: string[];
+};
+export declare function ensureCadences(queue: JobQueue, db: SqliteDatabase, now: Date): Promise<number>;
+export declare function runDue(queue: JobQueue, handlers: Partial<Record<JobKind, JobHandler>>, opts: {
+    halted: boolean;
+    now: Date;
+    limit?: number | undefined;
+}): Promise<{
+    ran: number;
+    errors: string[];
+}>;
+export declare function tick(queue: JobQueue, handlers: Partial<Record<JobKind, JobHandler>>, opts: {
+    db: SqliteDatabase;
+    halted: boolean;
+    now: Date;
+    limit?: number | undefined;
+}): Promise<TickResult>;
+export declare function startLoop(queue: JobQueue, handlers: Partial<Record<JobKind, JobHandler>>, opts: {
+    db: SqliteDatabase;
+    halted: () => boolean;
+    now?: (() => Date) | undefined;
+    intervalMs?: number | undefined;
+    onTick?: ((result: TickResult) => void) | undefined;
+}): () => Promise<void>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAG3D,OAAO,EAAa,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAErF,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,wBAAsB,cAAc,CAClC,KAAK,EAAE,QAAQ,EACf,EAAE,EAAE,cAAc,EAClB,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED,wBAAsB,MAAM,CAC1B,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,EAC9C,IAAI,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC/D,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA6B5C;AAED,wBAAsB,IAAI,CACxB,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,EAC9C,IAAI,EAAE;IAAE,EAAE,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACnF,OAAO,CAAC,UAAU,CAAC,CAKrB;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,EAC9C,IAAI,EAAE;IACJ,EAAE,EAAE,cAAc,CAAC;IACnB,MAAM,EAAE,MAAM,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACrD,GACA,MAAM,OAAO,CAAC,IAAI,CAAC,CAuBrB"}

package/dist/runner.js

@@ -0,0 +1,90 @@
+import { sites } from "@agentsean/db";
+import { rankCadenceForTenant, tenantIdForSite } from "@agentsean/hosted";
+import { CADENCES, DAY_MS, WEEK_MS, idempotencyKey } from "./cadence.js";
+import { JOB_KINDS } from "./types.js";
+export async function ensureCadences(queue, db, now) {
+    const rows = db.select().from(sites).all();
+    let n = 0;
+    for (const site of rows) {
+        const tenantId = tenantIdForSite(db, site.id);
+        const rankMs = tenantId && rankCadenceForTenant(db, tenantId) === "daily" ? DAY_MS : WEEK_MS;
+        for (const kind of JOB_KINDS) {
+            const cadenceMs = kind === "rank_check" ? rankMs : CADENCES[kind].everyMs;
+            const key = idempotencyKey(site.id, kind, now);
+            const job = await queue.enqueue({
+                siteId: site.id,
+                kind,
+                idempotencyKey: key,
+                payload: { origin: site.origin, cadenceMs },
+                runAt: now,
+            });
+            if (job.createdAt && new Date(job.createdAt).getTime() >= now.getTime() - 2000) {
+                n++;
+            }
+        }
+    }
+    return n;
+}
+export async function runDue(queue, handlers, opts) {
+    const claimed = await queue.claimDue(opts.limit ?? 5);
+    const errors = [];
+    for (const job of claimed) {
+        const handler = handlers[job.kind];
+        if (!handler) {
+            await queue.fail(job.id, new Error(`no handler for ${job.kind}`));
+            errors.push(`${job.id}: no handler for ${job.kind}`);
+            continue;
+        }
+        try {
+            const result = await handler(job, {
+                now: opts.now,
+                halted: opts.halted,
+                heartbeat: () => {
+                    void queue.heartbeat(job.id);
+                },
+                checkpoint: (payload) => {
+                    void queue.checkpoint(job.id, payload);
+                },
+            });
+            await queue.complete(job.id, result);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            await queue.fail(job.id, err);
+            errors.push(`${job.id}: ${message}`);
+        }
+    }
+    return { ran: claimed.length, errors };
+}
+export async function tick(queue, handlers, opts) {
+    const recovered = await queue.recoverStale();
+    const scheduled = await ensureCadences(queue, opts.db, opts.now);
+    const { ran, errors } = await runDue(queue, handlers, opts);
+    return { recovered, scheduled, ran, errors };
+}
+export function startLoop(queue, handlers, opts) {
+    let stopped = false;
+    let inflight = Promise.resolve();
+    const intervalMs = opts.intervalMs ?? 15_000;
+    const run = () => {
+        if (stopped)
+            return;
+        inflight = tick(queue, handlers, {
+            db: opts.db,
+            halted: opts.halted(),
+            now: opts.now?.() ?? new Date(),
+        })
+            .then((result) => opts.onTick?.(result))
+            .catch(() => {
+            /* the next interval retries; crash recovery requeues stale work */
+        });
+    };
+    run();
+    const handle = setInterval(run, intervalMs);
+    return async () => {
+        stopped = true;
+        clearInterval(handle);
+        await inflight;
+    };
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/sqlite-queue.d.ts

@@ -0,0 +1,9 @@
+import { type SqliteDatabase } from "@agentsean/db";
+import type { Clock, JobKind, JobQueue, JobStatus } from "./types.js";
+export type SqliteQueueOptions = {
+    now?: Clock | undefined;
+};
+export declare function createSqliteQueue(db: SqliteDatabase, options?: SqliteQueueOptions): JobQueue;
+export declare function parseJobKind(kind: string): JobKind;
+export type { JobStatus };
+//# sourceMappingURL=sqlite-queue.d.ts.map

package/dist/sqlite-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-queue.d.ts","sourceRoot":"","sources":["../src/sqlite-queue.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAG1D,OAAO,KAAK,EACV,KAAK,EAGL,OAAO,EAEP,QAAQ,EACR,SAAS,EACV,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;CACzB,CAAC;AA+BF,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,cAAc,EAClB,OAAO,GAAE,kBAAuB,GAC/B,QAAQ,CA4LV;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGlD;AAED,YAAY,EAAE,SAAS,EAAE,CAAC"}

package/dist/sqlite-queue.js

@@ -0,0 +1,226 @@
+import { randomUUID } from "node:crypto";
+import { and, eq, lte } from "drizzle-orm";
+import { jobs } from "@agentsean/db";
+import { backoffMs, MAX_ATTEMPTS, STALE_HEARTBEAT_MS } from "./backoff.js";
+import { isJobKind } from "./cadence.js";
+function parsePayload(raw) {
+    if (!raw)
+        return {};
+    try {
+        const v = JSON.parse(raw);
+        if (v && typeof v === "object" && !Array.isArray(v))
+            return v;
+    }
+    catch {
+        // ignore
+    }
+    return {};
+}
+function asJob(row) {
+    if (!isJobKind(row.kind))
+        return null;
+    return {
+        id: row.id,
+        siteId: row.siteId,
+        kind: row.kind,
+        status: row.status,
+        idempotencyKey: row.idempotencyKey,
+        payload: parsePayload(row.payload),
+        attempts: row.attempts,
+        runAt: row.runAt,
+        heartbeatAt: row.heartbeatAt,
+        error: row.error,
+        createdAt: row.createdAt,
+        completedAt: row.completedAt,
+    };
+}
+export function createSqliteQueue(db, options = {}) {
+    const now = () => options.now?.() ?? new Date();
+    const nowIso = () => now().toISOString();
+    const getSync = (id) => {
+        const row = db.select().from(jobs).where(eq(jobs.id, id)).get();
+        return row ? asJob(row) : null;
+    };
+    const queue = {
+        async enqueue(input) {
+            const existing = db
+                .select()
+                .from(jobs)
+                .where(eq(jobs.idempotencyKey, input.idempotencyKey))
+                .get();
+            if (existing) {
+                const job = asJob(existing);
+                if (job)
+                    return job;
+            }
+            const id = randomUUID();
+            const createdAt = nowIso();
+            const runAt = input.runAt instanceof Date
+                ? input.runAt.toISOString()
+                : (input.runAt ?? createdAt);
+            try {
+                db.insert(jobs)
+                    .values({
+                    id,
+                    siteId: input.siteId ?? null,
+                    kind: input.kind,
+                    status: "queued",
+                    idempotencyKey: input.idempotencyKey,
+                    payload: JSON.stringify(input.payload ?? {}),
+                    attempts: 0,
+                    runAt,
+                    heartbeatAt: null,
+                    error: null,
+                    createdAt,
+                    completedAt: null,
+                })
+                    .run();
+            }
+            catch {
+                const raced = db
+                    .select()
+                    .from(jobs)
+                    .where(eq(jobs.idempotencyKey, input.idempotencyKey))
+                    .get();
+                if (raced) {
+                    const job = asJob(raced);
+                    if (job)
+                        return job;
+                }
+                throw new Error("failed to enqueue job");
+            }
+            const created = getSync(id);
+            if (!created)
+                throw new Error("failed to load enqueued job");
+            return created;
+        },
+        async claimDue(limit) {
+            const cap = Math.min(Math.max(1, limit), 25);
+            const due = db
+                .select()
+                .from(jobs)
+                .where(and(eq(jobs.status, "queued"), lte(jobs.runAt, nowIso())))
+                .all()
+                .slice(0, cap);
+            const claimed = [];
+            const ts = nowIso();
+            for (const row of due) {
+                db.update(jobs)
+                    .set({
+                    status: "running",
+                    attempts: row.attempts + 1,
+                    heartbeatAt: ts,
+                })
+                    .where(eq(jobs.id, row.id))
+                    .run();
+                const job = getSync(row.id);
+                if (job)
+                    claimed.push(job);
+            }
+            return claimed;
+        },
+        async heartbeat(id) {
+            db.update(jobs).set({ heartbeatAt: nowIso() }).where(eq(jobs.id, id)).run();
+        },
+        async checkpoint(id, payload) {
+            const row = db.select().from(jobs).where(eq(jobs.id, id)).get();
+            const prev = parsePayload(row?.payload ?? null);
+            db.update(jobs)
+                .set({
+                payload: JSON.stringify({ ...prev, ...payload }),
+                heartbeatAt: nowIso(),
+            })
+                .where(eq(jobs.id, id))
+                .run();
+        },
+        async complete(id, result) {
+            const row = db.select().from(jobs).where(eq(jobs.id, id)).get();
+            const prev = parsePayload(row?.payload ?? null);
+            const next = result === undefined ? prev : { ...prev, result };
+            db.update(jobs)
+                .set({
+                status: "completed",
+                completedAt: nowIso(),
+                heartbeatAt: nowIso(),
+                error: null,
+                payload: JSON.stringify(next),
+            })
+                .where(eq(jobs.id, id))
+                .run();
+        },
+        async fail(id, error) {
+            const row = db.select().from(jobs).where(eq(jobs.id, id)).get();
+            const attempts = row?.attempts ?? 1;
+            const message = error instanceof Error ? error.message : String(error);
+            const ts = nowIso();
+            if (attempts >= MAX_ATTEMPTS) {
+                db.update(jobs)
+                    .set({
+                    status: "failed",
+                    error: message,
+                    completedAt: ts,
+                    heartbeatAt: ts,
+                })
+                    .where(eq(jobs.id, id))
+                    .run();
+                return;
+            }
+            const runAt = new Date(now().getTime() + backoffMs(attempts)).toISOString();
+            db.update(jobs)
+                .set({
+                status: "queued",
+                error: message,
+                runAt,
+                heartbeatAt: ts,
+            })
+                .where(eq(jobs.id, id))
+                .run();
+        },
+        async recoverStale() {
+            const cutoff = new Date(now().getTime() - STALE_HEARTBEAT_MS).toISOString();
+            const running = db.select().from(jobs).where(eq(jobs.status, "running")).all();
+            let n = 0;
+            for (const row of running) {
+                if (row.heartbeatAt && row.heartbeatAt >= cutoff)
+                    continue;
+                db.update(jobs)
+                    .set({
+                    status: "queued",
+                    error: "stale_heartbeat",
+                    runAt: nowIso(),
+                })
+                    .where(eq(jobs.id, row.id))
+                    .run();
+                n++;
+            }
+            return n;
+        },
+        async cancel(id) {
+            db.update(jobs)
+                .set({ status: "cancelled", completedAt: nowIso() })
+                .where(eq(jobs.id, id))
+                .run();
+        },
+        async get(id) {
+            return getSync(id);
+        },
+        async list(filter) {
+            let rows = db.select().from(jobs).all();
+            if (filter?.siteId)
+                rows = rows.filter((r) => r.siteId === filter.siteId);
+            if (filter?.status)
+                rows = rows.filter((r) => r.status === filter.status);
+            return rows
+                .map(asJob)
+                .filter((j) => j !== null)
+                .toSorted((a, b) => (a.createdAt < b.createdAt ? 1 : -1));
+        },
+    };
+    return queue;
+}
+export function parseJobKind(kind) {
+    if (!isJobKind(kind))
+        throw new Error(`unknown job kind ${kind}`);
+    return kind;
+}
+//# sourceMappingURL=sqlite-queue.js.map