@studious-lms/server 1.13.0 → 1.14.0

package/dist/services/adminInstitution.d.ts

@@ -10,13 +10,13 @@ export declare function listSchoolsForAdmin(input: {
             classes: number;
         };
     } & {
-        name: string;
         id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        name: string;
         description: string | null;
         logoId: string | null;
         subdomain: string | null;
-        createdAt: Date;
-        updatedAt: Date;
     })[];
     total: number;
     page: number;
@@ -30,8 +30,8 @@ export declare function listDepartmentsForAdmin(input: {
 }): Promise<{
     items: ({
         school: {
-            name: string;
             id: string;
+            name: string;
             subdomain: string | null;
         };
         _count: {
@@ -39,12 +39,12 @@ export declare function listDepartmentsForAdmin(input: {
             members: number;
         };
     } & {
-        name: string;
         id: string;
-        description: string | null;
         createdAt: Date;
         updatedAt: Date;
+        name: string;
         schoolId: string;
+        description: string | null;
         color: string | null;
     })[];
     total: number;
@@ -61,10 +61,10 @@ export declare function listSchoolDevelopmentProgramsForAdmin(input: {
     items: {
         type: string;
         status: string;
-        name: string;
         id: string;
-        submittedAt: Date | null;
         website: string | null;
+        name: string;
+        submittedAt: Date | null;
         address: string;
         city: string;
         country: string;

package/dist/services/adminRunJob.d.ts

@@ -11,13 +11,13 @@ export declare function listRunJobsForAdmin(input: {
         status: import(".prisma/client").$Enums.RunJobStatus;
         result: Prisma.JsonValue | null;
         id: string;
+        userId: string | null;
         createdAt: Date;
         updatedAt: Date;
-        userId: string | null;
         classId: string | null;
         input: Prisma.JsonValue;
-        attempts: number;
         bullJobId: string | null;
+        attempts: number;
         startedAt: Date | null;
         finishedAt: Date | null;
     }[];
@@ -32,13 +32,13 @@ export declare function getRunJobForAdmin(id: string): Promise<{
     status: import(".prisma/client").$Enums.RunJobStatus;
     result: Prisma.JsonValue | null;
     id: string;
+    userId: string | null;
     createdAt: Date;
     updatedAt: Date;
-    userId: string | null;
     classId: string | null;
     input: Prisma.JsonValue;
-    attempts: number;
     bullJobId: string | null;
+    attempts: number;
     startedAt: Date | null;
     finishedAt: Date | null;
 }>;

package/dist/services/agenda.d.ts

@@ -3,12 +3,12 @@ export declare function getAgenda(userId: string, weekStart: string): Promise<{
     events: {
         personal: ({
             class: {
-                name: string;
+                section: string;
                 id: string;
+                name: string;
                 schoolId: string | null;
-                subject: string;
                 color: string | null;
-                section: string;
+                subject: string;
                 syllabus: string | null;
                 departmentId: string | null;
                 discussionsEnabled: boolean;
@@ -20,10 +20,12 @@ export declare function getAgenda(userId: string, weekStart: string): Promise<{
                 id: string;
                 createdAt: Date | null;
                 classId: string;
-                modifiedAt: Date | null;
                 title: string;
-                instructions: string;
                 dueDate: Date;
+                maxGrade: number | null;
+                eventId: string | null;
+                instructions: string;
+                modifiedAt: Date | null;
                 teacherId: string;
                 acceptFiles: boolean;
                 acceptExtendedResponse: boolean;
@@ -32,34 +34,32 @@ export declare function getAgenda(userId: string, weekStart: string): Promise<{
                 aiPolicyLevel: number;
                 sectionId: string | null;
                 graded: boolean;
-                maxGrade: number | null;
                 weight: number;
                 inProgress: boolean;
                 template: boolean;
-                eventId: string | null;
                 markSchemeId: string | null;
                 order: number | null;
                 gradingBoundaryId: string | null;
             }[];
         } & {
-            name: string | null;
             id: string;
             userId: string | null;
+            location: string | null;
+            name: string | null;
             color: string | null;
             classId: string | null;
             startTime: Date;
             endTime: Date;
-            location: string | null;
             remarks: string | null;
         })[];
         class: ({
             class: {
-                name: string;
+                section: string;
                 id: string;
+                name: string;
                 schoolId: string | null;
-                subject: string;
                 color: string | null;
-                section: string;
+                subject: string;
                 syllabus: string | null;
                 departmentId: string | null;
                 discussionsEnabled: boolean;
@@ -71,10 +71,12 @@ export declare function getAgenda(userId: string, weekStart: string): Promise<{
                 id: string;
                 createdAt: Date | null;
                 classId: string;
-                modifiedAt: Date | null;
                 title: string;
-                instructions: string;
                 dueDate: Date;
+                maxGrade: number | null;
+                eventId: string | null;
+                instructions: string;
+                modifiedAt: Date | null;
                 teacherId: string;
                 acceptFiles: boolean;
                 acceptExtendedResponse: boolean;
@@ -83,24 +85,22 @@ export declare function getAgenda(userId: string, weekStart: string): Promise<{
                 aiPolicyLevel: number;
                 sectionId: string | null;
                 graded: boolean;
-                maxGrade: number | null;
                 weight: number;
                 inProgress: boolean;
                 template: boolean;
-                eventId: string | null;
                 markSchemeId: string | null;
                 order: number | null;
                 gradingBoundaryId: string | null;
             }[];
         } & {
-            name: string | null;
             id: string;
             userId: string | null;
+            location: string | null;
+            name: string | null;
             color: string | null;
             classId: string | null;
             startTime: Date;
             endTime: Date;
-            location: string | null;
             remarks: string | null;
         })[];
     };

package/dist/services/aiChatStream.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Shared AI chat streaming helper.
+ *
+ * Runs a genuine token-by-token stream via the Vercel AI SDK (`streamText`)
+ * against OpenAI — the same provider the rest of the app's inference uses
+ * (`OPENAI_API_KEY`). Real text tokens are broadcast over Pusher as they are
+ * produced, and real tool calls are broadcast inline (in the order the model
+ * invokes them) instead of being derived after the fact from a JSON blob.
+ *
+ * Callers own persistence: this helper returns the accumulated text and the
+ * ordered tool calls so the pipeline can write `content`/`meta` and emit the
+ * terminal `message-stream-complete` / `message-updated` events.
+ */
+import { type ModelMessage, type ToolSet } from 'ai';
+/** Default streaming model — matches the existing streamAIResponse path. */
+export declare const DEFAULT_STREAM_MODEL = "gpt-4o-mini";
+export interface StreamedToolCall {
+    toolName: string;
+    /** Args the model passed to the tool. */
+    input: unknown;
+    /** Value the tool returned (undefined for client-side / no-result tools). */
+    output?: unknown;
+    status: 'completed' | 'failed';
+}
+/**
+ * An ordered fragment of an AI message. The message is a sequence of these
+ * parts in the exact order the model produced them, so a tool call rendered
+ * "between paragraph 1 and 2" is represented as
+ * `[{text}, {tool}, {text}]` — enabling true inline rendering (and reload
+ * persistence) instead of text and tool calls living in separate buckets.
+ */
+export type StreamPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'tool';
+    toolCallId: string;
+    toolName: string;
+    /** Concrete entity label (e.g. assignment title / search query), if any. */
+    title?: string;
+    status: 'executing' | 'completed' | 'failed';
+};
+export interface StreamChatOptions {
+    conversationId: string;
+    aiMessageId: string;
+    system: string;
+    messages: ModelMessage[];
+    tools?: ToolSet;
+    model?: string;
+    temperature?: number;
+    maxOutputTokens?: number;
+    /** Max agent steps (tool round-trips). Defaults to 6. */
+    maxSteps?: number;
+}
+export interface StreamChatResult {
+    text: string;
+    toolCalls: StreamedToolCall[];
+    /** Ordered text/tool parts, in the exact order the model produced them. */
+    parts: StreamPart[];
+}
+/**
+ * Stream a chat completion, broadcasting real text chunks and tool-call
+ * events over Pusher. Does NOT persist the message or emit the terminal
+ * stream-complete event — the caller does that once it has assembled the
+ * final `content`/`meta` (e.g. PDF attachments, structured proposals).
+ */
+export declare function streamChatResponse(options: StreamChatOptions): Promise<StreamChatResult>;
+//# sourceMappingURL=aiChatStream.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aiChatStream.d.ts","sourceRoot":"/","sources":["services/aiChatStream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAA2B,KAAK,YAAY,EAAE,KAAK,OAAO,EAAE,MAAM,IAAI,CAAC;AAS9E,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAElD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,6EAA6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;CAChC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IACE,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;CAC9C,CAAC;AAcN,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,2EAA2E;IAC3E,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CA8H3B"}

package/dist/services/aiChatStream.js

@@ -0,0 +1,157 @@
+/**
+ * Shared AI chat streaming helper.
+ *
+ * Runs a genuine token-by-token stream via the Vercel AI SDK (`streamText`)
+ * against OpenAI — the same provider the rest of the app's inference uses
+ * (`OPENAI_API_KEY`). Real text tokens are broadcast over Pusher as they are
+ * produced, and real tool calls are broadcast inline (in the order the model
+ * invokes them) instead of being derived after the fact from a JSON blob.
+ *
+ * Callers own persistence: this helper returns the accumulated text and the
+ * ordered tool calls so the pipeline can write `content`/`meta` and emit the
+ * terminal `message-stream-complete` / `message-updated` events.
+ */
+
+!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]="53e385f3-8180-59f0-9c1b-b89457a29317")}catch(e){}}();
+import { streamText, stepCountIs } from 'ai';
+import { openai } from '@ai-sdk/openai';
+import { getRedis } from '../lib/redis.js';
+import { pusher, chatChannel } from '../lib/pusher.js';
+import { logger } from '../utils/logger.js';
+const STREAM_REDIS_TTL = 600; // 10 minutes
+const STREAM_KEY_PREFIX = 'stream:';
+/** Default streaming model — matches the existing streamAIResponse path. */
+export const DEFAULT_STREAM_MODEL = 'gpt-4o-mini';
+/** Pull a human-meaningful label out of a tool's input args, if present. */
+function toolTitleFromInput(input) {
+    if (input && typeof input === 'object') {
+        const obj = input;
+        for (const key of ['title', 'name', 'query']) {
+            const val = obj[key];
+            if (typeof val === 'string' && val.trim())
+                return val.trim();
+        }
+    }
+    return undefined;
+}
+/**
+ * Stream a chat completion, broadcasting real text chunks and tool-call
+ * events over Pusher. Does NOT persist the message or emit the terminal
+ * stream-complete event — the caller does that once it has assembled the
+ * final `content`/`meta` (e.g. PDF attachments, structured proposals).
+ */
+export async function streamChatResponse(options) {
+    const { conversationId, aiMessageId, system, messages, tools, model = DEFAULT_STREAM_MODEL, temperature = 0.7, maxOutputTokens = 4096, maxSteps = 6, } = options;
+    const redis = getRedis();
+    const streamKey = `${STREAM_KEY_PREFIX}${aiMessageId}`;
+    if (redis) {
+        await redis.set(streamKey, '', 'EX', STREAM_REDIS_TTL);
+    }
+    let fullText = '';
+    const parts = [];
+    const toolCalls = [];
+    // Map AI SDK toolCallId -> index in `parts` so the executing indicator can
+    // be flipped to completed/failed in place (preserving its position).
+    const toolPartIndexById = new Map();
+    const appendText = (text) => {
+        fullText += text;
+        const last = parts[parts.length - 1];
+        if (last && last.type === 'text') {
+            last.text += text;
+        }
+        else {
+            parts.push({ type: 'text', text });
+        }
+    };
+    const broadcast = async (event, payload) => {
+        try {
+            await pusher.trigger(chatChannel(conversationId), event, payload);
+        }
+        catch (err) {
+            logger.warn(`Failed to broadcast ${event}`, { err, aiMessageId });
+        }
+    };
+    try {
+        const result = streamText({
+            model: openai(model),
+            system,
+            messages,
+            ...(tools ? { tools } : {}),
+            temperature,
+            maxOutputTokens,
+            stopWhen: stepCountIs(maxSteps),
+        });
+        // `fullStream` yields text deltas AND tool events in a single, correctly
+        // ordered sequence — this is what makes inline tool calls possible. We
+        // build an ordered `parts` list and broadcast each event as it happens.
+        for await (const part of result.fullStream) {
+            switch (part.type) {
+                case 'text-delta': {
+                    appendText(part.text);
+                    if (redis) {
+                        await redis.append(streamKey, part.text).catch(() => { });
+                    }
+                    await broadcast('message-stream-chunk', {
+                        messageId: aiMessageId,
+                        chunk: part.text,
+                    });
+                    break;
+                }
+                case 'tool-call': {
+                    const title = toolTitleFromInput(part.input);
+                    toolPartIndexById.set(part.toolCallId, parts.length);
+                    parts.push({
+                        type: 'tool',
+                        toolCallId: part.toolCallId,
+                        toolName: part.toolName,
+                        ...(title ? { title } : {}),
+                        status: 'executing',
+                    });
+                    await broadcast('message-tool-call', {
+                        messageId: aiMessageId,
+                        toolCallId: part.toolCallId,
+                        toolName: part.toolName,
+                        ...(title ? { title } : {}),
+                        status: 'executing',
+                    });
+                    break;
+                }
+                case 'tool-result':
+                case 'tool-error': {
+                    const status = part.type === 'tool-error' ? 'failed' : 'completed';
+                    const idx = toolPartIndexById.get(part.toolCallId);
+                    if (idx !== undefined) {
+                        const existing = parts[idx];
+                        if (existing && existing.type === 'tool')
+                            existing.status = status;
+                    }
+                    toolCalls.push({
+                        toolName: part.toolName,
+                        input: part.input,
+                        output: part.type === 'tool-result' ? part.output : undefined,
+                        status,
+                    });
+                    await broadcast('message-tool-call', {
+                        messageId: aiMessageId,
+                        toolCallId: part.toolCallId,
+                        toolName: part.toolName,
+                        ...(toolTitleFromInput(part.input) ? { title: toolTitleFromInput(part.input) } : {}),
+                        status,
+                    });
+                    break;
+                }
+                default:
+                    // ignore reasoning/source/step/finish/raw parts
+                    break;
+            }
+        }
+        return { text: fullText, toolCalls, parts };
+    }
+    finally {
+        if (redis) {
+            await redis.del(streamKey).catch(() => { });
+        }
+    }
+}
+//# sourceMappingURL=aiChatStream.js.map
+//# debugId=53e385f3-8180-59f0-9c1b-b89457a29317

package/dist/services/aiChatStream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiChatStream.js","sources":["services/aiChatStream.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Shared AI chat streaming helper.\n *\n * Runs a genuine token-by-token stream via the Vercel AI SDK (`streamText`)\n * against OpenAI — the same provider the rest of the app's inference uses\n * (`OPENAI_API_KEY`). Real text tokens are broadcast over Pusher as they are\n * produced, and real tool calls are broadcast inline (in the order the model\n * invokes them) instead of being derived after the fact from a JSON blob.\n *\n * Callers own persistence: this helper returns the accumulated text and the\n * ordered tool calls so the pipeline can write `content`/`meta` and emit the\n * terminal `message-stream-complete` / `message-updated` events.\n */\nimport { streamText, stepCountIs, type ModelMessage, type ToolSet } from 'ai';\nimport { openai } from '@ai-sdk/openai';\nimport { getRedis } from '../lib/redis.js';\nimport { pusher, chatChannel } from '../lib/pusher.js';\nimport { logger } from '../utils/logger.js';\n\nconst STREAM_REDIS_TTL = 600; // 10 minutes\nconst STREAM_KEY_PREFIX = 'stream:';\n\n/** Default streaming model — matches the existing streamAIResponse path. */\nexport const DEFAULT_STREAM_MODEL = 'gpt-4o-mini';\n\nexport interface StreamedToolCall {\n  toolName: string;\n  /** Args the model passed to the tool. */\n  input: unknown;\n  /** Value the tool returned (undefined for client-side / no-result tools). */\n  output?: unknown;\n  status: 'completed' | 'failed';\n}\n\n/**\n * An ordered fragment of an AI message. The message is a sequence of these\n * parts in the exact order the model produced them, so a tool call rendered\n * \"between paragraph 1 and 2\" is represented as\n * `[{text}, {tool}, {text}]` — enabling true inline rendering (and reload\n * persistence) instead of text and tool calls living in separate buckets.\n */\nexport type StreamPart =\n  | { type: 'text'; text: string }\n  | {\n      type: 'tool';\n      toolCallId: string;\n      toolName: string;\n      /** Concrete entity label (e.g. assignment title / search query), if any. */\n      title?: string;\n      status: 'executing' | 'completed' | 'failed';\n    };\n\n/** Pull a human-meaningful label out of a tool's input args, if present. */\nfunction toolTitleFromInput(input: unknown): string | undefined {\n  if (input && typeof input === 'object') {\n    const obj = input as Record<string, unknown>;\n    for (const key of ['title', 'name', 'query'] as const) {\n      const val = obj[key];\n      if (typeof val === 'string' && val.trim()) return val.trim();\n    }\n  }\n  return undefined;\n}\n\nexport interface StreamChatOptions {\n  conversationId: string;\n  aiMessageId: string;\n  system: string;\n  messages: ModelMessage[];\n  tools?: ToolSet;\n  model?: string;\n  temperature?: number;\n  maxOutputTokens?: number;\n  /** Max agent steps (tool round-trips). Defaults to 6. */\n  maxSteps?: number;\n}\n\nexport interface StreamChatResult {\n  text: string;\n  toolCalls: StreamedToolCall[];\n  /** Ordered text/tool parts, in the exact order the model produced them. */\n  parts: StreamPart[];\n}\n\n/**\n * Stream a chat completion, broadcasting real text chunks and tool-call\n * events over Pusher. Does NOT persist the message or emit the terminal\n * stream-complete event — the caller does that once it has assembled the\n * final `content`/`meta` (e.g. PDF attachments, structured proposals).\n */\nexport async function streamChatResponse(\n  options: StreamChatOptions,\n): Promise<StreamChatResult> {\n  const {\n    conversationId,\n    aiMessageId,\n    system,\n    messages,\n    tools,\n    model = DEFAULT_STREAM_MODEL,\n    temperature = 0.7,\n    maxOutputTokens = 4096,\n    maxSteps = 6,\n  } = options;\n\n  const redis = getRedis();\n  const streamKey = `${STREAM_KEY_PREFIX}${aiMessageId}`;\n  if (redis) {\n    await redis.set(streamKey, '', 'EX', STREAM_REDIS_TTL);\n  }\n\n  let fullText = '';\n  const parts: StreamPart[] = [];\n  const toolCalls: StreamedToolCall[] = [];\n  // Map AI SDK toolCallId -> index in `parts` so the executing indicator can\n  // be flipped to completed/failed in place (preserving its position).\n  const toolPartIndexById = new Map<string, number>();\n\n  const appendText = (text: string) => {\n    fullText += text;\n    const last = parts[parts.length - 1];\n    if (last && last.type === 'text') {\n      last.text += text;\n    } else {\n      parts.push({ type: 'text', text });\n    }\n  };\n\n  const broadcast = async (event: string, payload: Record<string, unknown>) => {\n    try {\n      await pusher.trigger(chatChannel(conversationId), event, payload);\n    } catch (err) {\n      logger.warn(`Failed to broadcast ${event}`, { err, aiMessageId });\n    }\n  };\n\n  try {\n    const result = streamText({\n      model: openai(model),\n      system,\n      messages,\n      ...(tools ? { tools } : {}),\n      temperature,\n      maxOutputTokens,\n      stopWhen: stepCountIs(maxSteps),\n    });\n\n    // `fullStream` yields text deltas AND tool events in a single, correctly\n    // ordered sequence — this is what makes inline tool calls possible. We\n    // build an ordered `parts` list and broadcast each event as it happens.\n    for await (const part of result.fullStream) {\n      switch (part.type) {\n        case 'text-delta': {\n          appendText(part.text);\n          if (redis) {\n            await redis.append(streamKey, part.text).catch(() => {});\n          }\n          await broadcast('message-stream-chunk', {\n            messageId: aiMessageId,\n            chunk: part.text,\n          });\n          break;\n        }\n        case 'tool-call': {\n          const title = toolTitleFromInput(part.input);\n          toolPartIndexById.set(part.toolCallId, parts.length);\n          parts.push({\n            type: 'tool',\n            toolCallId: part.toolCallId,\n            toolName: part.toolName,\n            ...(title ? { title } : {}),\n            status: 'executing',\n          });\n          await broadcast('message-tool-call', {\n            messageId: aiMessageId,\n            toolCallId: part.toolCallId,\n            toolName: part.toolName,\n            ...(title ? { title } : {}),\n            status: 'executing',\n          });\n          break;\n        }\n        case 'tool-result':\n        case 'tool-error': {\n          const status: 'completed' | 'failed' =\n            part.type === 'tool-error' ? 'failed' : 'completed';\n          const idx = toolPartIndexById.get(part.toolCallId);\n          if (idx !== undefined) {\n            const existing = parts[idx];\n            if (existing && existing.type === 'tool') existing.status = status;\n          }\n          toolCalls.push({\n            toolName: part.toolName,\n            input: part.input,\n            output: part.type === 'tool-result' ? part.output : undefined,\n            status,\n          });\n          await broadcast('message-tool-call', {\n            messageId: aiMessageId,\n            toolCallId: part.toolCallId,\n            toolName: part.toolName,\n            ...(toolTitleFromInput(part.input) ? { title: toolTitleFromInput(part.input) } : {}),\n            status,\n          });\n          break;\n        }\n        default:\n          // ignore reasoning/source/step/finish/raw parts\n          break;\n      }\n    }\n\n    return { text: fullText, toolCalls, parts };\n  } finally {\n    if (redis) {\n      await redis.del(streamKey).catch(() => {});\n    }\n  }\n}\n"],"names":[],"mappings":"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","debug_id":"53e385f3-8180-59f0-9c1b-b89457a29317"}

package/dist/services/aiModifierTools.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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.
+ */
+import { type ToolSet } from 'ai';
+/** A single field write that was applied to a resource. */
+export interface ModifierFieldUpdate {
+    field: string;
+    value: unknown;
+    /** Human-readable label for the change, e.g. "title" or "due date". */
+    label: string;
+}
+/**
+ * Build the field-update tool for an assignment. The `onFieldUpdate` callback
+ * runs after a successful persist so the route can broadcast the change.
+ */
+export declare function assignmentModifierTools(userId: string, assignmentId: string, classId: string, onFieldUpdate: (update: ModifierFieldUpdate) => Promise<void> | void): ToolSet;
+/** Build the field-update tool for a worksheet. */
+export declare function worksheetModifierTools(worksheetId: string, userId: string, onFieldUpdate: (update: ModifierFieldUpdate) => Promise<void> | void): ToolSet;
+//# sourceMappingURL=aiModifierTools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aiModifierTools.d.ts","sourceRoot":"/","sources":["services/aiModifierTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,IAAI,CAAC;AAI9C,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;CACf;AAkED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GACnE,OAAO,CA+CT;AAED,mDAAmD;AACnD,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GACnE,OAAO,CAgCT"}

package/dist/services/aiModifierTools.js

@@ -0,0 +1,165 @@
+/**
+ * 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]="d1f30ff9-5af3-5e92-b758-96498a1a819d")}catch(e){}}();
+import { jsonSchema } from 'ai';
+import { updateAssignmentRecord } from './assignment.js';
+import { 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' },
+};
+/** 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}.`;
+            },
+        },
+    };
+}
+//# sourceMappingURL=aiModifierTools.js.map
+//# debugId=d1f30ff9-5af3-5e92-b758-96498a1a819d