@ord-api/ord-api-types 1.0.23 → 1.0.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ord-api/ord-api-types",
-  "version": "1.0.23",
+  "version": "1.0.25",
   "description": "TypeScript types for ORD API - Auto-generated from OpenAPI specification",
   "main": "types.ts",
   "types": "types.ts",

package/types.ts

@@ -604,6 +604,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/v1/conversations/ongoing/ai/generate-learning-tips": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Generate learning tips from latest AI message
+         * @description Generate structured learning tips and annotations from the most recent AI message in the conversation that doesn't have learning tips yet. The system automatically identifies the appropriate message.
+         */
+        post: operations["generateLearningTipsForAIMessage"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/v1/auth/otp-verify": {
         parameters: {
             query?: never;
@@ -1658,14 +1678,39 @@ export interface components {
             tone: "FRIENDLY" | "FORMAL" | "HUMOROUS" | "NEUTRAL" | "ENCOURAGING" | "CHALLENGING";
             /** @enum {string} */
             type: "SMALL_TALK" | "SCENARIO_ROLEPLAY" | "EXAM_PRACTICE" | "TOPIC_EXPLORATION" | "OXFORD_DEBATE";
-            aiInterlocutorName?: string;
-            aiInterlocutorAvatarId?: string;
+            aiInterlocutorName: string;
+            aiInterlocutorAvatarId: string;
         };
         AlternativeExpression: {
             context: string;
             alternatives: string[];
             note?: string;
         };
+        AnnotatedGrammarTip: {
+            phrase: string;
+            explanation: string;
+            grammarPoint: string;
+        };
+        AnnotatedIdiomTip: {
+            phrase: string;
+            meaning: string;
+            example: string;
+        };
+        AnnotatedVocabularyTip: {
+            word: string;
+            definition: string;
+            usageNote: string;
+            proficiencyLevel: string;
+        };
+        ConversationAIMessageLearningTipsDTO: {
+            /** Format: uuid */
+            id: string;
+            grammarTips: components["schemas"]["AnnotatedGrammarTip"][];
+            vocabularyTips: components["schemas"]["AnnotatedVocabularyTip"][];
+            idiomTips: components["schemas"]["AnnotatedIdiomTip"][];
+            /** Format: uuid */
+            messageId: string;
+        };
         ConversationDTO: {
             /** Format: uuid */
             id: string;
@@ -1681,8 +1726,8 @@ export interface components {
             type: "SMALL_TALK" | "SCENARIO_ROLEPLAY" | "EXAM_PRACTICE" | "TOPIC_EXPLORATION" | "OXFORD_DEBATE";
             /** @enum {string} */
             aiTone: "FRIENDLY" | "FORMAL" | "HUMOROUS" | "NEUTRAL" | "ENCOURAGING" | "CHALLENGING";
-            aiInterlocutorName?: string;
-            aiInterlocutorAvatarId?: string;
+            aiInterlocutorName: string;
+            aiInterlocutorAvatarId: string;
             additionalContext?: string;
             messages: components["schemas"]["ConversationMessageDTO"][];
             /** Format: date-time */
@@ -1699,12 +1744,14 @@ export interface components {
             sender: "USER" | "AI";
             content: string;
             feedback?: components["schemas"]["ConversationUserMessageFeedbackDTO"];
+            learningTips?: components["schemas"]["ConversationAIMessageLearningTipsDTO"];
             /** Format: date-time */
             createdAt: string;
         };
         ConversationUserMessageFeedbackDTO: {
             /** Format: uuid */
             id: string;
+            tutorComment: string;
             /** Format: int32 */
             grammar: number;
             /** Format: int32 */
@@ -1790,6 +1837,7 @@ export interface components {
         };
         ReviewedUserConversationMessage: {
             sabotage?: string;
+            tutorComment: string;
             /** Format: int32 */
             grammar: number;
             /** Format: int32 */
@@ -1814,6 +1862,15 @@ export interface components {
             messageOrder: number;
             latestUserMessage: string;
         };
+        GetLearningTipsForAIMessageRequest: {
+            /** Format: uuid */
+            conversationId: string;
+        };
+        AIMessageLearningTips: {
+            grammarTips: components["schemas"]["AnnotatedGrammarTip"][];
+            vocabularyTips: components["schemas"]["AnnotatedVocabularyTip"][];
+            idiomTips: components["schemas"]["AnnotatedIdiomTip"][];
+        };
         /** @description Request to verify OTP code and authenticate user */
         OtpVerifyDto: {
             /**
@@ -3478,6 +3535,53 @@ export interface operations {
             };
         };
     };
+    generateLearningTipsForAIMessage: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["GetLearningTipsForAIMessageRequest"];
+            };
+        };
+        responses: {
+            /** @description Learning tips generated successfully */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "*/*": components["schemas"]["AIMessageLearningTips"];
+                };
+            };
+            /** @description Bad Request */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "*/*": components["schemas"]["BadRequestResponse"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Conversation not found or no AI message without learning tips exists */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     verifyOtp: {
         parameters: {
             query?: never;