@prenta/core 8.9.1 → 8.10.0

package/dist/jobs/prisma-store.js

@@ -1,3 +1,4 @@
+import { withinRows } from './retention.js';
 function asRecord(value) {
     if (value && typeof value === 'object' && !Array.isArray(value)) {
         return value;
@@ -12,9 +13,15 @@ function asProgress(value) {
         ...(typeof record.message === 'string' ? { message: record.message } : {}),
     };
 }
+function asNullableRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : null;
+}
 function asStatus(value) {
-    if (value === 'running' || value === 'succeeded' || value === 'dead')
+    if (value === 'running' || value === 'succeeded' || value === 'dead' || value === 'cancelled') {
         return value;
+    }
     return 'queued';
 }
 function toRecord(row) {
@@ -31,8 +38,94 @@ function toRecord(row) {
         progress: asProgress(row.progress),
         createdAt: row.createdAt,
         updatedAt: row.updatedAt,
+        cancelRequestedAt: row.cancelRequestedAt ?? null,
+        cancelledById: row.cancelledById ?? null,
+        createdById: row.createdById ?? null,
+        title: row.title ?? null,
+        scope: row.scope ?? null,
+        tokensIn: row.tokensIn ?? 0,
+        tokensOut: row.tokensOut ?? 0,
+        explain: row.explain ?? null,
+        summary: row.summary ?? null,
+        // Stored by the worker in the contract shape (worker rule 3).
+        results: asNullableRecord(row.results),
+        finishedAt: row.finishedAt ?? null,
+    };
+}
+const EVENT_KINDS = new Set([
+    'queued',
+    'claimed',
+    'slice_ok',
+    'slice_failed',
+    'yielded',
+    'retry_scheduled',
+    'dead',
+    'cancel_requested',
+    'cancelled',
+    'finished',
+    'stale_lock',
+]);
+function toEvent(row) {
+    if (!EVENT_KINDS.has(row.kind))
+        return null;
+    return {
+        jobId: row.jobId,
+        at: row.at,
+        kind: row.kind,
+        message: row.message,
+        detail: row.detail,
+        durationMs: row.durationMs,
+        tokens: row.tokens,
+    };
+}
+/**
+ * Every column `save` writes. Not the cancel columns: a cancel can land while
+ * the slice runs (see requestCancel). Not createdById: it is written once, on insert.
+ */
+function savedFields(job) {
+    return {
+        type: job.type,
+        payload: job.payload,
+        status: job.status,
+        attempts: job.attempts,
+        maxAttempts: job.maxAttempts,
+        runAt: job.runAt,
+        lockedAt: job.lockedAt,
+        lastError: job.lastError,
+        progress: job.progress,
+        title: job.title ?? null,
+        scope: job.scope ?? null,
+        tokensIn: job.tokensIn ?? 0,
+        tokensOut: job.tokensOut ?? 0,
+        explain: job.explain ?? null,
+        summary: job.summary ?? null,
+        // A JS null clears a nullable Json column on Prisma 7.
+        results: job.results ?? null,
+        finishedAt: job.finishedAt ?? null,
+        updatedAt: job.updatedAt,
     };
 }
+/**
+ * Finished jobs retention may delete: done before `cutoff`, with no change
+ * waiting for review or decided since `cutoff`. Deleting the job would drop
+ * those, and with them the decision's undo.
+ */
+function prunable(cutoff) {
+    return {
+        // Implied by the finish below (a job finishes after it's created). Lets the read use the createdAt index.
+        createdAt: { lt: cutoff },
+        status: { in: ['succeeded', 'dead', 'cancelled'] },
+        OR: [{ finishedAt: { lt: cutoff } }, { finishedAt: null, updatedAt: { lt: cutoff } }],
+        // An approval sets decidedAt before it writes, so this also keeps a job while one is being applied.
+        reviewItems: { none: { OR: [{ status: 'pending' }, { decidedAt: { gte: cutoff } }] } },
+    };
+}
+/** A note's column at `value`, on the status it belongs to. */
+function noteIs(note, value) {
+    return note === 'explain'
+        ? { status: 'dead', explain: value }
+        : { status: 'succeeded', summary: value };
+}
 export class PrismaJobStore {
     db;
     constructor(db) {
@@ -51,6 +144,16 @@ export class PrismaJobStore {
                 lockedAt: job.lockedAt,
                 lastError: job.lastError,
                 progress: job.progress,
+                cancelRequestedAt: job.cancelRequestedAt ?? null,
+                cancelledById: job.cancelledById ?? null,
+                createdById: job.createdById ?? null,
+                title: job.title ?? null,
+                scope: job.scope ?? null,
+                tokensIn: job.tokensIn ?? 0,
+                tokensOut: job.tokensOut ?? 0,
+                explain: job.explain ?? null,
+                summary: job.summary ?? null,
+                finishedAt: job.finishedAt ?? null,
                 createdAt: job.createdAt,
                 updatedAt: job.updatedAt,
             },
@@ -86,28 +189,167 @@ export class PrismaJobStore {
         return rows.map((row) => toRecord(row));
     }
     async save(job) {
-        await this.db.job.update({
-            where: { id: job.id },
+        await this.db.job.update({ where: { id: job.id }, data: savedFields(job) });
+    }
+    async finishCancel(job) {
+        // Without the cancel's time there's nothing to match, and `null` would match
+        // a row that has no cancel at all.
+        if (!job.cancelRequestedAt)
+            return false;
+        const finished = await this.db.job.updateMany({
+            where: {
+                id: job.id,
+                status: { in: ['queued', 'running'] },
+                cancelRequestedAt: job.cancelRequestedAt,
+            },
+            data: savedFields(job),
+        });
+        return finished.count === 1;
+    }
+    async requestCancel(id, at, byId) {
+        const flagged = await this.db.job.updateMany({
+            where: { id, status: { in: ['queued', 'running'] }, cancelRequestedAt: null },
+            data: { cancelRequestedAt: at, cancelledById: byId, updatedAt: at },
+        });
+        return flagged.count === 1;
+    }
+    async findPendingNotes(since, summaryTypes, limit) {
+        const rows = await this.db.job.findMany({
+            where: {
+                finishedAt: { gte: since },
+                OR: [
+                    { status: 'dead', explain: null },
+                    { status: 'succeeded', type: { in: [...summaryTypes] }, summary: null },
+                ],
+            },
+            orderBy: { finishedAt: 'asc' },
+            take: limit,
+        });
+        return rows.map((row) => toRecord(row));
+    }
+    async claimNote(id, note, finishedAt) {
+        const claimed = await this.db.job.updateMany({
+            where: { id, finishedAt, ...noteIs(note, null) },
+            data: { [note]: '' },
+        });
+        return claimed.count === 1;
+    }
+    async writeNote(id, note, finishedAt, text, usage) {
+        if (usage && (usage.tokensIn > 0 || usage.tokensOut > 0)) {
+            await this.db.job.updateMany({
+                where: { id },
+                data: {
+                    tokensIn: { increment: usage.tokensIn },
+                    tokensOut: { increment: usage.tokensOut },
+                },
+            });
+        }
+        if (!text)
+            return false;
+        const written = await this.db.job.updateMany({
+            where: { id, finishedAt, ...noteIs(note, '') },
+            data: { [note]: text },
+        });
+        return written.count === 1;
+    }
+    async retry(id, now) {
+        const retried = await this.db.job.updateMany({
+            where: {
+                id,
+                OR: [{ status: 'dead' }, { status: 'queued', lastError: { not: null } }],
+            },
             data: {
-                type: job.type,
-                payload: job.payload,
-                status: job.status,
-                attempts: job.attempts,
-                maxAttempts: job.maxAttempts,
-                runAt: job.runAt,
-                lockedAt: job.lockedAt,
-                lastError: job.lastError,
-                progress: job.progress,
-                updatedAt: job.updatedAt,
+                status: 'queued',
+                attempts: 0,
+                lastError: null,
+                explain: null,
+                runAt: now,
+                lockedAt: null,
+                finishedAt: null,
+                cancelRequestedAt: null,
+                cancelledById: null,
+                updatedAt: now,
             },
         });
+        return retried.count === 1;
+    }
+    async get(id) {
+        const row = await this.db.job.findUnique({ where: { id } });
+        return row ? toRecord(row) : null;
+    }
+    async findCancelRequested() {
+        const rows = await this.db.job.findMany({
+            where: { status: 'queued', cancelRequestedAt: { not: null } },
+            orderBy: { updatedAt: 'asc' },
+        });
+        return rows.map((row) => toRecord(row));
+    }
+    async pruneFinished(cutoff, limit) {
+        const rows = (await this.db.job.findMany({
+            where: prunable(cutoff),
+            select: { id: true, _count: { select: { events: true, reviewItems: true } } },
+            orderBy: { createdAt: 'asc' },
+            take: limit.jobs,
+        }));
+        const ids = withinRows(rows.map((row) => ({ id: row.id, rows: row._count.events + row._count.reviewItems })), limit.rows);
+        if (ids.length === 0)
+            return 0;
+        // The filter again, so a job retried or reopened for review since the read is kept.
+        // Events and review items go with their job (ON DELETE CASCADE).
+        const deleted = await this.db.job.deleteMany({
+            where: { id: { in: ids }, ...prunable(cutoff) },
+        });
+        return deleted.count;
     }
-    async list(limit) {
+    async list(limit, filter = {}) {
         const rows = await this.db.job.findMany({
-            orderBy: { updatedAt: 'desc' },
+            where: {
+                ...(filter.type ? { type: filter.type } : {}),
+                ...(filter.statuses?.length ? { status: { in: filter.statuses } } : {}),
+            },
+            // createdAt, not updatedAt, so rows don't jump on every poll.
+            orderBy: [{ createdAt: 'desc' }, { id: 'desc' }],
             take: limit,
         });
         return rows.map((row) => toRecord(row));
     }
+    async addEvent(event) {
+        await this.db.jobEvent.create({
+            data: {
+                jobId: event.jobId,
+                at: event.at,
+                kind: event.kind,
+                message: event.message,
+                detail: event.detail ?? null,
+                durationMs: event.durationMs ?? null,
+                tokens: event.tokens ?? null,
+            },
+        });
+    }
+    async listEvents(jobId, limit) {
+        const rows = await this.db.jobEvent.findMany({
+            where: { jobId },
+            // cuid ids grow within a process, so they order events written at the same instant.
+            orderBy: [{ at: 'desc' }, { id: 'desc' }],
+            take: limit,
+        });
+        return rows.map((row) => toEvent(row)).filter((event) => event !== null);
+    }
+    async trimEvents(jobId, keep) {
+        // The newest event past the ones kept, in listEvents order, on the (jobId, at) index.
+        const [edge] = await this.db.jobEvent.findMany({
+            where: { jobId },
+            orderBy: [{ at: 'desc' }, { id: 'desc' }],
+            skip: keep,
+            take: 1,
+            select: { at: true, id: true },
+        });
+        if (!edge)
+            return 0;
+        const trimmed = await this.db.jobEvent.deleteMany({
+            where: { jobId, OR: [{ at: { lt: edge.at } }, { at: edge.at, id: { lte: edge.id } }] },
+        });
+        return trimmed.count;
+    }
 }
 //# sourceMappingURL=prisma-store.js.map

package/dist/jobs/prisma-store.js.map

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

package/dist/jobs/queue.d.ts

@@ -1,11 +1,62 @@
-import type { JobHandler, JobRecord, JobStore, QueueTickResult } from './types.js';
-export declare function enqueueJob(store: JobStore, input: {
+import type { JobHandler, JobRecord, JobStore, JobUsage, QueueTickResult } from './types.js';
+interface EnqueueInput {
     type: string;
     payload?: Record<string, unknown>;
     maxAttempts?: number;
     now?: Date;
+    /** Who asked for it. Leave out for cron. */
+    createdById?: string | null;
+    /** Display title and one-line scope. The serializer derives them when left out. */
+    title?: string | null;
+    scope?: string | null;
+}
+/**
+ * Queue a job. A queued or running job of the same type is returned instead,
+ * unless `dedupe` is false. Batch AI is never deduped.
+ */
+export declare function enqueueJob(store: JobStore, input: EnqueueInput & {
     dedupe?: boolean;
 }): Promise<JobRecord>;
+/**
+ * "Run now" from the Jobs screen. Same rule as cron: a queued or running job of
+ * the type is returned with `reused: true`. Batch AI never reuses one.
+ */
+export declare function runJobNow(store: JobStore, input: {
+    type: string;
+    createdById: string | null;
+    now?: Date;
+}): Promise<{
+    job: JobRecord;
+    reused: boolean;
+}>;
+/**
+ * Put a dead job, or a queued job waiting out a failure, back in the queue now.
+ * Attempts reset and the handler continues from its saved cursor. Returns null
+ * when there is no such job, and `retried: false` with the job as it is when it
+ * can't be retried.
+ */
+export declare function retryJob(store: JobStore, id: string, now: Date): Promise<{
+    job: JobRecord;
+    retried: boolean;
+} | null>;
+/** An AI note's text and the tokens it used. A null text leaves the note empty. */
+export interface NoteText {
+    text: string | null;
+    usage?: JobUsage;
+}
+/**
+ * The AI notes (worker rules 3 and 4, DATA_CONTRACTS §1). The worker writes
+ * them after the job's status, in time it has left, so a slow or missing AI
+ * never delays a transition or holds up other jobs.
+ */
+export interface JobNotes {
+    /** Job types whose success gets a `summary`. */
+    summaryTypes: readonly string[];
+    /** Why a dead job failed. `timeoutMs` bounds the call. */
+    explain(job: JobRecord, timeoutMs: number): Promise<NoteText>;
+    /** A finished scan's summary, from its saved `results`. */
+    summarize(job: JobRecord, timeoutMs: number): Promise<NoteText>;
+}
 export declare function processJobQueue(options: {
     store: JobStore;
     handlers: Record<string, JobHandler>;
@@ -13,5 +64,14 @@ export declare function processJobQueue(options: {
     budgetMs?: number;
     staleLockMs?: number;
     clock?: () => Date;
+    /** Writes the AI notes. Without it, `explain` and `summary` stay null. */
+    notes?: JobNotes;
 }): Promise<QueueTickResult>;
+/**
+ * Queued jobs cancel immediately. Running jobs stop at the next slice. Idempotent.
+ * A job that has already finished is returned unchanged, including one that
+ * finished between the read and the write here.
+ */
+export declare function requestJobCancel(store: JobStore, id: string, byId: string | null, now: Date): Promise<JobRecord | null>;
+export {};
 //# sourceMappingURL=queue.d.ts.map

package/dist/jobs/queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/jobs/queue.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAe,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAiB/F,wBAAsB,UAAU,CAC9B,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE;IACL,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,GAAG,CAAC,EAAE,IAAI,CAAA;IACV,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,GACA,OAAO,CAAC,SAAS,CAAC,CAsBpB;AAkED,wBAAsB,eAAe,CAAC,OAAO,EAAE;IAC7C,KAAK,EAAE,QAAQ,CAAA;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACpC,GAAG,CAAC,EAAE,IAAI,CAAA;IACV,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;CACnB,GAAG,OAAO,CAAC,eAAe,CAAC,CAuD3B"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/jobs/queue.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,UAAU,EAEV,SAAS,EACT,QAAQ,EACR,QAAQ,EAER,eAAe,EAChB,MAAM,YAAY,CAAA;AAkHnB,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,GAAG,CAAC,EAAE,IAAI,CAAA;IACV,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AA+BD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,YAAY,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GACzC,OAAO,CAAC,SAAS,CAAC,CAIpB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,IAAI,CAAA;CAAE,GAC9D,OAAO,CAAC;IAAE,GAAG,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAK9C;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,QAAQ,EACf,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,IAAI,GACR,OAAO,CAAC;IAAE,GAAG,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,CActD;AAED,mFAAmF;AACnF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,KAAK,CAAC,EAAE,QAAQ,CAAA;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,gDAAgD;IAChD,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/B,0DAA0D;IAC1D,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC7D,2DAA2D;IAC3D,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CAChE;AAmLD,wBAAsB,eAAe,CAAC,OAAO,EAAE;IAC7C,KAAK,EAAE,QAAQ,CAAA;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACpC,GAAG,CAAC,EAAE,IAAI,CAAA;IACV,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;IAClB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,QAAQ,CAAA;CACjB,GAAG,OAAO,CAAC,eAAe,CAAC,CA0J3B;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,QAAQ,EACf,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAqB3B"}