add deprecation comments

Author: Veikkosuhonen

src/server/routes/ai/v1.ts

@@ -13,6 +13,9 @@ import { upload } from './multer'
 import { parseFileAndAddToLastMessage } from './fileParsing'
 import type { MessageType } from './types'
 
+/**
+ * @deprecated In favor of v3. Kept alive since v2 is unreliable and v3 is not yet mature.
+ */
 const router = express.Router()
 
 router.post('/stream', upload.single('file'), async (r, res) => {

src/server/routes/ai/v2.ts

@@ -13,6 +13,9 @@ import { parseFileAndAddToLastMessage } from './fileParsing'
 import { upload } from './multer'
 import { type MessageType, PostStreamSchemaV2 } from './types'
 
+/**
+ * @deprecated Uses the Responses API, which is unreliably implemented in azure. Keep v2 for reference until v3 reaches feature parity (sort of).
+ */
 const router = express.Router()
 
 router.post('/stream', upload.single('file'), async (r, res) => {

src/server/routes/ai/v3.ts

@@ -1,20 +1,18 @@
 import express from 'express'
 import { DEFAULT_TOKEN_LIMIT, FREE_MODEL, inProduction } from '../../../config'
+import type { ChatMessage } from '../../../shared/llmTypes'
+import type { ResponseStreamEventData } from '../../../shared/types'
 import { ChatInstance, Discussion, UserChatInstanceUsage } from '../../db/models'
 import { calculateUsage, checkCourseUsage, checkUsage, incrementCourseUsage, incrementUsage } from '../../services/chatInstances/usage'
+import { createChatStream, streamChatResponse } from '../../services/langchain/chat'
 import type { RequestWithUser } from '../../types'
 import { ApplicationError } from '../../util/ApplicationError'
 import logger from '../../util/logger'
 import getEncoding from '../../util/tiktoken'
-import { getAllowedModels, getMessageContext, getModelContextLimit } from '../../util/util'
+import { getAllowedModels, getModelContextLimit } from '../../util/util'
 import { parseFileAndAddToLastMessage } from './fileParsing'
 import { upload } from './multer'
-import { type MessageType, PostStreamSchemaV3 } from './types'
-import { createChatStream, streamChatResponse } from '../../services/langchain/chat'
-import { IterableReadableStream } from '@langchain/core/utils/stream'
-import { AIMessageChunk } from '@langchain/core/messages'
-import { ChatMessage } from '../../../shared/llmTypes'
-import { ResponseStreamEventData } from '../../../shared/types'
+import { PostStreamSchemaV3 } from './types'
 
 const router = express.Router()