@studious-lms/server 1.1.12 → 1.1.13

package/dist/utils/inference.d.ts

@@ -0,0 +1,56 @@
+import OpenAI from 'openai';
+export declare const inferenceClient: OpenAI;
+export interface LabChatContext {
+    subject: string;
+    topic: string;
+    difficulty: 'beginner' | 'intermediate' | 'advanced';
+    objectives: string[];
+    resources?: string[];
+    persona: string;
+    constraints: string[];
+    examples?: any[];
+    metadata?: Record<string, any>;
+}
+export interface InferenceResponse {
+    content: string;
+    model: string;
+    tokensUsed: number;
+    finishReason: string;
+}
+/**
+ * Centralized function to send AI messages to conversations
+ * Handles database storage and Pusher broadcasting
+ */
+export declare function sendAIMessage(content: string, conversationId: string, options?: {
+    subject?: string;
+    customSender?: {
+        displayName: string;
+        profilePicture?: string | null;
+    };
+}): Promise<{
+    id: string;
+    content: string;
+    senderId: string;
+    conversationId: string;
+    createdAt: Date;
+}>;
+/**
+ * Simple inference function for general use
+ */
+export declare function generateInferenceResponse(subject: string, question: string, options?: {
+    model?: string;
+    maxTokens?: number;
+}): Promise<InferenceResponse>;
+/**
+ * Validate inference configuration
+ */
+export declare function validateInferenceConfig(): boolean;
+/**
+ * Get available inference models (for admin/config purposes)
+ */
+export declare function getAvailableModels(): Promise<string[]>;
+/**
+ * Estimate token count for a message (rough approximation)
+ */
+export declare function estimateTokenCount(text: string): number;
+//# sourceMappingURL=inference.d.ts.map

package/dist/utils/inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inference.d.ts","sourceRoot":"","sources":["../../src/utils/inference.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAW5B,eAAO,MAAM,eAAe,QAG1B,CAAC;AAGH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,GAAG,cAAc,GAAG,UAAU,CAAC;IACrD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC;CACE,GACL,OAAO,CAAC;IACT,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,IAAI,CAAC;CACjB,CAAC,CAmDD;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL,OAAO,CAAC,iBAAiB,CAAC,CAsC5B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAMjD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAW5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvD"}

package/dist/utils/inference.js

@@ -0,0 +1,135 @@
+import OpenAI from 'openai';
+import { logger } from './logger.js';
+import { prisma } from '../lib/prisma.js';
+import { pusher } from '../lib/pusher.js';
+import { ensureAIUserExists, getAIUserId } from './aiUser.js';
+// Initialize inference client (Cohere via OpenAI SDK)
+logger.info('Inference API Key', { apiKey: process.env.INFERENCE_API_KEY });
+logger.info('Inference API Base URL', { baseURL: process.env.INFERENCE_API_BASE_URL });
+export const inferenceClient = new OpenAI({
+    apiKey: process.env.INFERENCE_API_KEY,
+    baseURL: process.env.INFERENCE_API_BASE_URL,
+});
+/**
+ * Centralized function to send AI messages to conversations
+ * Handles database storage and Pusher broadcasting
+ */
+export async function sendAIMessage(content, conversationId, options = {}) {
+    // Ensure AI user exists
+    await ensureAIUserExists();
+    // Create message in database
+    const aiMessage = await prisma.message.create({
+        data: {
+            content,
+            senderId: getAIUserId(),
+            conversationId,
+        },
+    });
+    logger.info('AI Message sent', {
+        messageId: aiMessage.id,
+        conversationId,
+        contentLength: content.length,
+    });
+    // Prepare sender info
+    const senderInfo = {
+        id: getAIUserId(),
+        username: 'AI Assistant',
+        profile: {
+            displayName: options.customSender?.displayName || `${options.subject || 'AI'} Assistant`,
+            profilePicture: options.customSender?.profilePicture || null,
+        },
+    };
+    // Broadcast via Pusher
+    try {
+        await pusher.trigger(`conversation-${conversationId}`, 'new-message', {
+            id: aiMessage.id,
+            content: aiMessage.content,
+            senderId: getAIUserId(),
+            conversationId: aiMessage.conversationId,
+            createdAt: aiMessage.createdAt,
+            sender: senderInfo,
+            mentionedUserIds: [],
+        });
+    }
+    catch (error) {
+        logger.error('Failed to broadcast AI message:', { error, messageId: aiMessage.id });
+    }
+    return {
+        id: aiMessage.id,
+        content: aiMessage.content,
+        senderId: getAIUserId(),
+        conversationId: aiMessage.conversationId,
+        createdAt: aiMessage.createdAt,
+    };
+}
+/**
+ * Simple inference function for general use
+ */
+export async function generateInferenceResponse(subject, question, options = {}) {
+    const { model = 'command-r-plus', maxTokens = 500 } = options;
+    try {
+        const completion = await inferenceClient.chat.completions.create({
+            model,
+            messages: [
+                {
+                    role: 'system',
+                    content: `You are a helpful educational assistant for ${subject}. Provide clear, concise, and accurate answers. Keep responses educational and appropriate for students.`,
+                },
+                {
+                    role: 'user',
+                    content: question,
+                },
+            ],
+            max_tokens: maxTokens,
+            temperature: 0.5,
+            // Remove OpenAI-specific parameters for Cohere compatibility
+        });
+        const response = completion.choices[0]?.message?.content;
+        if (!response) {
+            throw new Error('No response generated from inference API');
+        }
+        return {
+            content: response,
+            model,
+            tokensUsed: completion.usage?.total_tokens || 0,
+            finishReason: completion.choices[0]?.finish_reason || 'unknown',
+        };
+    }
+    catch (error) {
+        logger.error('Failed to generate inference response', { error, subject, question: question.substring(0, 50) + '...' });
+        throw error;
+    }
+}
+/**
+ * Validate inference configuration
+ */
+export function validateInferenceConfig() {
+    if (!process.env.INFERENCE_API_KEY) {
+        logger.error('Inference API key not configured for Cohere');
+        return false;
+    }
+    return true;
+}
+/**
+ * Get available inference models (for admin/config purposes)
+ */
+export async function getAvailableModels() {
+    try {
+        const models = await inferenceClient.models.list();
+        return models.data
+            .filter(model => model.id.includes('command'))
+            .map(model => model.id)
+            .sort();
+    }
+    catch (error) {
+        logger.error('Failed to fetch inference models', { error });
+        return ['command-r-plus', 'command-r', 'command-light']; // Fallback Cohere models
+    }
+}
+/**
+ * Estimate token count for a message (rough approximation)
+ */
+export function estimateTokenCount(text) {
+    // Rough approximation: 1 token ≈ 4 characters for English text
+    return Math.ceil(text.length / 4);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studious-lms/server",
-  "version": "1.1.12",
+  "version": "1.1.13",
   "description": "Backend server for Studious application",
   "main": "dist/exportType.js",
   "types": "dist/exportType.d.ts",
@@ -30,6 +30,7 @@
     "dotenv": "^16.5.0",
     "express": "^4.18.3",
     "nodemailer": "^7.0.4",
+    "openai": "^5.23.0",
     "prisma": "^6.7.0",
     "pusher": "^5.2.0",
     "sharp": "^0.34.2",

package/src/routers/conversation.ts

@@ -16,6 +16,12 @@ export const conversationRouter = createTRPCRouter({
         },
       },
       include: {
+        labChat: {
+          select: {
+            id: true,
+            title: true,
+          },
+        },
         members: {
           include: {
             user: {
@@ -101,6 +107,7 @@ export const conversationRouter = createTRPCRouter({
           name: conversation.name,
           createdAt: conversation.createdAt,
           updatedAt: conversation.updatedAt,
+          labChat: conversation.labChat,
           members: conversation.members,
           lastMessage: conversation.messages[0] || null,
           unreadCount,

package/src/routers/folder.ts

@@ -3,6 +3,7 @@ import { createTRPCRouter, protectedProcedure, protectedClassMemberProcedure, pr
 import { TRPCError } from "@trpc/server";
 import { prisma } from "../lib/prisma.js";
 import { uploadFiles, type UploadedFile } from "../lib/fileUpload.js";
+import { type Folder } from "@prisma/client";
 
 const fileSchema = z.object({
   name: z.string(),
@@ -766,4 +767,26 @@ export const folderRouter = createTRPCRouter({
 
       return updatedFolder;
     }),
+    getParents: protectedProcedure
+    .input(z.object({
+      folderId: z.string(),
+    }))
+    .query(async ({ ctx, input }) => {
+      const { folderId } = input;
+
+      let currentParent: string | null = folderId;
+      const parents: Folder[] = [];
+      while (currentParent) {
+        const parent = await prisma.folder.findFirst({
+          where: {
+            id: currentParent,
+          },
+        });
+
+        currentParent = parent?.parentFolderId;
+        parents.push(parent);
+      }
+
+      return parents;
+    }),
 }); 

package/src/routers/labChat.ts

@@ -3,6 +3,14 @@ import { createTRPCRouter, protectedProcedure } from '../trpc.js';
 import { prisma } from '../lib/prisma.js';
 import { pusher } from '../lib/pusher.js';
 import { TRPCError } from '@trpc/server';
+import { 
+  inferenceClient,
+  sendAIMessage,
+  type LabChatContext 
+} from '../utils/inference.js';
+import { logger } from '../utils/logger.js';
+import { isAIUser } from '../utils/aiUser.js';
+import OpenAI from 'openai';
 
 export const labChatRouter = createTRPCRouter({
   create: protectedProcedure
@@ -83,14 +91,14 @@ export const labChatRouter = createTRPCRouter({
           },
         });
 
-        // Add all class members to the conversation
-        const allMembers = [
-          ...classWithTeachers.teachers.map(t => ({ userId: t.id, role: 'ADMIN' as const })),
-          ...classWithTeachers.students.map(s => ({ userId: s.id, role: 'MEMBER' as const })),
-        ];
+        // Add only teachers to the conversation (this is for course material creation)
+        const teacherMembers = classWithTeachers.teachers.map(t => ({ 
+          userId: t.id, 
+          role: 'ADMIN' as const 
+        }));
 
         await tx.conversationMember.createMany({
-          data: allMembers.map(member => ({
+          data: teacherMembers.map(member => ({
             userId: member.userId,
             conversationId: conversation.id,
             role: member.role,
@@ -152,6 +160,11 @@ export const labChatRouter = createTRPCRouter({
         return labChat;
       });
 
+      // Generate AI introduction message in parallel (don't await - fire and forget)
+      generateAndSendLabIntroduction(result.id, result.conversationId, context, classWithTeachers.subject || 'Lab').catch(error => {
+        logger.error('Failed to generate AI introduction:', { error, labChatId: result.id });
+      });
+
       // Broadcast lab chat creation to class members
       try {
         await pusher.trigger(`class-${classId}`, 'lab-chat-created', {
@@ -176,7 +189,8 @@ export const labChatRouter = createTRPCRouter({
       const userId = ctx.user!.id;
       const { labChatId } = input;
 
-      const labChat = await prisma.labChat.findFirst({
+      // First, try to find the lab chat if user is already a member
+      let labChat = await prisma.labChat.findFirst({
         where: {
           id: labChatId,
           conversation: {
@@ -230,6 +244,88 @@ export const labChatRouter = createTRPCRouter({
         },
       });
 
+      // If not found, check if user is a teacher in the class
+      if (!labChat) {
+        const labChatForTeacher = await prisma.labChat.findFirst({
+          where: {
+            id: labChatId,
+            class: {
+              teachers: {
+                some: {
+                  id: userId,
+                },
+              },
+            },
+          },
+          include: {
+            conversation: {
+              select: {
+                id: true,
+              },
+            },
+          },
+        });
+
+        if (labChatForTeacher) {
+          // Add teacher to conversation
+          await prisma.conversationMember.create({
+            data: {
+              userId,
+              conversationId: labChatForTeacher.conversation.id,
+              role: 'ADMIN',
+            },
+          });
+
+          // Now fetch the full lab chat with the user as a member
+          labChat = await prisma.labChat.findFirst({
+            where: {
+              id: labChatId,
+            },
+            include: {
+              conversation: {
+                include: {
+                  members: {
+                    include: {
+                      user: {
+                        select: {
+                          id: true,
+                          username: true,
+                          profile: {
+                            select: {
+                              displayName: true,
+                              profilePicture: true,
+                            },
+                          },
+                        },
+                      },
+                    },
+                  },
+                },
+              },
+              createdBy: {
+                select: {
+                  id: true,
+                  username: true,
+                  profile: {
+                    select: {
+                      displayName: true,
+                    },
+                  },
+                },
+              },
+              class: {
+                select: {
+                  id: true,
+                  name: true,
+                  subject: true,
+                  section: true,
+                },
+              },
+            },
+          });
+        }
+      }
+
       if (!labChat) {
         throw new TRPCError({
           code: 'NOT_FOUND',
@@ -439,7 +535,7 @@ export const labChatRouter = createTRPCRouter({
         return message;
       });
 
-      // Broadcast to Pusher channel (using conversation ID)
+      // Broadcast to Pusher channel (same format as regular chat)
       try {
         await pusher.trigger(`conversation-${labChat.conversationId}`, 'new-message', {
           id: result.id,
@@ -449,13 +545,20 @@ export const labChatRouter = createTRPCRouter({
           createdAt: result.createdAt,
           sender: result.sender,
           mentionedUserIds,
-          labChatId, // Include lab chat ID for frontend context
         });
       } catch (error) {
         console.error('Failed to broadcast lab chat message:', error);
         // Don't fail the request if Pusher fails
       }
 
+        // Generate AI response in parallel (don't await - fire and forget)
+        if (!isAIUser(userId)) {
+          // Run AI response generation in background
+          generateAndSendLabResponse(labChatId, content, labChat.conversationId).catch(error => {
+            logger.error('Failed to generate AI response:', { error });
+          });
+        }
+
       return {
         id: result.id,
         content: result.content,
@@ -464,7 +567,6 @@ export const labChatRouter = createTRPCRouter({
         createdAt: result.createdAt,
         sender: result.sender,
         mentionedUserIds,
-        labChatId,
       };
     }),
 
@@ -539,3 +641,184 @@ export const labChatRouter = createTRPCRouter({
       return { success: true };
     }),
 });
+
+/**
+ * Generate and send AI introduction for lab chat
+ * Uses the stored context directly from database
+ */
+async function generateAndSendLabIntroduction(
+  labChatId: string,
+  conversationId: string,
+  contextString: string,
+  subject: string
+): Promise<void> {
+  try {
+    // Enhance the stored context with clarifying question instructions
+    const enhancedSystemPrompt = `${contextString}
+
+IMPORTANT INSTRUCTIONS:
+- You are helping teachers create course materials
+- Use the context information provided above (subject, topic, difficulty, objectives, etc.) as your foundation
+- Only ask clarifying questions about details NOT already specified in the context
+- Focus your questions on format preferences, specific requirements, or missing details needed to create the content
+- Only output final course materials when you have sufficient details beyond what's in the context
+- Do not use markdown formatting in your responses - use plain text only
+- When creating content, make it clear and well-structured without markdown`;
+
+    const completion = await inferenceClient.chat.completions.create({
+      model: 'command-a-03-2025',
+      messages: [
+        { role: 'system', content: enhancedSystemPrompt },
+        { 
+          role: 'user', 
+          content: 'Please introduce yourself to the teaching team. Explain that you will help create course materials by first asking clarifying questions based on the context provided, and only output final content when you have enough information.' 
+        },
+      ],
+      max_tokens: 300,
+      temperature: 0.8,
+    });
+
+    const response = completion.choices[0]?.message?.content;
+    
+    if (!response) {
+      throw new Error('No response generated from inference API');
+    }
+
+    // Send AI introduction using centralized sender
+    await sendAIMessage(response, conversationId, {
+      subject,
+    });
+
+    logger.info('AI Introduction sent', { labChatId, conversationId });
+
+  } catch (error) {
+    logger.error('Failed to generate AI introduction:', { error, labChatId });
+    
+    // Send fallback introduction
+    try {
+      const fallbackIntro = `Hello teaching team! I'm your AI assistant for course material development. I will help you create educational content by first asking clarifying questions based on the provided context, then outputting final materials when I have sufficient information. I won't use markdown formatting in my responses. What would you like to work on?`;
+      
+      await sendAIMessage(fallbackIntro, conversationId, {
+        subject,
+      });
+
+      logger.info('Fallback AI introduction sent', { labChatId });
+
+    } catch (fallbackError) {
+      logger.error('Failed to send fallback AI introduction:', { error: fallbackError, labChatId });
+    }
+  }
+}
+
+/**
+ * Generate and send AI response to teacher message
+ * Uses the stored context directly from database
+ */
+async function generateAndSendLabResponse(
+  labChatId: string,
+  teacherMessage: string,
+  conversationId: string
+): Promise<void> {
+  try {
+    // Get lab context from database
+    const fullLabChat = await prisma.labChat.findUnique({
+      where: { id: labChatId },
+      include: {
+        class: {
+          select: {
+            name: true,
+            subject: true,
+          },
+        },
+      },
+    });
+
+    if (!fullLabChat) {
+      throw new Error('Lab chat not found');
+    }
+
+    // Get recent conversation history
+    const recentMessages = await prisma.message.findMany({
+      where: {
+        conversationId,
+      },
+      include: {
+        sender: {
+          select: {
+            id: true,
+            username: true,
+            profile: {
+              select: {
+                displayName: true,
+              },
+            },
+          },
+        },
+      },
+      orderBy: {
+        createdAt: 'desc',
+      },
+      take: 10, // Last 10 messages for context
+    });
+
+    // Build conversation history as proper message objects
+    // Enhance the stored context with clarifying question instructions
+    const enhancedSystemPrompt = `${fullLabChat.context}
+
+IMPORTANT INSTRUCTIONS:
+- Use the context information provided above (subject, topic, difficulty, objectives, etc.) as your foundation
+- Based on the teacher's input and existing context, only ask clarifying questions about details NOT already specified
+- Focus questions on format preferences, specific requirements, quantity, or missing implementation details
+- Only output final course materials when you have sufficient details beyond what's in the context
+- Do not use markdown formatting in your responses - use plain text only
+- When you do create content, make it clear and well-structured without markdown
+- If the request is vague, ask 1-2 specific clarifying questions about missing details only`;
+
+    const messages: OpenAI.Chat.Completions.ChatCompletionMessageParam[] = [
+      { role: 'system', content: enhancedSystemPrompt },
+    ];
+
+    // Add recent conversation history
+    recentMessages.reverse().forEach(msg => {
+      const role = isAIUser(msg.senderId) ? 'assistant' : 'user';
+      const senderName = msg.sender?.profile?.displayName || msg.sender?.username || 'Teacher';
+      const content = isAIUser(msg.senderId) ? msg.content : `${senderName}: ${msg.content}`;
+      
+      messages.push({
+        role: role as 'user' | 'assistant',
+        content,
+      });
+    });
+
+    // Add the new teacher message
+    const senderName = 'Teacher'; // We could get this from the actual sender if needed
+    messages.push({
+      role: 'user',
+      content: `${senderName}: ${teacherMessage}`,
+    });
+
+    const completion = await inferenceClient.chat.completions.create({
+      model: 'command-a-03-2025',
+      messages,
+      max_tokens: 500,
+      temperature: 0.7,
+    });
+
+    const response = completion.choices[0]?.message?.content;
+    
+    if (!response) {
+      throw new Error('No response generated from inference API');
+    }
+
+    // Send AI response
+    await sendAIMessage(response, conversationId, {
+      subject: fullLabChat.class?.subject || 'Lab',
+    });
+
+    logger.info('AI response sent', { labChatId, conversationId });
+
+  } catch (error) {
+    logger.error('Failed to generate AI response:', { error, labChatId });
+  }
+}
+

package/src/utils/aiUser.ts

@@ -0,0 +1,65 @@
+import { prisma } from '../lib/prisma.js';
+import { logger } from './logger.js';
+
+const AI_USER_ID = 'AI_ASSISTANT';
+
+/**
+ * Ensure AI assistant user exists in the database
+ */
+export async function ensureAIUserExists(): Promise<void> {
+  try {
+    // Check if AI user already exists
+    const existingAIUser = await prisma.user.findUnique({
+      where: { id: AI_USER_ID },
+    });
+
+    if (existingAIUser) {
+      return; // AI user already exists
+    }
+
+    // Create AI user
+    await prisma.user.create({
+      data: {
+        id: AI_USER_ID,
+        username: 'ai-assistant',
+        email: 'ai@studious-lms.com',
+        password: 'ai-system-user', // Not used for login
+        verified: true,
+        role: 'NONE', // Special role for AI
+        profile: {
+          create: {
+            displayName: 'AI Assistant',
+            bio: 'Intelligent assistant for lab chats and educational support',
+            profilePicture: null,
+          },
+        },
+      },
+    });
+
+    logger.info('AI user created successfully', { userId: AI_USER_ID });
+
+  } catch (error) {
+    // If user already exists (race condition), that's okay
+    if (error instanceof Error && error.message.includes('unique constraint')) {
+      logger.info('AI user already exists (race condition handled)');
+      return;
+    }
+
+    logger.error('Failed to create AI user', { error });
+    throw error;
+  }
+}
+
+/**
+ * Get the AI user ID
+ */
+export function getAIUserId(): string {
+  return AI_USER_ID;
+}
+
+/**
+ * Check if a user ID belongs to the AI assistant
+ */
+export function isAIUser(userId: string): boolean {
+  return userId === AI_USER_ID;
+}