@studious-lms/server 1.5.0 → 1.6.0

package/dist/workers/processors/aiLabChat.js

@@ -0,0 +1,52 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="cb84c0dd-1443-5364-811e-02e333b3e8c2")}catch(e){}}();
+import { generateAndSendLabIntroduction, generateAndSendLabResponse, } from '../../pipelines/aiLabChat.js';
+import { prisma } from '../../lib/prisma.js';
+import { isAIUser } from '../../utils/aiUser.js';
+import { createRunJobWorker } from './createRunJobWorker.js';
+export const aiLabChatWorker = createRunJobWorker({
+    type: 'AI_LAB_CHAT',
+    workerOptions: {
+        // Lab responses can produce PDFs and large schemas; cap concurrency to
+        // keep memory under control and to honour upstream model rate limits.
+        concurrency: 1,
+        limiter: { max: 5, duration: 60000 },
+    },
+    run: async ({ conversationId, aiMessageId }) => {
+        const labChat = await prisma.labChat.findFirst({
+            where: { conversationId },
+            select: {
+                id: true,
+                classId: true,
+                context: true,
+                class: { select: { subject: true } },
+            },
+        });
+        if (!labChat) {
+            throw new Error(`LabChat for conversationId=${conversationId} not found`);
+        }
+        // The AI message is a placeholder we created before enqueue; the
+        // pipeline fills it in. Look up the most recent non-AI message in the
+        // conversation to feed the response generator. If none exists, this is
+        // the introductory message at the top of a brand-new lab chat.
+        const triggeringMessage = await prisma.message.findFirst({
+            where: {
+                conversationId,
+                senderId: { not: 'AI_ASSISTANT' },
+            },
+            orderBy: { createdAt: 'desc' },
+            select: { id: true, content: true, senderId: true },
+        });
+        if (!triggeringMessage || isAIUser(triggeringMessage.senderId)) {
+            await generateAndSendLabIntroduction(labChat.id, conversationId, labChat.context, labChat.class?.subject || 'Lab', aiMessageId);
+            return { labChatId: labChat.id, kind: 'introduction', aiMessageId };
+        }
+        await generateAndSendLabResponse(labChat.id, triggeringMessage.content, {
+            classId: labChat.classId,
+            aiMessageId,
+        });
+        return { labChatId: labChat.id, aiMessageId };
+    },
+});
+//# sourceMappingURL=aiLabChat.js.map
+//# debugId=cb84c0dd-1443-5364-811e-02e333b3e8c2

package/dist/workers/processors/aiLabChat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiLabChat.js","sources":["workers/processors/aiLabChat.ts"],"sourceRoot":"/","sourcesContent":["import {\n  generateAndSendLabIntroduction,\n  generateAndSendLabResponse,\n} from '../../pipelines/aiLabChat.js';\nimport { prisma } from '../../lib/prisma.js';\nimport { isAIUser } from '../../utils/aiUser.js';\nimport { createRunJobWorker } from './createRunJobWorker.js';\n\nexport const aiLabChatWorker = createRunJobWorker({\n  type: 'AI_LAB_CHAT',\n  workerOptions: {\n    // Lab responses can produce PDFs and large schemas; cap concurrency to\n    // keep memory under control and to honour upstream model rate limits.\n    concurrency: 1,\n    limiter: { max: 5, duration: 60_000 },\n  },\n  run: async ({ conversationId, aiMessageId }) => {\n    const labChat = await prisma.labChat.findFirst({\n      where: { conversationId },\n      select: {\n        id: true,\n        classId: true,\n        context: true,\n        class: { select: { subject: true } },\n      },\n    });\n\n    if (!labChat) {\n      throw new Error(\n        `LabChat for conversationId=${conversationId} not found`,\n      );\n    }\n\n    // The AI message is a placeholder we created before enqueue; the\n    // pipeline fills it in. Look up the most recent non-AI message in the\n    // conversation to feed the response generator. If none exists, this is\n    // the introductory message at the top of a brand-new lab chat.\n    const triggeringMessage = await prisma.message.findFirst({\n      where: {\n        conversationId,\n        senderId: { not: 'AI_ASSISTANT' },\n      },\n      orderBy: { createdAt: 'desc' },\n      select: { id: true, content: true, senderId: true },\n    });\n\n    if (!triggeringMessage || isAIUser(triggeringMessage.senderId)) {\n      await generateAndSendLabIntroduction(\n        labChat.id,\n        conversationId,\n        labChat.context,\n        labChat.class?.subject || 'Lab',\n        aiMessageId,\n      );\n      return { labChatId: labChat.id, kind: 'introduction', aiMessageId };\n    }\n\n    await generateAndSendLabResponse(labChat.id, triggeringMessage.content, {\n      classId: labChat.classId,\n      aiMessageId,\n    });\n\n    return { labChatId: labChat.id, aiMessageId };\n  },\n});\n"],"names":[],"mappings":";;AAAA,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAC;IAChD,IAAI,EAAE,aAAa;IACnB,aAAa,EAAE;QACb,uEAAuE;QACvE,sEAAsE;QACtE,WAAW,EAAE,CAAC;QACd,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAM,EAAE;KACtC;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,EAAE,EAAE;QAC7C,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;YAC7C,KAAK,EAAE,EAAE,cAAc,EAAE;YACzB,MAAM,EAAE;gBACN,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;aACrC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,8BAA8B,cAAc,YAAY,CACzD,CAAC;QACJ,CAAC;QAED,iEAAiE;QACjE,sEAAsE;QACtE,uEAAuE;QACvE,+DAA+D;QAC/D,MAAM,iBAAiB,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;YACvD,KAAK,EAAE;gBACL,cAAc;gBACd,QAAQ,EAAE,EAAE,GAAG,EAAE,cAAc,EAAE;aAClC;YACD,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;YAC9B,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;SACpD,CAAC,CAAC;QAEH,IAAI,CAAC,iBAAiB,IAAI,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/D,MAAM,8BAA8B,CAClC,OAAO,CAAC,EAAE,EACV,cAAc,EACd,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,KAAK,EAAE,OAAO,IAAI,KAAK,EAC/B,WAAW,CACZ,CAAC;YACF,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;QACtE,CAAC;QAED,MAAM,0BAA0B,CAAC,OAAO,CAAC,EAAE,EAAE,iBAAiB,CAAC,OAAO,EAAE;YACtE,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,WAAW;SACZ,CAAC,CAAC;QAEH,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,WAAW,EAAE,CAAC;IAChD,CAAC;CACF,CAAC,CAAC","debug_id":"cb84c0dd-1443-5364-811e-02e333b3e8c2"}

package/dist/workers/processors/aiNewtonChat.d.ts

@@ -0,0 +1,7 @@
+export declare const aiNewtonChatWorker: import("bullmq").Worker<{
+    conversationId: string;
+    aiMessageId: string;
+} & {
+    runJobId: string;
+}, any, string>;
+//# sourceMappingURL=aiNewtonChat.d.ts.map

package/dist/workers/processors/aiNewtonChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiNewtonChat.d.ts","sourceRoot":"/","sources":["workers/processors/aiNewtonChat.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,kBAAkB;;;;;eAkE7B,CAAC"}

package/dist/workers/processors/aiNewtonChat.js

@@ -0,0 +1,57 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="e55f6275-3148-5423-9eae-9460ac8c1ece")}catch(e){}}();
+import { generateAndSendNewtonIntroduction, generateAndSendNewtonResponse, } from '../../pipelines/aiNewtonChat.js';
+import { prisma } from '../../lib/prisma.js';
+import { isAIUser } from '../../utils/aiUser.js';
+import { createRunJobWorker } from './createRunJobWorker.js';
+export const aiNewtonChatWorker = createRunJobWorker({
+    type: 'AI_NEWTON_CHAT',
+    workerOptions: {
+        concurrency: 2,
+        limiter: { max: 10, duration: 60000 },
+    },
+    run: async ({ conversationId, aiMessageId }) => {
+        const newtonChat = await prisma.newtonChat.findFirst({
+            where: { conversationId },
+            select: {
+                id: true,
+                submission: {
+                    select: {
+                        id: true,
+                        assignment: {
+                            select: {
+                                id: true,
+                                title: true,
+                                instructions: true,
+                                class: { select: { subject: true } },
+                            },
+                        },
+                    },
+                },
+            },
+        });
+        if (!newtonChat) {
+            throw new Error(`NewtonChat for conversationId=${conversationId} not found`);
+        }
+        // Resolve the triggering student message (if any). On a brand-new
+        // tutor session there are no student messages yet, so we run the
+        // introduction path; otherwise we run the response path against the
+        // most recent non-AI message.
+        const triggeringMessage = await prisma.message.findFirst({
+            where: {
+                conversationId,
+                senderId: { not: 'AI_ASSISTANT' },
+            },
+            orderBy: { createdAt: 'desc' },
+            select: { id: true, content: true, senderId: true },
+        });
+        if (!triggeringMessage || isAIUser(triggeringMessage.senderId)) {
+            await generateAndSendNewtonIntroduction(newtonChat.id, conversationId, newtonChat.submission.id, aiMessageId);
+            return { newtonChatId: newtonChat.id, kind: 'introduction', aiMessageId };
+        }
+        await generateAndSendNewtonResponse(newtonChat.id, triggeringMessage.content, conversationId, newtonChat.submission, aiMessageId);
+        return { newtonChatId: newtonChat.id, aiMessageId };
+    },
+});
+//# sourceMappingURL=aiNewtonChat.js.map
+//# debugId=e55f6275-3148-5423-9eae-9460ac8c1ece

package/dist/workers/processors/aiNewtonChat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiNewtonChat.js","sources":["workers/processors/aiNewtonChat.ts"],"sourceRoot":"/","sourcesContent":["import {\n  generateAndSendNewtonIntroduction,\n  generateAndSendNewtonResponse,\n} from '../../pipelines/aiNewtonChat.js';\nimport { prisma } from '../../lib/prisma.js';\nimport { isAIUser } from '../../utils/aiUser.js';\nimport { createRunJobWorker } from './createRunJobWorker.js';\n\nexport const aiNewtonChatWorker = createRunJobWorker({\n  type: 'AI_NEWTON_CHAT',\n  workerOptions: {\n    concurrency: 2,\n    limiter: { max: 10, duration: 60_000 },\n  },\n  run: async ({ conversationId, aiMessageId }) => {\n    const newtonChat = await prisma.newtonChat.findFirst({\n      where: { conversationId },\n      select: {\n        id: true,\n        submission: {\n          select: {\n            id: true,\n            assignment: {\n              select: {\n                id: true,\n                title: true,\n                instructions: true,\n                class: { select: { subject: true } },\n              },\n            },\n          },\n        },\n      },\n    });\n\n    if (!newtonChat) {\n      throw new Error(\n        `NewtonChat for conversationId=${conversationId} not found`,\n      );\n    }\n\n    // Resolve the triggering student message (if any). On a brand-new\n    // tutor session there are no student messages yet, so we run the\n    // introduction path; otherwise we run the response path against the\n    // most recent non-AI message.\n    const triggeringMessage = await prisma.message.findFirst({\n      where: {\n        conversationId,\n        senderId: { not: 'AI_ASSISTANT' },\n      },\n      orderBy: { createdAt: 'desc' },\n      select: { id: true, content: true, senderId: true },\n    });\n\n    if (!triggeringMessage || isAIUser(triggeringMessage.senderId)) {\n      await generateAndSendNewtonIntroduction(\n        newtonChat.id,\n        conversationId,\n        newtonChat.submission.id,\n        aiMessageId,\n      );\n      return { newtonChatId: newtonChat.id, kind: 'introduction', aiMessageId };\n    }\n\n    await generateAndSendNewtonResponse(\n      newtonChat.id,\n      triggeringMessage.content,\n      conversationId,\n      newtonChat.submission,\n      aiMessageId,\n    );\n\n    return { newtonChatId: newtonChat.id, aiMessageId };\n  },\n});\n"],"names":[],"mappings":";;AAAA,OAAO,EACL,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;IACnD,IAAI,EAAE,gBAAgB;IACtB,aAAa,EAAE;QACb,WAAW,EAAE,CAAC;QACd,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAM,EAAE;KACvC;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,EAAE,EAAE;QAC7C,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC;YACnD,KAAK,EAAE,EAAE,cAAc,EAAE;YACzB,MAAM,EAAE;gBACN,EAAE,EAAE,IAAI;gBACR,UAAU,EAAE;oBACV,MAAM,EAAE;wBACN,EAAE,EAAE,IAAI;wBACR,UAAU,EAAE;4BACV,MAAM,EAAE;gCACN,EAAE,EAAE,IAAI;gCACR,KAAK,EAAE,IAAI;gCACX,YAAY,EAAE,IAAI;gCAClB,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;6BACrC;yBACF;qBACF;iBACF;aACF;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,iCAAiC,cAAc,YAAY,CAC5D,CAAC;QACJ,CAAC;QAED,kEAAkE;QAClE,iEAAiE;QACjE,oEAAoE;QACpE,8BAA8B;QAC9B,MAAM,iBAAiB,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;YACvD,KAAK,EAAE;gBACL,cAAc;gBACd,QAAQ,EAAE,EAAE,GAAG,EAAE,cAAc,EAAE;aAClC;YACD,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;YAC9B,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;SACpD,CAAC,CAAC;QAEH,IAAI,CAAC,iBAAiB,IAAI,QAAQ,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/D,MAAM,iCAAiC,CACrC,UAAU,CAAC,EAAE,EACb,cAAc,EACd,UAAU,CAAC,UAAU,CAAC,EAAE,EACxB,WAAW,CACZ,CAAC;YACF,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;QAC5E,CAAC;QAED,MAAM,6BAA6B,CACjC,UAAU,CAAC,EAAE,EACb,iBAAiB,CAAC,OAAO,EACzB,cAAc,EACd,UAAU,CAAC,UAAU,EACrB,WAAW,CACZ,CAAC;QAEF,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,EAAE,WAAW,EAAE,CAAC;IACtD,CAAC;CACF,CAAC,CAAC","debug_id":"e55f6275-3148-5423-9eae-9460ac8c1ece"}

package/dist/workers/processors/createRunJobWorker.d.ts

@@ -0,0 +1,46 @@
+/**
+ * `createRunJobWorker` — shared factory for every BullMQ processor in this app.
+ *
+ * Wraps the boilerplate that every RunJob-backed worker needs:
+ *   - Idempotent skip if the RunJob already SUCCEEDED (recovery after a crash
+ *     that lost the BullMQ ack).
+ *   - Status transitions: PENDING/RUNNING → RUNNING (with attempts++) → SUCCEEDED.
+ *   - Failure handling: record latest error every attempt, flip to FAILED only
+ *     on the final retry.
+ *   - Standardised structured logging on `error` / `failed` / `completed`.
+ *
+ * A processor implementation only has to provide its `RunJobType`, optional
+ * BullMQ options (concurrency, limiter, etc.), and a `run` callback that does
+ * the actual work. The callback receives the typed `JobInputs[type]` payload
+ * and a context object with `runJobId`, `bullJobId`, `attempt`, plus the
+ * `userId` / `classId` from the original `enqueueRunJob` call.
+ */
+import { Worker, type WorkerOptions } from 'bullmq';
+import { Prisma, type RunJobType } from '@prisma/client';
+import { type JobInputs } from '../queues.js';
+export interface RunJobContext {
+    runJobId: string;
+    bullJobId: string | undefined;
+    /** 1-indexed attempt number of the current run. */
+    attempt: number;
+    /** From `EnqueueOptions.userId` on the producer side. */
+    userId: string | null;
+    /** From `EnqueueOptions.classId` on the producer side. */
+    classId: string | null;
+}
+export interface CreateRunJobWorkerOptions<T extends RunJobType> {
+    type: T;
+    /** BullMQ `WorkerOptions` minus `connection`, which is supplied by the helper. */
+    workerOptions?: Omit<WorkerOptions, 'connection'>;
+    /**
+     * The actual work. Return any JSON-serialisable value (or `null`) — it gets
+     * persisted to `RunJob.result` for the client to read back.
+     */
+    run: (input: JobInputs[T], ctx: RunJobContext) => Promise<Prisma.InputJsonValue | null>;
+}
+type WorkerData<T extends RunJobType> = JobInputs[T] & {
+    runJobId: string;
+};
+export declare function createRunJobWorker<T extends RunJobType>({ type, workerOptions, run, }: CreateRunJobWorkerOptions<T>): Worker<WorkerData<T>>;
+export {};
+//# sourceMappingURL=createRunJobWorker.d.ts.map

package/dist/workers/processors/createRunJobWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRunJobWorker.d.ts","sourceRoot":"/","sources":["workers/processors/createRunJobWorker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,MAAM,EAAY,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAIzD,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC,SAAS,UAAU;IAC7D,IAAI,EAAE,CAAC,CAAC;IACR,kFAAkF;IAClF,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAClD;;;OAGG;IACH,GAAG,EAAE,CACH,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CAC5C;AAED,KAAK,UAAU,CAAC,CAAC,SAAS,UAAU,IAAI,SAAS,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,UAAU,EAAE,EACvD,IAAI,EACJ,aAAa,EACb,GAAG,GACJ,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CA4GtD"}

package/dist/workers/processors/createRunJobWorker.js

@@ -0,0 +1,118 @@
+/**
+ * `createRunJobWorker` — shared factory for every BullMQ processor in this app.
+ *
+ * Wraps the boilerplate that every RunJob-backed worker needs:
+ *   - Idempotent skip if the RunJob already SUCCEEDED (recovery after a crash
+ *     that lost the BullMQ ack).
+ *   - Status transitions: PENDING/RUNNING → RUNNING (with attempts++) → SUCCEEDED.
+ *   - Failure handling: record latest error every attempt, flip to FAILED only
+ *     on the final retry.
+ *   - Standardised structured logging on `error` / `failed` / `completed`.
+ *
+ * A processor implementation only has to provide its `RunJobType`, optional
+ * BullMQ options (concurrency, limiter, etc.), and a `run` callback that does
+ * the actual work. The callback receives the typed `JobInputs[type]` payload
+ * and a context object with `runJobId`, `bullJobId`, `attempt`, plus the
+ * `userId` / `classId` from the original `enqueueRunJob` call.
+ */
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="55ff9081-193c-5053-9606-34eeebf74f10")}catch(e){}}();
+import { Worker } from 'bullmq';
+import { Prisma } from '@prisma/client';
+import { bullConnection } from '../connection.js';
+import { prisma } from '../../lib/prisma.js';
+import { logger } from '../../utils/logger.js';
+import { QUEUE_NAMES } from '../queues.js';
+export function createRunJobWorker({ type, workerOptions, run, }) {
+    const name = QUEUE_NAMES[type];
+    const worker = new Worker(name, async (job) => {
+        const { runJobId, ...rest } = job.data;
+        // The destructured rest is `Omit<JobInputs[T] & { runJobId }, 'runJobId'>`,
+        // which TS can't simplify back to `JobInputs[T]` while `T` is generic.
+        const input = rest;
+        const existing = await prisma.runJob.findUnique({
+            where: { id: runJobId },
+            select: { status: true, result: true, userId: true, classId: true },
+        });
+        if (existing?.status === 'SUCCEEDED') {
+            logger.info(`${name} RunJob already succeeded; skipping re-run`, {
+                runJobId,
+                bullJobId: job.id,
+            });
+            return existing.result;
+        }
+        await prisma.runJob.update({
+            where: { id: runJobId },
+            data: {
+                status: 'RUNNING',
+                startedAt: existing?.status === 'RUNNING' ? undefined : new Date(),
+                attempts: { increment: 1 },
+            },
+        });
+        const result = await run(input, {
+            runJobId,
+            bullJobId: job.id,
+            attempt: job.attemptsMade + 1,
+            userId: existing?.userId ?? null,
+            classId: existing?.classId ?? null,
+        });
+        await prisma.runJob.update({
+            where: { id: runJobId },
+            data: {
+                status: 'SUCCEEDED',
+                finishedAt: new Date(),
+                error: null,
+                result: result === null ? Prisma.JsonNull : result,
+            },
+        });
+        return result;
+    }, { connection: bullConnection, ...workerOptions });
+    worker.on('error', (err) => {
+        logger.error(`${name} worker error`, {
+            error: err.message,
+            stack: err.stack,
+        });
+    });
+    worker.on('failed', async (job, err) => {
+        if (!job)
+            return;
+        const runJobId = job.data?.runJobId;
+        const isFinalAttempt = job.attemptsMade >= (job.opts.attempts ?? 1);
+        logger.error(`${name} job failed`, {
+            bullJobId: job.id,
+            runJobId,
+            attempt: job.attemptsMade,
+            finalAttempt: isFinalAttempt,
+            error: err.message,
+        });
+        if (!runJobId)
+            return;
+        await prisma.runJob
+            .update({
+            where: { id: runJobId },
+            data: {
+                error: err.message,
+                ...(isFinalAttempt
+                    ? { status: 'FAILED', finishedAt: new Date() }
+                    : {}),
+            },
+        })
+            .catch((updateError) => {
+            logger.error(`Failed to record ${name} failure on RunJob`, {
+                runJobId,
+                error: updateError instanceof Error
+                    ? updateError.message
+                    : String(updateError),
+            });
+        });
+    });
+    worker.on('completed', (job) => {
+        logger.info(`${name} job completed`, {
+            bullJobId: job.id,
+            runJobId: job.data?.runJobId,
+        });
+    });
+    return worker;
+}
+//# sourceMappingURL=createRunJobWorker.js.map
+//# debugId=55ff9081-193c-5053-9606-34eeebf74f10

package/dist/workers/processors/createRunJobWorker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRunJobWorker.js","sources":["workers/processors/createRunJobWorker.ts"],"sourceRoot":"/","sourcesContent":["/**\n * `createRunJobWorker` — shared factory for every BullMQ processor in this app.\n *\n * Wraps the boilerplate that every RunJob-backed worker needs:\n *   - Idempotent skip if the RunJob already SUCCEEDED (recovery after a crash\n *     that lost the BullMQ ack).\n *   - Status transitions: PENDING/RUNNING → RUNNING (with attempts++) → SUCCEEDED.\n *   - Failure handling: record latest error every attempt, flip to FAILED only\n *     on the final retry.\n *   - Standardised structured logging on `error` / `failed` / `completed`.\n *\n * A processor implementation only has to provide its `RunJobType`, optional\n * BullMQ options (concurrency, limiter, etc.), and a `run` callback that does\n * the actual work. The callback receives the typed `JobInputs[type]` payload\n * and a context object with `runJobId`, `bullJobId`, `attempt`, plus the\n * `userId` / `classId` from the original `enqueueRunJob` call.\n */\nimport { Worker, type Job, type WorkerOptions } from 'bullmq';\nimport { Prisma, type RunJobType } from '@prisma/client';\nimport { bullConnection } from '../connection.js';\nimport { prisma } from '../../lib/prisma.js';\nimport { logger } from '../../utils/logger.js';\nimport { QUEUE_NAMES, type JobInputs } from '../queues.js';\n\nexport interface RunJobContext {\n  runJobId: string;\n  bullJobId: string | undefined;\n  /** 1-indexed attempt number of the current run. */\n  attempt: number;\n  /** From `EnqueueOptions.userId` on the producer side. */\n  userId: string | null;\n  /** From `EnqueueOptions.classId` on the producer side. */\n  classId: string | null;\n}\n\nexport interface CreateRunJobWorkerOptions<T extends RunJobType> {\n  type: T;\n  /** BullMQ `WorkerOptions` minus `connection`, which is supplied by the helper. */\n  workerOptions?: Omit<WorkerOptions, 'connection'>;\n  /**\n   * The actual work. Return any JSON-serialisable value (or `null`) — it gets\n   * persisted to `RunJob.result` for the client to read back.\n   */\n  run: (\n    input: JobInputs[T],\n    ctx: RunJobContext,\n  ) => Promise<Prisma.InputJsonValue | null>;\n}\n\ntype WorkerData<T extends RunJobType> = JobInputs[T] & { runJobId: string };\n\nexport function createRunJobWorker<T extends RunJobType>({\n  type,\n  workerOptions,\n  run,\n}: CreateRunJobWorkerOptions<T>): Worker<WorkerData<T>> {\n  const name = QUEUE_NAMES[type];\n\n  const worker = new Worker<WorkerData<T>>(\n    name,\n    async (job: Job<WorkerData<T>>) => {\n      const { runJobId, ...rest } = job.data;\n      // The destructured rest is `Omit<JobInputs[T] & { runJobId }, 'runJobId'>`,\n      // which TS can't simplify back to `JobInputs[T]` while `T` is generic.\n      const input = rest as unknown as JobInputs[T];\n\n      const existing = await prisma.runJob.findUnique({\n        where: { id: runJobId },\n        select: { status: true, result: true, userId: true, classId: true },\n      });\n\n      if (existing?.status === 'SUCCEEDED') {\n        logger.info(`${name} RunJob already succeeded; skipping re-run`, {\n          runJobId,\n          bullJobId: job.id,\n        });\n        return existing.result;\n      }\n\n      await prisma.runJob.update({\n        where: { id: runJobId },\n        data: {\n          status: 'RUNNING',\n          startedAt: existing?.status === 'RUNNING' ? undefined : new Date(),\n          attempts: { increment: 1 },\n        },\n      });\n\n      const result = await run(input, {\n        runJobId,\n        bullJobId: job.id,\n        attempt: job.attemptsMade + 1,\n        userId: existing?.userId ?? null,\n        classId: existing?.classId ?? null,\n      });\n\n      await prisma.runJob.update({\n        where: { id: runJobId },\n        data: {\n          status: 'SUCCEEDED',\n          finishedAt: new Date(),\n          error: null,\n          result: result === null ? Prisma.JsonNull : result,\n        },\n      });\n\n      return result;\n    },\n    { connection: bullConnection, ...workerOptions },\n  );\n\n  worker.on('error', (err) => {\n    logger.error(`${name} worker error`, {\n      error: err.message,\n      stack: err.stack,\n    });\n  });\n\n  worker.on('failed', async (job, err) => {\n    if (!job) return;\n\n    const runJobId = job.data?.runJobId;\n    const isFinalAttempt = job.attemptsMade >= (job.opts.attempts ?? 1);\n\n    logger.error(`${name} job failed`, {\n      bullJobId: job.id,\n      runJobId,\n      attempt: job.attemptsMade,\n      finalAttempt: isFinalAttempt,\n      error: err.message,\n    });\n\n    if (!runJobId) return;\n\n    await prisma.runJob\n      .update({\n        where: { id: runJobId },\n        data: {\n          error: err.message,\n          ...(isFinalAttempt\n            ? { status: 'FAILED', finishedAt: new Date() }\n            : {}),\n        },\n      })\n      .catch((updateError) => {\n        logger.error(`Failed to record ${name} failure on RunJob`, {\n          runJobId,\n          error:\n            updateError instanceof Error\n              ? updateError.message\n              : String(updateError),\n        });\n      });\n  });\n\n  worker.on('completed', (job) => {\n    logger.info(`${name} job completed`, {\n      bullJobId: job.id,\n      runJobId: job.data?.runJobId,\n    });\n  });\n\n  return worker;\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;;;AACH,OAAO,EAAE,MAAM,EAAgC,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAmB,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAkB,MAAM,cAAc,CAAC;AA6B3D,MAAM,UAAU,kBAAkB,CAAuB,EACvD,IAAI,EACJ,aAAa,EACb,GAAG,GAC0B;IAC7B,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAE/B,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,IAAI,EACJ,KAAK,EAAE,GAAuB,EAAE,EAAE;QAChC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;QACvC,4EAA4E;QAC5E,uEAAuE;QACvE,MAAM,KAAK,GAAG,IAA+B,CAAC;QAE9C,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;YAC9C,KAAK,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE;YACvB,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;SACpE,CAAC,CAAC;QAEH,IAAI,QAAQ,EAAE,MAAM,KAAK,WAAW,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,4CAA4C,EAAE;gBAC/D,QAAQ;gBACR,SAAS,EAAE,GAAG,CAAC,EAAE;aAClB,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC,MAAM,CAAC;QACzB,CAAC;QAED,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;YACzB,KAAK,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE;YACvB,IAAI,EAAE;gBACJ,MAAM,EAAE,SAAS;gBACjB,SAAS,EAAE,QAAQ,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE;gBAClE,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE;aAC3B;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE;YAC9B,QAAQ;YACR,SAAS,EAAE,GAAG,CAAC,EAAE;YACjB,OAAO,EAAE,GAAG,CAAC,YAAY,GAAG,CAAC;YAC7B,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,IAAI;YAChC,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,IAAI;SACnC,CAAC,CAAC;QAEH,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;YACzB,KAAK,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE;YACvB,IAAI,EAAE;gBACJ,MAAM,EAAE,WAAW;gBACnB,UAAU,EAAE,IAAI,IAAI,EAAE;gBACtB,KAAK,EAAE,IAAI;gBACX,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM;aACnD;SACF,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC,EACD,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,aAAa,EAAE,CACjD,CAAC;IAEF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QACzB,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,eAAe,EAAE;YACnC,KAAK,EAAE,GAAG,CAAC,OAAO;YAClB,KAAK,EAAE,GAAG,CAAC,KAAK;SACjB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACrC,IAAI,CAAC,GAAG;YAAE,OAAO;QAEjB,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC;QACpC,MAAM,cAAc,GAAG,GAAG,CAAC,YAAY,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC;QAEpE,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,aAAa,EAAE;YACjC,SAAS,EAAE,GAAG,CAAC,EAAE;YACjB,QAAQ;YACR,OAAO,EAAE,GAAG,CAAC,YAAY;YACzB,YAAY,EAAE,cAAc;YAC5B,KAAK,EAAE,GAAG,CAAC,OAAO;SACnB,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,MAAM,MAAM,CAAC,MAAM;aAChB,MAAM,CAAC;YACN,KAAK,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE;YACvB,IAAI,EAAE;gBACJ,KAAK,EAAE,GAAG,CAAC,OAAO;gBAClB,GAAG,CAAC,cAAc;oBAChB,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,EAAE;oBAC9C,CAAC,CAAC,EAAE,CAAC;aACR;SACF,CAAC;aACD,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE;YACrB,MAAM,CAAC,KAAK,CAAC,oBAAoB,IAAI,oBAAoB,EAAE;gBACzD,QAAQ;gBACR,KAAK,EACH,WAAW,YAAY,KAAK;oBAC1B,CAAC,CAAC,WAAW,CAAC,OAAO;oBACrB,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;aAC1B,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE;QAC7B,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,gBAAgB,EAAE;YACnC,SAAS,EAAE,GAAG,CAAC,EAAE;YACjB,QAAQ,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ;SAC7B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC","debug_id":"55ff9081-193c-5053-9606-34eeebf74f10"}

package/dist/workers/processors/gradeWorksheet.d.ts

@@ -0,0 +1,6 @@
+export declare const gradeWorksheetWorker: import("bullmq").Worker<{
+    worksheetResponseId: string;
+} & {
+    runJobId: string;
+}, any, string>;
+//# sourceMappingURL=gradeWorksheet.d.ts.map

package/dist/workers/processors/gradeWorksheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradeWorksheet.d.ts","sourceRoot":"/","sources":["workers/processors/gradeWorksheet.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,oBAAoB;;;;eAY/B,CAAC"}

package/dist/workers/processors/gradeWorksheet.js

@@ -0,0 +1,19 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1acdee19-3e17-56ee-ab44-55001b9460f2")}catch(e){}}();
+import { gradeWorksheetPipeline } from '../../pipelines/gradeWorksheet.js';
+import { createRunJobWorker } from './createRunJobWorker.js';
+export const gradeWorksheetWorker = createRunJobWorker({
+    type: 'GRADE_WORKSHEET',
+    workerOptions: {
+        concurrency: 2,
+        // Each pipeline run can fan out to many per-question inferences; keep
+        // throughput modest until we measure real-world usage.
+        limiter: { max: 5, duration: 60000 },
+    },
+    run: async ({ worksheetResponseId }) => {
+        await gradeWorksheetPipeline(worksheetResponseId);
+        return { worksheetResponseId };
+    },
+});
+//# sourceMappingURL=gradeWorksheet.js.map
+//# debugId=1acdee19-3e17-56ee-ab44-55001b9460f2

package/dist/workers/processors/gradeWorksheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradeWorksheet.js","sources":["workers/processors/gradeWorksheet.ts"],"sourceRoot":"/","sourcesContent":["import { gradeWorksheetPipeline } from '../../pipelines/gradeWorksheet.js';\nimport { createRunJobWorker } from './createRunJobWorker.js';\n\nexport const gradeWorksheetWorker = createRunJobWorker({\n  type: 'GRADE_WORKSHEET',\n  workerOptions: {\n    concurrency: 2,\n    // Each pipeline run can fan out to many per-question inferences; keep\n    // throughput modest until we measure real-world usage.\n    limiter: { max: 5, duration: 60_000 },\n  },\n  run: async ({ worksheetResponseId }) => {\n    await gradeWorksheetPipeline(worksheetResponseId);\n    return { worksheetResponseId };\n  },\n});\n"],"names":[],"mappings":";;AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;IACrD,IAAI,EAAE,iBAAiB;IACvB,aAAa,EAAE;QACb,WAAW,EAAE,CAAC;QACd,sEAAsE;QACtE,uDAAuD;QACvD,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAM,EAAE;KACtC;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,mBAAmB,EAAE,EAAE,EAAE;QACrC,MAAM,sBAAsB,CAAC,mBAAmB,CAAC,CAAC;QAClD,OAAO,EAAE,mBAAmB,EAAE,CAAC;IACjC,CAAC;CACF,CAAC,CAAC","debug_id":"1acdee19-3e17-56ee-ab44-55001b9460f2"}

package/dist/workers/processors/pdfToWorksheet.d.ts

@@ -1,9 +1,8 @@
-import { Worker } from 'bullmq';
-interface PdfToWorksheetJobData {
-    runJobId: string;
+export declare const pdfToWorksheetWorker: import("bullmq").Worker<{
     gcsUrl: string;
     classId: string;
-}
-export declare const pdfToWorksheetWorker: Worker<PdfToWorksheetJobData, any, string>;
-export {};
+    worksheetId: string;
+} & {
+    runJobId: string;
+}, any, string>;
 //# sourceMappingURL=pdfToWorksheet.d.ts.map

package/dist/workers/processors/pdfToWorksheet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pdfToWorksheet.d.ts","sourceRoot":"/","sources":["workers/processors/pdfToWorksheet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAY,MAAM,QAAQ,CAAC;AAO1C,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AA8CD,eAAO,MAAM,oBAAoB,4CAYhC,CAAC"}
+{"version":3,"file":"pdfToWorksheet.d.ts","sourceRoot":"/","sources":["workers/processors/pdfToWorksheet.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,oBAAoB;;;;;;eAa/B,CAAC"}

package/dist/workers/processors/pdfToWorksheet.js

@@ -1,100 +1,20 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1b13378b-3952-5f91-b138-a69c3693a56d")}catch(e){}}();
-import { Worker } from 'bullmq';
-import { Prisma } from '@prisma/client';
-import { bullConnection } from '../connection.js';
-import { prisma } from '../../lib/prisma.js';
-import { logger } from '../../utils/logger.js';
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="3beb4788-6c75-5aae-b6c1-3195cbdeffa3")}catch(e){}}();
 import { pdfToWorksheet } from '../../pipelines/pdfToWorksheet.js';
-async function process(job) {
-    const { runJobId, gcsUrl, classId } = job.data;
-    // If a previous attempt already succeeded for this RunJob (rare race after a
-    // crash that lost the BullMQ ack), return the prior result instead of
-    // re-running the AI call and creating a duplicate worksheet.
-    const existing = await prisma.runJob.findUnique({
-        where: { id: runJobId },
-        select: { status: true, result: true },
-    });
-    if (existing?.status === 'SUCCEEDED') {
-        logger.info('pdfToWorksheet RunJob already succeeded; skipping re-run', {
-            runJobId,
-            bullJobId: job.id,
-        });
-        return existing.result;
-    }
-    await prisma.runJob.update({
-        where: { id: runJobId },
-        data: {
-            status: 'RUNNING',
-            startedAt: existing?.status === 'RUNNING' ? undefined : new Date(),
-            attempts: { increment: 1 },
-        },
-    });
-    const worksheet = await pdfToWorksheet(gcsUrl, classId);
-    const result = worksheet ? { worksheetId: worksheet.id, name: worksheet.name } : null;
-    await prisma.runJob.update({
-        where: { id: runJobId },
-        data: {
-            status: 'SUCCEEDED',
-            finishedAt: new Date(),
-            error: null,
-            result: result === null ? Prisma.JsonNull : result,
-        },
-    });
-    return result;
-}
-export const pdfToWorksheetWorker = new Worker('pdfToWorksheet', process, {
-    connection: bullConnection,
-    // Conservative defaults — tune once we have real-world numbers.
-    concurrency: 2,
-    limiter: {
-        max: 5,
-        duration: 60000, // 5 jobs / minute, e.g. to stay under OpenAI rate limits
+import { createRunJobWorker } from './createRunJobWorker.js';
+export const pdfToWorksheetWorker = createRunJobWorker({
+    type: 'PDF_TO_WORKSHEET',
+    workerOptions: {
+        concurrency: 2,
+        // 5 jobs / minute, e.g. to stay under OpenAI rate limits.
+        limiter: { max: 5, duration: 60000 },
+    },
+    run: async ({ gcsUrl, classId, worksheetId }) => {
+        const worksheet = await pdfToWorksheet(gcsUrl, classId, { worksheetId });
+        return worksheet
+            ? { worksheetId: worksheet.id, name: worksheet.name }
+            : null;
     },
-});
-pdfToWorksheetWorker.on('error', (err) => {
-    logger.error('pdfToWorksheet worker error', {
-        error: err.message,
-        stack: err.stack,
-    });
-});
-pdfToWorksheetWorker.on('failed', async (job, err) => {
-    if (!job)
-        return;
-    const runJobId = job.data?.runJobId;
-    const isFinalAttempt = job.attemptsMade >= (job.opts.attempts ?? 1);
-    logger.error('pdfToWorksheet job failed', {
-        bullJobId: job.id,
-        runJobId,
-        attempt: job.attemptsMade,
-        finalAttempt: isFinalAttempt,
-        error: err.message,
-    });
-    if (!runJobId)
-        return;
-    // Always record the latest error message on the RunJob row.
-    // Only flip to FAILED on the final attempt — earlier failures are still
-    // "RUNNING" because BullMQ is going to retry.
-    await prisma.runJob.update({
-        where: { id: runJobId },
-        data: {
-            error: err.message,
-            ...(isFinalAttempt
-                ? { status: 'FAILED', finishedAt: new Date() }
-                : {}),
-        },
-    }).catch((updateError) => {
-        logger.error('Failed to record pdfToWorksheet failure on RunJob', {
-            runJobId,
-            error: updateError instanceof Error ? updateError.message : String(updateError),
-        });
-    });
-});
-pdfToWorksheetWorker.on('completed', (job) => {
-    logger.info('pdfToWorksheet job completed', {
-        bullJobId: job.id,
-        runJobId: job.data?.runJobId,
-    });
 });
 //# sourceMappingURL=pdfToWorksheet.js.map
-//# debugId=1b13378b-3952-5f91-b138-a69c3693a56d
+//# debugId=3beb4788-6c75-5aae-b6c1-3195cbdeffa3

package/dist/workers/processors/pdfToWorksheet.js.map

@@ -1 +1 @@
-{"version":3,"file":"pdfToWorksheet.js","sources":["workers/processors/pdfToWorksheet.ts"],"sourceRoot":"/","sourcesContent":["import { Worker, type Job } from 'bullmq';\nimport { Prisma } from '@prisma/client';\nimport { bullConnection } from '../connection.js';\nimport { prisma } from '../../lib/prisma.js';\nimport { logger } from '../../utils/logger.js';\nimport { pdfToWorksheet } from '../../pipelines/pdfToWorksheet.js';\n\ninterface PdfToWorksheetJobData {\n  runJobId: string;\n  gcsUrl: string;\n  classId: string;\n}\n\nasync function process(job: Job<PdfToWorksheetJobData>) {\n  const { runJobId, gcsUrl, classId } = job.data;\n\n  // If a previous attempt already succeeded for this RunJob (rare race after a\n  // crash that lost the BullMQ ack), return the prior result instead of\n  // re-running the AI call and creating a duplicate worksheet.\n  const existing = await prisma.runJob.findUnique({\n    where: { id: runJobId },\n    select: { status: true, result: true },\n  });\n  if (existing?.status === 'SUCCEEDED') {\n    logger.info('pdfToWorksheet RunJob already succeeded; skipping re-run', {\n      runJobId,\n      bullJobId: job.id,\n    });\n    return existing.result;\n  }\n\n  await prisma.runJob.update({\n    where: { id: runJobId },\n    data: {\n      status: 'RUNNING',\n      startedAt: existing?.status === 'RUNNING' ? undefined : new Date(),\n      attempts: { increment: 1 },\n    },\n  });\n\n  const worksheet = await pdfToWorksheet(gcsUrl, classId);\n\n  const result = worksheet ? { worksheetId: worksheet.id, name: worksheet.name } : null;\n\n  await prisma.runJob.update({\n    where: { id: runJobId },\n    data: {\n      status: 'SUCCEEDED',\n      finishedAt: new Date(),\n      error: null,\n      result: result === null ? Prisma.JsonNull : (result as Prisma.InputJsonValue),\n    },\n  });\n\n  return result;\n}\n\nexport const pdfToWorksheetWorker = new Worker<PdfToWorksheetJobData>(\n  'pdfToWorksheet',\n  process,\n  {\n    connection: bullConnection,\n    // Conservative defaults — tune once we have real-world numbers.\n    concurrency: 2,\n    limiter: {\n      max: 5,\n      duration: 60_000, // 5 jobs / minute, e.g. to stay under OpenAI rate limits\n    },\n  },\n);\n\npdfToWorksheetWorker.on('error', (err) => {\n  logger.error('pdfToWorksheet worker error', {\n    error: err.message,\n    stack: err.stack,\n  });\n});\n\npdfToWorksheetWorker.on('failed', async (job, err) => {\n  if (!job) return;\n\n  const runJobId = job.data?.runJobId;\n  const isFinalAttempt = job.attemptsMade >= (job.opts.attempts ?? 1);\n\n  logger.error('pdfToWorksheet job failed', {\n    bullJobId: job.id,\n    runJobId,\n    attempt: job.attemptsMade,\n    finalAttempt: isFinalAttempt,\n    error: err.message,\n  });\n\n  if (!runJobId) return;\n\n  // Always record the latest error message on the RunJob row.\n  // Only flip to FAILED on the final attempt — earlier failures are still\n  // \"RUNNING\" because BullMQ is going to retry.\n  await prisma.runJob.update({\n    where: { id: runJobId },\n    data: {\n      error: err.message,\n      ...(isFinalAttempt\n        ? { status: 'FAILED', finishedAt: new Date() }\n        : {}),\n    },\n  }).catch((updateError) => {\n    logger.error('Failed to record pdfToWorksheet failure on RunJob', {\n      runJobId,\n      error: updateError instanceof Error ? updateError.message : String(updateError),\n    });\n  });\n});\n\npdfToWorksheetWorker.on('completed', (job) => {\n  logger.info('pdfToWorksheet job completed', {\n    bullJobId: job.id,\n    runJobId: job.data?.runJobId,\n  });\n});\n"],"names":[],"mappings":"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","debug_id":"1b13378b-3952-5f91-b138-a69c3693a56d"}
+{"version":3,"file":"pdfToWorksheet.js","sources":["workers/processors/pdfToWorksheet.ts"],"sourceRoot":"/","sourcesContent":["import { pdfToWorksheet } from '../../pipelines/pdfToWorksheet.js';\nimport { createRunJobWorker } from './createRunJobWorker.js';\n\nexport const pdfToWorksheetWorker = createRunJobWorker({\n  type: 'PDF_TO_WORKSHEET',\n  workerOptions: {\n    concurrency: 2,\n    // 5 jobs / minute, e.g. to stay under OpenAI rate limits.\n    limiter: { max: 5, duration: 60_000 },\n  },\n  run: async ({ gcsUrl, classId, worksheetId }) => {\n    const worksheet = await pdfToWorksheet(gcsUrl, classId, { worksheetId });\n    return worksheet\n      ? { worksheetId: worksheet.id, name: worksheet.name }\n      : null;\n  },\n});\n"],"names":[],"mappings":";;AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;IACrD,IAAI,EAAE,kBAAkB;IACxB,aAAa,EAAE;QACb,WAAW,EAAE,CAAC;QACd,0DAA0D;QAC1D,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAM,EAAE;KACtC;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QAC9C,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;QACzE,OAAO,SAAS;YACd,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE;YACrD,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;CACF,CAAC,CAAC","debug_id":"3beb4788-6c75-5aae-b6c1-3195cbdeffa3"}

package/dist/workers/processors/studentProgressChat.d.ts

@@ -0,0 +1,8 @@
+export declare const studentProgressChatWorker: import("bullmq").Worker<{
+    classId: string;
+    studentId: string;
+    message: string;
+} & {
+    runJobId: string;
+}, any, string>;
+//# sourceMappingURL=studentProgressChat.d.ts.map

package/dist/workers/processors/studentProgressChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studentProgressChat.d.ts","sourceRoot":"/","sources":["workers/processors/studentProgressChat.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,yBAAyB;;;;;;eAwBpC,CAAC"}

package/dist/workers/processors/studentProgressChat.js

@@ -0,0 +1,27 @@
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="13740d05-3496-50cc-a32d-baa98cef5e0b")}catch(e){}}();
+import { chatAboutStudentProgress } from '../../services/studentProgress.js';
+import { createRunJobWorker } from './createRunJobWorker.js';
+export const studentProgressChatWorker = createRunJobWorker({
+    type: 'STUDENT_PROGRESS_CHAT',
+    workerOptions: {
+        concurrency: 4,
+        limiter: { max: 20, duration: 60000 },
+    },
+    run: async ({ classId, studentId, message }, ctx) => {
+        // `chatAboutStudentProgress` runs an authorization check using the viewer
+        // id, so callers MUST pass `userId` via `enqueueRunJob` options for the
+        // service to receive it here.
+        if (!ctx.userId) {
+            throw new Error('STUDENT_PROGRESS_CHAT requires `userId` on the RunJob (set via enqueueRunJob options)');
+        }
+        const response = await chatAboutStudentProgress(ctx.userId, {
+            classId,
+            studentId,
+            message,
+        });
+        return response;
+    },
+});
+//# sourceMappingURL=studentProgressChat.js.map
+//# debugId=13740d05-3496-50cc-a32d-baa98cef5e0b

package/dist/workers/processors/studentProgressChat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"studentProgressChat.js","sources":["workers/processors/studentProgressChat.ts"],"sourceRoot":"/","sourcesContent":["import { chatAboutStudentProgress } from '../../services/studentProgress.js';\nimport { createRunJobWorker } from './createRunJobWorker.js';\n\nexport const studentProgressChatWorker = createRunJobWorker({\n  type: 'STUDENT_PROGRESS_CHAT',\n  workerOptions: {\n    concurrency: 4,\n    limiter: { max: 20, duration: 60_000 },\n  },\n  run: async ({ classId, studentId, message }, ctx) => {\n    // `chatAboutStudentProgress` runs an authorization check using the viewer\n    // id, so callers MUST pass `userId` via `enqueueRunJob` options for the\n    // service to receive it here.\n    if (!ctx.userId) {\n      throw new Error(\n        'STUDENT_PROGRESS_CHAT requires `userId` on the RunJob (set via enqueueRunJob options)',\n      );\n    }\n\n    const response = await chatAboutStudentProgress(ctx.userId, {\n      classId,\n      studentId,\n      message,\n    });\n\n    return response;\n  },\n});\n"],"names":[],"mappings":";;AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,CAAC,MAAM,yBAAyB,GAAG,kBAAkB,CAAC;IAC1D,IAAI,EAAE,uBAAuB;IAC7B,aAAa,EAAE;QACb,WAAW,EAAE,CAAC;QACd,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAM,EAAE;KACvC;IACD,GAAG,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE;QAClD,0EAA0E;QAC1E,wEAAwE;QACxE,8BAA8B;QAC9B,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,wBAAwB,CAAC,GAAG,CAAC,MAAM,EAAE;YAC1D,OAAO;YACP,SAAS;YACT,OAAO;SACR,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF,CAAC,CAAC","debug_id":"13740d05-3496-50cc-a32d-baa98cef5e0b"}