@studious-lms/server 1.1.11 → 1.1.13

package/dist/utils/aiUser.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Ensure AI assistant user exists in the database
+ */
+export declare function ensureAIUserExists(): Promise<void>;
+/**
+ * Get the AI user ID
+ */
+export declare function getAIUserId(): string;
+/**
+ * Check if a user ID belongs to the AI assistant
+ */
+export declare function isAIUser(userId: string): boolean;
+//# sourceMappingURL=aiUser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aiUser.d.ts","sourceRoot":"","sources":["../../src/utils/aiUser.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CA0CxD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhD"}

package/dist/utils/aiUser.js

@@ -0,0 +1,57 @@
+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() {
+    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() {
+    return AI_USER_ID;
+}
+/**
+ * Check if a user ID belongs to the AI assistant
+ */
+export function isAIUser(userId) {
+    return userId === AI_USER_ID;
+}

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.11",
+  "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/prisma/migrations/20250925072732_add_lab_chat_system/migration.sql

@@ -0,0 +1,25 @@
+-- CreateTable
+CREATE TABLE "LabChat" (
+    "id" TEXT NOT NULL,
+    "title" TEXT NOT NULL,
+    "context" TEXT NOT NULL,
+    "classId" TEXT NOT NULL,
+    "conversationId" TEXT NOT NULL,
+    "createdById" TEXT NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+
+    CONSTRAINT "LabChat_pkey" PRIMARY KEY ("id")
+);
+
+-- CreateIndex
+CREATE UNIQUE INDEX "LabChat_conversationId_key" ON "LabChat"("conversationId");
+
+-- AddForeignKey
+ALTER TABLE "LabChat" ADD CONSTRAINT "LabChat_classId_fkey" FOREIGN KEY ("classId") REFERENCES "Class"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "LabChat" ADD CONSTRAINT "LabChat_conversationId_fkey" FOREIGN KEY ("conversationId") REFERENCES "Conversation"("id") ON DELETE CASCADE ON UPDATE CASCADE;
+
+-- AddForeignKey
+ALTER TABLE "LabChat" ADD CONSTRAINT "LabChat_createdById_fkey" FOREIGN KEY ("createdById") REFERENCES "User"("id") ON DELETE NO ACTION ON UPDATE CASCADE;

package/prisma/schema.prisma

@@ -80,6 +80,7 @@ model User {
   conversationMemberships ConversationMember[]
   sentMessages Message[] @relation("SentMessages")
   mentions Mention[] @relation("UserMentions")
+  createdLabChats LabChat[] @relation("CreatedLabChats")
 
 }
 
@@ -118,6 +119,7 @@ model Class {
   gradingBoundaries GradingBoundary[] @relation("ClassToGradingBoundary")
   draftFiles File[] @relation("ClassDraftFiles")
   classFiles Folder? @relation("ClassFiles")
+  labChats LabChat[] @relation("ClassLabChats")
 
   school    School? @relation(fields: [schoolId], references: [id])
   schoolId  String?
@@ -334,6 +336,22 @@ model Conversation {
   
   members ConversationMember[]
   messages Message[]
+  labChat LabChat?
+}
+
+model LabChat {
+  id String @id @default(uuid())
+  title String
+  context String // JSON string for LLM context
+  classId String
+  conversationId String @unique
+  createdById String // Teacher who created the lab
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+  
+  class Class @relation("ClassLabChats", fields: [classId], references: [id], onDelete: Cascade)
+  conversation Conversation @relation(fields: [conversationId], references: [id], onDelete: Cascade)
+  createdBy User @relation("CreatedLabChats", fields: [createdById], references: [id], onDelete: NoAction)
 }
 
 model ConversationMember {

package/src/routers/_app.ts

@@ -15,6 +15,7 @@ import { folderRouter } from "./folder.js";
 import { notificationRouter } from "./notifications.js";
 import { conversationRouter } from "./conversation.js";
 import { messageRouter } from "./message.js";
+import { labChatRouter } from "./labChat.js";
 
 export const appRouter = createTRPCRouter({
   class: classRouter,
@@ -31,6 +32,7 @@ export const appRouter = createTRPCRouter({
   notification: notificationRouter,
   conversation: conversationRouter,
   message: messageRouter,
+  labChat: labChatRouter,
 }); 
 
 // Export type router type definition

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;
+    }),
 });