@studious-lms/server 1.16.0 → 1.17.0

package/dist/services/newtonChat.js.map

@@ -1 +1 @@
-{"version":3,"file":"newtonChat.js","sources":["services/newtonChat.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Newton chat service – AI tutor conversations for assignments. Get or create\n * tutor session, post messages, trigger AI responses. Broadcasts via Pusher.\n */\nimport { TRPCError } from \"@trpc/server\";\nimport { logger } from \"../utils/logger.js\";\nimport { chatChannel, pusher } from \"../lib/pusher.js\";\nimport { isAIUser } from \"../utils/aiUser.js\";\nimport { createPendingAIMessage } from \"../utils/inference.js\";\nimport { enqueueRunJob } from \"../workers/queues.js\";\nimport {\n  claimMessageAttachments,\n  ensureMessageHasContentOrAttachments,\n} from \"./message.js\";\nimport { messageFileSelect } from \"../models/message.js\";\nimport {\n  findClassWithStudent,\n  findSubmissionByAssignmentAndStudent,\n  findNewtonChatByIdAndMember,\n  findConversationMembersByUserIds,\n} from \"../models/newtonChat.js\";\nimport { prisma } from \"../lib/prisma.js\";\n\n/** Get or create Newton tutor conversation for a submission. Student-only. */\nexport async function getTutorConversation(\n  userId: string,\n  assignmentId: string,\n  classId: string\n) {\n  const classMembership = await findClassWithStudent(classId, userId);\n  if (!classMembership) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Not a student in this class\",\n    });\n  }\n\n  const submission = await findSubmissionByAssignmentAndStudent(\n    assignmentId,\n    userId\n  );\n  if (!submission) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Submission not found. Please create a submission first.\",\n    });\n  }\n\n  const { chat, isNew } = await prisma.$transaction(async (tx) => {\n    const existingNewtonChat = await tx.newtonChat.findFirst({\n      where: { submissionId: submission.id },\n      include: {\n        conversation: {\n          include: {\n            members: {\n              where: { userId },\n            },\n          },\n        },\n      },\n      orderBy: { createdAt: \"desc\" },\n    });\n\n    if (existingNewtonChat && existingNewtonChat.conversation.members.length > 0) {\n      return { chat: existingNewtonChat, isNew: false };\n    }\n\n    if (existingNewtonChat) {\n      await tx.conversationMember.create({\n        data: {\n          userId,\n          conversationId: existingNewtonChat.conversationId,\n          role: \"MEMBER\",\n        },\n      });\n      return { chat: existingNewtonChat, isNew: false };\n    }\n\n    const conversation = await tx.conversation.create({\n      data: {\n        type: \"DM\",\n        name: \"Session with Newton Tutor\",\n        displayInChat: false,\n      },\n    });\n\n    await tx.conversationMember.create({\n      data: {\n        userId,\n        conversationId: conversation.id,\n        role: \"MEMBER\",\n      },\n    });\n\n    const newtonChat = await tx.newtonChat.create({\n      data: {\n        submissionId: submission.id,\n        conversationId: conversation.id,\n        title: \"Session with Newton Tutor\",\n      },\n    });\n\n    return { chat: newtonChat, isNew: true };\n  });\n\n  if (isNew) {\n    // Create the AI introduction placeholder and enqueue OUTSIDE the\n    // transaction — a tx rollback would otherwise orphan a job pointing at\n    // a non-existent NewtonChat / Message row.\n    try {\n      const aiPlaceholder = await createPendingAIMessage(chat.conversationId);\n      await enqueueRunJob(\n        \"AI_NEWTON_CHAT\",\n        { conversationId: chat.conversationId, aiMessageId: aiPlaceholder.id },\n        { userId },\n      );\n    } catch (error) {\n      logger.error(\"Failed to enqueue Newton introduction\", {\n        error,\n        newtonChatId: chat.id,\n      });\n    }\n  }\n\n  return {\n    conversationId: chat.conversationId,\n    newtonChatId: chat.id,\n  };\n}\n\nexport async function postToNewtonChat(\n  userId: string,\n  newtonChatId: string,\n  content: string,\n  mentionedUserIds: string[] = [],\n  fileIds: string[] = []\n) {\n  const newtonChat = await findNewtonChatByIdAndMember(newtonChatId, userId);\n  if (!newtonChat) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Newton chat not found or access denied\",\n    });\n  }\n\n  if (mentionedUserIds.length > 0) {\n    const mentionedMemberships = await findConversationMembersByUserIds(\n      newtonChat.conversationId,\n      mentionedUserIds\n    );\n    if (mentionedMemberships.length !== mentionedUserIds.length) {\n      throw new TRPCError({\n        code: \"BAD_REQUEST\",\n        message: \"Some mentioned users are not members of this conversation\",\n      });\n    }\n  }\n\n  ensureMessageHasContentOrAttachments(content, fileIds);\n  const normalizedContent = content.trim();\n\n  if (!normalizedContent) {\n    throw new TRPCError({\n      code: \"BAD_REQUEST\",\n      message: \"Newton chat messages must include text content\",\n    });\n  }\n\n  const result = await prisma.$transaction(async (tx) => {\n    const message = await tx.message.create({\n      data: {\n        content: normalizedContent,\n        senderId: userId,\n        conversationId: newtonChat.conversationId,\n      },\n    });\n\n    await claimMessageAttachments(\n      tx,\n      userId,\n      newtonChat.conversationId,\n      message.id,\n      fileIds\n    );\n\n    if (mentionedUserIds.length > 0) {\n      await tx.mention.createMany({\n        data: mentionedUserIds.map((mentionedUserId) => ({\n          messageId: message.id,\n          userId: mentionedUserId,\n        })),\n      });\n    }\n\n    await tx.newtonChat.update({\n      where: { id: newtonChatId },\n      data: { updatedAt: new Date() },\n    });\n\n    return tx.message.findUniqueOrThrow({\n      where: { id: message.id },\n      include: {\n        sender: {\n          select: {\n            id: true,\n            username: true,\n            profile: {\n              select: {\n                displayName: true,\n                profilePicture: true,\n              },\n            },\n          },\n        },\n        attachments: {\n          select: messageFileSelect,\n        },\n      },\n    });\n  });\n\n  try {\n    await pusher.trigger(\n      chatChannel(newtonChat.conversationId),\n      \"new-message\",\n      {\n        id: result.id,\n        content: result.content,\n        senderId: result.senderId,\n        conversationId: result.conversationId,\n        status: result.status,\n        createdAt: result.createdAt,\n        sender: result.sender,\n        attachments: result.attachments ?? [],\n        mentionedUserIds,\n        meta: {},\n      }\n    );\n  } catch (error) {\n    console.error(\"Failed to broadcast newton chat message:\", error);\n  }\n\n  if (!isAIUser(userId)) {\n    // Create the AI placeholder post-tx (so a rollback can't broadcast a\n    // ghost bubble); the pipeline fills it in.\n    try {\n      const aiPlaceholder = await createPendingAIMessage(newtonChat.conversationId);\n      await enqueueRunJob(\n        \"AI_NEWTON_CHAT\",\n        { conversationId: newtonChat.conversationId, aiMessageId: aiPlaceholder.id },\n        { userId },\n      );\n    } catch (error) {\n      logger.error(\"Failed to enqueue Newton response\", {\n        error,\n        newtonChatId,\n        studentMessageId: result.id,\n        conversationId: newtonChat.conversationId,\n      });\n    }\n  }\n\n  return {\n    id: result.id,\n    content: result.content,\n    senderId: result.senderId,\n    conversationId: result.conversationId,\n    status: result.status,\n    createdAt: result.createdAt,\n    sender: result.sender,\n    attachments: result.attachments ?? [],\n    mentionedUserIds,\n  };\n}\n"],"names":[],"mappings":"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","debug_id":"0575644e-e077-5f74-8b0c-a6feb71814e9"}
+{"version":3,"file":"newtonChat.js","sources":["services/newtonChat.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Newton chat service – AI tutor conversations for assignments. Get or create\n * tutor session, post messages, trigger AI responses. Broadcasts via Pusher.\n */\nimport { TRPCError } from \"@trpc/server\";\nimport { logger } from \"../utils/logger.js\";\nimport { chatChannel, pusher } from \"../lib/pusher.js\";\nimport { isAIUser } from \"../utils/aiUser.js\";\nimport { createPendingAIMessage } from \"../utils/inference.js\";\nimport { enqueueRunJob } from \"../workers/queues.js\";\nimport {\n  claimMessageAttachments,\n  ensureMessageHasContentOrAttachments,\n} from \"./message.js\";\nimport { messageFileSelect } from \"../models/message.js\";\nimport {\n  findClassWithStudent,\n  findSubmissionByAssignmentAndStudent,\n  findNewtonChatByIdAndMember,\n  findConversationMembersByUserIds,\n} from \"../models/newtonChat.js\";\nimport { prisma } from \"../lib/prisma.js\";\n\n/** Get or create Newton tutor conversation for a submission. Student-only. */\nexport async function getTutorConversation(\n  userId: string,\n  assignmentId: string,\n  classId: string\n) {\n  const classMembership = await findClassWithStudent(classId, userId);\n  if (!classMembership) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Not a student in this class\",\n    });\n  }\n\n  const submission = await findSubmissionByAssignmentAndStudent(\n    assignmentId,\n    userId\n  );\n  if (!submission) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Submission not found. Please create a submission first.\",\n    });\n  }\n\n  const { chat, isNew } = await prisma.$transaction(async (tx) => {\n    const existingNewtonChat = await tx.newtonChat.findFirst({\n      where: { submissionId: submission.id },\n      include: {\n        conversation: {\n          include: {\n            members: {\n              where: { userId },\n            },\n          },\n        },\n      },\n      orderBy: { createdAt: \"desc\" },\n    });\n\n    if (existingNewtonChat && existingNewtonChat.conversation.members.length > 0) {\n      return { chat: existingNewtonChat, isNew: false };\n    }\n\n    if (existingNewtonChat) {\n      await tx.conversationMember.create({\n        data: {\n          userId,\n          conversationId: existingNewtonChat.conversationId,\n          role: \"MEMBER\",\n        },\n      });\n      return { chat: existingNewtonChat, isNew: false };\n    }\n\n    const conversation = await tx.conversation.create({\n      data: {\n        type: \"DM\",\n        name: \"Session with Newton Tutor\",\n        displayInChat: false,\n      },\n    });\n\n    await tx.conversationMember.create({\n      data: {\n        userId,\n        conversationId: conversation.id,\n        role: \"MEMBER\",\n      },\n    });\n\n    const newtonChat = await tx.newtonChat.create({\n      data: {\n        submissionId: submission.id,\n        conversationId: conversation.id,\n        title: \"Session with Newton Tutor\",\n      },\n    });\n\n    return { chat: newtonChat, isNew: true };\n  });\n\n  if (isNew) {\n    // Create the AI introduction placeholder and enqueue OUTSIDE the\n    // transaction — a tx rollback would otherwise orphan a job pointing at\n    // a non-existent NewtonChat / Message row.\n    try {\n      const aiPlaceholder = await createPendingAIMessage(chat.conversationId);\n      await enqueueRunJob(\n        \"AI_NEWTON_CHAT\",\n        { conversationId: chat.conversationId, aiMessageId: aiPlaceholder.id },\n        { userId },\n      );\n    } catch (error) {\n      logger.error(\"Failed to enqueue Newton introduction\", {\n        error,\n        newtonChatId: chat.id,\n      });\n    }\n  }\n\n  return {\n    conversationId: chat.conversationId,\n    newtonChatId: chat.id,\n  };\n}\n\nexport async function postToNewtonChat(\n  userId: string,\n  newtonChatId: string,\n  content: string,\n  mentionedUserIds: string[] = [],\n  fileIds: string[] = []\n) {\n  const newtonChat = await findNewtonChatByIdAndMember(newtonChatId, userId);\n  if (!newtonChat) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Newton chat not found or access denied\",\n    });\n  }\n\n  if (mentionedUserIds.length > 0) {\n    const mentionedMemberships = await findConversationMembersByUserIds(\n      newtonChat.conversationId,\n      mentionedUserIds\n    );\n    if (mentionedMemberships.length !== mentionedUserIds.length) {\n      throw new TRPCError({\n        code: \"BAD_REQUEST\",\n        message: \"Some mentioned users are not members of this conversation\",\n      });\n    }\n  }\n\n  ensureMessageHasContentOrAttachments(content, fileIds);\n  const normalizedContent = content.trim();\n\n  const result = await prisma.$transaction(async (tx) => {\n    const message = await tx.message.create({\n      data: {\n        content: normalizedContent,\n        senderId: userId,\n        conversationId: newtonChat.conversationId,\n      },\n    });\n\n    await claimMessageAttachments(\n      tx,\n      userId,\n      newtonChat.conversationId,\n      message.id,\n      fileIds\n    );\n\n    if (mentionedUserIds.length > 0) {\n      await tx.mention.createMany({\n        data: mentionedUserIds.map((mentionedUserId) => ({\n          messageId: message.id,\n          userId: mentionedUserId,\n        })),\n      });\n    }\n\n    await tx.newtonChat.update({\n      where: { id: newtonChatId },\n      data: { updatedAt: new Date() },\n    });\n\n    return tx.message.findUniqueOrThrow({\n      where: { id: message.id },\n      include: {\n        sender: {\n          select: {\n            id: true,\n            username: true,\n            profile: {\n              select: {\n                displayName: true,\n                profilePicture: true,\n              },\n            },\n          },\n        },\n        attachments: {\n          select: messageFileSelect,\n        },\n      },\n    });\n  });\n\n  try {\n    await pusher.trigger(\n      chatChannel(newtonChat.conversationId),\n      \"new-message\",\n      {\n        id: result.id,\n        content: result.content,\n        senderId: result.senderId,\n        conversationId: result.conversationId,\n        status: result.status,\n        createdAt: result.createdAt,\n        sender: result.sender,\n        attachments: result.attachments ?? [],\n        mentionedUserIds,\n        meta: {},\n      }\n    );\n  } catch (error) {\n    console.error(\"Failed to broadcast newton chat message:\", error);\n  }\n\n  if (!isAIUser(userId)) {\n    // Create the AI placeholder post-tx (so a rollback can't broadcast a\n    // ghost bubble); the pipeline fills it in.\n    try {\n      const aiPlaceholder = await createPendingAIMessage(newtonChat.conversationId);\n      await enqueueRunJob(\n        \"AI_NEWTON_CHAT\",\n        { conversationId: newtonChat.conversationId, aiMessageId: aiPlaceholder.id },\n        { userId },\n      );\n    } catch (error) {\n      logger.error(\"Failed to enqueue Newton response\", {\n        error,\n        newtonChatId,\n        studentMessageId: result.id,\n        conversationId: newtonChat.conversationId,\n      });\n    }\n  }\n\n  return {\n    id: result.id,\n    content: result.content,\n    senderId: result.senderId,\n    conversationId: result.conversationId,\n    status: result.status,\n    createdAt: result.createdAt,\n    sender: result.sender,\n    attachments: result.attachments ?? [],\n    mentionedUserIds,\n  };\n}\n"],"names":[],"mappings":"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","debug_id":"39ab2fff-5212-508b-bb38-849fb5430153"}

package/dist/services/openaiDocumentGen.d.ts

@@ -1,9 +1,15 @@
 import type { Response } from 'openai/resources/responses/responses.js';
+/**
+ * Extensions OpenAI Code Interpreter can read/write in its sandbox.
+ * @see https://developers.openai.com/api/docs/guides/tools-code-interpreter
+ */
 export declare const SUPPORTED_DOCUMENT_FORMATS: readonly ["pdf", "docx", "doc", "xlsx", "pptx", "csv", "md", "html", "txt", "json", "xml", "tex", "png", "jpeg", "jpg", "gif", "zip", "tar", "py", "js", "ts", "css", "sh"];
 export type DocumentFormat = (typeof SUPPORTED_DOCUMENT_FORMATS)[number];
 export interface GenerateDocumentInput {
     title: string;
+    /** Markdown or plain-text source material for the output file. */
     content: string;
+    /** Output format. Defaults to pdf. */
     format?: DocumentFormat | string;
 }
 export interface GeneratedDocumentResult {
@@ -19,7 +25,13 @@ export interface ContainerGeneratedFile {
 }
 export declare function normalizeDocumentFormat(format?: string | null): DocumentFormat;
 export declare function mimeTypeForFormat(format: DocumentFormat): string;
+export declare function extensionForFormat(format: DocumentFormat): string;
+/** Pull generated-file citations for a given extension out of a Responses output. */
 export declare function extractContainerGeneratedFiles(response: Response, extension: DocumentFormat): ContainerGeneratedFile[];
 /** Generate a file via OpenAI Code Interpreter. */
 export declare function generateDocumentWithOpenAI(input: GenerateDocumentInput): Promise<GeneratedDocumentResult | null>;
+/** @deprecated Use {@link generateDocumentWithOpenAI} */
+export declare function generatePdfWithOpenAI(input: Omit<GenerateDocumentInput, 'format'>): Promise<Buffer | null>;
+/** @deprecated Use {@link extractContainerGeneratedFiles} */
+export declare const extractContainerPdfFiles: (response: Response) => ContainerGeneratedFile[];
 //# sourceMappingURL=openaiDocumentGen.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"openaiDocumentGen.d.ts","sourceRoot":"/","sources":["services/openaiDocumentGen.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAC;AAKxE,eAAO,MAAM,0BAA0B,6KAI7B,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAsDzE,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,cAAc,CAM9E;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAEhE;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,cAAc,GACxB,sBAAsB,EAAE,CAyB1B;AAwCD,mDAAmD;AACnD,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAgEzC"}
+{"version":3,"file":"openaiDocumentGen.d.ts","sourceRoot":"/","sources":["services/openaiDocumentGen.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yCAAyC,CAAC;AAKxE;;;GAGG;AACH,eAAO,MAAM,0BAA0B,6KAwB7B,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AA6FzE,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,uBAAuB,CACrC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GACrB,cAAc,CAMhB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAEhE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAEjE;AAED,qFAAqF;AACrF,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,cAAc,GACxB,sBAAsB,EAAE,CA2B1B;AA6ED,mDAAmD;AACnD,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAiEzC;AAED,yDAAyD;AACzD,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAC,GAC3C,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB;AAED,6DAA6D;AAC7D,eAAO,MAAM,wBAAwB,GAAI,UAAU,QAAQ,6BACV,CAAC"}

package/dist/services/openaiDocumentGen.js

@@ -3,14 +3,38 @@
  * Supports every format the sandbox can produce (pdf, docx, xlsx, pptx, …).
  */
 
-!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]="cd65973d-ca13-5498-8d6b-ff056b093631")}catch(e){}}();
+!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]="d086b281-e191-5157-a799-843675a76a37")}catch(e){}}();
 import OpenAI from 'openai';
 import { logger } from '../utils/logger.js';
-const DOCUMENT_GEN_MODEL = 'gpt-4o-mini';
+const DOCUMENT_GEN_MODEL = 'gpt-5.5';
+/**
+ * Extensions OpenAI Code Interpreter can read/write in its sandbox.
+ * @see https://developers.openai.com/api/docs/guides/tools-code-interpreter
+ */
 export const SUPPORTED_DOCUMENT_FORMATS = [
-    'pdf', 'docx', 'doc', 'xlsx', 'pptx', 'csv', 'md', 'html', 'txt', 'json',
-    'xml', 'tex', 'png', 'jpeg', 'jpg', 'gif', 'zip', 'tar', 'py', 'js', 'ts',
-    'css', 'sh',
+    'pdf',
+    'docx',
+    'doc',
+    'xlsx',
+    'pptx',
+    'csv',
+    'md',
+    'html',
+    'txt',
+    'json',
+    'xml',
+    'tex',
+    'png',
+    'jpeg',
+    'jpg',
+    'gif',
+    'zip',
+    'tar',
+    'py',
+    'js',
+    'ts',
+    'css',
+    'sh',
 ];
 const FORMAT_MIME = {
     pdf: 'application/pdf',
@@ -38,29 +62,67 @@ const FORMAT_MIME = {
     sh: 'application/x-sh',
 };
 const FORMAT_HINTS = {
-    pdf: 'fpdf2 or reportlab',
-    docx: 'python-docx',
-    doc: 'python-docx',
-    xlsx: 'openpyxl or pandas',
-    pptx: 'python-pptx',
-    csv: 'pandas or csv module',
-    md: 'write markdown directly',
-    html: 'write a complete HTML page',
-    txt: 'write plain text',
-    json: 'json.dumps with indentation',
-    xml: 'well-formed XML',
-    tex: 'LaTeX source',
-    png: 'matplotlib or Pillow',
-    jpeg: 'matplotlib or Pillow',
-    jpg: 'matplotlib or Pillow',
-    gif: 'matplotlib or Pillow',
-    zip: 'zipfile',
-    tar: 'tarfile',
-    py: 'Python source',
-    js: 'JavaScript source',
-    ts: 'TypeScript source',
-    css: 'CSS stylesheet',
-    sh: 'shell script',
+    pdf: 'fpdf2 or reportlab — polished document with headings, body text, and tables',
+    docx: 'python-docx — Word document with heading styles, paragraphs, and lists',
+    doc: 'python-docx saving as .doc if supported, otherwise .docx',
+    xlsx: 'openpyxl or pandas — spreadsheet with labelled columns, formulas where useful',
+    pptx: 'python-pptx — full slide deck: title slide, section slides, bullets, diagrams on slides',
+    csv: 'pandas or csv module — tabular data with headers',
+    md: 'write the markdown file directly',
+    html: 'write a complete, styled HTML page',
+    txt: 'write plain text with clear section breaks',
+    json: 'json.dumps with readable indentation',
+    xml: 'well-formed XML document',
+    tex: 'LaTeX source that compiles to the requested content',
+    png: 'matplotlib, networkx, or Pillow — render the described chart/diagram as a finished image',
+    jpeg: 'matplotlib or Pillow — high-quality visual saved as JPEG',
+    jpg: 'matplotlib or Pillow — high-quality visual saved as JPEG',
+    gif: 'matplotlib or Pillow — save as GIF',
+    zip: 'zipfile — bundle multiple related files if needed',
+    tar: 'tarfile — archive if multiple files are required',
+    py: 'valid, runnable Python source with comments',
+    js: 'valid JavaScript source with comments',
+    ts: 'valid TypeScript source with comments',
+    css: 'stylesheet file',
+    sh: 'shell script file',
+};
+/** Extra quality rules appended for formats that need more than a one-line library hint. */
+const FORMAT_QUALITY_RULES = {
+    png: [
+        'Interpret the source content as a visual spec — draw it, do not dump text into the image.',
+        'Charts: labelled axes, legend, title, readable font sizes, 150+ DPI.',
+        'Diagrams/flowcharts: use matplotlib patches, networkx, or Pillow drawing — boxes, arrows, labels.',
+        'Geometry/maps: accurate relative positions; label every important part.',
+        'Use color meaningfully; avoid blank or placeholder images.',
+    ],
+    jpeg: [
+        'Same visual quality rules as PNG — polished chart or diagram, not a screenshot of text.',
+    ],
+    jpg: [
+        'Same visual quality rules as PNG — polished chart or diagram, not a screenshot of text.',
+    ],
+    gif: [
+        'Render a clear educational visual; static GIF is fine unless animation is described.',
+    ],
+    pptx: [
+        'Split slides on "---" lines or "Slide N:" / "# " headings in the source content.',
+        'Title slide first, then content slides with concise bullets (not walls of text).',
+        'If the content describes a diagram, draw it on a slide (shapes/arrows) or embed a generated chart.',
+        'Use distinct slide layouts where appropriate (title, title+content).',
+    ],
+    xlsx: [
+        'Parse markdown tables or tabular lists in the source into real rows/columns.',
+        'Bold header row; auto-fit column widths where possible.',
+    ],
+    pdf: [
+        'If the source describes a figure/chart, generate and embed it — do not leave a "[diagram]" placeholder.',
+    ],
+    docx: [
+        'Use Heading 1/2 styles for section titles; bullets and numbered lists for enumerations.',
+    ],
+    html: [
+        'Include embedded CSS for readable typography; use tables or simple layout for structured content.',
+    ],
 };
 export function normalizeDocumentFormat(format) {
     const raw = (format ?? 'pdf').toLowerCase().replace(/^\./, '');
@@ -72,10 +134,21 @@ export function normalizeDocumentFormat(format) {
 export function mimeTypeForFormat(format) {
     return FORMAT_MIME[format];
 }
+export function extensionForFormat(format) {
+    return format === 'jpg' ? 'jpg' : format;
+}
+/** Pull generated-file citations for a given extension out of a Responses output. */
 export function extractContainerGeneratedFiles(response, extension) {
-    const suffix = `.${extension}`;
     const seen = new Set();
     const files = [];
+    const suffix = `.${extension}`;
+    const add = (containerId, fileId, filename) => {
+        const key = `${containerId}:${fileId}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        files.push({ containerId, fileId, filename });
+    };
     for (const item of response.output ?? []) {
         if (item.type !== 'message')
             continue;
@@ -86,17 +159,9 @@ export function extractContainerGeneratedFiles(response, extension) {
                 if (ann.type !== 'container_file_citation')
                     continue;
                 const name = ann.filename?.toLowerCase() ?? '';
-                if (!name.endsWith(suffix))
-                    continue;
-                const key = `${ann.container_id}:${ann.file_id}`;
-                if (seen.has(key))
-                    continue;
-                seen.add(key);
-                files.push({
-                    containerId: ann.container_id,
-                    fileId: ann.file_id,
-                    filename: ann.filename,
-                });
+                if (name.endsWith(suffix)) {
+                    add(ann.container_id, ann.file_id, ann.filename);
+                }
             }
         }
     }
@@ -125,38 +190,70 @@ async function listContainerGeneratedFiles(client, containerId, extension) {
     }
     return files;
 }
+async function downloadContainerFile(client, file) {
+    try {
+        const res = await client.containers.files.content.retrieve(file.fileId, {
+            container_id: file.containerId,
+        });
+        const bytes = await res.arrayBuffer();
+        return Buffer.from(bytes);
+    }
+    catch (error) {
+        logger.error('Failed to download container file', { error, file });
+        return null;
+    }
+}
 function safeBasename(title) {
-    return (title
+    const base = title
         .replace(/[^a-zA-Z0-9\s\-_]/g, '')
         .replace(/\s+/g, '_')
-        .substring(0, 60) || 'document');
+        .substring(0, 60);
+    return base || 'document';
+}
+function buildDocumentGenInstructions(format) {
+    const qualityRules = FORMAT_QUALITY_RULES[format] ?? [];
+    return [
+        'You are a document generator for K-12 and university teachers.',
+        'When given a title, output format, and source content:',
+        '1. Use the python tool to create exactly ONE output file of the requested type.',
+        `2. For this format use: ${FORMAT_HINTS[format]}.`,
+        `3. You MUST output a ${format.toUpperCase()} file — not any other format.`,
+        `4. The saved filename MUST end with .${extensionForFormat(format)}.`,
+        '5. Faithfully adapt ALL source content to the output medium — do not summarize away detail.',
+        '6. Include the document title prominently where the format allows.',
+        '7. Put ONLY the educational content in the file — no meta commentary.',
+        '8. You MUST save the file to disk in the working directory before you finish.',
+        ...(format !== 'pdf'
+            ? [`9. Do NOT create a PDF when ${format.toUpperCase()} was requested.`]
+            : []),
+        ...(qualityRules.length > 0
+            ? ['', 'Format-specific quality:', ...qualityRules.map((r, i) => `${i + 1}. ${r}`)]
+            : []),
+    ].join('\n');
 }
 /** Generate a file via OpenAI Code Interpreter. */
 export async function generateDocumentWithOpenAI(input) {
     const client = new OpenAI();
     const format = normalizeDocumentFormat(input.format);
-    const ext = format === 'jpg' ? 'jpg' : format;
+    const ext = extensionForFormat(format);
     const filename = `${safeBasename(input.title)}.${ext}`;
     try {
         const response = await client.responses.create({
             model: DOCUMENT_GEN_MODEL,
-            instructions: [
-                'You generate classroom-ready files for teachers using the python tool.',
-                `You MUST output a ${ext.toUpperCase()} file — not any other format.`,
-                `Use: ${FORMAT_HINTS[format]}.`,
-                `The saved filename MUST end with .${ext}.`,
-                'Save exactly one output file with the requested filename.',
-                'Include only educational content — no chat commentary.',
-                ...(format !== 'pdf' ? [`Do NOT create a PDF when ${ext.toUpperCase()} was requested.`] : []),
-            ].join(' '),
-            tools: [{ type: 'code_interpreter', container: { type: 'auto' } }],
+            instructions: buildDocumentGenInstructions(format),
+            tools: [
+                {
+                    type: 'code_interpreter',
+                    container: { type: 'auto' },
+                },
+            ],
             tool_choice: 'required',
             input: [
-                `Create a ${ext.toUpperCase()} file.`,
-                `Filename (exact): ${filename}`,
-                `Title: ${input.title}`,
-                'Content:',
-                input.content,
+                `Create a ${ext.toUpperCase()} file using the python tool.`,
+                `Output filename (exact): ${filename}`,
+                `Output format: ${ext}`,
+                `Document title: ${input.title}`,
+                ['Source content — adapt fully to the output medium (do not paste raw markdown into slides/images):', input.content].join('\n'),
             ].join('\n\n'),
         });
         let matches = extractContainerGeneratedFiles(response, format);
@@ -167,18 +264,18 @@ export async function generateDocumentWithOpenAI(input) {
             }
         }
         if (matches.length === 0) {
-            logger.error('OpenAI document gen: no output file', {
+            logger.error('OpenAI document gen produced no matching files', {
                 title: input.title,
                 format,
+                outputTypes: (response.output ?? []).map((o) => o.type),
             });
             return null;
         }
         const preferred = matches.find((f) => f.filename.toLowerCase() === filename.toLowerCase()) ??
             matches[0];
-        const res = await client.containers.files.content.retrieve(preferred.fileId, {
-            container_id: preferred.containerId,
-        });
-        const bytes = Buffer.from(await res.arrayBuffer());
+        const bytes = await downloadContainerFile(client, preferred);
+        if (!bytes)
+            return null;
         return {
             bytes,
             filename: preferred.filename,
@@ -187,9 +284,20 @@ export async function generateDocumentWithOpenAI(input) {
         };
     }
     catch (error) {
-        logger.error('OpenAI document generation failed', { error, title: input.title, format });
+        logger.error('OpenAI document generation failed', {
+            error,
+            title: input.title,
+            format,
+        });
         return null;
     }
 }
+/** @deprecated Use {@link generateDocumentWithOpenAI} */
+export async function generatePdfWithOpenAI(input) {
+    const result = await generateDocumentWithOpenAI({ ...input, format: 'pdf' });
+    return result?.bytes ?? null;
+}
+/** @deprecated Use {@link extractContainerGeneratedFiles} */
+export const extractContainerPdfFiles = (response) => extractContainerGeneratedFiles(response, 'pdf');
 //# sourceMappingURL=openaiDocumentGen.js.map
-//# debugId=cd65973d-ca13-5498-8d6b-ff056b093631
+//# debugId=d086b281-e191-5157-a799-843675a76a37

package/dist/services/openaiDocumentGen.js.map

@@ -1 +1 @@
-{"version":3,"file":"openaiDocumentGen.js","sources":["services/openaiDocumentGen.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Generate files via OpenAI Code Interpreter (Responses API).\n * Supports every format the sandbox can produce (pdf, docx, xlsx, pptx, …).\n */\nimport OpenAI from 'openai';\nimport type { Response } from 'openai/resources/responses/responses.js';\nimport { logger } from '../utils/logger.js';\n\nconst DOCUMENT_GEN_MODEL = 'gpt-4o-mini';\n\nexport const SUPPORTED_DOCUMENT_FORMATS = [\n  'pdf', 'docx', 'doc', 'xlsx', 'pptx', 'csv', 'md', 'html', 'txt', 'json',\n  'xml', 'tex', 'png', 'jpeg', 'jpg', 'gif', 'zip', 'tar', 'py', 'js', 'ts',\n  'css', 'sh',\n] as const;\n\nexport type DocumentFormat = (typeof SUPPORTED_DOCUMENT_FORMATS)[number];\n\nconst FORMAT_MIME: Record<DocumentFormat, string> = {\n  pdf: 'application/pdf',\n  docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n  doc: 'application/msword',\n  xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n  pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',\n  csv: 'text/csv',\n  md: 'text/markdown',\n  html: 'text/html',\n  txt: 'text/plain',\n  json: 'application/json',\n  xml: 'application/xml',\n  tex: 'text/x-tex',\n  png: 'image/png',\n  jpeg: 'image/jpeg',\n  jpg: 'image/jpeg',\n  gif: 'image/gif',\n  zip: 'application/zip',\n  tar: 'application/x-tar',\n  py: 'text/x-python',\n  js: 'text/javascript',\n  ts: 'application/typescript',\n  css: 'text/css',\n  sh: 'application/x-sh',\n};\n\nconst FORMAT_HINTS: Record<DocumentFormat, string> = {\n  pdf: 'fpdf2 or reportlab',\n  docx: 'python-docx',\n  doc: 'python-docx',\n  xlsx: 'openpyxl or pandas',\n  pptx: 'python-pptx',\n  csv: 'pandas or csv module',\n  md: 'write markdown directly',\n  html: 'write a complete HTML page',\n  txt: 'write plain text',\n  json: 'json.dumps with indentation',\n  xml: 'well-formed XML',\n  tex: 'LaTeX source',\n  png: 'matplotlib or Pillow',\n  jpeg: 'matplotlib or Pillow',\n  jpg: 'matplotlib or Pillow',\n  gif: 'matplotlib or Pillow',\n  zip: 'zipfile',\n  tar: 'tarfile',\n  py: 'Python source',\n  js: 'JavaScript source',\n  ts: 'TypeScript source',\n  css: 'CSS stylesheet',\n  sh: 'shell script',\n};\n\nexport interface GenerateDocumentInput {\n  title: string;\n  content: string;\n  format?: DocumentFormat | string;\n}\n\nexport interface GeneratedDocumentResult {\n  bytes: Buffer;\n  filename: string;\n  mimeType: string;\n  format: DocumentFormat;\n}\n\nexport interface ContainerGeneratedFile {\n  containerId: string;\n  fileId: string;\n  filename: string;\n}\n\nexport function normalizeDocumentFormat(format?: string | null): DocumentFormat {\n  const raw = (format ?? 'pdf').toLowerCase().replace(/^\\./, '');\n  if ((SUPPORTED_DOCUMENT_FORMATS as readonly string[]).includes(raw)) {\n    return raw as DocumentFormat;\n  }\n  return 'pdf';\n}\n\nexport function mimeTypeForFormat(format: DocumentFormat): string {\n  return FORMAT_MIME[format];\n}\n\nexport function extractContainerGeneratedFiles(\n  response: Response,\n  extension: DocumentFormat,\n): ContainerGeneratedFile[] {\n  const suffix = `.${extension}`;\n  const seen = new Set<string>();\n  const files: ContainerGeneratedFile[] = [];\n\n  for (const item of response.output ?? []) {\n    if (item.type !== 'message') continue;\n    for (const block of item.content ?? []) {\n      if (block.type !== 'output_text') continue;\n      for (const ann of block.annotations ?? []) {\n        if (ann.type !== 'container_file_citation') continue;\n        const name = ann.filename?.toLowerCase() ?? '';\n        if (!name.endsWith(suffix)) continue;\n        const key = `${ann.container_id}:${ann.file_id}`;\n        if (seen.has(key)) continue;\n        seen.add(key);\n        files.push({\n          containerId: ann.container_id,\n          fileId: ann.file_id,\n          filename: ann.filename,\n        });\n      }\n    }\n  }\n  return files;\n}\n\nfunction containerIdFromResponse(response: Response): string | undefined {\n  for (const item of response.output ?? []) {\n    if (item.type === 'code_interpreter_call' && item.container_id) {\n      return item.container_id;\n    }\n  }\n  return undefined;\n}\n\nasync function listContainerGeneratedFiles(\n  client: OpenAI,\n  containerId: string,\n  extension: DocumentFormat,\n): Promise<ContainerGeneratedFile[]> {\n  const suffix = `.${extension}`;\n  const files: ContainerGeneratedFile[] = [];\n  for await (const file of client.containers.files.list(containerId)) {\n    const path = file.path?.toLowerCase() ?? '';\n    if (path.endsWith(suffix) && file.source === 'assistant') {\n      files.push({\n        containerId,\n        fileId: file.id,\n        filename: file.path.split('/').pop() ?? file.path,\n      });\n    }\n  }\n  return files;\n}\n\nfunction safeBasename(title: string): string {\n  return (\n    title\n      .replace(/[^a-zA-Z0-9\\s\\-_]/g, '')\n      .replace(/\\s+/g, '_')\n      .substring(0, 60) || 'document'\n  );\n}\n\n/** Generate a file via OpenAI Code Interpreter. */\nexport async function generateDocumentWithOpenAI(\n  input: GenerateDocumentInput,\n): Promise<GeneratedDocumentResult | null> {\n  const client = new OpenAI();\n  const format = normalizeDocumentFormat(input.format);\n  const ext = format === 'jpg' ? 'jpg' : format;\n  const filename = `${safeBasename(input.title)}.${ext}`;\n\n  try {\n    const response = await client.responses.create({\n      model: DOCUMENT_GEN_MODEL,\n      instructions: [\n        'You generate classroom-ready files for teachers using the python tool.',\n        `You MUST output a ${ext.toUpperCase()} file — not any other format.`,\n        `Use: ${FORMAT_HINTS[format]}.`,\n        `The saved filename MUST end with .${ext}.`,\n        'Save exactly one output file with the requested filename.',\n        'Include only educational content — no chat commentary.',\n        ...(format !== 'pdf' ? [`Do NOT create a PDF when ${ext.toUpperCase()} was requested.`] : []),\n      ].join(' '),\n      tools: [{ type: 'code_interpreter', container: { type: 'auto' } }],\n      tool_choice: 'required',\n      input: [\n        `Create a ${ext.toUpperCase()} file.`,\n        `Filename (exact): ${filename}`,\n        `Title: ${input.title}`,\n        'Content:',\n        input.content,\n      ].join('\\n\\n'),\n    });\n\n    let matches = extractContainerGeneratedFiles(response, format);\n    if (matches.length === 0) {\n      const containerId = containerIdFromResponse(response);\n      if (containerId) {\n        matches = await listContainerGeneratedFiles(client, containerId, format);\n      }\n    }\n\n    if (matches.length === 0) {\n      logger.error('OpenAI document gen: no output file', {\n        title: input.title,\n        format,\n      });\n      return null;\n    }\n\n    const preferred =\n      matches.find((f) => f.filename.toLowerCase() === filename.toLowerCase()) ??\n      matches[0];\n\n    const res = await client.containers.files.content.retrieve(preferred.fileId, {\n      container_id: preferred.containerId,\n    });\n    const bytes = Buffer.from(await res.arrayBuffer());\n\n    return {\n      bytes,\n      filename: preferred.filename,\n      mimeType: mimeTypeForFormat(format),\n      format,\n    };\n  } catch (error) {\n    logger.error('OpenAI document generation failed', { error, title: input.title, format });\n    return null;\n  }\n}\n"],"names":[],"mappings":"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","debug_id":"cd65973d-ca13-5498-8d6b-ff056b093631"}
+{"version":3,"file":"openaiDocumentGen.js","sources":["services/openaiDocumentGen.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Generate files via OpenAI Code Interpreter (Responses API).\n * Supports every format the sandbox can produce (pdf, docx, xlsx, pptx, …).\n */\nimport OpenAI from 'openai';\nimport type { Response } from 'openai/resources/responses/responses.js';\nimport { logger } from '../utils/logger.js';\n\nconst DOCUMENT_GEN_MODEL = 'gpt-5.5';\n\n/**\n * Extensions OpenAI Code Interpreter can read/write in its sandbox.\n * @see https://developers.openai.com/api/docs/guides/tools-code-interpreter\n */\nexport const SUPPORTED_DOCUMENT_FORMATS = [\n  'pdf',\n  'docx',\n  'doc',\n  'xlsx',\n  'pptx',\n  'csv',\n  'md',\n  'html',\n  'txt',\n  'json',\n  'xml',\n  'tex',\n  'png',\n  'jpeg',\n  'jpg',\n  'gif',\n  'zip',\n  'tar',\n  'py',\n  'js',\n  'ts',\n  'css',\n  'sh',\n] as const;\n\nexport type DocumentFormat = (typeof SUPPORTED_DOCUMENT_FORMATS)[number];\n\nconst FORMAT_MIME: Record<DocumentFormat, string> = {\n  pdf: 'application/pdf',\n  docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n  doc: 'application/msword',\n  xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n  pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',\n  csv: 'text/csv',\n  md: 'text/markdown',\n  html: 'text/html',\n  txt: 'text/plain',\n  json: 'application/json',\n  xml: 'application/xml',\n  tex: 'text/x-tex',\n  png: 'image/png',\n  jpeg: 'image/jpeg',\n  jpg: 'image/jpeg',\n  gif: 'image/gif',\n  zip: 'application/zip',\n  tar: 'application/x-tar',\n  py: 'text/x-python',\n  js: 'text/javascript',\n  ts: 'application/typescript',\n  css: 'text/css',\n  sh: 'application/x-sh',\n};\n\nconst FORMAT_HINTS: Record<DocumentFormat, string> = {\n  pdf: 'fpdf2 or reportlab — polished document with headings, body text, and tables',\n  docx: 'python-docx — Word document with heading styles, paragraphs, and lists',\n  doc: 'python-docx saving as .doc if supported, otherwise .docx',\n  xlsx: 'openpyxl or pandas — spreadsheet with labelled columns, formulas where useful',\n  pptx: 'python-pptx — full slide deck: title slide, section slides, bullets, diagrams on slides',\n  csv: 'pandas or csv module — tabular data with headers',\n  md: 'write the markdown file directly',\n  html: 'write a complete, styled HTML page',\n  txt: 'write plain text with clear section breaks',\n  json: 'json.dumps with readable indentation',\n  xml: 'well-formed XML document',\n  tex: 'LaTeX source that compiles to the requested content',\n  png: 'matplotlib, networkx, or Pillow — render the described chart/diagram as a finished image',\n  jpeg: 'matplotlib or Pillow — high-quality visual saved as JPEG',\n  jpg: 'matplotlib or Pillow — high-quality visual saved as JPEG',\n  gif: 'matplotlib or Pillow — save as GIF',\n  zip: 'zipfile — bundle multiple related files if needed',\n  tar: 'tarfile — archive if multiple files are required',\n  py: 'valid, runnable Python source with comments',\n  js: 'valid JavaScript source with comments',\n  ts: 'valid TypeScript source with comments',\n  css: 'stylesheet file',\n  sh: 'shell script file',\n};\n\n/** Extra quality rules appended for formats that need more than a one-line library hint. */\nconst FORMAT_QUALITY_RULES: Partial<Record<DocumentFormat, string[]>> = {\n  png: [\n    'Interpret the source content as a visual spec — draw it, do not dump text into the image.',\n    'Charts: labelled axes, legend, title, readable font sizes, 150+ DPI.',\n    'Diagrams/flowcharts: use matplotlib patches, networkx, or Pillow drawing — boxes, arrows, labels.',\n    'Geometry/maps: accurate relative positions; label every important part.',\n    'Use color meaningfully; avoid blank or placeholder images.',\n  ],\n  jpeg: [\n    'Same visual quality rules as PNG — polished chart or diagram, not a screenshot of text.',\n  ],\n  jpg: [\n    'Same visual quality rules as PNG — polished chart or diagram, not a screenshot of text.',\n  ],\n  gif: [\n    'Render a clear educational visual; static GIF is fine unless animation is described.',\n  ],\n  pptx: [\n    'Split slides on \"---\" lines or \"Slide N:\" / \"# \" headings in the source content.',\n    'Title slide first, then content slides with concise bullets (not walls of text).',\n    'If the content describes a diagram, draw it on a slide (shapes/arrows) or embed a generated chart.',\n    'Use distinct slide layouts where appropriate (title, title+content).',\n  ],\n  xlsx: [\n    'Parse markdown tables or tabular lists in the source into real rows/columns.',\n    'Bold header row; auto-fit column widths where possible.',\n  ],\n  pdf: [\n    'If the source describes a figure/chart, generate and embed it — do not leave a \"[diagram]\" placeholder.',\n  ],\n  docx: [\n    'Use Heading 1/2 styles for section titles; bullets and numbered lists for enumerations.',\n  ],\n  html: [\n    'Include embedded CSS for readable typography; use tables or simple layout for structured content.',\n  ],\n};\n\nexport interface GenerateDocumentInput {\n  title: string;\n  /** Markdown or plain-text source material for the output file. */\n  content: string;\n  /** Output format. Defaults to pdf. */\n  format?: DocumentFormat | string;\n}\n\nexport interface GeneratedDocumentResult {\n  bytes: Buffer;\n  filename: string;\n  mimeType: string;\n  format: DocumentFormat;\n}\n\nexport interface ContainerGeneratedFile {\n  containerId: string;\n  fileId: string;\n  filename: string;\n}\n\nexport function normalizeDocumentFormat(\n  format?: string | null,\n): DocumentFormat {\n  const raw = (format ?? 'pdf').toLowerCase().replace(/^\\./, '');\n  if ((SUPPORTED_DOCUMENT_FORMATS as readonly string[]).includes(raw)) {\n    return raw as DocumentFormat;\n  }\n  return 'pdf';\n}\n\nexport function mimeTypeForFormat(format: DocumentFormat): string {\n  return FORMAT_MIME[format];\n}\n\nexport function extensionForFormat(format: DocumentFormat): string {\n  return format === 'jpg' ? 'jpg' : format;\n}\n\n/** Pull generated-file citations for a given extension out of a Responses output. */\nexport function extractContainerGeneratedFiles(\n  response: Response,\n  extension: DocumentFormat,\n): ContainerGeneratedFile[] {\n  const seen = new Set<string>();\n  const files: ContainerGeneratedFile[] = [];\n  const suffix = `.${extension}`;\n\n  const add = (containerId: string, fileId: string, filename: string) => {\n    const key = `${containerId}:${fileId}`;\n    if (seen.has(key)) return;\n    seen.add(key);\n    files.push({ containerId, fileId, filename });\n  };\n\n  for (const item of response.output ?? []) {\n    if (item.type !== 'message') continue;\n    for (const block of item.content ?? []) {\n      if (block.type !== 'output_text') continue;\n      for (const ann of block.annotations ?? []) {\n        if (ann.type !== 'container_file_citation') continue;\n        const name = ann.filename?.toLowerCase() ?? '';\n        if (name.endsWith(suffix)) {\n          add(ann.container_id, ann.file_id, ann.filename);\n        }\n      }\n    }\n  }\n\n  return files;\n}\n\nfunction containerIdFromResponse(response: Response): string | undefined {\n  for (const item of response.output ?? []) {\n    if (item.type === 'code_interpreter_call' && item.container_id) {\n      return item.container_id;\n    }\n  }\n  return undefined;\n}\n\nasync function listContainerGeneratedFiles(\n  client: OpenAI,\n  containerId: string,\n  extension: DocumentFormat,\n): Promise<ContainerGeneratedFile[]> {\n  const suffix = `.${extension}`;\n  const files: ContainerGeneratedFile[] = [];\n  for await (const file of client.containers.files.list(containerId)) {\n    const path = file.path?.toLowerCase() ?? '';\n    if (path.endsWith(suffix) && file.source === 'assistant') {\n      files.push({\n        containerId,\n        fileId: file.id,\n        filename: file.path.split('/').pop() ?? file.path,\n      });\n    }\n  }\n  return files;\n}\n\nasync function downloadContainerFile(\n  client: OpenAI,\n  file: ContainerGeneratedFile,\n): Promise<Buffer | null> {\n  try {\n    const res = await client.containers.files.content.retrieve(file.fileId, {\n      container_id: file.containerId,\n    });\n    const bytes = await res.arrayBuffer();\n    return Buffer.from(bytes);\n  } catch (error) {\n    logger.error('Failed to download container file', { error, file });\n    return null;\n  }\n}\n\nfunction safeBasename(title: string): string {\n  const base = title\n    .replace(/[^a-zA-Z0-9\\s\\-_]/g, '')\n    .replace(/\\s+/g, '_')\n    .substring(0, 60);\n  return base || 'document';\n}\n\nfunction buildDocumentGenInstructions(format: DocumentFormat): string {\n  const qualityRules = FORMAT_QUALITY_RULES[format] ?? [];\n  return [\n    'You are a document generator for K-12 and university teachers.',\n    'When given a title, output format, and source content:',\n    '1. Use the python tool to create exactly ONE output file of the requested type.',\n    `2. For this format use: ${FORMAT_HINTS[format]}.`,\n    `3. You MUST output a ${format.toUpperCase()} file — not any other format.`,\n    `4. The saved filename MUST end with .${extensionForFormat(format)}.`,\n    '5. Faithfully adapt ALL source content to the output medium — do not summarize away detail.',\n    '6. Include the document title prominently where the format allows.',\n    '7. Put ONLY the educational content in the file — no meta commentary.',\n    '8. You MUST save the file to disk in the working directory before you finish.',\n    ...(format !== 'pdf'\n      ? [`9. Do NOT create a PDF when ${format.toUpperCase()} was requested.`]\n      : []),\n    ...(qualityRules.length > 0\n      ? ['', 'Format-specific quality:', ...qualityRules.map((r, i) => `${i + 1}. ${r}`)]\n      : []),\n  ].join('\\n');\n}\n\n/** Generate a file via OpenAI Code Interpreter. */\nexport async function generateDocumentWithOpenAI(\n  input: GenerateDocumentInput,\n): Promise<GeneratedDocumentResult | null> {\n  const client = new OpenAI();\n  const format = normalizeDocumentFormat(input.format);\n  const ext = extensionForFormat(format);\n  const filename = `${safeBasename(input.title)}.${ext}`;\n\n  try {\n    const response = await client.responses.create({\n      model: DOCUMENT_GEN_MODEL,\n      instructions: buildDocumentGenInstructions(format),\n      tools: [\n        {\n          type: 'code_interpreter',\n          container: { type: 'auto' },\n        },\n      ],\n      tool_choice: 'required',\n      input: [\n        `Create a ${ext.toUpperCase()} file using the python tool.`,\n        `Output filename (exact): ${filename}`,\n        `Output format: ${ext}`,\n        `Document title: ${input.title}`,\n        ['Source content — adapt fully to the output medium (do not paste raw markdown into slides/images):', input.content].join('\\n'),\n      ].join('\\n\\n'),\n    });\n\n    let matches = extractContainerGeneratedFiles(response, format);\n\n    if (matches.length === 0) {\n      const containerId = containerIdFromResponse(response);\n      if (containerId) {\n        matches = await listContainerGeneratedFiles(client, containerId, format);\n      }\n    }\n\n    if (matches.length === 0) {\n      logger.error('OpenAI document gen produced no matching files', {\n        title: input.title,\n        format,\n        outputTypes: (response.output ?? []).map((o) => o.type),\n      });\n      return null;\n    }\n\n    const preferred =\n      matches.find((f) => f.filename.toLowerCase() === filename.toLowerCase()) ??\n      matches[0];\n\n    const bytes = await downloadContainerFile(client, preferred);\n    if (!bytes) return null;\n\n    return {\n      bytes,\n      filename: preferred.filename,\n      mimeType: mimeTypeForFormat(format),\n      format,\n    };\n  } catch (error) {\n    logger.error('OpenAI document generation failed', {\n      error,\n      title: input.title,\n      format,\n    });\n    return null;\n  }\n}\n\n/** @deprecated Use {@link generateDocumentWithOpenAI} */\nexport async function generatePdfWithOpenAI(\n  input: Omit<GenerateDocumentInput, 'format'>,\n): Promise<Buffer | null> {\n  const result = await generateDocumentWithOpenAI({ ...input, format: 'pdf' });\n  return result?.bytes ?? null;\n}\n\n/** @deprecated Use {@link extractContainerGeneratedFiles} */\nexport const extractContainerPdfFiles = (response: Response) =>\n  extractContainerGeneratedFiles(response, 'pdf');\n"],"names":[],"mappings":"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","debug_id":"d086b281-e191-5157-a799-843675a76a37"}

package/dist/services/school.d.ts

@@ -162,6 +162,8 @@ export declare function createSchoolClass(userId: string, input: {
             email: string;
             password: string;
             verified: boolean;
+            termsAcceptedAt: Date | null;
+            termsVersion: string | null;
             schoolId: string | null;
         }[];
         students: {
@@ -170,6 +172,8 @@ export declare function createSchoolClass(userId: string, input: {
             email: string;
             password: string;
             verified: boolean;
+            termsAcceptedAt: Date | null;
+            termsVersion: string | null;
             schoolId: string | null;
         }[];
     } & {
@@ -358,6 +362,118 @@ export declare function getStudentTimeline(userId: string, input: {
         status: "PRESENT" | "LATE" | "ABSENT";
     }[];
 }>;
+/**
+ * Role-aware overview used by `/view/[userId]`.
+ *
+ * - For STUDENT members it returns the same timeline as `getStudentTimeline`
+ *   (events, assignments, attendance) so teachers/admins can audit progress.
+ * - For TEACHER/ADMIN members it returns their teaching agenda: every event in
+ *   a class they teach plus their personal events, alongside the classes they
+ *   run with enrolment counts.
+ *
+ * Permissions:
+ * - School admins can view anyone in the institution.
+ * - A teacher can view a STUDENT they share a class with.
+ * - A teacher/admin can always view their own overview.
+ */
+export declare function getMemberTimeline(userId: string, input: {
+    schoolId: string;
+    memberId: string;
+    from?: Date;
+    to?: Date;
+}): Promise<{
+    role: "STUDENT";
+    member: {
+        id: string;
+        username: string;
+        profile: {
+            profilePicture: string | null;
+            displayName: string | null;
+        } | null;
+    };
+    events: {
+        class: {
+            id: string;
+            name: string;
+            color: string | null;
+        } | null;
+        id: string;
+        location: string | null;
+        name: string | null;
+        color: string | null;
+        startTime: Date;
+        endTime: Date;
+        remarks: string | null;
+    }[];
+    assignments: {
+        type: import(".prisma/client").$Enums.AssignmentType;
+        class: {
+            section: string;
+            id: string;
+            name: string;
+            color: string | null;
+            subject: string;
+        };
+        id: string;
+        submissions: {
+            id: string;
+            gradeReceived: number | null;
+            submittedAt: Date | null;
+            submitted: boolean | null;
+            returned: boolean | null;
+        }[];
+        title: string;
+        dueDate: Date;
+        maxGrade: number | null;
+        graded: boolean;
+        weight: number;
+    }[];
+    attendance: {
+        id: string;
+        date: Date;
+        class: {
+            id: string;
+            name: string;
+            color: string | null;
+        };
+        status: "PRESENT" | "LATE" | "ABSENT";
+    }[];
+    classes?: undefined;
+} | {
+    role: "TEACHER" | "ADMIN";
+    member: {
+        id: string;
+        username: string;
+        profile: {
+            profilePicture: string | null;
+            displayName: string | null;
+        } | null;
+    };
+    events: {
+        class: {
+            id: string;
+            name: string;
+            color: string | null;
+        } | null;
+        id: string;
+        location: string | null;
+        name: string | null;
+        color: string | null;
+        startTime: Date;
+        endTime: Date;
+        remarks: string | null;
+    }[];
+    classes: {
+        id: string;
+        name: string;
+        section: string;
+        subject: string;
+        color: string | null;
+        studentCount: number;
+    }[];
+    assignments?: undefined;
+    attendance?: undefined;
+}>;
 export declare function createInvite(userId: string, input: {
     schoolId: string;
     email: string;