@studious-lms/server 1.13.0 → 1.15.0

package/dist/services/aiModifierTools.js

@@ -0,0 +1,274 @@
+/**
+ * AI modifier "field-update" tools.
+ *
+ * Unlike the Lab-chat proposal tools (which only *record* a payload for the
+ * teacher to accept later), these tools DIRECTLY edit a single key of an
+ * existing assignment or worksheet and persist it immediately via the normal
+ * service layer. The modifier route locks the resource (Redis flag + Pusher
+ * `modifier-started`) while the stream runs, and each successful field write
+ * fires a callback so the route can broadcast `modifier-field-updated` to every
+ * open editor — they apply the change live and stay read-only until the run
+ * completes or fails.
+ *
+ * NOTE: like `aiTools.ts` / `aiProposalTools.ts`, these intentionally use
+ * `jsonSchema()` rather than the zod `tool()` helper to avoid the TS2589
+ * "excessively deep" compiler blow-up on nested schemas.
+ */
+
+!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]="ed55e709-4194-573d-b522-7077f5d6d6bf")}catch(e){}}();
+import { randomUUID } from 'node:crypto';
+import { jsonSchema } from 'ai';
+import { updateAssignmentRecord } from './assignment.js';
+import { addQuestionToWorksheet, deleteWorksheetQuestionRecord, updateWorksheetQuestionRecord, updateWorksheetRecord, } from './worksheet.js';
+const ASSIGNMENT_TYPES = [
+    'HOMEWORK', 'QUIZ', 'TEST', 'PROJECT', 'ESSAY', 'DISCUSSION', 'PRESENTATION', 'LAB', 'OTHER',
+];
+/**
+ * Editable scalar keys of an assignment, with the coercion + human label used
+ * when the model passes a (string) value. Keys map 1:1 to
+ * `updateAssignmentRecord` input fields.
+ */
+const ASSIGNMENT_FIELDS = {
+    title: { label: 'title', type: 'string' },
+    instructions: { label: 'instructions', type: 'string' },
+    dueDate: { label: 'due date', type: 'date' },
+    type: { label: 'type', type: 'enum', enumValues: ASSIGNMENT_TYPES },
+    maxGrade: { label: 'max grade', type: 'number' },
+    graded: { label: 'graded', type: 'boolean' },
+    weight: { label: 'weight', type: 'number' },
+    acceptFiles: { label: 'file submissions', type: 'boolean' },
+    acceptExtendedResponse: { label: 'extended response', type: 'boolean' },
+    acceptWorksheet: { label: 'worksheet submissions', type: 'boolean' },
+    aiPolicyLevel: { label: 'AI policy level', type: 'number' },
+};
+const WORKSHEET_FIELDS = {
+    name: { label: 'name', type: 'string' },
+};
+const WORKSHEET_QUESTION_TYPES = [
+    'MULTIPLE_CHOICE', 'TRUE_FALSE', 'SHORT_ANSWER', 'LONG_ANSWER', 'MATH_EXPRESSION', 'ESSAY',
+];
+/** Attach stable ids to model-supplied MCQ options (matches the editor's shape). */
+function buildOptions(options) {
+    if (!options || options.length === 0)
+        return undefined;
+    return options.map((o) => ({
+        id: randomUUID(),
+        text: o.text,
+        isCorrect: Boolean(o.isCorrect),
+    }));
+}
+const QUESTION_PROPERTIES = {
+    question: { type: 'string', description: 'The question text shown to students.' },
+    answer: {
+        type: 'string',
+        description: 'The correct answer. For TRUE_FALSE use "true"/"false". For MULTIPLE_CHOICE leave it empty and mark the correct option instead.',
+    },
+    type: {
+        type: 'string',
+        enum: [...WORKSHEET_QUESTION_TYPES],
+        description: 'The question type.',
+    },
+    points: { type: 'number', description: 'Points the question is worth.' },
+    options: {
+        type: 'array',
+        description: 'Answer choices, only for MULTIPLE_CHOICE questions. Mark exactly one as correct.',
+        items: {
+            type: 'object',
+            properties: {
+                text: { type: 'string', description: 'The option text.' },
+                isCorrect: { type: 'boolean', description: 'Whether this option is the correct answer.' },
+            },
+            required: ['text'],
+        },
+    },
+};
+/** Coerce a model-supplied string value into the type a field expects. */
+function coerceValue(raw, spec) {
+    switch (spec.type) {
+        case 'number': {
+            const n = Number(raw);
+            if (Number.isNaN(n))
+                throw new Error(`Expected a number but got "${raw}"`);
+            return n;
+        }
+        case 'boolean': {
+            const v = raw.trim().toLowerCase();
+            if (['true', 'yes', '1'].includes(v))
+                return true;
+            if (['false', 'no', '0'].includes(v))
+                return false;
+            throw new Error(`Expected a boolean but got "${raw}"`);
+        }
+        case 'date': {
+            const d = new Date(raw);
+            if (Number.isNaN(d.getTime()))
+                throw new Error(`Expected an ISO date but got "${raw}"`);
+            return d.toISOString();
+        }
+        case 'enum': {
+            const v = raw.trim().toUpperCase();
+            if (spec.enumValues && !spec.enumValues.includes(v)) {
+                throw new Error(`Expected one of ${spec.enumValues.join(', ')} but got "${raw}"`);
+            }
+            return v;
+        }
+        default:
+            return raw;
+    }
+}
+/**
+ * Build the field-update tool for an assignment. The `onFieldUpdate` callback
+ * runs after a successful persist so the route can broadcast the change.
+ */
+export function assignmentModifierTools(userId, assignmentId, classId, onFieldUpdate) {
+    const fieldNames = Object.keys(ASSIGNMENT_FIELDS);
+    return {
+        update_assignment_field: {
+            description: 'Directly update a single field of the assignment and save it immediately. ' +
+                'Call this once per field the teacher wants changed. The assignment is locked ' +
+                'for editing until you finish.',
+            inputSchema: jsonSchema({
+                type: 'object',
+                properties: {
+                    field: {
+                        type: 'string',
+                        enum: fieldNames,
+                        description: 'The assignment field to update.',
+                    },
+                    value: {
+                        type: 'string',
+                        description: 'The new value as a string. Booleans use "true"/"false", numbers as digits, ' +
+                            'dates as ISO 8601, type as one of the allowed enum values.',
+                    },
+                },
+                required: ['field', 'value'],
+            }),
+            execute: async ({ field, value }) => {
+                const spec = ASSIGNMENT_FIELDS[field];
+                if (!spec) {
+                    return `Unknown field "${field}". Allowed: ${fieldNames.join(', ')}.`;
+                }
+                let coerced;
+                try {
+                    coerced = coerceValue(value, spec);
+                }
+                catch (err) {
+                    return `Could not update ${spec.label}: ${err.message}`;
+                }
+                const updateInput = {
+                    id: assignmentId,
+                    classId,
+                };
+                updateInput[field] = coerced;
+                await updateAssignmentRecord(userId, updateInput);
+                await onFieldUpdate({ field, value: coerced, label: spec.label });
+                return `Updated ${spec.label}.`;
+            },
+        },
+    };
+}
+/** Build the field-update tool for a worksheet. */
+export function worksheetModifierTools(worksheetId, userId, onFieldUpdate) {
+    const fieldNames = Object.keys(WORKSHEET_FIELDS);
+    return {
+        update_worksheet_field: {
+            description: 'Directly update a single field of the worksheet and save it immediately. ' +
+                'The worksheet is locked for editing until you finish.',
+            inputSchema: jsonSchema({
+                type: 'object',
+                properties: {
+                    field: {
+                        type: 'string',
+                        enum: fieldNames,
+                        description: 'The worksheet field to update.',
+                    },
+                    value: { type: 'string', description: 'The new value as a string.' },
+                },
+                required: ['field', 'value'],
+            }),
+            execute: async ({ field, value }) => {
+                const spec = WORKSHEET_FIELDS[field];
+                if (!spec) {
+                    return `Unknown field "${field}". Allowed: ${fieldNames.join(', ')}.`;
+                }
+                const updateInput = {};
+                updateInput[field] = value;
+                await updateWorksheetRecord(worksheetId, userId, updateInput);
+                await onFieldUpdate({ field, value, label: spec.label });
+                return `Updated ${spec.label}.`;
+            },
+        },
+        add_worksheet_question: {
+            description: 'Add a new question to the worksheet and save it immediately. ' +
+                'Call this once per question to add.',
+            inputSchema: jsonSchema({
+                type: 'object',
+                properties: QUESTION_PROPERTIES,
+                required: ['question', 'answer', 'type'],
+            }),
+            execute: async ({ question, answer, type, points, options, }) => {
+                const created = await addQuestionToWorksheet(worksheetId, userId, {
+                    question,
+                    answer,
+                    type,
+                    points,
+                    options: buildOptions(options),
+                });
+                await onFieldUpdate({
+                    field: 'questions',
+                    value: { action: 'added', questionId: created.id },
+                    label: `question "${question.slice(0, 60)}"`,
+                });
+                return `Added question (id ${created.id}).`;
+            },
+        },
+        update_worksheet_question: {
+            description: 'Update an existing worksheet question by its Q_ID and save it immediately. ' +
+                'Only pass the fields that should change.',
+            inputSchema: jsonSchema({
+                type: 'object',
+                properties: {
+                    questionId: { type: 'string', description: 'The Q_ID of the question to update.' },
+                    ...QUESTION_PROPERTIES,
+                },
+                required: ['questionId'],
+            }),
+            execute: async ({ questionId, question, answer, type, points, options, }) => {
+                await updateWorksheetQuestionRecord(worksheetId, questionId, userId, {
+                    ...(question !== undefined && { question }),
+                    ...(answer !== undefined && { answer }),
+                    ...(type !== undefined && { type }),
+                    ...(points !== undefined && { points }),
+                    ...(options !== undefined && { options: buildOptions(options) }),
+                });
+                await onFieldUpdate({
+                    field: 'questions',
+                    value: { action: 'updated', questionId },
+                    label: 'a question',
+                });
+                return `Updated question ${questionId}.`;
+            },
+        },
+        delete_worksheet_question: {
+            description: 'Delete a worksheet question by its Q_ID. This is permanent.',
+            inputSchema: jsonSchema({
+                type: 'object',
+                properties: {
+                    questionId: { type: 'string', description: 'The Q_ID of the question to delete.' },
+                },
+                required: ['questionId'],
+            }),
+            execute: async ({ questionId }) => {
+                await deleteWorksheetQuestionRecord(worksheetId, questionId, userId);
+                await onFieldUpdate({
+                    field: 'questions',
+                    value: { action: 'deleted', questionId },
+                    label: 'a question',
+                });
+                return `Deleted question ${questionId}.`;
+            },
+        },
+    };
+}
+//# sourceMappingURL=aiModifierTools.js.map
+//# debugId=ed55e709-4194-573d-b522-7077f5d6d6bf

package/dist/services/aiModifierTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiModifierTools.js","sources":["services/aiModifierTools.ts"],"sourceRoot":"/","sourcesContent":["/**\n * AI modifier \"field-update\" tools.\n *\n * Unlike the Lab-chat proposal tools (which only *record* a payload for the\n * teacher to accept later), these tools DIRECTLY edit a single key of an\n * existing assignment or worksheet and persist it immediately via the normal\n * service layer. The modifier route locks the resource (Redis flag + Pusher\n * `modifier-started`) while the stream runs, and each successful field write\n * fires a callback so the route can broadcast `modifier-field-updated` to every\n * open editor — they apply the change live and stay read-only until the run\n * completes or fails.\n *\n * NOTE: like `aiTools.ts` / `aiProposalTools.ts`, these intentionally use\n * `jsonSchema()` rather than the zod `tool()` helper to avoid the TS2589\n * \"excessively deep\" compiler blow-up on nested schemas.\n */\nimport { randomUUID } from 'node:crypto';\nimport { jsonSchema, type ToolSet } from 'ai';\nimport type { JSONSchema7Definition } from 'json-schema';\nimport type { WorksheetQuestionType } from '@prisma/client';\nimport { updateAssignmentRecord } from './assignment.js';\nimport {\n  addQuestionToWorksheet,\n  deleteWorksheetQuestionRecord,\n  updateWorksheetQuestionRecord,\n  updateWorksheetRecord,\n} from './worksheet.js';\n\n/** A single field write that was applied to a resource. */\nexport interface ModifierFieldUpdate {\n  field: string;\n  value: unknown;\n  /** Human-readable label for the change, e.g. \"title\" or \"due date\". */\n  label: string;\n}\n\nconst ASSIGNMENT_TYPES = [\n  'HOMEWORK', 'QUIZ', 'TEST', 'PROJECT', 'ESSAY', 'DISCUSSION', 'PRESENTATION', 'LAB', 'OTHER',\n] as const;\n\n/**\n * Editable scalar keys of an assignment, with the coercion + human label used\n * when the model passes a (string) value. Keys map 1:1 to\n * `updateAssignmentRecord` input fields.\n */\nconst ASSIGNMENT_FIELDS: Record<\n  string,\n  { label: string; type: 'string' | 'number' | 'boolean' | 'date' | 'enum'; enumValues?: readonly string[] }\n> = {\n  title: { label: 'title', type: 'string' },\n  instructions: { label: 'instructions', type: 'string' },\n  dueDate: { label: 'due date', type: 'date' },\n  type: { label: 'type', type: 'enum', enumValues: ASSIGNMENT_TYPES },\n  maxGrade: { label: 'max grade', type: 'number' },\n  graded: { label: 'graded', type: 'boolean' },\n  weight: { label: 'weight', type: 'number' },\n  acceptFiles: { label: 'file submissions', type: 'boolean' },\n  acceptExtendedResponse: { label: 'extended response', type: 'boolean' },\n  acceptWorksheet: { label: 'worksheet submissions', type: 'boolean' },\n  aiPolicyLevel: { label: 'AI policy level', type: 'number' },\n};\n\nconst WORKSHEET_FIELDS: Record<string, { label: string; type: 'string' }> = {\n  name: { label: 'name', type: 'string' },\n};\n\nconst WORKSHEET_QUESTION_TYPES = [\n  'MULTIPLE_CHOICE', 'TRUE_FALSE', 'SHORT_ANSWER', 'LONG_ANSWER', 'MATH_EXPRESSION', 'ESSAY',\n] as const;\n\ninterface QuestionOptionInput {\n  text: string;\n  isCorrect?: boolean;\n}\n\n/** Attach stable ids to model-supplied MCQ options (matches the editor's shape). */\nfunction buildOptions(options: QuestionOptionInput[] | undefined) {\n  if (!options || options.length === 0) return undefined;\n  return options.map((o) => ({\n    id: randomUUID(),\n    text: o.text,\n    isCorrect: Boolean(o.isCorrect),\n  }));\n}\n\nconst QUESTION_PROPERTIES: Record<string, JSONSchema7Definition> = {\n  question: { type: 'string', description: 'The question text shown to students.' },\n  answer: {\n    type: 'string',\n    description:\n      'The correct answer. For TRUE_FALSE use \"true\"/\"false\". For MULTIPLE_CHOICE leave it empty and mark the correct option instead.',\n  },\n  type: {\n    type: 'string',\n    enum: [...WORKSHEET_QUESTION_TYPES],\n    description: 'The question type.',\n  },\n  points: { type: 'number', description: 'Points the question is worth.' },\n  options: {\n    type: 'array',\n    description: 'Answer choices, only for MULTIPLE_CHOICE questions. Mark exactly one as correct.',\n    items: {\n      type: 'object',\n      properties: {\n        text: { type: 'string', description: 'The option text.' },\n        isCorrect: { type: 'boolean', description: 'Whether this option is the correct answer.' },\n      },\n      required: ['text'],\n    },\n  },\n};\n\n/** Coerce a model-supplied string value into the type a field expects. */\nfunction coerceValue(\n  raw: string,\n  spec: { type: 'string' | 'number' | 'boolean' | 'date' | 'enum'; enumValues?: readonly string[] },\n): unknown {\n  switch (spec.type) {\n    case 'number': {\n      const n = Number(raw);\n      if (Number.isNaN(n)) throw new Error(`Expected a number but got \"${raw}\"`);\n      return n;\n    }\n    case 'boolean': {\n      const v = raw.trim().toLowerCase();\n      if (['true', 'yes', '1'].includes(v)) return true;\n      if (['false', 'no', '0'].includes(v)) return false;\n      throw new Error(`Expected a boolean but got \"${raw}\"`);\n    }\n    case 'date': {\n      const d = new Date(raw);\n      if (Number.isNaN(d.getTime())) throw new Error(`Expected an ISO date but got \"${raw}\"`);\n      return d.toISOString();\n    }\n    case 'enum': {\n      const v = raw.trim().toUpperCase();\n      if (spec.enumValues && !spec.enumValues.includes(v)) {\n        throw new Error(`Expected one of ${spec.enumValues.join(', ')} but got \"${raw}\"`);\n      }\n      return v;\n    }\n    default:\n      return raw;\n  }\n}\n\n/**\n * Build the field-update tool for an assignment. The `onFieldUpdate` callback\n * runs after a successful persist so the route can broadcast the change.\n */\nexport function assignmentModifierTools(\n  userId: string,\n  assignmentId: string,\n  classId: string,\n  onFieldUpdate: (update: ModifierFieldUpdate) => Promise<void> | void,\n): ToolSet {\n  const fieldNames = Object.keys(ASSIGNMENT_FIELDS);\n  return {\n    update_assignment_field: {\n      description:\n        'Directly update a single field of the assignment and save it immediately. ' +\n        'Call this once per field the teacher wants changed. The assignment is locked ' +\n        'for editing until you finish.',\n      inputSchema: jsonSchema({\n        type: 'object',\n        properties: {\n          field: {\n            type: 'string',\n            enum: fieldNames,\n            description: 'The assignment field to update.',\n          },\n          value: {\n            type: 'string',\n            description:\n              'The new value as a string. Booleans use \"true\"/\"false\", numbers as digits, ' +\n              'dates as ISO 8601, type as one of the allowed enum values.',\n          },\n        },\n        required: ['field', 'value'],\n      }),\n      execute: async ({ field, value }: { field: string; value: string }) => {\n        const spec = ASSIGNMENT_FIELDS[field];\n        if (!spec) {\n          return `Unknown field \"${field}\". Allowed: ${fieldNames.join(', ')}.`;\n        }\n        let coerced: unknown;\n        try {\n          coerced = coerceValue(value, spec);\n        } catch (err) {\n          return `Could not update ${spec.label}: ${(err as Error).message}`;\n        }\n        const updateInput: Parameters<typeof updateAssignmentRecord>[1] = {\n          id: assignmentId,\n          classId,\n        };\n        (updateInput as Record<string, unknown>)[field] = coerced;\n        await updateAssignmentRecord(userId, updateInput);\n        await onFieldUpdate({ field, value: coerced, label: spec.label });\n        return `Updated ${spec.label}.`;\n      },\n    },\n  };\n}\n\n/** Build the field-update tool for a worksheet. */\nexport function worksheetModifierTools(\n  worksheetId: string,\n  userId: string,\n  onFieldUpdate: (update: ModifierFieldUpdate) => Promise<void> | void,\n): ToolSet {\n  const fieldNames = Object.keys(WORKSHEET_FIELDS);\n  return {\n    update_worksheet_field: {\n      description:\n        'Directly update a single field of the worksheet and save it immediately. ' +\n        'The worksheet is locked for editing until you finish.',\n      inputSchema: jsonSchema({\n        type: 'object',\n        properties: {\n          field: {\n            type: 'string',\n            enum: fieldNames,\n            description: 'The worksheet field to update.',\n          },\n          value: { type: 'string', description: 'The new value as a string.' },\n        },\n        required: ['field', 'value'],\n      }),\n      execute: async ({ field, value }: { field: string; value: string }) => {\n        const spec = WORKSHEET_FIELDS[field];\n        if (!spec) {\n          return `Unknown field \"${field}\". Allowed: ${fieldNames.join(', ')}.`;\n        }\n        const updateInput: Parameters<typeof updateWorksheetRecord>[2] = {};\n        (updateInput as Record<string, unknown>)[field] = value;\n        await updateWorksheetRecord(worksheetId, userId, updateInput);\n        await onFieldUpdate({ field, value, label: spec.label });\n        return `Updated ${spec.label}.`;\n      },\n    },\n    add_worksheet_question: {\n      description:\n        'Add a new question to the worksheet and save it immediately. ' +\n        'Call this once per question to add.',\n      inputSchema: jsonSchema({\n        type: 'object',\n        properties: QUESTION_PROPERTIES,\n        required: ['question', 'answer', 'type'],\n      }),\n      execute: async ({\n        question,\n        answer,\n        type,\n        points,\n        options,\n      }: {\n        question: string;\n        answer: string;\n        type: WorksheetQuestionType;\n        points?: number;\n        options?: QuestionOptionInput[];\n      }) => {\n        const created = await addQuestionToWorksheet(worksheetId, userId, {\n          question,\n          answer,\n          type,\n          points,\n          options: buildOptions(options),\n        });\n        await onFieldUpdate({\n          field: 'questions',\n          value: { action: 'added', questionId: created.id },\n          label: `question \"${question.slice(0, 60)}\"`,\n        });\n        return `Added question (id ${created.id}).`;\n      },\n    },\n    update_worksheet_question: {\n      description:\n        'Update an existing worksheet question by its Q_ID and save it immediately. ' +\n        'Only pass the fields that should change.',\n      inputSchema: jsonSchema({\n        type: 'object',\n        properties: {\n          questionId: { type: 'string', description: 'The Q_ID of the question to update.' },\n          ...QUESTION_PROPERTIES,\n        },\n        required: ['questionId'],\n      }),\n      execute: async ({\n        questionId,\n        question,\n        answer,\n        type,\n        points,\n        options,\n      }: {\n        questionId: string;\n        question?: string;\n        answer?: string;\n        type?: WorksheetQuestionType;\n        points?: number;\n        options?: QuestionOptionInput[];\n      }) => {\n        await updateWorksheetQuestionRecord(worksheetId, questionId, userId, {\n          ...(question !== undefined && { question }),\n          ...(answer !== undefined && { answer }),\n          ...(type !== undefined && { type }),\n          ...(points !== undefined && { points }),\n          ...(options !== undefined && { options: buildOptions(options) }),\n        });\n        await onFieldUpdate({\n          field: 'questions',\n          value: { action: 'updated', questionId },\n          label: 'a question',\n        });\n        return `Updated question ${questionId}.`;\n      },\n    },\n    delete_worksheet_question: {\n      description:\n        'Delete a worksheet question by its Q_ID. This is permanent.',\n      inputSchema: jsonSchema({\n        type: 'object',\n        properties: {\n          questionId: { type: 'string', description: 'The Q_ID of the question to delete.' },\n        },\n        required: ['questionId'],\n      }),\n      execute: async ({ questionId }: { questionId: string }) => {\n        await deleteWorksheetQuestionRecord(worksheetId, questionId, userId);\n        await onFieldUpdate({\n          field: 'questions',\n          value: { action: 'deleted', questionId },\n          label: 'a question',\n        });\n        return `Deleted question ${questionId}.`;\n      },\n    },\n  };\n}\n"],"names":[],"mappings":"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","debug_id":"ed55e709-4194-573d-b522-7077f5d6d6bf"}

package/dist/services/aiProposalTools.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Lab-chat "proposal" tools.
+ *
+ * In the agentic Lab pipeline the model produces create-actions by *calling
+ * tools* (e.g. `propose_assignment`) instead of returning a JSON blob. Each
+ * tool records a structured payload into a shared accumulator and returns a
+ * short confirmation so the model can keep narrating. After the stream ends
+ * the pipeline turns the accumulator into the `message.meta.*ToCreate` shape
+ * the frontend accept-cards already consume — so the data contract is
+ * preserved while the generation becomes genuine inline tool calls.
+ *
+ * NOTE: these tools intentionally use `jsonSchema()` rather than the zod
+ * `tool()` helper. Zod-typed `tool()` definitions with deeply nested schemas
+ * make the TS compiler instantiate excessively deep types (TS2589) and OOM,
+ * so we mirror the existing `aiTools.ts` pattern (plain JSON Schema + manually
+ * typed execute args).
+ */
+import { type ToolSet } from 'ai';
+import type { AssignmentToCreate, WorksheetToCreate, SectionToCreate, DocToCreate } from '../pipelines/aiLabChatContract.js';
+export interface LabProposals {
+    assignments: AssignmentToCreate[];
+    worksheets: WorksheetToCreate[];
+    sections: SectionToCreate[];
+    docs: DocToCreate[];
+}
+export declare function createLabProposals(): LabProposals;
+/**
+ * Build the set of proposal tools backed by the given accumulator.
+ * Merge these with the read-only RAG tools from `aiTools(classId)`.
+ */
+export declare function labProposalTools(proposals: LabProposals): ToolSet;
+//# sourceMappingURL=aiProposalTools.d.ts.map

package/dist/services/aiProposalTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiProposalTools.d.ts","sourceRoot":"/","sources":["services/aiProposalTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,IAAI,CAAC;AAE9C,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACZ,MAAM,mCAAmC,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,IAAI,EAAE,WAAW,EAAE,CAAC;CACrB;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD;AAuDD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAmLjE"}

package/dist/services/aiProposalTools.js

@@ -0,0 +1,207 @@
+/**
+ * Lab-chat "proposal" tools.
+ *
+ * In the agentic Lab pipeline the model produces create-actions by *calling
+ * tools* (e.g. `propose_assignment`) instead of returning a JSON blob. Each
+ * tool records a structured payload into a shared accumulator and returns a
+ * short confirmation so the model can keep narrating. After the stream ends
+ * the pipeline turns the accumulator into the `message.meta.*ToCreate` shape
+ * the frontend accept-cards already consume — so the data contract is
+ * preserved while the generation becomes genuine inline tool calls.
+ *
+ * NOTE: these tools intentionally use `jsonSchema()` rather than the zod
+ * `tool()` helper. Zod-typed `tool()` definitions with deeply nested schemas
+ * make the TS compiler instantiate excessively deep types (TS2589) and OOM,
+ * so we mirror the existing `aiTools.ts` pattern (plain JSON Schema + manually
+ * typed execute args).
+ */
+
+!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]="0c9ff67f-a8a4-5232-b858-905d3275b385")}catch(e){}}();
+import { jsonSchema } from 'ai';
+import { v4 } from 'uuid';
+export function createLabProposals() {
+    return { assignments: [], worksheets: [], sections: [], docs: [] };
+}
+function normalizeDueDate(input) {
+    if (input) {
+        const parsed = new Date(input);
+        if (!Number.isNaN(parsed.getTime()))
+            return parsed.toISOString();
+    }
+    // Default: one week out.
+    return new Date(Date.now() + 7 * 24 * 60 * 60 * 1000).toISOString();
+}
+const ASSIGNMENT_TYPES = [
+    'HOMEWORK', 'QUIZ', 'TEST', 'PROJECT', 'ESSAY', 'DISCUSSION', 'PRESENTATION', 'LAB', 'OTHER',
+];
+const QUESTION_TYPES = [
+    'MULTIPLE_CHOICE', 'TRUE_FALSE', 'SHORT_ANSWER', 'LONG_ANSWER', 'MATH_EXPRESSION', 'ESSAY',
+];
+/**
+ * Build the set of proposal tools backed by the given accumulator.
+ * Merge these with the read-only RAG tools from `aiTools(classId)`.
+ */
+export function labProposalTools(proposals) {
+    return {
+        propose_section: {
+            description: 'Propose a new section (folder) to organise class content. Call once per section you want to create.',
+            inputSchema: jsonSchema({
+                type: 'object',
+                properties: {
+                    name: { type: 'string', description: 'Section name' },
+                    color: { type: 'string', description: 'Optional hex color like #3b82f6' },
+                },
+                required: ['name'],
+            }),
+            execute: async ({ name, color }) => {
+                proposals.sections.push({ name, color: color ?? null });
+                return `Section "${name}" proposed.`;
+            },
+        },
+        propose_worksheet: {
+            description: 'Propose a worksheet of questions for the teacher to review and create. Include all questions in a single call.',
+            inputSchema: jsonSchema({
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Worksheet title' },
+                    questions: {
+                        type: 'array',
+                        description: 'The list of questions',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                type: { type: 'string', enum: QUESTION_TYPES },
+                                question: { type: 'string' },
+                                answer: { type: 'string' },
+                                options: {
+                                    type: 'array',
+                                    description: 'For MULTIPLE_CHOICE/TRUE_FALSE questions',
+                                    items: {
+                                        type: 'object',
+                                        properties: {
+                                            text: { type: 'string' },
+                                            isCorrect: { type: 'boolean' },
+                                        },
+                                        required: ['text', 'isCorrect'],
+                                    },
+                                },
+                                markScheme: {
+                                    type: 'array',
+                                    items: {
+                                        type: 'object',
+                                        properties: {
+                                            points: { type: 'number' },
+                                            description: { type: 'string' },
+                                        },
+                                        required: ['points', 'description'],
+                                    },
+                                },
+                                points: { type: 'number' },
+                            },
+                            required: ['type', 'question'],
+                        },
+                    },
+                },
+                required: ['title', 'questions'],
+            }),
+            execute: async ({ title, questions }) => {
+                const worksheet = {
+                    title,
+                    questions: (questions ?? []).map((q, index) => ({
+                        type: q.type,
+                        question: q.question,
+                        answer: q.answer ?? '',
+                        options: (q.options ?? []).map((o) => ({
+                            id: v4(),
+                            text: o.text,
+                            isCorrect: o.isCorrect,
+                        })),
+                        markScheme: (q.markScheme ?? []).map((m) => ({
+                            id: v4(),
+                            points: m.points,
+                            description: m.description,
+                        })),
+                        points: q.points ?? 0,
+                        order: index,
+                    })),
+                };
+                proposals.worksheets.push(worksheet);
+                return `Worksheet "${title}" with ${worksheet.questions.length} question(s) proposed.`;
+            },
+        },
+        propose_assignment: {
+            description: 'Propose an assignment for the teacher to review and create. Call once per assignment.',
+            inputSchema: jsonSchema({
+                type: 'object',
+                properties: {
+                    title: { type: 'string' },
+                    instructions: { type: 'string' },
+                    dueDate: {
+                        type: 'string',
+                        description: 'ISO 8601 datetime. Defaults to one week from now if omitted.',
+                    },
+                    type: { type: 'string', enum: ASSIGNMENT_TYPES },
+                    maxGrade: { type: 'number' },
+                    acceptFiles: { type: 'boolean' },
+                    acceptExtendedResponse: { type: 'boolean' },
+                    acceptWorksheet: { type: 'boolean' },
+                },
+                required: ['title', 'instructions'],
+            }),
+            execute: async ({ title, instructions, dueDate, type, maxGrade, acceptFiles, acceptExtendedResponse, acceptWorksheet, }) => {
+                const assignment = {
+                    title,
+                    instructions,
+                    dueDate: normalizeDueDate(dueDate),
+                    type: type ?? 'HOMEWORK',
+                    maxGrade: maxGrade ?? 100,
+                    acceptFiles: acceptFiles ?? true,
+                    acceptExtendedResponse: acceptExtendedResponse ?? false,
+                    acceptWorksheet: acceptWorksheet ?? false,
+                    gradingBoundaryId: null,
+                    markSchemeId: null,
+                    worksheetIds: [],
+                    studentIds: [],
+                    sectionId: null,
+                    attachments: [],
+                };
+                proposals.assignments.push(assignment);
+                return `Assignment "${title}" proposed.`;
+            },
+        },
+        generate_document: {
+            description: 'Generate a downloadable file and attach it to this message. You are NOT limited to PDF — pick the best format for the request (pptx for slides/presentations, xlsx/csv for data, docx for editable handouts, pdf for print-ready docs, png for diagrams, etc.). Always set format explicitly.',
+            inputSchema: jsonSchema({
+                type: 'object',
+                properties: {
+                    title: { type: 'string', description: 'Document title' },
+                    content: {
+                        type: 'string',
+                        description: 'Full body — markdown or plain text with headings, lists, tables, slide notes, etc.',
+                    },
+                    format: {
+                        type: 'string',
+                        description: 'Output file type. REQUIRED. pptx=slides/presentation, xlsx/csv=spreadsheet/data, docx=Word handout, pdf=printable doc, md/txt/html=text, png/jpeg/gif=image, py/js/ts=code.',
+                        enum: [
+                            'pdf', 'docx', 'doc', 'xlsx', 'pptx', 'csv', 'md', 'html', 'txt',
+                            'json', 'xml', 'tex', 'png', 'jpeg', 'jpg', 'gif', 'zip', 'tar',
+                            'py', 'js', 'ts', 'css', 'sh',
+                        ],
+                    },
+                },
+                required: ['title', 'content', 'format'],
+            }),
+            execute: async ({ title, content, format }) => {
+                proposals.docs.push({
+                    title,
+                    content: content.trim(),
+                    format: (format ?? 'pdf'),
+                });
+                const ext = (format ?? 'pdf').toUpperCase();
+                return `Document "${title}" queued for ${ext} generation.`;
+            },
+        },
+    };
+}
+//# sourceMappingURL=aiProposalTools.js.map
+//# debugId=0c9ff67f-a8a4-5232-b858-905d3275b385

package/dist/services/aiProposalTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiProposalTools.js","sources":["services/aiProposalTools.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Lab-chat \"proposal\" tools.\n *\n * In the agentic Lab pipeline the model produces create-actions by *calling\n * tools* (e.g. `propose_assignment`) instead of returning a JSON blob. Each\n * tool records a structured payload into a shared accumulator and returns a\n * short confirmation so the model can keep narrating. After the stream ends\n * the pipeline turns the accumulator into the `message.meta.*ToCreate` shape\n * the frontend accept-cards already consume — so the data contract is\n * preserved while the generation becomes genuine inline tool calls.\n *\n * NOTE: these tools intentionally use `jsonSchema()` rather than the zod\n * `tool()` helper. Zod-typed `tool()` definitions with deeply nested schemas\n * make the TS compiler instantiate excessively deep types (TS2589) and OOM,\n * so we mirror the existing `aiTools.ts` pattern (plain JSON Schema + manually\n * typed execute args).\n */\nimport { jsonSchema, type ToolSet } from 'ai';\nimport { v4 } from 'uuid';\nimport type {\n  AssignmentToCreate,\n  WorksheetToCreate,\n  SectionToCreate,\n  DocToCreate,\n} from '../pipelines/aiLabChatContract.js';\n\nexport interface LabProposals {\n  assignments: AssignmentToCreate[];\n  worksheets: WorksheetToCreate[];\n  sections: SectionToCreate[];\n  docs: DocToCreate[];\n}\n\nexport function createLabProposals(): LabProposals {\n  return { assignments: [], worksheets: [], sections: [], docs: [] };\n}\n\nfunction normalizeDueDate(input?: string | null): string {\n  if (input) {\n    const parsed = new Date(input);\n    if (!Number.isNaN(parsed.getTime())) return parsed.toISOString();\n  }\n  // Default: one week out.\n  return new Date(Date.now() + 7 * 24 * 60 * 60 * 1000).toISOString();\n}\n\nconst ASSIGNMENT_TYPES = [\n  'HOMEWORK', 'QUIZ', 'TEST', 'PROJECT', 'ESSAY', 'DISCUSSION', 'PRESENTATION', 'LAB', 'OTHER',\n] as const;\ntype AssignmentType = (typeof ASSIGNMENT_TYPES)[number];\n\nconst QUESTION_TYPES = [\n  'MULTIPLE_CHOICE', 'TRUE_FALSE', 'SHORT_ANSWER', 'LONG_ANSWER', 'MATH_EXPRESSION', 'ESSAY',\n] as const;\ntype QuestionType = (typeof QUESTION_TYPES)[number];\n\ninterface ProposeSectionArgs {\n  name: string;\n  color?: string | null;\n}\n\ninterface ProposeWorksheetArgs {\n  title: string;\n  questions: Array<{\n    type: QuestionType;\n    question: string;\n    answer?: string;\n    options?: Array<{ text: string; isCorrect: boolean }>;\n    markScheme?: Array<{ points: number; description: string }>;\n    points?: number;\n  }>;\n}\n\ninterface ProposeAssignmentArgs {\n  title: string;\n  instructions: string;\n  dueDate?: string;\n  type?: AssignmentType;\n  maxGrade?: number;\n  acceptFiles?: boolean;\n  acceptExtendedResponse?: boolean;\n  acceptWorksheet?: boolean;\n}\n\ninterface GenerateDocumentArgs {\n  title: string;\n  content: string;\n  format?: string;\n}\n\n/**\n * Build the set of proposal tools backed by the given accumulator.\n * Merge these with the read-only RAG tools from `aiTools(classId)`.\n */\nexport function labProposalTools(proposals: LabProposals): ToolSet {\n  return {\n    propose_section: {\n      description:\n        'Propose a new section (folder) to organise class content. Call once per section you want to create.',\n      inputSchema: jsonSchema({\n        type: 'object',\n        properties: {\n          name: { type: 'string', description: 'Section name' },\n          color: { type: 'string', description: 'Optional hex color like #3b82f6' },\n        },\n        required: ['name'],\n      }),\n      execute: async ({ name, color }: ProposeSectionArgs) => {\n        proposals.sections.push({ name, color: color ?? null });\n        return `Section \"${name}\" proposed.`;\n      },\n    },\n\n    propose_worksheet: {\n      description:\n        'Propose a worksheet of questions for the teacher to review and create. Include all questions in a single call.',\n      inputSchema: jsonSchema({\n        type: 'object',\n        properties: {\n          title: { type: 'string', description: 'Worksheet title' },\n          questions: {\n            type: 'array',\n            description: 'The list of questions',\n            items: {\n              type: 'object',\n              properties: {\n                type: { type: 'string', enum: QUESTION_TYPES as unknown as string[] },\n                question: { type: 'string' },\n                answer: { type: 'string' },\n                options: {\n                  type: 'array',\n                  description: 'For MULTIPLE_CHOICE/TRUE_FALSE questions',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      text: { type: 'string' },\n                      isCorrect: { type: 'boolean' },\n                    },\n                    required: ['text', 'isCorrect'],\n                  },\n                },\n                markScheme: {\n                  type: 'array',\n                  items: {\n                    type: 'object',\n                    properties: {\n                      points: { type: 'number' },\n                      description: { type: 'string' },\n                    },\n                    required: ['points', 'description'],\n                  },\n                },\n                points: { type: 'number' },\n              },\n              required: ['type', 'question'],\n            },\n          },\n        },\n        required: ['title', 'questions'],\n      }),\n      execute: async ({ title, questions }: ProposeWorksheetArgs) => {\n        const worksheet: WorksheetToCreate = {\n          title,\n          questions: (questions ?? []).map((q, index) => ({\n            type: q.type,\n            question: q.question,\n            answer: q.answer ?? '',\n            options: (q.options ?? []).map((o) => ({\n              id: v4(),\n              text: o.text,\n              isCorrect: o.isCorrect,\n            })),\n            markScheme: (q.markScheme ?? []).map((m) => ({\n              id: v4(),\n              points: m.points,\n              description: m.description,\n            })),\n            points: q.points ?? 0,\n            order: index,\n          })),\n        };\n        proposals.worksheets.push(worksheet);\n        return `Worksheet \"${title}\" with ${worksheet.questions.length} question(s) proposed.`;\n      },\n    },\n\n    propose_assignment: {\n      description:\n        'Propose an assignment for the teacher to review and create. Call once per assignment.',\n      inputSchema: jsonSchema({\n        type: 'object',\n        properties: {\n          title: { type: 'string' },\n          instructions: { type: 'string' },\n          dueDate: {\n            type: 'string',\n            description: 'ISO 8601 datetime. Defaults to one week from now if omitted.',\n          },\n          type: { type: 'string', enum: ASSIGNMENT_TYPES as unknown as string[] },\n          maxGrade: { type: 'number' },\n          acceptFiles: { type: 'boolean' },\n          acceptExtendedResponse: { type: 'boolean' },\n          acceptWorksheet: { type: 'boolean' },\n        },\n        required: ['title', 'instructions'],\n      }),\n      execute: async ({\n        title,\n        instructions,\n        dueDate,\n        type,\n        maxGrade,\n        acceptFiles,\n        acceptExtendedResponse,\n        acceptWorksheet,\n      }: ProposeAssignmentArgs) => {\n        const assignment: AssignmentToCreate = {\n          title,\n          instructions,\n          dueDate: normalizeDueDate(dueDate),\n          type: type ?? 'HOMEWORK',\n          maxGrade: maxGrade ?? 100,\n          acceptFiles: acceptFiles ?? true,\n          acceptExtendedResponse: acceptExtendedResponse ?? false,\n          acceptWorksheet: acceptWorksheet ?? false,\n          gradingBoundaryId: null,\n          markSchemeId: null,\n          worksheetIds: [],\n          studentIds: [],\n          sectionId: null,\n          attachments: [],\n        };\n        proposals.assignments.push(assignment);\n        return `Assignment \"${title}\" proposed.`;\n      },\n    },\n\n    generate_document: {\n      description:\n        'Generate a downloadable file and attach it to this message. You are NOT limited to PDF — pick the best format for the request (pptx for slides/presentations, xlsx/csv for data, docx for editable handouts, pdf for print-ready docs, png for diagrams, etc.). Always set format explicitly.',\n      inputSchema: jsonSchema({\n        type: 'object',\n        properties: {\n          title: { type: 'string', description: 'Document title' },\n          content: {\n            type: 'string',\n            description:\n              'Full body — markdown or plain text with headings, lists, tables, slide notes, etc.',\n          },\n          format: {\n            type: 'string',\n            description:\n              'Output file type. REQUIRED. pptx=slides/presentation, xlsx/csv=spreadsheet/data, docx=Word handout, pdf=printable doc, md/txt/html=text, png/jpeg/gif=image, py/js/ts=code.',\n            enum: [\n              'pdf', 'docx', 'doc', 'xlsx', 'pptx', 'csv', 'md', 'html', 'txt',\n              'json', 'xml', 'tex', 'png', 'jpeg', 'jpg', 'gif', 'zip', 'tar',\n              'py', 'js', 'ts', 'css', 'sh',\n            ],\n          },\n        },\n        required: ['title', 'content', 'format'],\n      }),\n      execute: async ({ title, content, format }: GenerateDocumentArgs) => {\n        proposals.docs.push({\n          title,\n          content: content.trim(),\n          format: (format ?? 'pdf') as DocToCreate['format'],\n        });\n        const ext = (format ?? 'pdf').toUpperCase();\n        return `Document \"${title}\" queued for ${ext} generation.`;\n      },\n    },\n  };\n}\n"],"names":[],"mappings":"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","debug_id":"0c9ff67f-a8a4-5232-b858-905d3275b385"}

package/dist/services/aiStream.d.ts

@@ -0,0 +1,22 @@
+/**
+ * AI Streaming service – handles streamed AI responses with tool calls.
+ * Uses Vercel AI SDK for streaming and Redis for temporary chunk caching.
+ */
+import { type ModelMessage } from 'ai';
+export interface StreamOptions {
+    conversationId: string;
+    aiMessageId: string;
+    messages: ModelMessage[];
+    systemPrompt: string;
+    classId?: string;
+    enableTools?: boolean;
+    model?: string;
+    temperature?: number;
+    maxOutputTokens?: number;
+}
+/**
+ * Stream an AI response, broadcasting chunks via Pusher and caching in Redis.
+ * On completion, persists the full response to the database.
+ */
+export declare function streamAIResponse(options: StreamOptions): Promise<void>;
+//# sourceMappingURL=aiStream.d.ts.map

package/dist/services/aiStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiStream.d.ts","sourceRoot":"/","sources":["services/aiStream.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,IAAI,CAAC;AAahE,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA6I5E"}