@prenta/core 8.9.2 → 8.10.0

package/dist/jobs/memory-store.js

@@ -1,6 +1,18 @@
+import { withinRows } from './retention.js';
+const FINISHED = new Set(['succeeded', 'dead', 'cancelled']);
 /** In-process store for the queue tests. Production uses {@link PrismaJobStore}. */
 export class MemoryJobStore {
+    reviewItems;
     jobs = new Map();
+    events = [];
+    /**
+     * @param reviewItems The live `job_review_items` rows (`jobId`, `status`,
+     *   `decidedAt`) of a test that drives review items, so retention keeps a
+     *   job for them like the Prisma store does, and deletes them with it.
+     */
+    constructor(reviewItems = () => []) {
+        this.reviewItems = reviewItems;
+    }
     async insert(job) {
         this.jobs.set(job.id, { ...job, payload: { ...job.payload }, progress: { ...job.progress } });
     }
@@ -31,15 +43,155 @@ export class MemoryJobStore {
             job.lockedAt.getTime() < cutoff.getTime())
             .map((job) => this.clone(job));
     }
+    /** Keeps the stored cancel fields and creator, like {@link PrismaJobStore.save}. */
     async save(job) {
-        this.jobs.set(job.id, { ...job, payload: { ...job.payload }, progress: { ...job.progress } });
+        const stored = this.jobs.get(job.id);
+        this.jobs.set(job.id, {
+            ...job,
+            payload: { ...job.payload },
+            progress: { ...job.progress },
+            cancelRequestedAt: stored?.cancelRequestedAt ?? null,
+            cancelledById: stored?.cancelledById ?? null,
+            createdById: stored?.createdById ?? null,
+        });
+    }
+    async requestCancel(id, at, byId) {
+        const job = this.jobs.get(id);
+        if (!job || job.cancelRequestedAt)
+            return false;
+        if (job.status !== 'queued' && job.status !== 'running')
+            return false;
+        job.cancelRequestedAt = at;
+        job.cancelledById = byId;
+        job.updatedAt = at;
+        return true;
+    }
+    async finishCancel(job) {
+        const stored = this.jobs.get(job.id);
+        if (!stored?.cancelRequestedAt || !job.cancelRequestedAt)
+            return false;
+        if (stored.cancelRequestedAt.getTime() !== job.cancelRequestedAt.getTime())
+            return false;
+        if (stored.status !== 'queued' && stored.status !== 'running')
+            return false;
+        await this.save(job);
+        return true;
+    }
+    async findPendingNotes(since, summaryTypes, limit) {
+        return [...this.jobs.values()]
+            .filter((job) => job.finishedAt && job.finishedAt.getTime() >= since.getTime())
+            .filter((job) => (job.status === 'dead' && job.explain == null) ||
+            (job.status === 'succeeded' && summaryTypes.includes(job.type) && job.summary == null))
+            .sort((a, b) => a.finishedAt.getTime() - b.finishedAt.getTime())
+            .slice(0, limit)
+            .map((job) => this.clone(job));
+    }
+    async claimNote(id, note, finishedAt) {
+        const job = this.sameFinish(id, note, finishedAt);
+        if (!job || job[note] != null)
+            return false;
+        job[note] = '';
+        return true;
+    }
+    async writeNote(id, note, finishedAt, text, usage) {
+        const stored = this.jobs.get(id);
+        if (stored && usage) {
+            stored.tokensIn = (stored.tokensIn ?? 0) + usage.tokensIn;
+            stored.tokensOut = (stored.tokensOut ?? 0) + usage.tokensOut;
+        }
+        const job = this.sameFinish(id, note, finishedAt);
+        if (!text || !job || job[note] !== '')
+            return false;
+        job[note] = text;
+        return true;
     }
-    async list(limit) {
+    async retry(id, now) {
+        const job = this.jobs.get(id);
+        if (!job)
+            return false;
+        if (job.status !== 'dead' && !(job.status === 'queued' && job.lastError !== null))
+            return false;
+        Object.assign(job, {
+            status: 'queued',
+            attempts: 0,
+            lastError: null,
+            explain: null,
+            runAt: now,
+            lockedAt: null,
+            finishedAt: null,
+            cancelRequestedAt: null,
+            cancelledById: null,
+            updatedAt: now,
+        });
+        return true;
+    }
+    async get(id) {
+        const job = this.jobs.get(id);
+        return job ? this.clone(job) : null;
+    }
+    async findCancelRequested() {
+        return [...this.jobs.values()]
+            .filter((job) => job.status === 'queued' && job.cancelRequestedAt)
+            .map((job) => this.clone(job));
+    }
+    async pruneFinished(cutoff, limit) {
+        const before = cutoff.getTime();
+        const items = this.reviewItems();
+        const held = (job) => items.some((item) => item.jobId === job.id &&
+            (item.status === 'pending' ||
+                (item.decidedAt instanceof Date && item.decidedAt.getTime() >= before)));
+        const old = [...this.jobs.values()]
+            .filter((job) => FINISHED.has(job.status) &&
+            job.createdAt.getTime() < before &&
+            (job.finishedAt ?? job.updatedAt).getTime() < before &&
+            !held(job))
+            .sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime())
+            .slice(0, limit.jobs);
+        const rowsOf = (id) => this.events.filter((event) => event.jobId === id).length +
+            items.filter((item) => item.jobId === id).length;
+        const ids = new Set(withinRows(old.map((job) => ({ id: job.id, rows: rowsOf(job.id) })), limit.rows));
+        for (const id of ids)
+            this.jobs.delete(id);
+        this.removeEvents((event) => ids.has(event.jobId));
+        const keptItems = items.filter((item) => !ids.has(String(item.jobId)));
+        items.splice(0, items.length, ...keptItems);
+        return ids.size;
+    }
+    async list(limit, filter = {}) {
         return [...this.jobs.values()]
-            .sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime())
+            .filter((job) => !filter.type || job.type === filter.type)
+            .filter((job) => !filter.statuses?.length || filter.statuses.includes(job.status))
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime())
             .slice(0, limit)
             .map((job) => this.clone(job));
     }
+    async addEvent(event) {
+        this.events.push({ ...event });
+    }
+    async listEvents(jobId, limit) {
+        return this.events
+            .filter((event) => event.jobId === jobId)
+            .reverse()
+            .slice(0, limit)
+            .map((event) => ({ ...event }));
+    }
+    async trimEvents(jobId, keep) {
+        const own = this.events.filter((event) => event.jobId === jobId);
+        const old = new Set(own.slice(0, Math.max(own.length - keep, 0)));
+        this.removeEvents((event) => old.has(event));
+        return old.size;
+    }
+    removeEvents(drop) {
+        const kept = this.events.filter((event) => !drop(event));
+        this.events.splice(0, this.events.length, ...kept);
+    }
+    /** The stored job if it is still the finish a note belongs to. */
+    sameFinish(id, note, finishedAt) {
+        const job = this.jobs.get(id);
+        if (!job || job.status !== (note === 'explain' ? 'dead' : 'succeeded'))
+            return null;
+        return job.finishedAt?.getTime() === finishedAt.getTime() ? job : null;
+    }
     clone(job) {
         return {
             ...job,
@@ -47,6 +199,8 @@ export class MemoryJobStore {
             progress: { ...job.progress },
             runAt: new Date(job.runAt),
             lockedAt: job.lockedAt ? new Date(job.lockedAt) : null,
+            cancelRequestedAt: job.cancelRequestedAt ? new Date(job.cancelRequestedAt) : null,
+            finishedAt: job.finishedAt ? new Date(job.finishedAt) : null,
             createdAt: new Date(job.createdAt),
             updatedAt: new Date(job.updatedAt),
         };

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

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

package/dist/jobs/outcomes.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Worker rules 3 and 4 (DATA_CONTRACTS.md §1): a finished scan's `results`,
+ * read from the database as the scan ends, and the AI notes the worker writes
+ * afterwards: a scan's `summary` and a dead job's `explain`. Every AI call goes
+ * through the governed runtime within the time the queue gives it and is best
+ * effort: a missing feature, a spent cap or a slow provider leaves the note empty.
+ */
+import type { PrentaDB } from '../db/client-types.js';
+import type { DigestSendResult } from '../seo/digest.js';
+import type { ScanResults } from './contract.js';
+import type { JobNotes, NoteText } from './queue.js';
+import type { JobRecord } from './types.js';
+/** The error line without server paths or email addresses. */
+export declare function redactForAi(text: string): string;
+/**
+ * Rule 3 for an SEO scan, after the digest was attempted: the run's score
+ * against the last one, the issues it found, the issues it resolved, the open
+ * issues by kind, and the digest. Undefined when the run can't be read; the
+ * scan itself still succeeded.
+ */
+export declare function seoScanResults(db: PrentaDB, runId: string, digest: DigestSendResult, now: Date): Promise<ScanResults | undefined>;
+/**
+ * Rule 3 for a content health scan, after unseen issues were resolved: the new
+ * and resolved counts and the open issues by kind, as the dashboard counts
+ * them. Content health sends no digest.
+ */
+export declare function contentHealthResults(db: PrentaDB, counts: {
+    found: number;
+    resolved: number;
+}): Promise<ScanResults | undefined>;
+/**
+ * Rule 3's summary of a finished scan, from the `results` saved with its
+ * success and, for SEO, the issues open now. No text for a scan without
+ * results, such as one that found another audit already running.
+ */
+export declare function summarizeScan(db: PrentaDB, job: JobRecord, timeoutMs: number): Promise<NoteText>;
+/**
+ * Rule 4: a plain-language account of why a job died and what to do next.
+ * Built from the one-line error summary, never the stack, so it shows no more
+ * than every caller already sees, with server paths and email addresses taken
+ * out before it goes to the AI provider. No text when AI is unavailable or fails.
+ */
+export declare function explainJobFailure(db: PrentaDB, job: JobRecord, timeoutMs: number): Promise<NoteText>;
+/** The worker's AI notes: `explain` on any dead job, `summary` on finished scans. */
+export declare function createJobNotes(db: PrentaDB): JobNotes;
+//# sourceMappingURL=outcomes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outcomes.d.ts","sourceRoot":"","sources":["../../src/jobs/outcomes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,YAAY,CAAA;AA4CrD,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAoED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE,IAAI,GACR,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CA+BlC;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAmBlC;AAYD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,QAAQ,EACZ,GAAG,EAAE,SAAS,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,QAAQ,CAAC,CAyBnB;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,QAAQ,EACZ,GAAG,EAAE,SAAS,EACd,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,QAAQ,CAAC,CAqBnB;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,GAAG,QAAQ,CAMrD"}

package/dist/jobs/outcomes.js

@@ -0,0 +1,251 @@
+/**
+ * Worker rules 3 and 4 (DATA_CONTRACTS.md §1): a finished scan's `results`,
+ * read from the database as the scan ends, and the AI notes the worker writes
+ * afterwards: a scan's `summary` and a dead job's `explain`. Every AI call goes
+ * through the governed runtime within the time the queue gives it and is best
+ * effort: a missing feature, a spent cap or a slow provider leaves the note empty.
+ */
+import { explainToEditor, seoIssueLine, summarizeIssues } from '../ai/tasks/editor-text.js';
+import { sortIssuesBySeverity } from '../api/routes/seo/handlers/shared.js';
+import { errorSummary } from './error-text.js';
+const TEXT_MAX = 2000;
+/** The Results tab lists this many issue kinds. */
+const CATEGORY_LIMIT = 8;
+const OPEN = { in: ['open', 'recurring'] };
+/** Where each kind of SEO issue gets fixed in the admin. */
+const SEO_CATEGORY_HREFS = {
+    content: '/seo/content',
+    technical: '/seo/technical',
+    redirects: '/seo/redirects',
+    media: '/media',
+    performance: '/seo/technical',
+    schema: '/seo/content',
+    social: '/seo/content',
+    indexing: '/seo/technical',
+};
+/** Content health's issue kinds, labelled as the dashboard labels them. */
+const CONTENT_ISSUES = {
+    MISSING_META_DESCRIPTION: { label: 'Missing meta descriptions', href: '/seo/content' },
+    BROKEN_INTERNAL_LINK: { label: 'Broken internal links', href: '/seo/link-health' },
+    MISSING_ALT_TEXT: { label: 'Missing alt text', href: '/media' },
+    OUTDATED_CONTENT: { label: 'Outdated content (90+ days)', href: '/posts' },
+};
+const JOB_LABELS = {
+    'seo-scan': 'SEO scan',
+    'content-health': 'Content health check',
+    'batch-ai': 'Batch AI changes',
+};
+/** Server file paths and email addresses in an error line, which the AI provider needn't see. */
+const PRIVATE_TEXT = [
+    [/[\w.%+-]+@[\w-]+(?:\.[\w-]+)*\.[a-z]{2,}/gi, '[email]'],
+    [/file:\/\/\S+/gi, '[path]'],
+    [/\b[a-z]:\\[^\s'"`]+/gi, '[path]'],
+    [
+        /(?<![\w.:/])\/(?:srv|var|home|usr|opt|tmp|etc|root|app|mnt|private|proc|workspace|Users)\/[^\s'"`()]+/g,
+        '[path]',
+    ],
+];
+/** The error line without server paths or email addresses. */
+export function redactForAi(text) {
+    return PRIVATE_TEXT.reduce((out, [pattern, label]) => out.replace(pattern, label), text);
+}
+function clip(text) {
+    const trimmed = text.trim();
+    return trimmed.length > TEXT_MAX ? `${trimmed.slice(0, TEXT_MAX - 1)}…` : trimmed;
+}
+function usageOf(out) {
+    return { tokensIn: out.usage.promptTokens, tokensOut: out.usage.completionTokens };
+}
+/** `missing_meta_description` → `Missing meta description`. */
+function humanize(type) {
+    const words = type.replace(/[_-]+/g, ' ').trim().toLowerCase();
+    return words ? words[0].toUpperCase() + words.slice(1) : type;
+}
+function topCategories(categories) {
+    return categories
+        .filter((category) => category.count > 0)
+        .sort((a, b) => b.count - a.count || a.label.localeCompare(b.label))
+        .slice(0, CATEGORY_LIMIT);
+}
+/** The AI summary of a scan, or no text when AI is unavailable or there is nothing to summarize. */
+async function summarize(db, input) {
+    if (input.issueLines.length === 0)
+        return { text: null };
+    try {
+        const out = await summarizeIssues(db, input);
+        if (!out.ok)
+            return { text: null };
+        return { text: clip(out.text) || null, usage: usageOf(out) };
+    }
+    catch {
+        return { text: null };
+    }
+}
+/**
+ * Open SEO issues grouped by kind. A kind whose issues all share a title is
+ * labelled with it; one whose titles vary (they name a page or keyword) gets a
+ * readable form of its type.
+ */
+function seoCategories(groups) {
+    const byType = new Map();
+    for (const group of groups) {
+        const entry = byType.get(group.type) ?? {
+            category: group.category,
+            titles: new Set(),
+            count: 0,
+        };
+        entry.titles.add(group.title);
+        entry.count += group._count._all;
+        byType.set(group.type, entry);
+    }
+    return topCategories([...byType.entries()].map(([type, entry]) => ({
+        key: type,
+        label: entry.titles.size === 1 ? [...entry.titles][0] : humanize(type),
+        count: entry.count,
+        href: SEO_CATEGORY_HREFS[entry.category] ?? '/seo',
+    })));
+}
+/**
+ * Rule 3 for an SEO scan, after the digest was attempted: the run's score
+ * against the last one, the issues it found, the issues it resolved, the open
+ * issues by kind, and the digest. Undefined when the run can't be read; the
+ * scan itself still succeeded.
+ */
+export async function seoScanResults(db, runId, digest, now) {
+    try {
+        const run = await db.seoAuditRun.findFirst({ where: { id: runId } });
+        if (!run)
+            return undefined;
+        const [resolved, groups] = await Promise.all([
+            // The run resolves what it no longer finds, with no person attached.
+            db.seoIssue.count({
+                where: { status: 'resolved', resolvedById: null, resolvedAt: { gte: run.startedAt } },
+            }),
+            db.seoIssue.groupBy({
+                by: ['type', 'category', 'title'],
+                where: { status: OPEN },
+                _count: { _all: true },
+            }),
+        ]);
+        return {
+            ...(typeof run.siteScoreAfter === 'number' ? { score: run.siteScoreAfter } : {}),
+            ...(typeof run.siteScoreBefore === 'number' ? { prevScore: run.siteScoreBefore } : {}),
+            found: run.issuesFound,
+            resolved,
+            categories: seoCategories(groups),
+            digest: digest.sent
+                ? {
+                    sentAt: now.toISOString(),
+                    recipients: Math.max(0, (digest.recipients ?? 0) - (digest.failed ?? 0)),
+                }
+                : null,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Rule 3 for a content health scan, after unseen issues were resolved: the new
+ * and resolved counts and the open issues by kind, as the dashboard counts
+ * them. Content health sends no digest.
+ */
+export async function contentHealthResults(db, counts) {
+    try {
+        const rows = await db.contentIssue.groupBy({ by: ['type'], _sum: { count: true } });
+        return {
+            found: counts.found,
+            resolved: counts.resolved,
+            categories: topCategories(rows.map((row) => ({
+                key: row.type,
+                label: CONTENT_ISSUES[row.type]?.label ?? humanize(row.type),
+                count: row._sum.count ?? 0,
+                href: CONTENT_ISSUES[row.type]?.href ?? '/',
+            }))),
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Open SEO issues as summary lines, most severe first, as `/ai/seo/summarize` lists them. */
+async function openSeoIssueLines(db) {
+    const open = await db.seoIssue.findMany({
+        where: { status: OPEN },
+        orderBy: { lastDetectedAt: 'desc' },
+        take: 40,
+    });
+    return sortIssuesBySeverity(open).slice(0, 25).map(seoIssueLine);
+}
+/**
+ * Rule 3's summary of a finished scan, from the `results` saved with its
+ * success and, for SEO, the issues open now. No text for a scan without
+ * results, such as one that found another audit already running.
+ */
+export async function summarizeScan(db, job, timeoutMs) {
+    const results = job.results;
+    if (!results)
+        return { text: null };
+    try {
+        if (job.type === 'seo-scan') {
+            const score = results.score === undefined
+                ? ''
+                : `Site score ${results.score}${results.prevScore === undefined ? '' : ` (was ${results.prevScore})`}. `;
+            return await summarize(db, {
+                subject: 'SEO',
+                issueLines: await openSeoIssueLines(db),
+                context: `This scan: ${score}${results.found} issues found, ${results.resolved} fixed since the last scan.`,
+                timeoutMs,
+            });
+        }
+        return await summarize(db, {
+            subject: 'content health',
+            issueLines: results.categories.map((category) => `- ${category.label}: ${category.count}`),
+            context: `This scan: ${job.progress.completed} documents scanned, ${results.found} new issues, ${results.resolved} resolved since the last scan.`,
+            timeoutMs,
+        });
+    }
+    catch {
+        return { text: null };
+    }
+}
+/**
+ * Rule 4: a plain-language account of why a job died and what to do next.
+ * Built from the one-line error summary, never the stack, so it shows no more
+ * than every caller already sees, with server paths and email addresses taken
+ * out before it goes to the AI provider. No text when AI is unavailable or fails.
+ */
+export async function explainJobFailure(db, job, timeoutMs) {
+    const error = errorSummary(job.lastError);
+    if (!error)
+        return { text: null };
+    const { completed, total } = job.progress;
+    try {
+        const out = await explainToEditor(db, {
+            subject: 'why this background job failed',
+            ask: 'one concrete next step',
+            facts: [
+                ['Job', JOB_LABELS[job.type] ?? job.type, 100],
+                ['Attempts', `${job.attempts} of ${job.maxAttempts}`, 50],
+                ['Progress', total > 0 ? `${completed} of ${total} done` : 'not started', 100],
+            ],
+            description: redactForAi(error),
+            timeoutMs,
+        });
+        if (!out.ok)
+            return { text: null };
+        return { text: clip(out.text) || null, usage: usageOf(out) };
+    }
+    catch {
+        return { text: null };
+    }
+}
+/** The worker's AI notes: `explain` on any dead job, `summary` on finished scans. */
+export function createJobNotes(db) {
+    return {
+        summaryTypes: ['seo-scan', 'content-health'],
+        explain: (job, timeoutMs) => explainJobFailure(db, job, timeoutMs),
+        summarize: (job, timeoutMs) => summarizeScan(db, job, timeoutMs),
+    };
+}
+//# sourceMappingURL=outcomes.js.map

package/dist/jobs/outcomes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcomes.js","sourceRoot":"","sources":["../../src/jobs/outcomes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAC3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAA;AAI3E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAI9C,MAAM,QAAQ,GAAG,IAAI,CAAA;AACrB,mDAAmD;AACnD,MAAM,cAAc,GAAG,CAAC,CAAA;AACxB,MAAM,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAA;AAE1C,4DAA4D;AAC5D,MAAM,kBAAkB,GAA2B;IACjD,OAAO,EAAE,cAAc;IACvB,SAAS,EAAE,gBAAgB;IAC3B,SAAS,EAAE,gBAAgB;IAC3B,KAAK,EAAE,QAAQ;IACf,WAAW,EAAE,gBAAgB;IAC7B,MAAM,EAAE,cAAc;IACtB,MAAM,EAAE,cAAc;IACtB,QAAQ,EAAE,gBAAgB;CAC3B,CAAA;AAED,2EAA2E;AAC3E,MAAM,cAAc,GAAoD;IACtE,wBAAwB,EAAE,EAAE,KAAK,EAAE,2BAA2B,EAAE,IAAI,EAAE,cAAc,EAAE;IACtF,oBAAoB,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,kBAAkB,EAAE;IAClF,gBAAgB,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC/D,gBAAgB,EAAE,EAAE,KAAK,EAAE,6BAA6B,EAAE,IAAI,EAAE,QAAQ,EAAE;CAC3E,CAAA;AAED,MAAM,UAAU,GAA2B;IACzC,UAAU,EAAE,UAAU;IACtB,gBAAgB,EAAE,sBAAsB;IACxC,UAAU,EAAE,kBAAkB;CAC/B,CAAA;AAED,iGAAiG;AACjG,MAAM,YAAY,GAA4B;IAC5C,CAAC,4CAA4C,EAAE,SAAS,CAAC;IACzD,CAAC,gBAAgB,EAAE,QAAQ,CAAC;IAC5B,CAAC,uBAAuB,EAAE,QAAQ,CAAC;IACnC;QACE,wGAAwG;QACxG,QAAQ;KACT;CACF,CAAA;AAED,8DAA8D;AAC9D,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,IAAI,CAAC,CAAA;AAC1F,CAAC;AAED,SAAS,IAAI,CAAC,IAAY;IACxB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAC3B,OAAO,OAAO,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAA;AACnF,CAAC;AAED,SAAS,OAAO,CAAC,GAAkE;IACjF,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAA;AACpF,CAAC;AAED,+DAA+D;AAC/D,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC9D,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAChE,CAAC;AAED,SAAS,aAAa,CAAC,UAAqC;IAC1D,OAAO,UAAU;SACd,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC;SACxC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;SACnE,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAA;AAC7B,CAAC;AAED,oGAAoG;AACpG,KAAK,UAAU,SAAS,CACtB,EAAY,EACZ,KAAoF;IAEpF,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACxD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;QAC5C,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;QAClC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAA;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACvB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CACpB,MAA0F;IAE1F,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoE,CAAA;IAC1F,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI;YACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,IAAI,GAAG,EAAU;YACzB,KAAK,EAAE,CAAC;SACT,CAAA;QACD,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAC7B,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAA;QAChC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAC/B,CAAC;IACD,OAAO,aAAa,CAClB,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5C,GAAG,EAAE,IAAI;QACT,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QACvE,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,MAAM;KACnD,CAAC,CAAC,CACJ,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAY,EACZ,KAAa,EACb,MAAwB,EACxB,GAAS;IAET,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAA;QACpE,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAA;QAC1B,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC3C,qEAAqE;YACrE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAChB,KAAK,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE;aACtF,CAAC;YACF,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAClB,EAAE,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC;gBACjC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;gBACvB,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;aACvB,CAAC;SACH,CAAC,CAAA;QACF,OAAO;YACL,GAAG,CAAC,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,GAAG,CAAC,OAAO,GAAG,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtF,KAAK,EAAE,GAAG,CAAC,WAAW;YACtB,QAAQ;YACR,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC;YACjC,MAAM,EAAE,MAAM,CAAC,IAAI;gBACjB,CAAC,CAAC;oBACE,MAAM,EAAE,GAAG,CAAC,WAAW,EAAE;oBACzB,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;iBACzE;gBACH,CAAC,CAAC,IAAI;SACT,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,EAAY,EACZ,MAA2C;IAE3C,IAAI,CAAC;QACH,MAAM,IAAI,GACR,MAAM,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAA;QACxE,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,aAAa,CACvB,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACjB,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;gBAC5D,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;gBAC1B,IAAI,EAAE,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,GAAG;aAC5C,CAAC,CAAC,CACJ;SACF,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,8FAA8F;AAC9F,KAAK,UAAU,iBAAiB,CAAC,EAAY;IAC3C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACtC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QACvB,OAAO,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE;QACnC,IAAI,EAAE,EAAE;KACT,CAAC,CAAA;IACF,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,EAAY,EACZ,GAAc,EACd,SAAiB;IAEjB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAA;IAC3B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACnC,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC5B,MAAM,KAAK,GACT,OAAO,CAAC,KAAK,KAAK,SAAS;gBACzB,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,cAAc,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,SAAS,GAAG,IAAI,CAAA;YAC5G,OAAO,MAAM,SAAS,CAAC,EAAE,EAAE;gBACzB,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,MAAM,iBAAiB,CAAC,EAAE,CAAC;gBACvC,OAAO,EAAE,cAAc,KAAK,GAAG,OAAO,CAAC,KAAK,kBAAkB,OAAO,CAAC,QAAQ,6BAA6B;gBAC3G,SAAS;aACV,CAAC,CAAA;QACJ,CAAC;QACD,OAAO,MAAM,SAAS,CAAC,EAAE,EAAE;YACzB,OAAO,EAAE,gBAAgB;YACzB,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC1F,OAAO,EAAE,cAAc,GAAG,CAAC,QAAQ,CAAC,SAAS,uBAAuB,OAAO,CAAC,KAAK,gBAAgB,OAAO,CAAC,QAAQ,gCAAgC;YACjJ,SAAS;SACV,CAAC,CAAA;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACvB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,EAAY,EACZ,GAAc,EACd,SAAiB;IAEjB,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACzC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACjC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,QAAQ,CAAA;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE;YACpC,OAAO,EAAE,gCAAgC;YACzC,GAAG,EAAE,wBAAwB;YAC7B,KAAK,EAAE;gBACL,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC;gBAC9C,CAAC,UAAU,EAAE,GAAG,GAAG,CAAC,QAAQ,OAAO,GAAG,CAAC,WAAW,EAAE,EAAE,EAAE,CAAC;gBACzD,CAAC,UAAU,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,EAAE,GAAG,CAAC;aAC/E;YACD,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC;YAC/B,SAAS;SACV,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;QAClC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAA;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACvB,CAAC;AACH,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,cAAc,CAAC,EAAY;IACzC,OAAO;QACL,YAAY,EAAE,CAAC,UAAU,EAAE,gBAAgB,CAAC;QAC5C,OAAO,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC;QAClE,SAAS,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC;KACjE,CAAA;AACH,CAAC"}

package/dist/jobs/prisma-store.d.ts

@@ -1,5 +1,5 @@
 import type { PrentaDB } from '../db/client-types.js';
-import type { JobRecord, JobStore } from './types.js';
+import type { JobEventRecord, JobListFilter, JobNote, JobRecord, JobStore, JobUsage, PruneLimit } from './types.js';
 export declare class PrismaJobStore implements JobStore {
     private readonly db;
     constructor(db: PrentaDB);
@@ -8,6 +8,18 @@ export declare class PrismaJobStore implements JobStore {
     claimNext(now: Date): Promise<JobRecord | null>;
     findStaleRunning(cutoff: Date): Promise<JobRecord[]>;
     save(job: JobRecord): Promise<void>;
-    list(limit: number): Promise<JobRecord[]>;
+    finishCancel(job: JobRecord): Promise<boolean>;
+    requestCancel(id: string, at: Date, byId: string | null): Promise<boolean>;
+    findPendingNotes(since: Date, summaryTypes: readonly string[], limit: number): Promise<JobRecord[]>;
+    claimNote(id: string, note: JobNote, finishedAt: Date): Promise<boolean>;
+    writeNote(id: string, note: JobNote, finishedAt: Date, text: string, usage?: JobUsage): Promise<boolean>;
+    retry(id: string, now: Date): Promise<boolean>;
+    get(id: string): Promise<JobRecord | null>;
+    findCancelRequested(): Promise<JobRecord[]>;
+    pruneFinished(cutoff: Date, limit: PruneLimit): Promise<number>;
+    list(limit: number, filter?: JobListFilter): Promise<JobRecord[]>;
+    addEvent(event: JobEventRecord): Promise<void>;
+    listEvents(jobId: string, limit: number): Promise<JobEventRecord[]>;
+    trimEvents(jobId: string, keep: number): Promise<number>;
 }
 //# sourceMappingURL=prisma-store.d.ts.map

package/dist/jobs/prisma-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prisma-store.d.ts","sourceRoot":"","sources":["../../src/jobs/prisma-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,EAAe,SAAS,EAAa,QAAQ,EAAE,MAAM,YAAY,CAAA;AAqD7E,qBAAa,cAAe,YAAW,QAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ;IAEnC,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBrC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAQnD,SAAS,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAc/C,gBAAgB,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAQpD,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBnC,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAOhD"}
+{"version":3,"file":"prisma-store.d.ts","sourceRoot":"","sources":["../../src/jobs/prisma-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAErD,OAAO,KAAK,EAEV,cAAc,EACd,aAAa,EACb,OAAO,EAEP,SAAS,EAET,QAAQ,EACR,QAAQ,EACR,UAAU,EACX,MAAM,YAAY,CAAA;AAiLnB,qBAAa,cAAe,YAAW,QAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ;IAEnC,MAAM,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BrC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAQnD,SAAS,CAAC,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAc/C,gBAAgB,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAQpD,IAAI,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAInC,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAe9C,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ1E,gBAAgB,CACpB,KAAK,EAAE,IAAI,EACX,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS,EAAE,CAAC;IAejB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAQxE,SAAS,CACb,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,IAAI,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,QAAQ,GACf,OAAO,CAAC,OAAO,CAAC;IAkBb,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB9C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAK1C,mBAAmB,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAQ3C,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB/D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAarE,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAUnE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAe/D"}